Fin — Fullstack Boilerplate

• Что это: стартовый скаффолд (boilerplate) для fullstack-приложений, а не готовый продукт. В README он прямо назван «Production-ready fullstack TypeScript monorepo boilerplate». Содержит рабочую аутентификацию (Better Auth + RBAC + Redis-сессии), пример сущности (CRUD по posts) и инфраструктурные пакеты для переиспользования. Название «fin», вероятно, плейсхолдер под будущий финансовый продукт, но в коде это дженерик-boilerplate.
• Тип / статус / роль: library/boilerplate · prototype (ранняя стадия, ~неделя) · lead — пользователь основной автор (~16 коммит-единиц по shortlog --all), со-разработчик Bobur (11).
• Период активности: 2026-01-24 → 2026-01-29 (~5 дней интенсивной сборки, 10 коммитов в основной ветке).

• Языки: TypeScript (strict, пакет typescript-config).
• Монорепозиторий: Turborepo + Bun workspaces (apps/*, packages/*), bun@1.3.2.
• Приложения: api — Elysia.js на Bun (порт 3001, версионированные модули /src/modules/v1, Better Auth на /api/auth/*, Swagger, CORS на портах 3000-3004); admin — админка на Next.js (порт 3003).
• Пакеты (10):
• @workspace/auth — Better Auth + server/client, Redis-кэш сессий, Postgres через Drizzle.
• @workspace/db — Drizzle ORM + Postgres (схема Better Auth: user/session/account/verification, db:generate/migrate/push/studio).
• @workspace/cache — обёртка над ioredis.
• @workspace/email — Resend (транзакционные письма).
• @workspace/ui — полный shadcn/ui (Radix) + CVA, общий для всех фронтендов.
• @workspace/entities — фабрика клиента Eden Treaty (createApiClient) + Zod-схемы + хуки React Query (пример: usePosts/usePost).
• @workspace/cli — интерактивный CLI на Ink (React), компилируется в бинарник (bun build --compile), режим Setup: создаёт .env, генерирует auth-секреты, прогоняет миграции, создаёт админ-пользователя с хешированием.
• queue, eslint-config, typescript-config — инфраструктура.
• Инфраструктура/деплой: пайплайн Turbo (turbo.json), Bun, .env.example, дизайн-система в стиле glassmorphism.
• AI-тулинг: `.mcp.json` настраивает shadcn MCP server (bunx shadcn mcp) — Claude Code добавляет shadcn-компоненты через MCP. .claude/ + CLAUDE.md (20 KB) как гайд для агента.

10 коммитов за неделю (boilerplate с нуля):

• Скаффолд Turborepo + 10 workspace-пакетов.
• Better Auth + RBAC + Redis-сессии в @workspace/auth.
• Сквозной типобезопасный клиент Eden Treaty в @workspace/entities (пример CRUD по posts).
• Ink-CLI с автоматическим сетапом при первом запуске (env/секреты/миграции/админ-пользователь), скомпилированный в исполняемый бинарник.
• Полный пакет shadcn/ui + glassmorphism.
• Скоуп: компактный, но архитектурно завершённый boilerplate; ранняя стадия (одна примерная сущность).

Подтверждено по CLAUDE.md/README/манифестам:

• Сквозная типобезопасность через Eden Treaty (createApiClient в @workspace/entities): типы Elysia API прорастают в хуки React Query на фронтендах без дублирования — единый контракт через всю границу.
• Интерактивный setup-CLI на Ink (@workspace/cli): визард первого запуска в терминале на React (env, генерация секретов, миграции, админ-пользователь с хешем), скомпилированный в нативный бинарник через bun build --compile. → сильный акцент на developer experience, нетривиальный тулинг.
• Чистая композиция монорепозитория (Turborepo + 10 пакетов): auth/db/cache/email/ui/entities как переиспользуемые границы, общие eslint/ts-config. → зрелая архитектура переиспользования.
• AI-first DX (.mcp.json → shadcn MCP): UI-компоненты добавляются агентом через MCP-сервер; разработка велась в 5 сессиях Claude Code. → демонстрация современного AI-тулинга в реальном проекте.
• Better Auth + Redis-кэш сессий + RBAC: централизованная аутентификация вынесена в отдельный пакет, сессии кэшируются в Redis.

• Найдено сессий: ~5 (fin-fullstack: 3 subdir-сессии; fin-fullstack-packages: 2 + index) — разработка пакетов велась из отдельной рабочей директории.
• Что делалось с AI: сборка boilerplate от и до (по скоупу/структуре из CLAUDE.md) — скаффолд монорепозитория, auth, entities, CLI; добавление shadcn-компонентов через MCP.
• Паттерны AI-воркфлоу: интеграция MCP (shadcn MCP в .mcp.json), CLAUDE.md как гайд для агента, мультидиректорные сессии (apps vs packages). Хороший пример «AI + MCP в реальном монорепозитории».

• 10 workspace-пакетов + 2 приложения в одном Turborepo.
• Сквозная типобезопасность (Elysia→Eden→React Query).
• Компилируемый Ink-CLI для авто-сетапа.
• Better Auth + RBAC + Redis из коробки.
• AI-first: shadcn MCP + 5 сессий Claude.