プロジェクト設定

プロジェクト概要

名称: 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 デプロイ戦略
失敗時は自動ロールバック
データベースマイグレーションはデプロイ前に実行する

よく使うコマンド

コマンド	用途
`npm run dev`	開発サーバを起動
`npm test`	テストスイートを実行
`npm run lint`	コードスタイルを確認
`npm run build`	本番向けビルド
`npm run migrate`	データベースマイグレーションを実行

チーム連絡先

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