Решения проекта

Здесь хранятся только существенные решения: архитектура, инструменты, структура, риск, компромисс или изменение политики.

Имена файлов

0001-краткое-название.md
0002-следующее-решение.md

Номер не переиспользуется. Изменённое решение не удаляется: создаётся новое, а старое получает статус Заменено со ссылкой.

Индекс

• 0001 — Правила и структура проекта SKUARO — принято 2026-08-18; продуктовая граница заменена решением 0033.
• 0002 — Внешняя папка секретов — принято 2026-08-18.
• 0003 — UI-система и frontend-прототип «Сегодня» — принято 2026-08-18.
• 0004 — Целевая архитектура и технологический стек — принято 2026-08-21.
• 0005 — Доменная модель, доступ и данные — принято 2026-08-21; пункт о закрытой регистрации заменён решением 0009.
• 0006 — Среды, домены, инфраструктура и релизы — принято 2026-08-21; Basic Auth заменён решением 0030, доменная схема заменена решением 0019.
• 0007 — Репозитории и документация — принято 2026-08-21; VitePress заменён решением 0015, test-домены документации уточнены решением 0019.
• 0008 — Валидационный шлюз и порядок реализации — принято 2026-08-21; результат ПОДТВЕРЖДЕНО объявлен владельцем.
• 0009 — Открытая регистрация и подтверждение email — принято 2026-08-21; момент создания tenant-контекста заменён решением 0024.
• 0010 — Ролевая модель и платформенное администрирование — принято 2026-08-21; состав ролей дополняется.
• 0011 — Административный dashboard и ручная активация — принято 2026-08-21; post-verification onboarding уточнён решением 0024.
• 0012 — Продуктовые модули, доступ и тарифные пакеты — принято 2026-08-21; структура кода дополнена решением 0014, состав модулей и тарифов дополняется.
• 0013 — Auth PoC и Gmail для DEV — принято для PoC и DEV 2026-08-21; Gmail SMTP сохранён как fallback, основной DEV transport уточнён решением 0025.
• 0014 — Структура продуктовых модулей в монорепозитории — принято 2026-08-22; закрепляет обязательную классификацию новой разработки.
• 0015 — Material for MkDocs и среда developer docs — принято 2026-08-22; заменяет выбор VitePress в решении 0007, имя developer-docs домена заменено решением 0019, Basic Auth заменён решением 0030.
• 0016 — Доступ к DEV и защита маршрутов — принято 2026-08-22; Basic Auth policy заменена решением 0030, SKUARO Auth остаётся действующей.
• 0017 — Первичная учётная запись SuperAdmin — принято 2026-08-22; одноразовая инициализация пустого DEV-контура.
• 0018 — Главный экран и единый каркас приложения — принято 2026-08-23; отделяет /home, общий AppShell, модуль today и настройки аккаунта/организации.
• 0019 — Домены и состав STAGE — принято 2026-08-23; сохраняет production на .com, разделяет Site/App/Docs в STAGE и отменяет обязательную очистку STAGE от служебных файлов; promotion дополнен решением 0020.
• 0020 — Автоматическое продвижение и тесты STAGE — принято 2026-08-23; строгий процесс сохранён для отдельной проверки/PROD и заменён решением 0032 для обычных итераций.
• 0021 — Общая память агентов и самоулучшение Skills — принято 2026-08-23; вводит общую Git-версионируемую память опыта и управляемое обновление Skills без дублирования и расширения permissions.
• 0022 — Доказательное завершение и handoff задач — принято 2026-08-23; применяется только в отдельном verification/production-контуре по решению 0032.
• 0023 — Профили и маршрутизация AI-агентов — принято 2026-08-23; создаёт шесть project-scoped профилей, ограничивает параллельность и разделяет executor/verifier/orchestrator.
• 0024 — Onboarding организации после подтверждения email — принято 2026-08-24; отделяет подтверждение email от атомарного создания tenant-контекста через /onboarding/organization.
• 0025 — Resend HTTPS API для DEV email — принято для локальной реализации и последующего DEV PoC 2026-08-25; сохраняет Gmail fallback и не выбирает production-провайдера.
• 0026 — Единая защита Auth-токенов в runtime-логах — принято 2026-08-25; закрепляет общий security contract Product App для DEV, STAGE и PROD.
• 0027 — Внешний UI/UX-агент и reference workspace — принято 2026-08-26; закрепляет одну текущую MD-задачу, управляемый проектный контекст, results/memory и отдельную внутреннюю Product implementation; pre-site source уточнён решением 0028.
• 0028 — Первая UI-reference задача до developer-сайта — принято 2026-08-26; разрешает READY по явно перечисленному снимку product-репозитория, пока dev-doc.skuaro.top не опубликован.
• 0029 — Control Surface и новая UI-система Product App — принято 2026-08-26; заменяет прежние visual tokens, rail и mobile-navigation composition, сохраняя routes, AppShell zones, permissions и Product contracts.
• 0030 — Basic Auth только по прямому запросу владельца — принято 2026-08-26; отменяет Basic Auth по умолчанию для всех origins и сохраняет SKUARO Auth защищённых Product-маршрутов.
• 0031 — Автоматическая приёмка UI-reference — принято 2026-08-26; внешний result принимается как точный visual reference без повторного UI-аудита.
• 0032 — Быстрая разработка через live STAGE — принято 2026-08-26; обычная итерация сразу размещается на STAGE, а строгая проверка запускается отдельно.
• 0033 — Открытая функциональная граница SKUARO — принято 2026-08-26; снимает запрет на CRM и любые другие необходимые продукту функции.
• 0034 — Production-like STAGE без тестовых ограничений — принято 2026-08-26; сохраняет открытую регистрацию и штатный Product-flow без test-only accounts, bypass или mocks.
• 0035 — Отдельный production-readiness контур — принято 2026-08-26; вводит отдельную команду, профиль, audit/repair loop и независимый GO/NO-GO без автоматического PROD deploy.
• 0031 — Автоматическая приёмка UI-reference — принято 2026-08-26; весь завершённый visual result UI/UX-агента принимается как точный reference без отдельного UI-аудита, а Product contracts и runtime остаются ответственностью внутренней команды.