# RECADA / Airholder

Параметрическая система проектирования автобагажников: истина — параметры и код,
геометрия — артефакт. Реверс листовых деталей, приёмка по трём критериям,
пакет производства для поставщика. Всё headless, на своём сервере в Германии.

**Рабочая папка:** `C:\CAD COWORK`

## Структура

```
docs/          документ проекта (RU/DE), резюме, архив ревизий
tool/          recada.py — инструмент реверса, документация, код для FreeCAD
parts/         детали: STEP, паспорта обмера, генераторы, spec.yaml
vehicles/      паспорта машин: точки крепления, зоны, ссылки на Aufbaurichtlinien
accessories/   каталог аксессуаров и интерфейсы крепления
library/       библиотека для регрессии: детали + ответы портала
rules/         dfm_blechcon.json, materials.json, тарифы, правила валидатора
ci/            пайплайны сборки и регрессии
```

## Первая установка (один раз)

**cmd:**
```
cd /d "C:\CAD COWORK\tool"
python -m venv .venv
.venv\Scripts\pip install cadquery-ocp build123d networkx numpy scipy streamlit ezdxf pandas
```

**PowerShell:**
```powershell
cd "C:\CAD COWORK\tool"
python -m venv .venv
.\.venv\Scripts\pip install cadquery-ocp build123d networkx numpy scipy streamlit ezdxf pandas
```

## Запуск

**cmd:** `"C:\CAD COWORK\go.bat"`
**PowerShell:** `& "C:\CAD COWORK\go.ps1"`

Скрипты переносят свежий `recada.py` из Downloads (если он там есть) и запускают
интерфейс на `http://localhost:8501`.

Подробности — `tool/УСТАНОВКА.md` и `tool/ЗАПУСК.md`.

## Три критерия приёмки

| Критерий | Чем проверяется | Что ловит |
|---|---|---|
| Метрология | point-sampling двусторонний, до поверхности, порог 99.9 % в 0.05 мм | точность геометрии |
| Целостность | свободных рёбер = 0, солидов ≥ 1 | дыры, незамкнутость |
| Производство | загрузка на портал поставщика | распознавание как листовой детали |

Далее: посадка по скану, входной контроль поставки, поле.

## Правила проекта

1. Правится только истина (params.json, генераторы, паспорта, rules, спеки).
   Всё остальное пересобирается — артефакт руками не трогают.
2. Файл без SKU и ревизии в имени не покидает сервер.
3. При расхождении версий права та, что выше в трубе истины.
4. Версия ядра OCCT фиксирована (7.9.3) и записана в project.json;
   переход — только после прогона регрессии по библиотеке.
5. BREP внутри процесса, STEP на любой границе; STEP пишется с именами через XCAF.
6. Инструмент входит в стек, только если open source или бесплатен без подписки.

## Документ

- `docs/RECADA_проект_полное_описание_v59.pdf` — полная версия, 85 стр., сквозная нумерация 1–44
- `docs/RECADA_проект_полное_описание_v59.md` — то же в Markdown: истина документа, для правок и диффов
- `docs/RECADA_Projektbeschreibung_v50_DE_komplett.pdf` — немецкая версия, 55 стр.
- `docs/RECADA_Резюме_RU_v50.pdf`, `docs/RECADA_Zusammenfassung_DE_v50.pdf` — резюме для внешних

## Git (когда поднимется сервер)

```
cd /d "C:\CAD COWORK"
git init
git lfs install
git add .
git commit -m "первый коммит: инструмент, документ, правила, шаблоны"
git remote add origin git@<сервер>:recada/project.git
git push -u origin main
```