HSE/tgit
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: ТЗ, архитектура и бэклог проекта #2

New Issue
Closed
opened 2026-10-12 19:32:05 +03:00 by Eleboba · 0 comments
Eleboba commented 2026-10-12 19:32:05 +03:00
Owner
Copy Link
Copy Source

Описание

Официального ТЗ от преподавателя пока нет. Расписываем ТЗ по исходной постановке (переписка 2026-10-12) и согласованным расширениям: статус CI, алерты о падении/перегрузке, логи, LLM-ассистент по логам. Оформление — как в Vobot/meditron + «Требования к оформлению решений» (README с разделами, структура каталогов, Docker, демо-данные, презентация).

Желаемый результат

  • docs/SPEC.md — ТЗ: роли, функциональные/нефункциональные требования, сценарии, критерии приёмки.
  • docs/ARCHITECTURE.md — компоненты, потоки данных, модель данных, CI/CD, деплой, безопасность.
  • docs/DECISIONS.md — ADR по ключевым развилкам.
  • docs/QUESTIONS_IDEAS.md — обновлённые открытые вопросы.
  • Бэклог issues по вехам M1–M4.

Подзадачи

  • Разведка: SourceCraft API/CI/registry, сервер vobot, шаблон деплоя meditron
  • SPEC.md
  • ARCHITECTURE.md
  • ADR
  • Бэклог issues + вехи

Как проверить

Прочитать SPEC и ARCHITECTURE: по ним можно взять любую задачу бэклога без дополнительных вопросов.

Лог выполнения

2026-10-12

  • SourceCraft: registry есть (pkg.sourcecraft.tech), но требует платёжный аккаунт Yandex Cloud → по умолчанию собираем образы на хосте. Исходящих webhooks нет; API отдаёт CI-прогоны, статусы и логи кубов → polling. API коммита файлов нет → пуш по git+SSH.
  • Сервер vobot (72.56.247.166): 4 vCPU, 7.8 ГБ RAM (~1.9 ГБ свободно), диск 75%; nginx на 80/443, рядом vobot dev/prod и meditron (/srv/ptsr, пользователь ptsr-deploy).
  • Написаны SPEC v1 (F-1…F-62, НФТ, сценарии, критерии приёмки), ARCHITECTURE (компоненты, потоки, песочница, CI/CD, деплой, риски), ADR-002…009.
  • Оформление: структура и README-разделы по «Требованиям к оформлению решений» (meditron), процесс — как в Vobot.
  • Бэклог: вехи M1–M4, issues #3–#21 с метками, вехами и связями blocked_by.
  • Нюансы API (milestone_id, ключи списков, base64 секретов) — в шпаргалку.

Перенесено из SourceCraft: https://sourcecraft.dev/rogachevegorushka/tgit/issues/2

## Описание Официального ТЗ от преподавателя пока нет. Расписываем ТЗ по исходной постановке (переписка 2026-10-12) и согласованным расширениям: статус CI, алерты о падении/перегрузке, логи, LLM-ассистент по логам. Оформление — как в Vobot/meditron + «Требования к оформлению решений» (README с разделами, структура каталогов, Docker, демо-данные, презентация). ## Желаемый результат - `docs/SPEC.md` — ТЗ: роли, функциональные/нефункциональные требования, сценарии, критерии приёмки. - `docs/ARCHITECTURE.md` — компоненты, потоки данных, модель данных, CI/CD, деплой, безопасность. - `docs/DECISIONS.md` — ADR по ключевым развилкам. - `docs/QUESTIONS_IDEAS.md` — обновлённые открытые вопросы. - Бэклог issues по вехам M1–M4. ## Подзадачи - [x] Разведка: SourceCraft API/CI/registry, сервер vobot, шаблон деплоя meditron - [x] SPEC.md - [x] ARCHITECTURE.md - [x] ADR - [x] Бэклог issues + вехи ## Как проверить Прочитать SPEC и ARCHITECTURE: по ним можно взять любую задачу бэклога без дополнительных вопросов. --- ## Лог выполнения ### 2026-10-12 - SourceCraft: registry есть (`pkg.sourcecraft.tech`), но требует платёжный аккаунт Yandex Cloud → по умолчанию собираем образы на хосте. Исходящих webhooks нет; API отдаёт CI-прогоны, статусы и логи кубов → polling. API коммита файлов нет → пуш по git+SSH. - Сервер vobot (72.56.247.166): 4 vCPU, 7.8 ГБ RAM (~1.9 ГБ свободно), диск 75%; nginx на 80/443, рядом vobot dev/prod и meditron (`/srv/ptsr`, пользователь `ptsr-deploy`). - Написаны SPEC v1 (F-1…F-62, НФТ, сценарии, критерии приёмки), ARCHITECTURE (компоненты, потоки, песочница, CI/CD, деплой, риски), ADR-002…009. - Оформление: структура и README-разделы по «Требованиям к оформлению решений» (meditron), процесс — как в Vobot. - Бэклог: вехи M1–M4, issues #3–#21 с метками, вехами и связями blocked_by. - Нюансы API (milestone_id, ключи списков, base64 секретов) — в шпаргалку. > Перенесено из SourceCraft: https://sourcecraft.dev/rogachevegorushka/tgit/issues/2
Eleboba added the docssize/1 labels 2026-10-12 19:32:05 +03:00
Eleboba self-assigned this 2026-10-12 19:32:05 +03:00
Eleboba added a new dependency 2026-10-12 19:45:49 +03:00
#21 docs: guardrails в CLAUDE.md
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bot
Зона: код бота (app/)
 ci
Зона: CI
 docs
Зона: документация
 feature
Тип: новая функциональность
 fix
Тип: исправление
 infra
Зона: Docker, деплой, хост
 llm
Зона: LLM-ассистент
 refactor
Тип: рефакторинг
 size/0.5
≈ 2 ч
 size/1
≈ 4 ч
 size/2
≈ 1 день
No labels docs size/1
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
Eleboba
No Assignees Eleboba
1 Participants
Notifications
Due Date
No due date set.
Blocks
#21 docs: guardrails в CLAUDE.md
HSE/tgit
Reference: HSE/tgit#2