Архитектура
TL;DR
Размах — модульный монолит (P2) для российских маркетплейсов с multi-tenant изоляцией через PostgreSQL Row-Level Security. Phase 1 — кабинет одного селлера, Phase 1.5 — invite-only для близких партнёров, Phase 3 — SaaS.
Деталь по полному стеку и принципам — в репозиторном файле
ARCHITECTURE.md
и в research/
(76 research docs).
Стек
| Слой | Технология | Версия | Почему |
|---|---|---|---|
| Язык backend | Python | 3.13 | Async support, modern typing |
| Web framework | FastAPI | 0.115+ | Pydantic, OpenAPI 3.1 auto, asyncio native |
| ORM | SQLAlchemy 2 | async | Mature, type-safe, async |
| DB driver | asyncpg | 0.31 | Самый быстрый async PG driver |
| База | PostgreSQL | 18 | UUID v7 native, RLS, pgvector |
| LLM orchestration | Pydantic AI + LlamaIndex | latest | Type-safe, retriever-first |
| Frontend | Next.js | 16.2.x | App Router, RSC, mature |
| UI | React 19 + Tailwind 4 + shadcn/ui | latest | Type-safe, copy-source primitives |
| Icons | Phosphor | 2.x | Anti-AI design (НЕ Lucide) |
| Deploy | Docker Compose + Caddy 2 | latest | Single host v1, простой rollback |
| CI/CD | GitHub Actions | — | Уже в проекте Netnik |
| Observability | Loki + Prometheus + GlitchTip + PostHog | self-host | Sanctions-safe, owned |
| Docs | Astro Starlight + Pagefind | 5.x | Pagefind sanctions-safe (vs Algolia) |
| Secrets | Infisical (self-host) | 0.x | Раздельная razmakh-vps install |
Главные архитектурные решения
БД и RLS PostgreSQL 18, UUID v7, schemas (raw/core/mart/ops), Row-Level Security с organization_id scope (P15)
Секреты Infisical self-hosted, secret_ref:// URI format, cache + retry, P15 RBAC scope в Phase 1.5
Phase plan
- Phase 0 Research (77 research docs) — почти закрыта.
- Phase 1 Foundation F-01…F-17 — текущая. F-13 (этот сайт) — current.
- Phase 1.5 Close-partners — multi-org, RBAC, invite flow.
- Phase 2 Extended (Ozon, ЯМ, advertising) — TBD.
- Phase 3 SaaS — open signup, pricing, billing.
Детально → ROADMAP.md.