posimai-root/docs/strategic-roadmap.md

# Posimai Project 2026 戦略ロードマップ

本書は Posimai プロジェクトの技術的決定事項・中長期構想をまとめます。
Claude Code / Cursor / Antigravity 等すべての AI は本書を前提として開発を進めてください。

最終更新: 2026-03-31

---

## 0. コアポジショニング（不変）

**Posimai = 個人 AI 開発者のための OS**

| コンポーネント | 役割 |
|---------------|------|
| posimai-station | 目（Ubuntu PC キオスク監視盤） |
| posimai-dev | 手（ブラウザ内ターミナル + AI 対話） |
| posimai-atlas | 脳（インフラ・依存関係の可視化） |
| posimai-dashboard | 統合ハブ（全アプリ管理 + 外部への窓口） |

これら4つのセットは競合不在のポジションです。設計・UI・機能追加はこの世界観を強化する方向で行ってください。

---

## 1. 【確定】AI 開発基盤の安定化

### CLAUDE.md / AGENTS.md のスリム化
純粋な「掟」のみ（約100行）に維持します。詳細仕様は以下の辞書ドキュメントを参照してください:
- `docs/new-app-guide.md` — 新規アプリ作成手順
- `docs/design-system.md` — デザインシステム・カラートークン
- `docs/master-architecture.md` — インフラ構成・全アプリ一覧

### server.js の改修ルール（WONTFIX: ルーター分割）

`server.js`（2300行超）は `buildRouter()` クロージャ内で `pool`・`KEY_MAP` 等の状態を共有しています。**ルーター構造の物理分割は禁止**です（Docker 環境ごと全滅するリスク）。

ただし以下は許可します:
- `// ──` 見出しコメントを頼りにしたピンポイント追記
- **JWT 生成・メール送信・バリデーション等の純粋関数** → `utils/` や `helpers/` への抽出は可

**壊れていないものを直さない。追記で解決できることを優先する。**

---

## 2. 【構想待機】Posimai Chronicle（自動コンテンツ生成）

非エンジニアである開発者の「AI 駆動開発の奮闘記」を自動ブログ化する構想です。

### アーキテクチャ

```
Gitea API（コミット・PR・issue）──┐
VPS journal_posts（手書きメモ）  ──┤
habit / pulse データ（気分・体調）──┼→ server.js cron → Gemini API → journal_posts（draft）
station metrics（作業負荷記録）  ──┤
Atlas データ（インフラ変更）     ──┘
```

1. VPS `server.js` に定期実行（cron）エンドポイントを追加
2. **Gitea API から直近コミット・PR・issue を取得**（`feat:`/`fix:` プレフィックスで構造化済み）
   - ※ `timeline/page.tsx` を直接読むのは避ける（React コンポーネントのパースは脆弱）
3. 補完データとして journal の手書きメモ・habit/pulse の体調記録・station の CPU 推移を付加
4. Gemini API に「posimai らしいテイスト（奮闘記・感情あり）」でストーリー化させる
5. `journal_posts` テーブルに `status: 'draft'` で INSERT
6. mai が journal を開き1行感想を足して公開 → posimai-site に掲載

### posimai らしさの核心
**「Gitea の開発ログ × 自分の体調・気分 × 作業負荷」を束ねて生成する Chronicle は他に存在しない。**
純粋な git log を使う汎用ツールとは違い、Gitea という「自分だけのプライベートサーバーの記録」を起点にすることで唯一無二の開発日記になる。

### 開始条件
「Chronicle の実装に入る」というトリガーが発動した時点で着手。

---

## 3. 【構想待機】posimai-store（PWA 販売・納品プラットフォーム）

### 設計思想

Zenn 記事で指摘された通り「PWA を広める場所がない」問題は現実に存在します。
posimai-store は最初は「posimai の PWA を売る場所」ですが、将来的に**他の開発者の PWA も扱える配布プラットフォーム**に育てる可能性があります。

### フロー

```
posimai-store（静的 Vercel）
  └→ Stripe Payment Links（固定価格・単品）
       └→ Stripe Webhook → server.js
            ├→ PostgreSQL: users テーブルに登録
            └→ Resend: Magic Link メールを自動送信
                 └→ 顧客がリンクを開くと即利用開始
```

### 技術決定

| 項目 | 選択 | 理由 |
|------|------|------|
| 販売ページ | 純粋な静的 HTML/CSS（Vercel） | CMS 非連動・絶対に落ちない |
| 決済（MVP） | Stripe Payment Links | コードなしで即日開始可能 |
| 決済（将来） | Stripe Checkout Session | 複数プラン・割引コード対応時に移行 |
| 認証 | Magic Link（自前実装済み） | パスワード不要・サポートゼロ |
| 解約・請求変更 | Stripe Customer Portal | 管理コードほぼゼロ |

### posimai-site との関係
- `posimai-site` = 個人ポートフォリオ・ブログ実験場（現状維持）
- `posimai-store` = 商用販売の唯一の窓口（新設・完全切り離し）

### 開始条件
「販売インフラを作る」というトリガーが発動した時点で着手。
その前提として **Magic Link 認証の server.js 実装**が完了していること。

---

## 4. 優先順位（2026-03-31 時点）

```
[今すぐ] Magic Link + Passkey 認証実装（server.js）
    ↓ 完了後
[次] posimai-store 新設（静的 LP + Stripe Payment Links）
    ↓ 並行して
[随時] Chronicle 実装（git log → Gemini → journal draft）
    ↓ 将来
[長期] posimai-store を他開発者の PWA 配布プラットフォームへ拡張
```

---

## 5. 一元管理の方針

情報はできる限り以下に集約します:

| 種別 | 場所 |
|------|------|
| アプリ一覧・リンク・ステータス | `posimai-dashboard/src/data/projects.json` |
| 更新・開発履歴 | `posimai-dashboard/src/app/timeline/page.tsx` |
| インフラ構成 | `posimai-atlas`（atlas.json） |
| 技術的決定事項・戦略 | 本ファイル（`docs/strategic-roadmap.md`） |
| インフラ詳細・URL一覧 | `docs/master-architecture.md` |
| AI の個人記憶 | `memory/MEMORY.md`（claude-memory リポジトリと同期） |