Общее

Copy page

Biologic System — единая документация backend + frontend

Дата консолидации: 23 февраля 2026.

Этот каталог (docs/) теперь является полным объединённым проектом документации по двум сервисам:

• backend: docs/backend/*
• frontend: docs/frontend/*

Канонический слой интеграции (единый)

Эти файлы фиксируют согласованные правила между сервисами и устраняют расхождения:

• Архитектура системы
• Сущности БД и доменная модель
• Канонический backend API
• Frontend архитектура и модульная карта
• Канонический контракт интеграции
• Журнал расхождений и их закрытие

Полная backend-документация (зеркало)

Полный набор backend-материалов перенесён в docs/backend:

• Backend index
• Архитектура backend
• Модель данных
• API guidelines
• DTO contracts
• ADR index
• Runbook

Подробные сущности БД:

• docs/backend/data-model/entities/*.md

Подробные DTO по сущностям:

• docs/backend/dto-contracts/entities/*.md

Полная frontend-документация (зеркало)

Полный набор frontend-материалов перенесён в docs/frontend:

• Frontend index
• Быстрый старт
• Архитектура frontend
• Auth и permissions
• Роутинг и guards
• API overview
• Контракты модулей
• Текущее состояние проекта

Правило источников истины

1. Детали реализации backend описываются в docs/backend/*.
2. Детали реализации frontend описываются в docs/frontend/*.
3. Межсервисный контракт и согласованные правила фиксируются в корневых unified-файлах (architecture.md, backend-api.md, integration-contract.md).
4. При изменениях в одном сервисе сначала обновляется его профильная документация, затем unified-слой.