Архитектура — обзор
Что в этом разделе
Архитектурные решения, описанные на уровне “что делает” и “почему так”.
Полные ADR с альтернативами хранятся в netnik-state/decisions/
(см. ниже).
| База данных | PostgreSQL 18, UUID v7, RLS по organization_id, схемы raw/core/mart/ops |
| Секреты | Infisical self-hosted, secret_ref URI, кэш + ретраи, RBAC |
Architectural Decision Records
ADR живут в netnik-state репозитории — это git-backed журнал решений
Netnik проекта в целом (Размах — один из проектов). Текущий список
razmakh ADR:
| # | Решение | Дата |
|---|---|---|
| 1 | Имя проекта — “Размах” | 2026-05-16 |
| 2 | Stack: Python + FastAPI + Next.js | 2026-05-17 |
| 3 | Frontend stack — Next.js 16.2 | 2026-05-17 |
| 4 | PostgreSQL 18 как единая БД | 2026-05-17 |
| 5 | RLS scope = organization_id | 2026-05-17 |
| 6 | Secrets backend = Infisical | 2026-05-17 |
| 7 | Docs platform = Astro Starlight | 2026-05-17 |
| 8 | razmakh-vps deployment isolation | 2026-05-17 |
Полный список — в netnik-state/decisions/razmakh-*.md (доступ для команды).
Где смотреть глубже
- Research (77 docs):
research/— детальные исследования по каждой архитектурной теме (база, секреты, observability, design, multi-tenancy и т.д.) - Lessons:
lessons/— что узнали в процессе реализации. - Plans:
plan/active/— поэтапные чек-листы Foundation + Blocks.