70ba5e9db8
- model/entities-v5.14.md: таблица «Что изменилось в v5.14», related_group_member (ГСК и ГСЗ одновременно), audit_event - context/04: файлы и partial unique (legal_entity_id, kind) v5.14, OQ-31/32 закрыты - ссылки на v5.14: 00, 03, 05, KICKOFF-PROMPT, dev/checks.md, openspec/config.yaml, repo-templates/arm-core.CLAUDE.md - 09: Срез 1 по факту (вариант Б), перенос UI справочника; 10: статус экранов справочника и /admin - 08: выгрузка ЕЦП; 06: §6.1 фикстура directories/ecp-export-russkiy-biskvit.xlsx - 05 §13: сверка с ImportCode (добавлен GSZ_CREATED, перечень 16 кодов), порядок проверок, уточнения реализации, лимиты файла, ошибки файла, след в аудите и S3 - tasks.md: 2.1–2.3, 3.1 выполнены Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vJkmBGKKqMoEMzvsXG3y2
74 lines
7.6 KiB
Markdown
74 lines
7.6 KiB
Markdown
# KICKOFF-PROMPT — первое сообщение агенту в workspace
|
||
|
||
Запускать `claude` из корня workspace (`~/work/arm-ka/`), когда выполнен чек-лист в конце файла.
|
||
|
||
---
|
||
|
||
Ты начинаешь разработку АРМ КА с нуля в workspace из нескольких git-репозиториев (`docs/`, `fixtures/`, `arm-core/`,
|
||
`tabular-parser/`, `scan-gateway/`). Прочитай в таком порядке и **не пиши код, пока не закончишь**:
|
||
|
||
1. `CLAUDE.md` (workspace) и `docs/context/00-workspace-layout.md` — как устроена рабочая область, статус аналитики, макет.
|
||
2. `docs/context/01-project-overview.md`, `02-glossary.md` — предметная область.
|
||
3. `docs/context/03-architecture.md`, `04-data-model-guide.md`, затем **весь** `docs/model/data-model-v5.14.dbml` и
|
||
`docs/model/entities-v5.14.md`.
|
||
4. `docs/context/05-domain-rules.md` — алгоритмы (особенно §1.0 и §12 — парсеры ищут структуру по содержимому);
|
||
`06-test-data.md`; `07-open-questions.md`; `10-user-journey.md`; `09-delivery-plan.md`.
|
||
5. `arm-core/`, `tabular-parser/`, `scan-gateway/` — три репозитория, развёрнутые из нулевого коммита шаблона команды,
|
||
и их `CLAUDE.md`. Выясни соглашения шаблона: структура, DI, ORM/миграции, тесты, линтеры, сборка, фронт.
|
||
6. `docs/mockup/INDEX.md` — индекс макета. HTML-файлы макета **не читай подряд**; открывай один экран, только когда
|
||
он нужен для задачи.
|
||
|
||
Затем сделай четыре вещи и остановись для ревью:
|
||
|
||
**A. Дополни `docs/context/03-architecture.md`** разделом «Соглашения шаблона» и заполни секции «Соглашения шаблона» в
|
||
`CLAUDE.md` каждого из трёх репозиториев. Не переделывай шаблон под документ — наоборот. Зафиксируй, что вырезано из
|
||
шаблона в `tabular-parser` и `scan-gateway` (фронт, лишние таргеты).
|
||
|
||
**B. Сверь docs/context/10-user-journey.md и docs/mockup/INDEX.md со снимками docs/mockup/screens/ — дополни пропуски из раздела «Что осталось уточнить», расхождения с DBML/правилами занеси в 07-open-questions.md. HTML макета не читай как текст; при необходимости рендерь scripts/mockup_crawl.py.
|
||
|
||
**C. Напиши OpenSpec proposal для Среза 0** — три change, по одному в каждом сервисном репозитории
|
||
(`openspec/changes/slice-0-skeleton/`), и один в `docs/` для сквозного: `docker-compose` workspace-уровня (PostgreSQL,
|
||
NATS, MinIO, эмулятор ИС Сканирование), контракт `recognition-result.schema.json` v1.0, CI-шаблон. В `arm-core`:
|
||
миграция 0001 по DBML целиком, seed справочников/ролей/прав, auth с dev-эмитентом JWT, `check_dbml_vs_orm.py`.
|
||
В `tasks.md` — задачи ≤ половины дня, в порядке зависимостей, с указанием репозитория.
|
||
|
||
**D. Составь список вопросов ко мне** — только те, без которых нельзя начать Срез 0 (версии Python/Node в шаблоне,
|
||
секреты, реестр образов, доступ к `arm-ka-fixtures` из CI). Вопросы по предметной области не задавай — они в
|
||
`07-open-questions.md`; если нужен ответ для среза — делай допущение по правилам из этого файла.
|
||
|
||
Ограничения на всё время работы:
|
||
- имена таблиц, колонок и enum'ов — ровно как в DBML v5.14; поля, которых нет в DBML, не изобретать;
|
||
- алгоритмы — только из `05-domain-rules.md`; из страниц ТЗ напрямую не кодировать;
|
||
- парсеры: никаких координат ячеек, букв колонок, имён листов и номеров строк в коде — структура по содержимому,
|
||
синонимы в `rules/*.yaml`; фикстуры — регрессия, не спецификация;
|
||
- деньги — `Decimal`/`numeric(18,2)`;
|
||
- всё, что в DBML помечено «не хранится / вычисляется», — чистые функции в `domain/`;
|
||
- любое изменение модели — через новую версию DBML с changelog и миграцию;
|
||
- один OpenSpec change и один PR — на один репозиторий; `git -C <repo>`; никаких коммитов в `main`;
|
||
- общение, коммиты, комментарии, документация — по-русски; идентификаторы — по-английски.
|
||
|
||
Когда Срез 0 принят: Срез 1 (справочники, `arm-core`), затем Срез 2 (`tabular-parser` + маппинг в `arm-core`) — его
|
||
начинай с property-тестов на `fixtures/osv/**` и `fixtures/statements-xlsx/**`, потом парсер.
|
||
|
||
---
|
||
|
||
## Подготовка workspace перед kickoff (чек-лист для пользователя)
|
||
|
||
Репозитории в Gitea: `arm-ka-docs`, `arm-ka-fixtures` (ограниченный доступ), `arm-core`, `arm-tabular-parser`,
|
||
`arm-scan-gateway`; `main` защищён везде.
|
||
|
||
- [ ] `mkdir ~/work/arm-ka && cd ~/work/arm-ka` — workspace, **не** `git init`
|
||
- [ ] `docs/`: клонировать `arm-ka-docs`, положить содержимое пакета `docs/` + `docs/source/tz/` (22 md + `_tree.json` +
|
||
`_export.md` с датой экспорта) + `docs/source/biq/` (3 docx → pandoc md) + `docs/mockup/dkb_24.09.26/`;
|
||
`python ../scripts/mockup_index.py docs/mockup/dkb_24.09.26 > docs/mockup/INDEX.md`
|
||
- [ ] `CLAUDE.md` пакета — в корень workspace (не в docs); `scripts/` — в `docs/scripts/` или корень workspace
|
||
- [ ] `fixtures/`: клонировать `arm-ka-fixtures`, разложить файлы по `06-test-data.md` §6 (`scripts/sort_osv_fixtures.py`
|
||
из инструкции), добавить `statements-xlsx/` (попросить у аналитиков ББ/ОФР в Excel; пока — лист «Отчетность» из
|
||
`Анализ *.xlsx` и рекомендуемые формы)
|
||
- [ ] `arm-core/`, `tabular-parser/`, `scan-gateway/`: из нулевого коммита шаблона (`00-workspace-layout.md`), в каждый —
|
||
`CLAUDE.md` из `docs/repo-templates/`, пустой `openspec/` (`openspec init`), codegraph-индекс
|
||
- [ ] `.claude/settings.json` workspace: хуки guard-main (по репозиторию файла), require-plan, cc-status; разрешения на
|
||
`git -C`
|
||
- [ ] `tea login`; метки `slice-0 … slice-8` в каждом сервисном репозитории
|
||
- [ ] первый коммит в каждом репозитории — «шаблон/контекст как есть», в ветке, PR, merge — единственный раз без плана
|