プロジェクト概要

• 名称: E コマースプラットフォーム
• 技術スタック: Node.js、PostgreSQL、React 18、Docker
• チーム規模: 開発者 5 名
• デッドライン: 2025 年第 4 四半期

アーキテクチャ

@docs/architecture.md @docs/api-standards.md @docs/database-schema.md

開発標準

コードスタイル

• フォーマットには Prettier を使う
• ESLint（airbnb config）を使う
• 1 行の最大長: 100 文字
• インデント: スペース 2 個

命名規則

• ファイル: kebab-case（user-controller.js）
• クラス: PascalCase（UserService）
• 関数／変数: camelCase（getUserById）
• 定数: UPPER_SNAKE_CASE（API_BASE_URL）
• データベーステーブル: snake_case（user_accounts）

Git ワークフロー

• ブランチ名: feature/description または fix/description
• コミットメッセージ: Conventional Commits に従う
• マージ前に PR が必要
• すべての CI/CD チェックを通す
• 最低 1 名の承認が必要

テスト要件

• コードカバレッジ最低 80%
• すべての主要パスにテストが必要
• ユニットテストには Jest を使う
• E2E テストには Cypress を使う
• テストファイル名: *.test.ts または *.spec.ts

API 標準

• RESTful エンドポイントのみ
• リクエスト／レスポンスは JSON
• HTTP ステータスコードを正しく使う
• API はバージョン付きエンドポイント: /api/v1/
• 全エンドポイントに例付きドキュメントを用意する

データベース

• スキーマ変更にはマイグレーションを使う
• 認証情報をハードコードしない
• コネクションプーリングを使う
• 開発環境ではクエリログを有効化する
• 定期的なバックアップを必須とする

デプロイ

• Docker ベースのデプロイ
• Kubernetes によるオーケストレーション
• Blue-Green デプロイ戦略
• 失敗時は自動ロールバック
• データベースマイグレーションはデプロイ前に実行する

よく使うコマンド

チーム連絡先

• Tech Lead: Sarah Chen (@sarah.chen)
• Product Manager: Mike Johnson (@mike.j)
• DevOps: Alex Kim (@alex.k)

既知の問題と回避策

• ピーク時、PostgreSQL のコネクションプールが 20 に制限される
• 回避策: クエリのキューイングを実装する
• Safari 14 で async generator の互換性問題
• 回避策: Babel トランスパイラを使う

関連プロジェクト

• Analytics Dashboard: /projects/analytics
• Mobile App: /projects/mobile
• Admin Panel: /projects/admin

Last Updated: April 9, 2026