первый коммит: инструмент, документ, правила, шаблоны

2026-09-13 00:15:15 +02:00
commit 1971daf8c7
38 changed files with 7752 additions and 0 deletions
@@ -0,0 +1,86 @@
+# 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
+```