Update .gitignore to include local environment files and expand README with project details, tech stack, documentation links, and project status.

docs/README.md

@@ -0,0 +1,28 @@
+# 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.