resource-planner

要員計画アプリ — Svelte 5 + Tailwind v4 + @tommykey-apps/ui-components 消費。

Tech Stack

開発環境

flox を使う。 手動で Node や pnpm をインストールしない。

flox activate

認証 (@tommykey-apps/* private packageを取得)

GitHub Packages から private package を取得するため、GITHUB_TOKEN 環境変数(read:packages スコープを持つ PAT)が必要:

export GITHUB_TOKEN=$(gh auth token)   # gh が tommykey0925 / tommykey-apps 配下にアクセス権を持つ場合
# または明示的に PAT を設定:
# export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxx

.npmrc で ${GITHUB_TOKEN} を参照しているので、env が設定されていれば pnpm install 経由で透過的に解決される。

CI では secrets.GITHUB_TOKEN をそのまま使う(.github/workflows/ci.yaml 参照)。

コマンド

ルート (Makefile):

make help          # 利用可能なコマンド一覧
make dev           # SvelteKit dev server (cd web && pnpm dev)
make build         # 本番ビルド (Lambda container 用)
make db            # DynamoDB Local 起動 + table 作成 (port 8000)
make db-docs       # tbls で docs/db/schema/ 再生成
make db-docs-diff  # スキーマ drift 確認
make clean         # docker compose down

web/ 直接:

cd web
pnpm install               # 依存インストール (要 GITHUB_TOKEN)
pnpm dev                   # Vite dev server
pnpm build                 # ビルド (build/ に出力、Lambda 用)
pnpm check                 # svelte-check
pnpm format                # Prettier 自動修正
pnpm test                  # Vitest (unit; DDB Local 起動時は integration も含む)
pnpm test:watch            # Vitest watch mode
pnpm test:coverage         # Vitest + v8 coverage

コード品質 audit

Claude Code セッションで web/src/ を編集すると、 ターン終了時に /audit skill 実行が自動推奨される (.claude/hooks/stop-audit-gate.sh 経由)。 audit は pnpm check / pnpm test / knip (unused exports) / jscpd (重複コード) / madge (循環依存) を順次実行し、 大規模変更時は code-reviewer subagent も spawn する。 ローカルバイパス防止のため PR 時に CI でも同 audit を走らせる (.github/workflows/audit.yaml、 continue-on-error で warning レベル)。 詳細は CLAUDE.md 参照。

統合テストの実行

web/src/lib/repository/integration.test.ts は AWS_ENDPOINT_URL が設定されている時のみ実行 (describe.runIf)。ローカルで integration まで含めて実行するには:

make db                    # DynamoDB Local 起動 + table 作成
cd web
AWS_ENDPOINT_URL=http://localhost:8000 \
AWS_ACCESS_KEY_ID=local AWS_SECRET_ACCESS_KEY=local AWS_DEFAULT_REGION=ap-northeast-1 \
DYNAMODB_TABLE=resource-planner \
pnpm test

CI では .github/workflows/ci.yaml の test job が services.dynamodb で起動して unit + integration を一括実行する。 詳細方針は ADR 0007 参照。

UI 構成

主要画面 (home / / assignments /assignments) は @tommykey-apps/ui-components の ResourceTimeline + TimelineToolbar を組み合わせて構成する。 直近の version で取り込んだ機能:

ui-components 側の挙動と props 一覧は tommykey-apps/ui-components README 参照。

アーキテクチャ

docs/architecture.drawio を draw.io で開くと編集できる。 図を更新したら drawio-png skill (またはローカル draw.io GUI) で docs/architecture.png を再 export して commit する。

設計ドキュメントの読み方

本リポジトリは 型駆動 docs 戦略 を採用している (ADR 0001)。 OpenAPI は使わず、TypeScript 型 + Zod schema を API 仕様の正本とし、自然言語ドキュメントは 役割を分けて 4 箇所に集約する。

📖 公開 docs: https://tommykey-apps.github.io/resource-planner/

Architecture Decision Records

Use Cases

新機能を追加するときは .github/ISSUE_TEMPLATE/feature.yml を使う。 ADR / use-case / 型定義の追加が AC に含まれる。

本番投入手順 (Auth.js infra、PR-A4)

infra/ を terraform apply した後、以下を 手動で 1 度だけ 実行する:

# 1. AUTH_SECRET を生成して SSM SecureString に投入 (terraform state には残さない)
SECRET=$(openssl rand -hex 32)
aws ssm put-parameter \
  --name /resource-planner/auth-secret \
  --value "$SECRET" \
  --type SecureString \
  --overwrite \
  --region ap-northeast-1

# 2. SES domain identity の verified 状態を確認 (DKIM CNAME 反映に最大 15 分)
aws sesv2 get-email-identity \
  --email-identity tommykeyapp.com \
  --region ap-northeast-1
# VerifiedForSendingStatus が true、DkimAttributes.Status が SUCCESS ならOK

# 3. SES Sandbox 解除を申請 (本番ユーザーへの送信を有効化、24-48 時間)
# AWS Console → SES → Account dashboard → Request production access
# `ALLOWED_DOMAIN` 配下の社内ユーザーのみに送信する旨を理由に記載

その後 gh secret set で CD 用の env を本番用に揃える (AUTH_SECRET は SSM 経由で Lambda 起動時に取得するため、CD には不要)。

関連リポジトリ

• tommykey-apps/ui-components — Svelte コンポーネントライブラリ