AWSユースケース学習: 勤怠打刻API基盤

0. この資料で作るもの

打刻データを記録・集計する社内向けAPIを構築する。

1. 構成図

architecture-beta
    service user(internet)[User]

    group vpc(logos:aws-vpc)[VPC]
    group pub[Public Subnet] in vpc
    group prv[Private Subnet] in vpc
    service n1_api_gateway(logos:aws-api-gateway)[API Gateway] in pub
    service n2_lambda(logos:aws-lambda)[Lambda] in prv
    service n3_dynamodb(logos:aws-dynamodb)[DynamoDB] in prv
    service n4_cognito(logos:aws-cognito)[Cognito]
    service n5_cloudwatch(logos:aws-cloudwatch)[CloudWatch]

    user:R --> L:n1_api_gateway
    n1_api_gateway:R --> L:n2_lambda
    n2_lambda:R --> L:n3_dynamodb
    n2_lambda:B --> T:n4_cognito
    n2_lambda:B --> T:n5_cloudwatch

構成図サービスリンク

• API Gateway
• Lambda
• DynamoDB
• Cognito
• CloudWatch

2. サービス選定表

3. リクエスト処理シーケンス

sequenceDiagram
    User->>API Gateway: リクエスト
    API Gateway->>Lambda: 認証/入口制御
    Lambda->>DynamoDB: 業務処理
    DynamoDB->>Cognito: データ更新
    Cognito-->>User: 結果応答

4. データモデル（例）

ポイント:

• 認可境界を意識したキー設計にする
• 監査/再処理のためイベント履歴を保持する

4.5 クラス図（アプリ構造）

classDiagram
    class Controller {
      +handle(request) Response
    }
    class UseCaseService {
      +execute(command) Result
    }
    class Repository {
      +save(entity)
      +find(query)
    }
    class EventPublisher {
      +publish(event)
    }

    Controller --> UseCaseService
    UseCaseService --> Repository
    UseCaseService --> EventPublisher

5. API設計（例）

POST /attendance-tracking-api, GET /attendance-tracking-api/{id}, GET /attendance-tracking-api/health

認可方針:

• エッジで認証し、ドメイン層で認可を強制する
• ユーザー/テナント境界を越えるアクセスを禁止する

6. 実装ステップ（最短）

7. 監視と運用

8. コスト見積もり観点

8.5 料金例（目安）

前提トラフィック: 月間 10万リクエスト / データ転送 200GB / 保存 500GB

コストドライバー上位: API Gateway, Lambda, DynamoDB

注意:

• 上記は学習用の概算レンジ
• 正式見積もりはAWS Pricing Calculatorで試算

9. 次の発展課題

• Blue/Greenデプロイ
• マルチリージョンDR
• IaC完全自動化（CDK）
• セキュリティ運用の自動化

10. リスクと対策