GET /api/projects/:id/export/design-doc — Экспорт дизайн-дока
Как открыть: откройте проект → вкладка «Doc» (▧) → в верхней панели документа нажмите «Скачать документ .md». Файл сохранится на диск.
Собирает весь дизайн-док в один Markdown-файл. Документ строится по разделам (обзор, требования, подход, реализация, данные, инфраструктура) и в порядке зависимостей блоков. Где у блока есть написанный текст — попадает он; где текста ещё нет — раздел заполняется заготовкой-чек-листом из артефактов блока, чтобы документ не зиял пустотами.
Можно выгрузить документ с учётом выбранных специальностей — тогда в файл попадут только их задачи (то же, что фильтр в панели документа). В шапке файла указываются формулировка задачи проекта, дата, а при фильтре — список ролей. Скачать документ может любой, у кого есть доступ к проекту; гость — только свой. Точные правила — RP-117.
Связанные
- Экраны: Design Doc
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | GET /api/projects/:id/export/design-doc |
| Auth | optionalAuth, requireProjectAccess — гость + авторизованный, доступ к проекту (read/write) |
| Scope токена | read |
| PG-функции | api.get_design_doc_data |
| Таблицы | project, project_node, content_item, space_layer, project_node_role |
| SRM | SRM-028, SRM-029, SRM-030, SRM-031 |
| RP (права) | RP-040, RP-041, RP-047, RP-048, RP-117 |
| Файл роута | server/routes/projects.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
format | query | подтвердить | |
role | query | подтвердить | |
roles | query | подтвердить |
Коды ответов/ошибок (из хендлера): 404, 500 (+ 200) — уточнить причины вручную