バックエンド基盤構築¶

概要¶

AI文書管理システムのバックエンド基盤を構築し、APIサーバー、データベース連携、認証システムを実装する。

詳細タスク¶

1. Express.jsプロジェクト初期化

   • Node.js/Express.jsプロジェクト作成
   • TypeScript設定
   • フォルダ構造設定（routes, controllers, services, models, middleware, utils, types）
   • 環境変数管理設定（dotenv）

2. データベース設計と接続

   • PostgreSQL接続設定
   • Prismaセットアップ
   • マイグレーション初期化
   • データモデル定義（User, Document, Storage, etc.）
   • シードデータ作成

3. API基盤実装

   • RESTful APIルート設計
   • ミドルウェア設定（cors, helmet, morgan, etc.）
   • エラーハンドリング
   • リクエストバリデーション
   • レスポンスフォーマット統一

4. 認証・認可システム実装

   • JWT認証実装
   • パスワードハッシュ化
   • OAuth連携（Google, Box）
   • ロールベースアクセス制御
   • API認証ミドルウェア

5. テスト環境構築

   • Jestセットアップ
   • テストデータベース設定
   • APIテスト用スーパーテスト設定
   • モック・スタブ設定

受け入れ基準¶

• npm startでバックエンドサーバーが起動すること
• データベース接続とマイグレーションが正常に動作すること
• 基本的なAPI（ユーザー認証、CRUD操作）が実装されていること
• JWTベースの認証フローが機能すること
• OAuthプロバイダとの連携が設定されていること
• テストが実行可能で、基本的なカバレッジがあること

技術的注意点¶

• Node.js v18以上を使用
• TypeScriptの厳格モード有効化
• Prisma v4以上を使用
• セキュリティベストプラクティスの適用（XSS対策、CSRF対策、SQL注入対策等）
• ロギング設定（アクセスログ、エラーログ）
• APIドキュメントの自動生成（Swagger/OpenAPI）

依存関係¶

• 親チケット: #231 (AI秘書付き文書管理システム開発)
• 関連チケット: #232 (プロジェクト基盤構築)

作業時間見積もり¶

• 24時間