コーディング自動化基盤

🎯 目的¶

VPS-ROOT環境のインフラ仕様を完全文書化し、MCPツールに組み込むことで、文脈を把握しない作業による破壊的ミスを根絶する。

🚨 現在の問題状況¶

根本原因¶

• 仕様把握せずに作業開始
• ホットフィックスによる設定混乱
• 開発効率の著しい悪化
• 指示完走率の低下

具体的な混乱事例¶

• Docker Composeの管理構造を理解せずコンテナ操作
• SNI方式を知らずにポート番号でのアクセス試行
• Nginxリバースプロキシの仕組み無視
• コンテナ名指定ルールの不理解

📖 VPS-ROOT環境 基本仕様¶

🏗️ アーキテクチャ概要¶

Internet → Nginx (SNI) → Docker Containers
         ↓
    SSL証明書 (Let's Encrypt)
         ↓
    サブドメイン別ルーティング

🐳 Docker管理方式¶

• Docker Compose: 複数コンテナの統合管理
• コンテナ名指定: ポート番号は使用しない
• 内部ネットワーク: Docker内部でサービス連携
• ボリューム管理: データ永続化の統一方式

🌐 Nginx SNI方式¶

• Server Name Indication: 単一IPで複数SSL
• サブドメイン別設定: /etc/nginx/sites-available/
• リバースプロキシ: コンテナ名での内部転送
• SSL自動化: certbotによる証明書管理

🔧 作業原則¶

1. 仕様確認必須: 作業前の環境理解
2. ステージング先行: 本番直接変更禁止
3. コンテナ名指定: ポート番号使用禁止
4. 設定ファイル管理: 必ずGit管理下で変更

🛠️ 実装内容¶

1. 仕様文書の体系化¶

/root/infrastructure-docs/
├── architecture-overview.md
├── docker-management.md
├── nginx-sni-config.md
├── ssl-management.md
├── troubleshooting-guide.md
└── safe-operation-procedures.md

2. MCPツール統合¶

• 作業前の自動仕様確認
• 環境状態の可視化
• 安全な変更手順の提示
• リアルタイム設定検証

3. チェックリスト自動化¶

• Docker Compose構造の確認
• Nginx設定の検証
• SSL証明書の状態確認
• コンテナ間依存関係の可視化

📋 作業フロー改善¶

Before (問題のある流れ)¶

指示受信 → 即座に作業開始 → 設定変更 → 障害発生 → ホットフィックス → 混乱拡大

After (改善された流れ)¶

指示受信 → 仕様確認 → 環境理解 → ステージング検証 → 段階的適用 → 動作確認 → 完了

🎯 完了条件¶

• 全インフラ仕様の完全文書化
• MCPツールでの仕様参照機能
• 作業前チェックの自動化
• ホットフィックス根絶の確認

📅 実装スケジュール¶

1. Phase 1 (1-2日): 現状仕様の完全調査・文書化
2. Phase 2 (2-3日): MCPツールへの統合実装
3. Phase 3 (1-2日): 自動チェック機能の追加
4. Phase 4 (1日): 運用テスト・最終調整

🔗 関連チケット¶

• #303: 破壊的ミス防止システム
• #304: MCP統合基盤構築