48 lines
4.7 KiB
Markdown
48 lines
4.7 KiB
Markdown
# Posimai Project 2026 戦略ロードマップ（Claude Code 共有事項）
|
||
|
||
本書は、Antigravity（アーキテクト AI）との協議によって決定した、2026年3月以降の Posimai プロジェクトにおける **「3つの重要な戦略・構想」** をまとめています。Claude Code は以降の開発において、必ずこの方針を前提としてコード生成や提案を行ってください。
|
||
|
||
---
|
||
|
||
## 1. 【確定】AI 開発基盤の安定化（`server.js` の現状維持）
|
||
|
||
膨大なトークン消費とデグレリスクを防ぐため、以下の決定が下されました。
|
||
|
||
- **ルールのスリム化**: `CLAUDE.md` と `AGENTS.md` を純粋な「掟」のみ（約100行）にスリム化しました。アプリ作成手順などは `docs/new-app-guide.md`、デザインは `docs/design-system.md` に分割されています。今後はこれらを辞書的に参照してください。
|
||
- **`server.js` は分割しない**: 当初予定していた `server.js` の複数ファイルへの解体（`routes/` 等へのモジュール化）は**無期限に中止（WONTFIX）**となりました。
|
||
- **理由**: 現在の `server.js`（2300行超）は `buildRouter()` という巨大なクロージャの中でデータベース `pool` や `KEY_MAP` などの状態を暗黙的に共有しており、物理分割すると VPS の Docker 環境を含めて全滅するリスクが高いためです。
|
||
- **Claude Code への指示**: 今後 `server.js` を改修する際は全体を書き直そうとせず、ファイル内に整然と敷き詰められている `// ──` の見出しコメントを頼りに、ピンポイントでの検索・追記のみを行ってください（壊れていないものを直さない方針）。
|
||
|
||
---
|
||
|
||
## 2. 【構想待機】自動コンテンツジェネレーター（Posimai Chronicle 構想）
|
||
|
||
非エンジニアであるユーザーの「AI 駆動開発の奮闘記（すったもんだ）」を、外部サービスへの過度な依存なしに完全自動化してブログ化する構想です。
|
||
|
||
- **脱・外部ツール**: n8n や Selenium など、ブラウザ自動操作を用いた脆い仕組みは作成しません。
|
||
- **インビジブル・ロギング**: 以下のアーキテクチャで「何もしなくても下書きが溜まる」ように構築します。
|
||
1. VPS の `server.js` に定期実行（cron）やトリガー用の小さなスクリプトを追加。
|
||
2. Gitea の直近コミットログと、ダッシュボードの `posimai-dashboard/src/app/timeline/page.tsx` を読み込む。
|
||
3. VPS 内蔵の Gemini API に「奮闘記のテイスト」でストーリー化させる。
|
||
4. 生成された Markdown テキストを、既存の PostgreSQL `journal_posts` テーブルに `status: 'draft'`（下書き）として直接 `INSERT` する。
|
||
5. ユーザーが `posimai-journal`（CMS）を開き、1行だけ感想を足して公開ボタンを押し、`posimai-site` に載せる。
|
||
|
||
---
|
||
|
||
## 3. 【構想待機】PWA 販売・納品インフラ（Neo-Minimalist E-Commerce）
|
||
|
||
非エンジニア顧客に対して、サポートコストを「ゼロ」に抑えた状態で PWA 群を販売するプラットフォーム構想です。
|
||
|
||
- **販売フロント（ストア）**: 実験的要素（CMS連動）を含む `posimai-site` は使わず、これとは別に完全に新しい静的 PWA **`posimai-store`（仮）** を Vercel に構築します。ここにはカートロジックは置かず、商品説明と「Stripe決済URL（Payment Links）への href リンク」のみを置きます。
|
||
- **決済と納品（完全自動化）**:
|
||
1. お客様が Stripe で決済完了した瞬間、Stripe Webhook が VPS (`server.js`) へ飛びます。
|
||
2. `server.js` は PostgreSQL の `users` テーブルにお客様のアドレスを登録します。
|
||
3. `server.js` から Resend API を経由して、顧客に「Magic Link」メールを自動送信します。
|
||
4. パスワード不要の Magic Link により、非エンジニアでも迷わずに PWA にログインし利用開始できます。
|
||
- **サポートゼロ化**: クレカの変更やサブスクの解約手続きは「Stripe Customer Portal」をお客様自身に操作させることで、こちら側の管理コードをほぼゼロにします。
|
||
|
||
---
|
||
|
||
> [!NOTE]
|
||
> 構想 2 (Chronicle) および 構想 3 (Store) に関しては、まだコードの改変は開始していません。ユーザーから「Chronicle の実装に入る」「販売インフラを作る」といったトリガーが発動した際に、この構想に沿って粛々と `server.js` 等への機能追加を進めてください。
|