app-bff-api と admin-bff-api を統合

[kantacky]

変更点

fun-dotto/app-bff-api と fun-dotto/admin-bff-api の 2 リポジトリを、本リポジトリのモジュラーモノリス規約に沿って統合しました。

配置

統合元	統合先
app-bff-api/internal/*	internal/modules/app/{domain,external,handler,middleware,repository,service}
admin-bff-api/internal/*	internal/modules/admin/{handler,middleware}
両者の internal/infrastructure/clients.go	internal/shared/apiclient/clients.go
各 cmd/server/main.go	cmd/app-api/main.go / cmd/admin-api/main.go

OpenAPI 仕様

• 仕様の原本は api/openapi/{app,admin}/openapi.yaml に既に存在するものをそのまま利用し、複製は作っていません。
• cmd/admin-api は統合元と同じく実行時に相対パスで仕様を読み、リクエストバリデータと Firebase 認証を構築します。runtime image への同梱は、cmd/migrate が migrations/ を読むのと同じ方式で Dockerfile に追加しました。
• cmd/app-api は統合元でもリクエストバリデータを使っていないため、導入していません（挙動維持）。

生成コードの扱い

統合元が持っていた generated/external/*_api は再生成せず廃止しました。両 BFF の外部 spec は本リポジトリの api/openapi/{academic,announcement,funch,user}/openapi.yaml と一致（funch のみ引用符スタイル差のみ）で、既存の gen/* が 4 サービスとも client: true で生成済みだったため、import エイリアスのみで解決しています。gen/{app,admin} も既存のものを利用しています。

その他

• 外部 API クライアントの初期化を internal/shared/apiclient に集約（統合元 2 つでほぼ同一の実装が重複していたため）。google.golang.org/api を直接依存へ昇格。
• サーバ起動を internal/shared/server.Run に統一。
• Dockerfile のビルド対象、.github/actions/set-env の DEPLOY_TARGETS、mise.toml の build / 起動タスクに app-api と admin-api を追加。
• mise.toml の build から漏れていた announcement-api / user-api も追加（Dockerfile 側には元からあり、CI の mise run build が検証できていなかったため）。

移植の忠実性

internal/ 配下は統合元のコピーで、ロジックの変更はありません。統合元と 1 ファイルずつ比較した結果は次の通りです。

	ファイル数	完全一致	import 行のみ差分	それ以外の差分
app	67	14	47	6
admin	23	2	21	0

app の「それ以外の差分」6 件はすべて gofmt による整形結果です。統合元に gofmt 未適用の箇所が残っていたためで、内訳は構造体フィールドのアラインメント調整が 4 件（external/room_change_model.go、handler/room_change.go、repository/announcement_mock.go、repository/funch_mock.go）、ファイル末尾の余分な空行削除が 2 件（service/academic.go、service/academic_test.go）です。

意図的に手を入れたのは以下の 3 点だけです。

1. import パスの一括書き換え
2. internal/infrastructure/clients.go を internal/shared/apiclient へ集約する際の書き直し（URL 取得を requireURL に切り出し、初期化順を整理）
3. cmd/*/main.go の起動処理（router.Run → internal/shared/server.Run）と、admin の仕様読み込みパス

確認内容

• go build ./... / go vet ./... / go test ./... がすべて通過（統合元の既存テストを含む）。
• gofmt 差分なし。

マージ前に別途必要な対応

• .env.example: ACADEMIC_API_URL / ANNOUNCEMENT_API_URL / FUNCH_API_URL / USER_API_URL の追記が必要です（作業環境の制約でこの PR には含めていません）。
• Cloud Run の環境変数: 統合元の deploy.yml は上記 4 つを env_vars でデプロイ時に投入していましたが、本リポジトリの cd.yml は既存サービスも含め env を管理していないため、その方針に合わせて追加していません。app-api / admin-api のサービス側に 4 つの URL を設定する必要があります。
• 統合元リポジトリ固有のファイル（way submodule、Taskfile.yml、AGENTS.md / CLAUDE.md、.serena 等）は取り込んでいません。

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying fun-dotto-server-docs with    Cloudflare Pages

Latest commit:	a62e7d6
Status:	✅  Deploy successful!
Preview URL:	https://8fbdfd39.fun-dotto-server-docs.pages.dev
Branch Preview URL:	https://feat-integrate-bff-apis.fun-dotto-server-docs.pages.dev

View logs