Leonid Pershin
8b92204733
- Updated various API endpoints to include response type annotations using .Produces<T>() for better documentation and type safety. - Enhanced activation, admin, user, config, and other endpoints to specify response types, improving clarity for frontend integration. - Added new DTOs for structured responses in authentication and Telegram-related endpoints. - Improved overall API schema generation to reflect these changes, ensuring consistency between backend and frontend types.
PnvPanel — Документация
Индекс проектной документации. Читать в этом порядке для погружения:
- Product Vision & Scope — продукт, роли, пользовательские сценарии, границы MVP.
- Architecture — Clean Architecture, слои, CQRS, интеграция с 3x-ui, realtime, безопасность, фоновые задачи.
- Domain Model — сущности, value objects, связи, инварианты, доменные события.
- Tech Stack (ADR) — принятые решения по технологиям и их обоснование.
- Backend Conventions — структура решения, паттерны, соглашения по коду.
- Frontend — стек, структура, работа с API и realtime.
- Telegram Bot — бот: ссылка на сайт, просмотр конфигов, passwordless-вход через привязку Telegram.
- API Design — контракты REST и SignalR.
- Roadmap — этапы (milestones) и порядок реализации.
Принятые решения
Ключевые развилки закрыты (полная таблица — в 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.