アーキテクチャ概要
こしあんスクエアは、現在の構成を前提に以下の責務分離で管理します。
| 領域 | 技術 | 責務 |
|---|---|---|
| Frontend | Next.js / Vercel | 公開画面、管理画面、SEO、UI |
| Backend | FastAPI | 外部連携、将来のAPI集約、バッチ系 |
| Database | Supabase PostgreSQL | 永続化、認証、RLS |
| Docs | MkDocs Material | 設計書、仕様書、運用手順 |
| Source Control | GitHub | 差分管理、レビュー、自動公開 |
設計原則
- 実装に近い情報を一次情報として扱う。
- migration、OpenAPI、画面コードから設計書を更新する。
- Excel中心の静的設計書ではなく、PRレビュー可能なテキスト形式に寄せる。
- 自動生成できるものは生成し、判断が必要なものは Markdown で明文化する。