Guinness ドキュメント

Guinness は、プロジェクトの ワイヤーフレーム・デザイン・コード を常に同期し続けるための 4D 製 AI プラットフォームです。三角形の各辺に 6 つの双方向変換ツール を提供し、いずれか 1 つを更新すると残り 2 つを生成・更新できるようにします。

flowchart LR
    Design(["🎨 Design\n(Figma)"])
    Wireframe(["📐 Wireframe\n(Figma)"])
    Code(["💻 Code\n(jsx / html)"])

    Design ==>|"Des2Code（稼働中）"| Code
    Code ==>|"Code2Des（開発中）"| Design

    Wireframe -.->|"WF2Des"| Design
    Design -.->|"Des2WF"| Wireframe
    Wireframe -.->|"WF2Code"| Code
    Code -.->|"Code2WF"| Wireframe

---

読む順序の目安

👤 はじめての方

ステップ	ドキュメント	内容
1	プロダクト概要	Guinness とは何か・Triangle Workflow・6 つの変換ツール
2	登場人物	ロール定義（管理者・オーナー・メンバー・外部システム）
3	機能一覧	ロール別の機能一覧
4	データモデル	エンティティ用語集・2 DB 構成の理由

💻 開発者向け

ステップ	ドキュメント	内容
1	プロダクト概要	まず全体像を把握
2	インフラ構成	AWS トポロジー（管理者側・ユーザー側・AI ワーカー）
3	バックエンド（api-user）	ユーザー向け REST API
4	バックエンド（api-admin）	管理者向け REST API
5	AI ワーカー（guinness-ai-v2）	des2code・design-import・code-import
6	データベース	PostgreSQL のテーブル単位スキーマ

---

ドキュメント構成

ビジネスドメイン

ドキュメント	内容
プロダクト概要	Triangle Workflow・ツール一覧・チーム体制
登場人物	ロール定義・ロール関係図
機能一覧	ロール別の機能一覧
データモデル	エンティティ用語集・変換フロー・DB 分離の理由

開発リファレンス

ドキュメント	内容
インフラ構成	AWS トポロジー・認証フロー・AI 処理フロー
バックエンド（api-user）	Hono + Bun + PostgreSQL
バックエンド（api-admin）	Hono + Bun + PostgreSQL
AI ワーカー（guinness-ai-v2）	Python + PydanticAI + DocumentDB
データベース	PostgreSQL のテーブル単位スキーマ