bablo / стройплощадка
← Все сессии
Дата: 2026-05-19
Часов: 1
Кто: roman

Ревизия документов — Phase 0 / Эпик F4

Аудит документации на полноту и согласованность + применение решений. Выполнено Claude Code под надзором Романа.

Что сделано

Аудит

Прочитаны и сверены между собой: Vision, Roadmap, PRD (784 стр.), Tech Stack, brief, оба research-документа, CLAUDE.md, инфраструктура. Найдены 3 противоречия (A1-A3) и 5 мелких дрифтов (B1-B5).

Применённые решения

  • A1: transparency/ мигрирован на Tailwind 4 (CSS-first: @theme в src/styles/global.css, @tailwindcss/vite вместо @astrojs/tailwind, удалён tailwind.config.mjs). Сборка и контейнер проверены.
  • A2: создан docs/plaid/05-DESIGN.md — единый источник правды по визуальному языку. Ссылки в PRD §7 и Roadmap P1 переведены на него.
  • A3: docker-compose.yml перенесён в корень /opt/bablo/ (совпадает с CLAUDE.md/TECH-STACK, убран костыль --project-directory).
  • B1: Roadmap — имя репозитория roman-bablo → bablo (ADR 0002).
  • B2: создан infra/scripts/restore.sh (был обещан в TECH-STACK).
  • B3: PRD §6 — примечание о зависимости имени бота от вопроса Q1.
  • B4: PRD §2 — примечание, что DDL иллюстративен (схема через Drizzle).
  • B5: консоль MinIO переведена на зарезервированный порт 9002, сверена VPS-карта.

Решения

  • Tailwind зафиксирован на 4.x (выбор владельца) — единообразие с будущим app/; миграция выполнена сразу, пока сайт небольшой.
  • Дизайн-токены вынесены в отдельный PLAID-документ 05-DESIGN.md (а не в Vision) — чище структура, явная ссылка из PRD/Roadmap.
  • docker-compose.yml в корне — устранил баг сборки и расхождение документации с реальностью.

Открытые вопросы

  • Деплой Стройплощадки наружу (#10) ждёт решения Q3 (домен).
  • Визуальная проверка скриншотами по-прежнему недоступна (sandbox среды); рендер проверен на уровне собранного/задеплоенного HTML.

Что дальше

  • F3 — финансовая прозрачность: автогенерация hours-записей в expenses.yaml из frontmatter work-logs, шаблон work-log, проверка графика на реальных данных.
  • #10 — Proxy Host в NPM после решения по домену (Q3).

Расход часов

1 час надзора Романа = 4 200 ₽ (ставка 4 200 ₽/час, на 30% ниже среднерыночной 6 000 ₽/час). Запись в expenses.yaml — EXP-2026-05-19-004.