# Posimai Project — マスターアーキテクチャドキュメント

最終更新: 2026-04-06
対象: Claude Code / Cursor / Gemini / 全 AI エージェント

**このドキュメントはプロジェクトの現状を一元管理します。実装の前に必ず読んでください。**

---

## 0. ビジネス体制（確定）

- **Eiji**: 共同経営者。VPS・DNS（soar-enrich.com）・Cloudflare 管理・対外窓口・代表。VPS は mai も自由に操作可。
- **mai**: プロダクト開発担当。アプリ設計・実装・AI 活用。
- インフラ・ドメイン共用は設計通り。

---

## 1. 全体構成図（2026-04-06 確定）

```
╔══════════════════════════════════════════════════════════╗
║  mai の開発環境（Windows 11 PC）                         ║
║  VS Code / Claude Code CLI                               ║
╚══════════════════════════════════════════════════════════╝
         │ git push（gitea + github の2リモート同時）
         │ ※ Gitea 廃止は検討中・現状維持
         ▼
╔══════════════════════════════════════════════════════════╗
║  コード管理                                              ║
║  GitHub（正）← Vercel 自動デプロイトリガー              ║
║  Gitea（NAS）← バックアップのみ・確認先にしない          ║
╚══════════════════════════════════════════════════════════╝
         │ GitHub push → Vercel 自動デプロイ
         ▼
╔══════════════════════════════════════════════════════════╗
║  フロントエンド（Vercel / CDN）                           ║
║  posimai.soar-enrich.com → posimai-dashboard             ║
║  *.posimai.soar-enrich.com → Vercel（ワイルドカード設定済）║
║  全 27 本アプリ（全て PWA）                              ║
╚══════════════════════════════════════════════════════════╝
         │ https://api.soar-enrich.com/brain/api/...
         ▼
╔══════════════════════════════════════════════════════════╗
║  バックエンド本番（VPS）85.131.245.239                   ║
║  Ubuntu 25.04 / AMD EPYC 4コア / 5.8GB RAM              ║
║                                                          ║
║  Nginx: api.soar-enrich.com → :8090                     ║
║  posimai-api（Node.js / Express / :8090）                ║
║  PostgreSQL 16（posimai_brain DB）                       ║
║  VOICEVOX（:50021）稼働済み                              ║
╚══════════════════════════════════════════════════════════╝

╔══════════════════════════════════════════════════════════╗
║  Ubuntu PC（100.77.11.43 / Tailscale）                   ║
║  ・posimai-dev（:3333）ブラウザターミナル + Station      ║
║  ・Station（HDMI 全画面監視）                            ║
║  ・Openbox + Chromium kiosk                              ║
╚══════════════════════════════════════════════════════════╝

╔══════════════════════════════════════════════════════════╗
║  Synology NAS（100.76.7.3 / Tailscale のみ）             ║
║  ・Gitea（:3000）git バックアップ                        ║
║  ・Uptime Kuma（:3002）死活監視                          ║
║  ・旧 API / PostgreSQL 15（停止可能・保留中）            ║
║  ・Ubuntu PC → NAS rsync バックアップ（毎日3時）         ║
╚══════════════════════════════════════════════════════════╝

╔══════════════════════════════════════════════════════════╗
║  外部サービス                                            ║
║  Resend（Magic Link メール / noreply@soar-enrich.com）   ║
║  Stripe（テストモード稼働中 / 月額¥500）                 ║
║  Gemini API（VPS 経由・gemini-2.5-flash 固定）           ║
║  Google Places API（Maps アプリ・フロント直接・要改善）  ║
╚══════════════════════════════════════════════════════════╝
```

---

## 2. VPS PostgreSQL — テーブルとデータの実体

| テーブル | 何が入っているか | AIが関与するか |
|---------|----------------|--------------|
| `users` | ユーザー情報・plan（free/premium）・Stripe ID | なし |
| `auth_sessions` | JWTセッション | なし |
| `articles` | Brain保存記事・**AI要約（summaryカラム）**・全文・トピック | Gemini が要約生成・VPS に永続保存 |
| `journal_posts` | Journal投稿・タグ | タグはGeminiが提案（その場限り） |
| `reading_history` | 読んだURL・タイトル・ドメイン | なし |
| `habit_habits` / `habit_log` | 習慣定義・達成ログ | なし |
| `pulse_log` | 気分・エネルギー・集中度・メモ | なし |
| `lens_history` | 写真EXIFデータ・サムネイル | なし |
| `together_groups/members/shares/reactions/comments` | Together全データ（2026-04-06 Supabaseから移行済み） | 投稿にAI要約あり |

**Supabase は撤退済み（2026-04-06）。** Together を VPS PostgreSQL に完全移行。

---

## 3. データ保存先（確定）

| 保存先 | 対象 | 状態 |
|--------|------|------|
| VPS PostgreSQL | brain・journal・together・reading_history・habit・pulse・認証 | 稼働中 |
| localStorage（永続・移行しない） | veil設定・timer設定 | 確定 |
| localStorage（将来VPS移行予定） | habit・pulse（VPSにテーブルは存在済み） | 商用化フェーズで移行 |
| データなし（都度処理） | diff・clean・think・digest・brief・feed・timer | — |

---

## 4. アプリ間パイプライン（設計）

```
Feed（発見）
  ↓ 記事クリック
Reader（読む）→ reading_history に記録（2026-04-06 対応済み）
  ↓ 保存ボタン
Brain（保存・AI要約）→ articles に記録
  ↓ 気づきをメモ
Think / Journal（内省）→ journal_posts
  ↓ 週次バッチ（未実装）
Digest（まとめ）→ user_activity から集計して生成
Brief（音声）→ Digest の内容を VOICEVOX で読み上げ
  ↓ 公開したいものだけ
Together（共有）→ together_shares
```

**Pulse/Habit は横断的に記録され、Rewind（振り返り）アプリの材料になる（将来）。**

### 未実装・改善が必要なもの

| 課題 | 内容 | 優先度 |
|------|------|--------|
| `user_activity` テーブル | アプリ横断の行動ログ基盤。Digestの週次集計に必要 | 中 |
| habit/pulse → VPS移行 | テーブルはVPSに存在。アプリ側をAPI呼び出しに変えるだけ | 中（premium機能として） |
| Together に Brain/Journal 連携 | `source_type` / `source_id` カラム追加で Brain記事を直接共有可能 | 低 |
| Digest `/api/digest/weekly` 実装 | user_activityから週次サマリー生成 | 低 |
| Google Places API → VPS経由化 | Mapsアプリのキーがフロントに露出している | 低（急がない） |

---

## 5. 認証フロー（確定・全て稼働中）

```
Magic Link（Resend メール → JWT）
Google OAuth → VPS → JWT → /auth/verify?type=oauth
GitHub OAuth → VPS → JWT → /auth/verify?type=oauth
WebAuthn / Passkey（rpID: posimai.soar-enrich.com）

JWT: { userId, sid, plan }
plan = "free" or "premium"（Stripe決済後にDB更新）

/auth/session/verify → { ok, userId, plan, purchased }
```

**Supabase Auth は不採用。完全 VPS 自前認証。**
`X-API-Key`・`?init_key=` の旧認証体系は一部アプリが依存しているため変更禁止。

---

## 6. 販売フロー（テストモード稼働中）

```
posimai-store（LP）
  → Stripe Payment Link（月額¥500・1日無料トライアル）
  → Stripe Webhook → VPS → users.plan = "premium"
  → JWT に plan: "premium" が入る
  → 各アプリで purchased フラグで機能出し分け可能
```

**本番切り替え待ち:** Storeデザイン確定 → 特商法記入 → Stripe本番切り替え

---

## 7. アプリ一覧（全 27 本・2026-04-06 時点）

| アプリ | バックエンド | 備考 |
|--------|------------|------|
| posimai-dashboard | — | Next.js / メインダッシュボード |
| posimai-brain | VPS API | 記事保存・AI要約 |
| posimai-feed | Vercel Serverless + RSS | フィード（キー不要） |
| posimai-reader | VPS API | 記事リーダー（reading_history連携済み） |
| posimai-journal | VPS API | CMS / Geminiタグ提案 |
| posimai-together | VPS API | 共有（Supabaseから移行済み） |
| posimai-brief | VPS TTS | VOICEVOX音声 |
| posimai-daily | VPS API | ブリーフィング |
| posimai-habit | localStorage → VPS（予定） | 習慣管理 |
| posimai-pulse | localStorage → VPS（予定） | 気分記録 |
| posimai-think | Gemini直接 | AI思考整理 |
| posimai-digest | Gemini直接 | テキスト要約 |
| posimai-maps | Google Places API（フロント直接） | 要VPS化 |
| posimai-tech-events | VPS経由RSS | ITイベント |
| posimai-atlas | VPS API | インフラ構成図 |
| posimai-site | VPS API | 公開ホームページ |
| posimai-lens | — | EXIF表示（処理のみ） |
| posimai-diff | — | テキスト差分（処理のみ） |
| posimai-clean | — | テキストクリーナー（処理のみ） |
| posimai-timer | — | タイマー（localStorage） |
| posimai-veil | — | アプリランチャー |
| posimai-ambient | open-meteo | 常時表示 |
| posimai-roadmap | — | ロードマップ |
| posimai-widget-dl | — | ウィジェット |
| posimai-events | VPS API | イベント情報（モック・Beta） |
| posimai-hotels | — | ホテル価格（モック・Beta） |
| posimai-analytics | — | Next.js / RFM分析 |

---

## 8. デプロイパイプライン

```bash
# フロントエンド（全アプリ共通）
git add . && git commit -m "feat/fix/chore: ..." && npm run deploy
# = git push gitea main && git push github main → Vercel 自動デプロイ

# VPS バックエンド（server.js 変更時）
bash deploy-server.sh

# Ubuntu PC（posimai-dev/station 変更時）
npm run deploy:dev  # git push + scp + systemctl restart
```

- `vercel --prod` 直接実行: **禁止**
- VPS DBバックアップ: 毎日4時自動実行・7日分保持・正常稼働確認済み（2026-04-06）

---

## 9. 残タスク（優先順）

### 商用化直結（maiの決定が必要）

| タスク | 状態 |
|--------|------|
| **どのアプリにpremium機能を実装するか決める** | **未決定・最重要** |
| Storeデザイン確定（A/B/C/D） | Eiji意見待ち |
| 特商法ページ記入（事業者名・住所等） | mai手動作業 |
| Stripe本番モード切り替え | デザイン確定後 |

### AIが対応可能（maiの決定後）

| タスク | 工数 |
|--------|------|
| 各アプリへのpremiumフラグ実装 | 1アプリ30分 |
| habit/pulse → VPS API移行 | 各2時間 |
| user_activityテーブル追加 | 2時間 |

### 保留・検討中

| 項目 | 状態 |
|------|------|
| Giteaをdeployから外す | 検討中（廃止メリットあり・決定待ち） |
| Uptime Kuma → Ubuntu PC移設 + UptimeRobot追加 | 検討中 |
| Synology 旧コンテナ停止 | 保留 |

---

## 10. 設計判断ログ

| 日付 | 決定事項 |
|------|---------|
| 2026-03-25 | バックエンドを Synology → VPS に移行完了 |
| 2026-03-26 | API URL を `api.soar-enrich.com` に分離完了 |
| 2026-03-29 | Supabase Auth を不採用。VPS 自前認証を正規方針に確定 |
| 2026-04-04 | Google OAuth + GitHub OAuth 実装完了 |
| 2026-04-04 | Stripe Webhook 実装完了・テスト決済確認済み |
| 2026-04-06 | Together を Supabase → VPS PostgreSQL に完全移行（61件） |
| 2026-04-06 | *.posimai.soar-enrich.com ワイルドカード DNS 設定済み確認 |
| 2026-04-06 | Reader reading_history を localStorage → VPS に修正済み |
| 2026-04-06 | WebSocket認証・SSRF blocklist・Feed POST認証・e.message修正済み |

---

## 11. 絶対に守るルール（全 AI 共通）

1. **デプロイは `npm run deploy` のみ**（`vercel --prod` 禁止）
2. **絵文字禁止**（コード・UI・コミット全て）
3. **Lucide @0.344.0 固定**（`@latest` 禁止）
4. **デザイントークン外の色直接使用禁止**（`var(--accent)` を使う）
5. **`git push origin` 禁止**（gitea と github の2リモートのみ）
6. **Gemini モデルは `gemini-2.5-flash` 固定**
7. **このファイルを変更したら「最終更新」日付を更新する**