# SOFT FACET V2 - форма для керамической кофейной воронки

Параметрический комплект под OpenSCAD 2021.01: печатный мастер, постоянный
кожух для гипса, фиксирующие штифты, резак опорной площадки и A3-раскрой
глины в масштабе 1:1.

По умолчанию выбран `v60_02`, пласт 5 мм и суммарная усадка 12%. Это
практический размер под фильтр 02, а не копия и не обмер изделия Hario.

![Сборка мастера, кожуха и фиксирующих штифтов в OpenSCAD 2021.01](docs/images/soft-facet-v2-assembly.png)

## С чего начать

1. Откройте [`dripper_mold.scad`](dripper_mold.scad) в OpenSCAD **2021.01**.
2. Укажите `size_preset`, `surface_style`, реальную усадку и толщину пласта.
3. Поставьте `quality_preset = "normal"`, выберите `part = "master"`, нажмите
   F6 и прочитайте всю вкладку Console.
4. Не экспортируйте мастер, если Console сообщает угол съема ниже 5 градусов
   или стенку тоньше 1.2 мм.
5. Экспортируйте по очереди `master`, `box`, `mount_pins` и `support_cutter` в STL.
6. Напечатайте контрольный участок или мастер в draft, проверьте съемность и
   посадку на седлах кожуха, затем печатайте рабочую версию.
7. Выполните инструкции по гипсу и глине из папки `docs/`.
8. Выберите PDF по пресету и стилю, например
   `output/pdf/v60_02_spiral_flow_clay_templates_a3.pdf`, распечатайте на A3
   без масштабирования и измерьте контрольный квадрат 50 x 50 мм.

## Рендеры OpenSCAD 2021.01

Все изображения ниже отрендерены непосредственно из `dripper_mold.scad`.
Используется release-safe геометрия V2 с теми же параметрами, что применяются
при экспорте STL и расчете PDF.

### Одиннадцать вариантов поверхности

![Галерея одиннадцати release-safe вариантов поверхности](docs/images/soft-facet-v2-variants.png)

### Предпросмотр керамической воронки

![Керамическая стенка и опорная площадка после соединения](docs/images/soft-facet-v2-dripper-preview.png)

## Документация

- [`docs/01_MODEL_AND_PRINT.md`](docs/01_MODEL_AND_PRINT.md) - настройка SCAD,
  экспорт, печать и подготовка мастера.
- [`docs/02_PLASTER_MOLD.md`](docs/02_PLASTER_MOLD.md) - полная сборка и
  заливка одночастной гипсовой формы с верхними седлами и штифтами.
- [`docs/03_CLAY_ASSEMBLY.md`](docs/03_CLAY_ASSEMBLY.md) - раскрой, формование,
  соединение, сушка и контроль после обжига.
- [`docs/04_MULTIPLICATION.md`](docs/04_MULTIPLICATION.md) - как размножить
  цифровые детали, гипсовые формы и серийные изделия.
- [`docs/05_A3_TEMPLATES.md`](docs/05_A3_TEMPLATES.md) - метод расчета,
  ограничения и регенерация PDF/SVG для v60_01 и v60_02.
- [`docs/CODE_REVIEW.md`](docs/CODE_REVIEW.md) - senior-review OpenSCAD и
  оставшиеся производственные риски.
- [`CHANGELOG.md`](CHANGELOG.md) - отличия release-safe версии 2.0.

## Что лежит в репозитории

```text
v60/
├── dripper_mold.scad
├── README.md
├── CHANGELOG.md
├── docs/
│   ├── images/     # PNG-рендеры OpenSCAD 2021.01 для README
├── output/
│   ├── data/       # точные рассчитанные размеры
│   ├── pdf/        # 22 стилевых A3 PDF + 2 smooth-алиаса, 1:1
│   ├── stl/        # экспорт мастер/кожух/штифты/резак
│   └── svg/        # векторные контуры для плоттера/CAD
└── tools/
    ├── generate_a3_templates.py
    ├── verify_v2_outputs.py
    └── requirements-pdf.txt
```

## Важное ограничение точности

Плоский лист нельзя математически без деформации уложить на поверхность с
талией и рельефом: она имеет двойную кривизну. Поэтому PDF содержит два
варианта:

- цельная заготовка с нахлестом - быстрее, но требует сжатия средней зоны;
- четыре индивидуальных сектора - рекомендуемый раскрой с намного меньшей
  деформацией.

Генератор A3 рассчитывает все 11 стилей отдельно для `v60_01` и `v60_02`.
Для асимметричных и спиральных рельефов четыре сектора могут отличаться, их
нужно соединять по номерам 1-2-3-4. Абсолютную посадку определяют также
конкретная глина, влажность, направление прокатки, реальная усадка и масштаб
принтера. Рабочий эталон - пробный цикл с измерением сырой, сухой и
обожженной детали.

V2 автоматически уменьшает только ту амплитуду рельефа, которая мешает
сохранить production-угол съема 5 градусов. Для `dimpled_grid` это видно в
Console и JSON как `release_scale` меньше 1.

## Проверка из терминала

На Apple Silicon установленная 2021.01 может требовать запуск x86_64-среза:

```sh
arch -x86_64 /Applications/OpenSCAD-2021.01.app/Contents/MacOS/OpenSCAD \
  -o /tmp/v60-master.stl \
  -D 'part="master"' \
  -D 'quality_preset="draft"' \
  dripper_mold.scad
```

Генерация раскроя описана в `docs/05_A3_TEMPLATES.md`.