arm-ka-docs/openspec/config.yaml
Andrey Epifancev a0be5ab5a1 docs: Срез 0 под факты платформы — NATS без JetStream, Python 3.11, PostgreSQL 16, без CI и Nexus
По ответам пользователя 03.10.2026: обмен через recognition_job перестроен на core NATS (queue group'ы,
ack сервиса = конверт status=processing, повторная публикация ядром 30 с × 3 → dlq, дедуп по result_msg_id);
capability ci-template заменена на quality-checks (make check / make check-full, конфигураций CI нет);
compose: PostgreSQL 16, NATS без --jetstream, python:3.11-slim; пакеты raisa_* фильтруются при dev-установке,
npm raisa-* → optionalDependencies. Обновлены 03-architecture, 09-delivery-plan, 00-workspace-layout,
proposal/design/specs/tasks change'а; открытые вопросы к платформе закрыты, остались Node и JWT РАИСА.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-03 16:21:39 +04:00

36 lines
3.3 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

schema: spec-driven
context: |
Репозиторий arm-ka-docs — контекст, модель данных (DBML v5.13), правила домена, контракты между сервисами
(docs/contracts/*.schema.json), макет UI и экспорт ТЗ системы АРМ КА (ДКБ, Россельхозбанк).
Здесь оформляются СКВОЗНЫЕ изменения: контракт + окружение разработки (docs/dev) + проверки качества (make check) + изменения
документов контекста. Код сервисов живёт в соседних репозиториях (../arm-core, ../tabular-parser, ../scan-gateway),
у каждого свой openspec/ и свой change; сквозной change ссылается на них.
Источники истины по приоритету: docs/model/data-model-v5.13.dbml → docs/model/entities-v5.13.md →
docs/context/05-domain-rules.md → docs/source/tz (черновик, имена v4). Открытые вопросы — docs/context/07-open-questions.md;
план срезов — docs/context/09-delivery-plan.md; соглашения шаблона команды — docs/context/03-architecture.md.
Язык документов и коммитов — русский, идентификаторы — английские, как в DBML. docs/source/** не редактируется.
rules:
proposal:
- Указывать номер среза из 09-delivery-plan.md и перечислять дочерние change'и в сервисных репозиториях
- "Изменение контракта = новая schema_version; перечислять сервисы, которые его читают и пишут"
- Раздел «Non-goals» обязателен
- Любое допущение по открытому вопросу помечать ASSUMPTION(OQ-nn)
specs:
- "Требования к контракту — через JSON Schema и примеры из ../fixtures; требования к окружению — через наблюдаемое поведение (сервис стартует, бакет существует, сообщение доставлено)"
design:
- "Раздел «Decisions made without discussion» обязателен: дата, решение, обоснование, цена ошибки"
tasks:
- Задачи не больше половины дня, с указанием репозитория и файлов, в порядке зависимостей между репозиториями
- Последняя задача — обновление документов контекста (03-architecture, 07-open-questions, 09-delivery-plan)
operations:
apply:
guidance:
- Работать в ветке (worktree); git -C <repo>; один PR на репозиторий; в описании PR указывать связанные PR
- Файлы docs/source/** не трогать
archive:
guidance:
- "Перед архивированием: дочерние change'и сервисов заархивированы или явно перенесены в следующий срез"