Agent モデル切り替えとプリペイドクレジット課金基盤を追加（Phase 1 / ADR-0012）

.github/workflows/ci.yml

@@ -116,7 +116,7 @@ jobs:
         run: npm ci --prefix frontend
 
       - name: 脆弱性スキャン (npm audit)
-        run: npm audit --audit-level=high --prefix frontend
+        run: node frontend/scripts/audit-check.mjs
 
       - name: Lint frontend
         run: npm run lint --prefix frontend

.gitignore

@@ -12,6 +12,9 @@ htmlcov/
 node_modules/
 dist/
 frontend/.test-dist/
+# Playwright E2E の生成物（実行ごとに作られるローカル成果物）
+frontend/test-results/
+frontend/playwright-report/
 frontend/tsconfig.app.tsbuildinfo
 frontend/tsconfig.node.tsbuildinfo
 frontend/vite.config.js

backend/alembic_migrations/versions/0044_add_credit_billing.py

@@ -0,0 +1,88 @@
+"""プリペイドクレジット課金の基盤テーブルを追加する（ADR-0012）
+
+- users.credit_balance: 残高キャッシュ（正本は credit_transactions 台帳）。
+  既存行は残高 0 から開始するため server_default="0"
+- credit_transactions: 付与・消費の追記専用台帳。stripe_session_id の UNIQUE 制約は
+  Phase 2（Stripe Webhook）の二重付与防止用に最初から張る
+- agent_usage_logs: Agent チャットの実トークン使用量記録（無料モデル含む）
+
+libSQL (SQLite 互換) は ADD COLUMN を直接サポートするため upgrade は op.add_column を使う。
+users は子テーブルから FK 参照される親テーブルのため batch_alter_table（テーブル再作成）を
+使わない。素のカラムは SQLite/libSQL 3.35+ の ALTER TABLE DROP COLUMN で直接削除できる。
+
+Revision ID: 0044_add_credit_billing
+Revises: 0043_add_contact_to_resumes
+Create Date: 2026-06-12 00:00:00.000000
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "0044_add_credit_billing"
+down_revision: Union[str, None] = "0043_add_contact_to_resumes"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "users",
+        sa.Column(
+            "credit_balance", sa.Integer(), nullable=False, server_default="0"
+        ),
+    )
+    op.create_table(
+        "credit_transactions",
+        sa.Column("id", sa.String(length=36), primary_key=True),
+        sa.Column(
+            "user_id",
+            sa.String(length=36),
+            sa.ForeignKey("users.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("amount", sa.Integer(), nullable=False),
+        sa.Column("balance_after", sa.Integer(), nullable=False),
+        sa.Column("transaction_type", sa.String(length=20), nullable=False),
+        sa.Column("description", sa.String(length=200), nullable=True),
+        sa.Column("stripe_session_id", sa.String(length=255), nullable=True, unique=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index(
+        "ix_credit_transactions_user_id", "credit_transactions", ["user_id"]
+    )
+    op.create_table(
+        "agent_usage_logs",
+        sa.Column("id", sa.String(length=36), primary_key=True),
+        sa.Column(
+            "user_id",
+            sa.String(length=36),
+            sa.ForeignKey("users.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("model_alias", sa.String(length=20), nullable=False),
+        sa.Column("input_tokens", sa.Integer(), nullable=False),
+        sa.Column("output_tokens", sa.Integer(), nullable=False),
+        sa.Column("credit_cost", sa.Integer(), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index("ix_agent_usage_logs_user_id", "agent_usage_logs", ["user_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_agent_usage_logs_user_id", table_name="agent_usage_logs")
+    op.drop_table("agent_usage_logs")
+    op.drop_index("ix_credit_transactions_user_id", table_name="credit_transactions")
+    op.drop_table("credit_transactions")
+    op.drop_column("users", "credit_balance")

backend/app/core/errors.py

@@ -33,6 +33,8 @@ class ErrorCode(str, Enum):
     # Agent（LLM チャット / ADR-0010）
     AGENT_LLM_ERROR = "AGENT_LLM_ERROR"
     AGENT_PARSE_ERROR = "AGENT_PARSE_ERROR"
+    # 課金（プリペイドクレジット / ADR-0012）
+    INSUFFICIENT_CREDITS = "INSUFFICIENT_CREDITS"
     # アプリケーション全体
     RATE_LIMITED = "RATE_LIMITED"
     # サーバー

backend/app/main.py

@@ -31,6 +31,7 @@
 from .routers import (  # noqa: E402
     agent_router,
     auth_router,
+    billing_router,
     blog_router,
     github_link_router,
     health_router,
@@ -215,3 +216,4 @@ async def dispatch(self, request: Request, call_next) -> Response:
 app.include_router(notifications_router)
 app.include_router(internal_router)
 app.include_router(agent_router)
+app.include_router(billing_router)

backend/app/messages.json

@@ -73,6 +73,10 @@
       "parse_failed": "AI の応答を解釈できませんでした。もう一度お試しください。",
       "target_required": "このスコープでは対象の指定が必要です。",
       "target_not_found": "指定された対象が見つかりません。"
+    },
+    "billing": {
+      "insufficient_credits": "クレジット残高が不足しています。Haiku（無料）に切り替えるか、クレジットを追加してください。",
+      "grant_user_not_found": "付与対象のユーザーが見つかりません。"
     }
   },
   "notification": {

backend/app/models/__init__.py

@@ -1,5 +1,6 @@
 """SQLAlchemy モデル。"""
 
+from .billing import AgentUsageLog, CreditTransaction
 from .blog import BlogAccount, BlogArticle, BlogArticleTag
 from .cache import GitHubLinkCache
 from .master_data import MQualification, MTechnologyStack
@@ -18,9 +19,11 @@
 from .user import User
 
 __all__ = [
+    "AgentUsageLog",
     "BlogAccount",
     "BlogArticle",
     "BlogArticleTag",
+    "CreditTransaction",
     "GitHubLinkCache",
     "MQualification",
     "MTechnologyStack",

backend/app/models/billing.py

@@ -0,0 +1,70 @@
+"""クレジット課金モデル（ADR-0012）。
+
+``credit_transactions`` は付与・消費の全履歴を持つ追記専用の台帳（正本）。
+``users.credit_balance`` はそのキャッシュで、台帳と同一トランザクション内で更新する。
+``agent_usage_logs`` はモデル別の実トークン使用量の記録（無料モデルも記録する）。
+"""
+
+import uuid
+from datetime import datetime
+
+from sqlalchemy import DateTime, ForeignKey, Integer, String, func
+from sqlalchemy.orm import Mapped, mapped_column
+
+from ..db import Base
+
+
+class CreditTransaction(Base):
+    """クレジットの付与・消費 1 件分の台帳エントリ（追記専用）。"""
+
+    __tablename__ = "credit_transactions"
+
+    id: Mapped[str] = mapped_column(
+        String(36), primary_key=True, default=lambda: str(uuid.uuid4())
+    )
+    user_id: Mapped[str] = mapped_column(
+        String(36), ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True
+    )
+    # 符号付きの増減量（付与: 正 / 消費: 負）
+    amount: Mapped[int] = mapped_column(Integer, nullable=False)
+    # 本トランザクション適用後の残高（監査・デバッグ用のスナップショット）
+    balance_after: Mapped[int] = mapped_column(Integer, nullable=False)
+    # 種別: consumption（チャット消費）/ admin_grant（管理者付与）/ purchase（Stripe 購入）
+    transaction_type: Mapped[str] = mapped_column(String(20), nullable=False)
+    description: Mapped[str | None] = mapped_column(String(200), nullable=True, default=None)
+    # Stripe Checkout Session ID。UNIQUE 制約により Webhook 再送時の二重付与を防ぐ
+    # （Phase 2 で使用。Phase 1 では常に NULL / ADR-0012）
+    stripe_session_id: Mapped[str | None] = mapped_column(
+        String(255), nullable=True, unique=True, default=None
+    )
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        default=func.now(),
+        server_default=func.now(),
+        nullable=False,
+    )
+
+
+class AgentUsageLog(Base):
+    """Agent チャット 1 回分の実トークン使用量の記録（コスト分析用）。"""
+
+    __tablename__ = "agent_usage_logs"
+
+    id: Mapped[str] = mapped_column(
+        String(36), primary_key=True, default=lambda: str(uuid.uuid4())
+    )
+    user_id: Mapped[str] = mapped_column(
+        String(36), ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True
+    )
+    # model_catalog.py のエイリアス（haiku / sonnet）
+    model_alias: Mapped[str] = mapped_column(String(20), nullable=False)
+    input_tokens: Mapped[int] = mapped_column(Integer, nullable=False)
+    output_tokens: Mapped[int] = mapped_column(Integer, nullable=False)
+    # 消費クレジット（無料モデルは 0）
+    credit_cost: Mapped[int] = mapped_column(Integer, nullable=False)
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        default=func.now(),
+        server_default=func.now(),
+        nullable=False,
+    )

backend/app/models/user.py

@@ -1,7 +1,7 @@
 import uuid
 from datetime import datetime
 
-from sqlalchemy import DateTime, String, func
+from sqlalchemy import DateTime, Integer, String, func
 from sqlalchemy.orm import Mapped, mapped_column
 
 from ..db import Base
@@ -16,6 +16,11 @@ class User(Base):
     github_id: Mapped[int | None] = mapped_column(nullable=True, unique=True, default=None)
     github_token: Mapped[str | None] = mapped_column(String(255), nullable=True, default=None)
     refresh_jti: Mapped[str | None] = mapped_column(String(36), nullable=True, default=None)
+    # プリペイドクレジット残高のキャッシュ（正本は credit_transactions 台帳 / ADR-0012）。
+    # 事前チェック通過後の事後減算により一時的に負になりうる（有界損失を許容）
+    credit_balance: Mapped[int] = mapped_column(
+        Integer, nullable=False, default=0, server_default="0"
+    )
     created_at: Mapped[datetime] = mapped_column(
         DateTime(timezone=True),
         server_default=func.now(),

backend/app/repositories/__init__.py

@@ -1,13 +1,15 @@
 """Repository 層。"""
 
 from .base import BaseMasterRepository, SingleUserDocumentRepository
+from .billing import BillingRepository
 from .blog import BlogAccountRepository, BlogArticleRepository
 from .master_data import MQualificationRepository, MTechnologyStackRepository
 from .resume import ResumeRepository
 from .user import UserRepository
 
 __all__ = [
     "BaseMasterRepository",
+    "BillingRepository",
     "BlogAccountRepository",
     "BlogArticleRepository",
     "MQualificationRepository",