mai
/
posimai-root
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
posimai-root/docs/strategic-roadmap.md

6.2 KiB
Raw Blame History

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 リポジトリと同期）