26 KiB

Raw Blame History

Synology環境完全構築ロードマップ

作成日: 2026-02-23 期間: 12週間（3フェーズ）目標: プロダクション品質のAI駆動開発環境構築

🎯 Phase 1: インフラ完全構築（Week 1-4）

Week 1: 緊急対応 - 既存システムの安定化

Day 1-2: Tailscale Funnel 永続化 🔴 Critical

目標: Synology再起動でもGitea外部公開を維持

タスク:

# posimai-lab (100.76.7.3) にSSH接続
ssh admin@100.76.7.3

# systemdサービス化（最も堅牢）
sudo nano /etc/systemd/system/tailscale-funnel.service

設定内容:

[Unit]
Description=Tailscale Funnel for Gitea
After=network.target tailscaled.service
Requires=tailscaled.service

[Service]
Type=simple
ExecStart=/usr/local/bin/tailscale funnel --bg 3000
Restart=always
RestartSec=10
User=root

[Install]
WantedBy=multi-user.target

有効化:

sudo systemctl daemon-reload
sudo systemctl enable tailscale-funnel.service
sudo systemctl start tailscale-funnel.service
sudo systemctl status tailscale-funnel.service

# 動作確認
curl https://posimai-lab.tail72e846.ts.net

成功基準:

✅ Synology再起動後も自動起動
✅ systemctl status でactive (running)
✅ 外部からGiteaアクセス可能

Day 3-4: バックアップ戦略確立 🔴 Critical

目標: データ損失ゼロ保証

タスク1: Gitea データバックアップ

# posimai-lab で実行
sudo nano /usr/local/bin/gitea-backup.sh

スクリプト内容:

#!/bin/bash
BACKUP_DIR="/volume1/backups/gitea"
DATE=$(date +%Y%m%d_%H%M%S)
GITEA_DIR="/var/lib/gitea"

mkdir -p $BACKUP_DIR

# Giteaバックアップコマンド（公式）
cd /usr/local/bin
./gitea dump -c /etc/gitea/app.ini -f $BACKUP_DIR/gitea-dump-$DATE.zip

# 7日以上古いバックアップを削除
find $BACKUP_DIR -name "gitea-dump-*.zip" -mtime +7 -delete

echo "Backup completed: gitea-dump-$DATE.zip"

cron設定:

# 毎日午前3時にバックアップ
sudo crontab -e
# 追加
0 3 * * * /usr/local/bin/gitea-backup.sh >> /var/log/gitea-backup.log 2>&1

タスク2: プロジェクトファイルバックアップ

Synology Hyper Backup設定:

DSM → Hyper Backup → 外部ストレージ（USB HDD推奨）
対象ディレクトリ:
- /volume1/docker/gitea (Gitea全体)
- /volume1/projects (全プロジェクト)
- /volume1/backups (バックアップデータ)
スケジュール: 毎日午前2時
バージョン管理: 30世代保持

タスク3: 外部クラウドバックアップ（推奨）

# Google Drive同期（rclone使用）
# posimai-lab で実行
curl https://rclone.org/install.sh | sudo bash
rclone config  # Google Drive設定

# 自動同期スクリプト
sudo nano /usr/local/bin/gdrive-sync.sh

スクリプト内容:

#!/bin/bash
rclone sync /volume1/backups gdrive:posimai-backups \
  --exclude "*.tmp" \
  --log-file=/var/log/rclone-sync.log \
  --stats 1m

cron設定:

# 毎日午前4時にクラウド同期
0 4 * * * /usr/local/bin/gdrive-sync.sh

成功基準:

✅ Gitea自動バックアップ（毎日）
✅ Synology Hyper Backup設定完了
✅ 外部クラウド同期（オプション）
✅ リストア手順のドキュメント作成

Day 5-7: PostgreSQL + Redis 導入 🟡 Important

目標: データ永続化とパフォーマンス向上

タスク1: Docker Compose 統合管理

# posimai-lab で実行
mkdir -p /volume1/docker/posimai-stack
cd /volume1/docker/posimai-stack
nano docker-compose.yml

docker-compose.yml:

version: '3.8'

services:
  # PostgreSQL - 将来のアプリ用データベース
  postgres:
    image: postgres:16-alpine
    container_name: posimai-postgres
    restart: always
    environment:
      POSTGRES_USER: posimai
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: posimai_db
    volumes:
      - /volume1/docker/postgres/data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    networks:
      - posimai-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U posimai"]
      interval: 10s
      timeout: 5s
      retries: 5

  # Redis - Proxyレート制限 & キャッシュ
  redis:
    image: redis:7-alpine
    container_name: posimai-redis
    restart: always
    command: redis-server --appendonly yes
    volumes:
      - /volume1/docker/redis/data:/data
    ports:
      - "6379:6379"
    networks:
      - posimai-net
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

  # Gemini Proxy - レート制限永続化版
  gemini-proxy:
    build: ./proxy
    container_name: posimai-gemini-proxy
    restart: always
    environment:
      GEMINI_API_KEY: ${GEMINI_API_KEY}
      REDIS_HOST: redis
      REDIS_PORT: 6379
    ports:
      - "3001:3001"
    networks:
      - posimai-net
    depends_on:
      redis:
        condition: service_healthy

networks:
  posimai-net:
    driver: bridge

.env設定:

nano .env

POSTGRES_PASSWORD=your_secure_password_here
GEMINI_API_KEY=your_gemini_api_key

起動:

docker-compose up -d
docker-compose ps  # 全て healthy確認

タスク2: Proxy サーバー Redis対応

mkdir -p /volume1/docker/posimai-stack/proxy
cd /volume1/docker/posimai-stack/proxy
nano server.js

server.js（Redis永続化版）:

const express = require('express');
const { GoogleGenerativeAI } = require('@google/generative-ai');
const redis = require('redis');

const app = express();
const PORT = 3001;

// Redis接続
const redisClient = redis.createClient({
  url: `redis://${process.env.REDIS_HOST}:${process.env.REDIS_PORT}`
});

redisClient.on('error', (err) => console.error('Redis Error:', err));
redisClient.connect();

// Gemini初期化
const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY);

app.use(express.json());

// レート制限チェック（Redis永続化）
async function checkRateLimit(userId) {
  const today = new Date().toISOString().split('T')[0];
  const key = `quota:${userId}:${today}`;

  const count = await redisClient.get(key);

  if (!count) {
    // 初回アクセス - 明日0時にexpire
    const tomorrow = new Date();
    tomorrow.setDate(tomorrow.getDate() + 1);
    tomorrow.setHours(0, 0, 0, 0);
    const ttl = Math.floor((tomorrow - new Date()) / 1000);

    await redisClient.set(key, 1, { EX: ttl });
    return { allowed: true, count: 1, limit: 1000 };
  }

  const currentCount = parseInt(count);

  if (currentCount >= 1000) {
    return { allowed: false, count: currentCount, limit: 1000 };
  }

  await redisClient.incr(key);
  return { allowed: true, count: currentCount + 1, limit: 1000 };
}

// プロキシエンドポイント
app.post('/api/gemini', async (req, res) => {
  const userId = req.body.userId || 'anonymous';

  // レート制限チェック
  const rateLimit = await checkRateLimit(userId);

  if (!rateLimit.allowed) {
    return res.status(429).json({
      error: 'Rate limit exceeded',
      quota: rateLimit
    });
  }

  try {
    const model = genAI.getGenerativeModel({
      model: 'gemini-2.0-flash-exp',
      generationConfig: { responseMimeType: 'application/json' }
    });

    const result = await model.generateContent(req.body.prompt);
    const response = result.response.text();

    res.json({
      result: JSON.parse(response),
      quota: rateLimit
    });
  } catch (error) {
    console.error('Gemini API Error:', error);
    res.status(500).json({ error: error.message });
  }
});

app.listen(PORT, '0.0.0.0', () => {
  console.log(`Proxy listening on http://0.0.0.0:${PORT}`);
});

Dockerfile:

FROM node:20-alpine
WORKDIR /app
COPY package.json .
RUN npm install
COPY server.js .
EXPOSE 3001
CMD ["node", "server.js"]

package.json:

{
  "name": "gemini-proxy",
  "version": "2.0.0",
  "dependencies": {
    "express": "^4.18.2",
    "@google/generative-ai": "^0.21.0",
    "redis": "^4.7.0"
  }
}

再ビルド・再起動:

cd /volume1/docker/posimai-stack
docker-compose build gemini-proxy
docker-compose up -d
docker-compose logs -f gemini-proxy  # 動作確認

成功基準:

✅ PostgreSQL起動・接続確認
✅ Redis起動・接続確認
✅ Proxy サーバーがRedis経由でレート制限管理
✅ Synology再起動後も自動起動

Week 2: 監視・アラート - 障害を即座に検知

Day 8-10: Uptime Kuma 導入 🟡 Important

目標: ダウンタイムを即座に検知・通知

タスク1: Uptime Kuma インストール

# posimai-lab で実行
cd /volume1/docker/posimai-stack
nano docker-compose.yml

docker-compose.yml に追加:

  # Uptime Kuma - 監視・アラート
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: posimai-uptime-kuma
    restart: always
    volumes:
      - /volume1/docker/uptime-kuma:/app/data
    ports:
      - "3002:3001"
    networks:
      - posimai-net

起動:

docker-compose up -d uptime-kuma

初期設定:

ブラウザで http://100.76.7.3:3002 にアクセス
管理者アカウント作成
監視対象を追加:
- Gitea: https://posimai-lab.tail72e846.ts.net (HTTP 200)
- Vercel配布ページ: https://ponshu-room.vercel.app (HTTP 200)
- Proxy API: http://localhost:3001/health (HTTP 200)
- PostgreSQL: TCP接続 localhost:5432
- Redis: TCP接続 localhost:6379

タスク2: 通知設定

Slack通知 (推奨):

Slack App作成 → Incoming Webhook URL取得
Uptime Kuma → Settings → Notifications → Slack
Webhook URL入力
テスト送信

メール通知 (代替):

Uptime Kuma → Settings → Notifications → Email (SMTP)
Gmail SMTP設定:
- Host: smtp.gmail.com
- Port: 587
- Username: your-email@gmail.com
- Password: App Password（2段階認証必須）

成功基準:

✅ 全サービスが "Up" 状態
✅ ダウン時にSlack/メール通知
✅ 稼働率グラフ表示

Day 11-14: ログ集約・分析基盤 🟢 Nice to Have

目標: トラブルシューティング効率化

Option A: Loki + Grafana（軽量）

  # Loki - ログ集約
  loki:
    image: grafana/loki:latest
    container_name: posimai-loki
    restart: always
    ports:
      - "3100:3100"
    volumes:
      - /volume1/docker/loki:/loki
    networks:
      - posimai-net

  # Grafana - 可視化
  grafana:
    image: grafana/grafana:latest
    container_name: posimai-grafana
    restart: always
    ports:
      - "3003:3000"
    environment:
      GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_PASSWORD}
    volumes:
      - /volume1/docker/grafana:/var/lib/grafana
    networks:
      - posimai-net

Option B: スキップ（Week 2-4で時間不足の場合）

Week 3-4: CI/CD構築 - デプロイ完全自動化

Day 15-18: Gitea Actions 設定 🟡 Important

目標: git push だけで自動ビルド・デプロイ

タスク1: Gitea Actions 有効化

# posimai-lab で実行
sudo nano /etc/gitea/app.ini

app.ini 追加:

[actions]
ENABLED = true

Gitea再起動:

sudo systemctl restart gitea

タスク2: Runner 登録

# Runner用ディレクトリ作成
mkdir -p /volume1/docker/gitea-runner
cd /volume1/docker/gitea-runner

# Runner起動（Docker版）
docker run -d \
  --name gitea-runner \
  --restart always \
  -v /volume1/docker/gitea-runner:/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitea/act_runner:latest

Runner登録:

Gitea Web UI → Settings → Actions → Runners
登録トークン取得
Runner登録:

docker exec -it gitea-runner \
  act_runner register \
  --instance http://100.76.7.3:3000 \
  --token YOUR_REGISTRATION_TOKEN

タスク3: Workflow 作成

# ponshu_room_lite リポジトリ
cd /path/to/ponshu_room_lite
mkdir -p .gitea/workflows
nano .gitea/workflows/release.yml

.gitea/workflows/release.yml:

name: Auto Release to Gitea & Vercel

on:
  push:
    tags:
      - 'v*.*.*'

jobs:
  build-and-release:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Setup Flutter
        uses: subosito/flutter-action@v2
        with:
          flutter-version: '3.19.0'

      - name: Build APKs
        run: |
          chmod +x build_all_apks.sh
          ./build_all_apks.sh          

      - name: Release to Gitea
        env:
          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
        run: |
          pwsh -ExecutionPolicy Bypass -File release_to_gitea.ps1

Secrets設定:

Gitea → ponshu_room_lite → Settings → Secrets
追加: GITEA_TOKEN = あなたのGiteaトークン

テスト:

git tag v1.0.17
git push origin v1.0.17
# → 自動でAPKビルド・リリース・Vercelデプロイ

成功基準:

✅ タグpushで自動ビルド開始
✅ APK 4本自動生成
✅ Giteaリリース自動作成
✅ Vercel自動デプロイ
✅ 所要時間: 15分以内

Day 19-21: マルチプロジェクト対応 🟡 Important

目標: 日本酒アプリ以外もCI/CD対応

タスク1: 共通Workflowテンプレート作成

# Giteaに共通テンプレートリポジトリ作成
mkdir -p /volume1/projects/workflow-templates
cd /volume1/projects/workflow-templates

flutter-release-template.yml:

name: Flutter APK Release

on:
  push:
    tags:
      - 'v*'

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: subosito/flutter-action@v2
      - run: flutter pub get
      - run: flutter build apk --release
      - run: |
          # リリース作成スクリプト
          # プロジェクトごとにカスタマイズ

タスク2: スキャンアプリCI/CD設定

（日本酒アプリと同様の手順）

Day 22-28: ドキュメント整備

成果物:

インフラ運用マニュアル (INFRASTRUCTURE_MANUAL.md)
- 各サービスの起動/停止方法
- トラブルシューティング
- 復旧手順
CI/CDガイド (CICD_GUIDE.md)
- Workflowの書き方
- Secretsの管理方法
- デプロイフロー図
緊急時対応マニュアル (EMERGENCY_PROCEDURES.md)
- Synologyダウン時の対応
- データリストア手順
- 連絡先リスト

🎯 Phase 2: プロジェクト構造最適化（Week 5-8）

Week 5-6: 共通資産の抽出

目標: AI分析・OCR等を00_coreに集約

現状の問題:

ponshu_room_lite/
  ├─ lib/services/gemini_service.dart  # AI分析
  ├─ lib/services/ocr_service.dart     # OCR

scan_app/  # 未完成プロジェクト
  ├─ lib/services/gemini_service.dart  # 重複！
  ├─ lib/services/ocr_service.dart     # 重複！

理想の構造:

posimai-project/
├─ 00_core/  # 共通ライブラリ
│  ├─ packages/
│  │  ├─ posimai_ai/  # Gemini統合
│  │  │  ├─ lib/
│  │  │  │  ├─ gemini_client.dart
│  │  │  │  ├─ proxy_client.dart
│  │  │  │  └─ rate_limiter.dart
│  │  │  └─ pubspec.yaml
│  │  │
│  │  ├─ posimai_ocr/  # OCR統合
│  │  │  ├─ lib/ocr_service.dart
│  │  │  └─ pubspec.yaml
│  │  │
│  │  └─ posimai_ui/  # 共通UIコンポーネント
│  │     ├─ lib/
│  │     │  ├─ theme.dart
│  │     │  ├─ widgets/loading.dart
│  │     │  └─ widgets/error_dialog.dart
│  │     └─ pubspec.yaml
│  │
│  └─ docs/
│     ├─ ARCHITECTURE.md
│     └─ API_REFERENCE.md
│
├─ ponshu_room_lite/  # 日本酒アプリ
│  └─ pubspec.yaml
│     dependencies:
│       posimai_ai:
│         path: ../00_core/packages/posimai_ai
│
└─ scan_app/  # スキャンアプリ
   └─ pubspec.yaml
      dependencies:
        posimai_ai:
          path: ../00_core/packages/posimai_ai
        posimai_ocr:
          path: ../00_core/packages/posimai_ocr

実装手順:

Day 29-32: posimai_ai パッケージ作成

cd /volume1/projects/posimai-project
mkdir -p 00_core/packages/posimai_ai
cd 00_core/packages/posimai_ai

flutter create --template=package posimai_ai

pubspec.yaml:

name: posimai_ai
version: 1.0.0
description: Posimai AI統合ライブラリ（Gemini API + Proxy対応）

dependencies:
  flutter:
    sdk: flutter
  http: ^1.1.0

dev_dependencies:
  flutter_test:
    sdk: flutter

lib/gemini_client.dart:

/// ponshu_room_lite/lib/services/gemini_service.dart から抽出
class GeminiClient {
  final String? apiKey;
  final String? proxyUrl;
  final bool useProxy;

  GeminiClient({
    this.apiKey,
    this.proxyUrl,
    this.useProxy = false,
  });

  Future<Map<String, dynamic>> analyze({
    required String prompt,
    String? imageBase64,
  }) async {
    if (useProxy) {
      return _analyzeViaProxy(prompt, imageBase64);
    } else {
      return _analyzeDirectAPI(prompt, imageBase64);
    }
  }

  // 実装...
}

Day 33-35: 日本酒アプリを共通パッケージに移行

cd ponshu_room_lite
nano pubspec.yaml

追加:

dependencies:
  posimai_ai:
    path: ../00_core/packages/posimai_ai

lib/services/gemini_service.dart 書き換え:

// 変更前
class GeminiService {
  // 全実装がここに...
}

// 変更後
import 'package:posimai_ai/posimai_ai.dart';

class GeminiService {
  final GeminiClient _client;

  GeminiService()
    : _client = GeminiClient(
        apiKey: Secrets.geminiApiKey,
        useProxy: Secrets.useProxy,
      );

  Future<SakeAnalysisResult> analyzeSake(String imageBase64) async {
    final result = await _client.analyze(
      prompt: '...日本酒分析プロンプト...',
      imageBase64: imageBase64,
    );
    return SakeAnalysisResult.fromJson(result);
  }
}

テスト:

flutter test
flutter run  # 動作確認

成功基準:

✅ 日本酒アプリが共通パッケージで動作
✅ テスト全てパス
✅ ビルドサイズ変化なし

Week 7-8: 新プロジェクトテンプレート作成

目標: 新規アプリを30分で立ち上げ

テンプレート作成:

cd /volume1/projects/posimai-project/00_core
mkdir -p templates/flutter_app_template
cd templates/flutter_app_template

flutter create --org com.posimai flutter_app_template

事前設定済みの内容:

✅ posimai_ai, posimai_ui 依存関係
✅ ダークモード対応テーマ
✅ Hive永続化設定
✅ 多言語対応（日英）
✅ CI/CD Workflow (.gitea/workflows/release.yml)
✅ README.md（開発手順）

新規プロジェクト作成スクリプト:

nano /usr/local/bin/posimai-new-project

スクリプト内容:

#!/bin/bash
PROJECT_NAME=$1

if [ -z "$PROJECT_NAME" ]; then
  echo "Usage: posimai-new-project <project_name>"
  exit 1
fi

cd /volume1/projects/posimai-project
cp -r 00_core/templates/flutter_app_template $PROJECT_NAME
cd $PROJECT_NAME

# プロジェクト名置換
find . -type f -exec sed -i "s/flutter_app_template/$PROJECT_NAME/g" {} \;

echo "✅ Project created: $PROJECT_NAME"
echo "Next steps:"
echo "  cd $PROJECT_NAME"
echo "  flutter pub get"
echo "  flutter run"

使い方:

# 香道アプリを30分で立ち上げ
posimai-new-project kodo_app
cd kodo_app
flutter pub get
flutter run  # 即座に動作するテンプレート

🎯 Phase 3: AI駆動開発の高速化（Week 9-12）

Week 9-10: AI開発ワークフロー最適化

目標: Claude + Antigravity の協調効率を最大化

現状の問題:

Claude Code, Antigravity, Geminiを手動で切り替え
コンテキスト共有が手動（コピペ）
レビュー結果の蓄積なし

理想の姿:

git push
  → Gitea Actions起動
  → Claude Codeが自動コードレビュー
  → Antigravityが自動修正提案
  → 人間が承認
  → 自動マージ・デプロイ

実装: AI Code Review Bot

タスク1: Gitea Webhook設定

# posimai-lab で実行
cd /volume1/docker/posimai-stack
mkdir -p ai-review-bot
cd ai-review-bot
nano server.js

server.js:

const express = require('express');
const { exec } = require('child_process');

const app = express();
app.use(express.json());

// Gitea Webhookエンドポイント
app.post('/webhook/gitea', async (req, res) => {
  const { action, pull_request } = req.body;

  if (action === 'opened' || action === 'synchronized') {
    const prNumber = pull_request.number;
    const repo = pull_request.base.repo.full_name;

    console.log(`New PR #${prNumber} in ${repo}`);

    // Claude Code でレビュー実行
    exec(`claude-code review ${repo} ${prNumber}`, (error, stdout) => {
      if (error) {
        console.error('Review failed:', error);
        return;
      }

      console.log('Review completed:', stdout);

      // レビュー結果をPRコメントに投稿
      // ... Gitea API経由でコメント投稿 ...
    });
  }

  res.sendStatus(200);
});

app.listen(3004, () => {
  console.log('AI Review Bot listening on port 3004');
});

Gitea Webhook設定:

Gitea → リポジトリ → Settings → Webhooks
URL: http://localhost:3004/webhook/gitea
イベント: Pull Request

成功基準:

✅ PR作成で自動レビュー開始
✅ レビュー結果がPRコメントに投稿
✅ 人間が承認→自動マージ

Week 11-12: ドキュメント自動生成 & ナレッジベース構築

目標: AI開発の学習を蓄積

タスク1: 自動ドキュメント生成

# .gitea/workflows/docs.yml
name: Auto Documentation

on:
  push:
    branches:
      - main

jobs:
  generate-docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Generate API docs
        run: |
          flutter pub get
          flutter pub run dartdoc          

      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITEA_TOKEN }}
          publish_dir: ./doc/api

タスク2: ナレッジベース（Obsidian連携）

# Synologyに Obsidian Vault作成
mkdir -p /volume1/projects/posimai-knowledge
cd /volume1/projects/posimai-knowledge

# 構造
# ├─ AI開発ログ/
# │  ├─ 2026-02-23_配布システム構築.md
# │  └─ 2026-02-24_共通パッケージ化.md
# ├─ トラブルシューティング/
# │  ├─ Flutter_ビルドエラー集.md
# │  └─ Docker_ネットワーク問題.md
# └─ アーキテクチャ決定記録/
#    ├─ ADR-001_Tailscale-Funnel選定.md
#    └─ ADR-002_共通パッケージ戦略.md

自動連携スクリプト:

#!/bin/bash
# git commit時に自動でナレッジベースにログ追加

DATE=$(date +%Y-%m-%d)
LOG_FILE="/volume1/projects/posimai-knowledge/AI開発ログ/${DATE}_作業ログ.md"

echo "## $(date +%H:%M) - $1" >> $LOG_FILE
git log -1 --pretty=format:"%B" >> $LOG_FILE
echo "" >> $LOG_FILE

📊 Phase別優先順位マトリクス

フェーズ	必須 (Must Have)	重要 (Should Have)	あれば良い (Nice to Have)
Phase 1	Tailscale Funnel永続化バックアップ戦略 PostgreSQL/Redis	Uptime Kuma CI/CD基礎	ログ集約（Loki）
Phase 2	共通パッケージ化プロジェクトテンプレート	新規アプリテスト作成	既存アプリ全移行
Phase 3	ドキュメント整備	AI Code Review Bot	ナレッジベース自動化

🎯 成功指標（KPI）

Phase 1完了時

Synology再起動後も全サービス自動起動
バックアップから30分以内にリストア可能
サービスダウン時に5分以内に通知
git tag push → 自動デプロイ完了（15分以内）

Phase 2完了時

新規Flutterアプリを30分で立ち上げ
既存アプリ2つ以上が共通パッケージ使用
コード重複率50%削減

Phase 3完了時

PR作成→自動レビュー→コメント投稿（10分以内）
ドキュメントカバレッジ80%以上
トラブルシューティング時間50%削減

⚠️ リスクと対策

リスク	影響	対策
Phase 1が長引く	Phase 2/3に影響	Week 1-2に集中、Week 3-4は柔軟調整
Synology容量不足	Docker起動失敗	事前に空き容量確認（推奨: 500GB以上）
CI/CD学習コスト高	挫折リスク	最小構成から開始、段階的拡張
新規プロジェクト誘惑	12週間計画放棄	Phase 1完了までは厳格に新規着手禁止

📅 週次チェックポイント

毎週金曜17時: 進捗レビュー

確認事項:

今週の目標達成率は？（%）
ブロッカーは何か？
来週の優先順位調整は必要か？

AI活用:

Claude Code: コードレビュー
Antigravity: 実装加速
Gemini: アーキテクチャ相談

🎓 学習リソース

必読ドキュメント

Tailscale Funnel公式ドキュメント
Gitea Actions ガイド
Docker Compose Best Practices
Flutter Package開発ガイド

推奨チュートリアル

Uptime Kuma セットアップ（30分）
PostgreSQL Docker運用（1時間）
CI/CDパイプライン構築（2時間）

次のアクション: Phase 1 Week 1 Day 1のTailscale Funnel永続化から開始してください。

作成者: Claude (Sonnet 4.5) 対象: 日本酒アプリ完成後の開発環境最適化 期間: 12週間（2026-02-24 ~ 2026-05-18）

26 KiB Raw Blame History Unescape Escape

Synology環境 完全構築ロードマップ

🎯 Phase 1: インフラ完全構築（Week 1-4）

Week 1: 緊急対応 - 既存システムの安定化

Day 1-2: Tailscale Funnel 永続化 🔴 Critical

Day 3-4: バックアップ戦略確立 🔴 Critical

Day 5-7: PostgreSQL + Redis 導入 🟡 Important

Week 2: 監視・アラート - 障害を即座に検知

Day 8-10: Uptime Kuma 導入 🟡 Important

Day 11-14: ログ集約・分析基盤 🟢 Nice to Have

Week 3-4: CI/CD構築 - デプロイ完全自動化

Day 15-18: Gitea Actions 設定 🟡 Important

Day 19-21: マルチプロジェクト対応 🟡 Important

Day 22-28: ドキュメント整備

🎯 Phase 2: プロジェクト構造最適化（Week 5-8）

Week 5-6: 共通資産の抽出

目標: AI分析・OCR等を00_coreに集約

Week 7-8: 新プロジェクトテンプレート作成

🎯 Phase 3: AI駆動開発の高速化（Week 9-12）

Week 9-10: AI開発ワークフロー最適化

目標: Claude + Antigravity の協調効率を最大化

Week 11-12: ドキュメント自動生成 & ナレッジベース構築

📊 Phase別優先順位マトリクス

🎯 成功指標（KPI）

Phase 1完了時

Phase 2完了時

Phase 3完了時

⚠️ リスクと対策

📅 週次チェックポイント

毎週金曜17時: 進捗レビュー

🎓 学習リソース

必読ドキュメント

推奨チュートリアル

26 KiB

Raw Blame History

Synology環境完全構築ロードマップ