Для разработчиков

Если вы добавляете фичу, чините баг или разворачиваете окружение — это раздел для вас.

Быстрая навигация

Быстрый старт — поднять локальное окружение из пяти сервисов за 10 минут.
API — структура REST-эндпоинтов, OpenAPI, аутентификация.
Деплой — Ansible-плейбук, секреты, порядок ролей.

Архитектура и соглашения вынесены в отдельные разделы:

Архитектура — пять сервисов, потоки данных, подсистема уведомлений.
Соглашения проекта — KSUID, часовые пояса, i18n, базовая модель.
Модель данных — все сущности с полями и связями.

Документация по конкретным сервисам

Каждый сервис содержит подробные служебные инструкции в корне своего репозитория — это первый источник правды по конкретному стеку. Там описаны команды, паттерны и тонкости, специфичные для:

Frontend — Next.js-архитектура, компоненты, тестирование (Vitest, Playwright, Storybook), SDK, i18n.
Backend (Garden) — Django-модули, аутентификация, паттерн services/selectors, структура API.
Telegram-бот — Aiogram-хендлеры, factory-паттерн, интеграция с Chatwoot, строгий MyPy, read-only-доступ к БД.
Supabase — Edge-функции, безопасность вебхуков, email-шаблоны.
Ansible — роли, порядок деплоя, управление секретами, оркестрация Docker.

Дополнительные материалы

Модификация апрель 2026 — ТЗ и system design для последнего крупного релиза. Включает подсистему уведомлений и поимённый учёт человеко-часов.
Sprint plan по garden — пошаговый план реализации.