133 lines
5.6 KiB
Markdown
133 lines
5.6 KiB
Markdown
# 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 駆動開発の奮闘記」を自動ブログ化する構想です。
|
||
|
||
### アーキテクチャ
|
||
|
||
```
|
||
git log（コミット履歴） ──┐
|
||
├→ server.js cron → Gemini API → journal_posts（draft）
|
||
posimai-journal（手動）──┘
|
||
```
|
||
|
||
1. VPS `server.js` に定期実行（cron）エンドポイントを追加
|
||
2. **Gitea API から直近コミットログを取得**（`feat:`/`fix:` プレフィックスで構造化済み）
|
||
- ※ `timeline/page.tsx` を直接読むのは避ける（React コンポーネントのパースは脆弱）
|
||
3. Gemini API に「posimai らしいテイスト」でストーリー化させる
|
||
4. `journal_posts` テーブルに `status: 'draft'` で INSERT
|
||
5. mai が journal を開き1行感想を足して公開 → posimai-site に掲載
|
||
|
||
### 開始条件
|
||
「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 リポジトリと同期） |
|