29 lines
2.4 KiB
Markdown
29 lines
2.4 KiB
Markdown
# PnvPanel — Документация
|
||
|
||
Индекс проектной документации. Читать в этом порядке для погружения:
|
||
|
||
1. **[Product Vision & Scope](vision.md)** — продукт, роли, пользовательские сценарии, границы MVP.
|
||
2. **[Architecture](architecture.md)** — Clean Architecture, слои, CQRS, интеграция с 3x-ui, realtime, безопасность, фоновые задачи.
|
||
3. **[Domain Model](domain-model.md)** — сущности, value objects, связи, инварианты, доменные события.
|
||
4. **[Tech Stack (ADR)](tech-stack.md)** — принятые решения по технологиям и их обоснование.
|
||
5. **[Backend Conventions](backend-conventions.md)** — структура решения, паттерны, соглашения по коду.
|
||
6. **[Frontend](frontend.md)** — стек, структура, работа с API и realtime.
|
||
7. **[Telegram Bot](telegram-bot.md)** — бот: ссылка на сайт, просмотр конфигов, passwordless-вход через привязку Telegram.
|
||
8. **[API Design](api-design.md)** — контракты REST и SignalR.
|
||
9. **[Roadmap](roadmap.md)** — этапы (milestones) и порядок реализации.
|
||
|
||
## Принятые решения
|
||
|
||
Ключевые развилки закрыты (полная таблица — в [tech-stack.md](tech-stack.md#принятые-решения-по-открытым-вопросам)):
|
||
|
||
- **CQRS** — собственный тонкий диспетчер (не MediatR).
|
||
- **Роли** — ровно одна роль на пользователя; квота = `MaxConfigs` роли.
|
||
- **Секреты нод** — ASP.NET Core Data Protection (шифрование at-rest).
|
||
- **Тарифы `Plan`** — backlog (в MVP конфиги без лимитов трафика/срока).
|
||
- **i18n** — RU + EN с первого дня (react-i18next).
|
||
- **Telegram** — long polling; только привязка аккаунта (signup из бота — backlog).
|
||
- **История трафика** — простая таблица + TTL-чистка.
|
||
- **Логирование** — Serilog.
|
||
|
||
Остаточные мелочи (не блокируют старт): значение TTL истории трафика, прод-синки Serilog, TTL токенов Telegram.
|