adb-web
AI-generated content
This document was generated by an AI assistant. Verify accuracy before relying on the details.
adb-web/ is a frozen, unimplemented scaffold for an Angular UI + Hono BFF on Cloudflare Workers — 🔴 black box per MODULE_OWNERSHIP.md ("the remaining engineer has never seen this service and it is not in production"), last touched 2026-07-02, and not the repository's actual Cloudflare migration. That migration is a different, actively developed effort living at the repo root — see Not to be confused with below before reading any further.
At a glance
| Status | 🔴 black box, frozen, not in production |
Last commit touching adb-web/ | 7e25aa07d "fix cf stack", 2026-07-02 |
| Implemented | GET /healthz on the BFF. Everything else is .gitkeep placeholders — apps/ui/src has no Angular code at all. |
| Package manager / runner | Yarn 4.5.0 + Turborepo 2.3.0 |
| Real Cloudflare port | services/*, packages/*, apps/ui, apps/ui-legacy, apps/api, infra-cf/ at repo root — see Onboarding a new engineer |
Not to be confused with the real Cloudflare port
The repository has two, unrelated things that both call themselves "the Cloudflare migration," and their directory names collide in a way that actively misleads:
adb-web/apps/ui (this page) | root-level apps/ui | |
|---|---|---|
| Framework | Angular, empty (src/ holds only a .gitkeep) | React Router 7, fully built (hundreds of files) |
| Backend counterpart | adb-web/apps/bff — one route (/healthz), rest is .gitkeep | services/* (10+ Workers, one per JVM service) + packages/* |
| Reaches the JVM services via | a planned Cloudflare Tunnel (ADB_UPSTREAM_URL / ADB_TUNNEL_TOKEN secrets, never wired) | Service Bindings to services/*, which themselves talk to services/mongo-broker |
| Activity | last touched 2026-07-02, no further commits since | actively developed — see e.g. apps/ui/docs/orchestration/HANDOFF.md and the ADRs under apps/ui/docs/adr/ |
| Ownership | 🔴 black box (adb-web/CLAUDE.md) | documented in depth in apps/ui/CLAUDE.md, CLAUDE.md's own "Tests (Cloudflare workspace)" section |
Read apps/ui/CLAUDE.md and follow Onboarding a new engineer for the real Cloudflare port. The rest of this page documents adb-web/ as it exists today, for completeness and so nobody re-discovers it and assumes it is live.
Layout (as it exists on disk)
adb-web/
├── apps/
│ ├── ui/ Angular workspace — package.json + wrangler.jsonc only, src/ is empty
│ └── bff/
│ ├── src/index.ts ONE route (/healthz); everything else returns 501 "not implemented"
│ ├── src/middleware/ .gitkeep only
│ ├── src/routes/ .gitkeep only
│ ├── src/upstream/ .gitkeep only
│ └── wrangler.jsonc
└── packages/
├── api-client/ meant to generate a TS client from ../adb/adb-openapi
├── shared-types/
├── ui-components/
├── ui-styles/
└── eslint-config/
Stack (as declared in package.json, unused)
| Item | Value |
|---|---|
| Package manager | Yarn 4.5.0 |
| Build orchestrator | Turbo 2.3.0 |
| Node | >= 20.10.0 |
| TypeScript | 5.6.0 |
| BFF framework | Hono 4.6.0 |
| Wrangler | ^4.0.0 |
| Workers types | @cloudflare/workers-types 4.20240925.0 |
| Tests | Vitest 2.0 + @cloudflare/vitest-pool-workers 0.5 |
apps/bff/src/index.ts, verbatim
export default {
async fetch(request: Request, env: Env, _ctx: ExecutionContext): Promise<Response> {
const url = new URL(request.url);
if (url.pathname === '/healthz') {
return Response.json({ ok: true, env: env.ENVIRONMENT });
}
// TODO: replace with Hono router + middleware once routes are added
return new Response('adb-bff: not implemented', { status: 501 });
},
} satisfies ExportedHandler<Env>;
The doc comment above this function states the intended responsibilities (terminate auth at the edge, cache idempotent reads, rate-limit, fan out to the JVM services via Cloudflare Tunnel) — none of them are implemented. wrangler.jsonc declares no routes, no KV namespace, no Durable Object class and no secrets; the three "expected secrets" (ADB_UPSTREAM_URL, ADB_TUNNEL_TOKEN, JWT_SECRET) exist only as comments in apps/bff/src/index.ts's Env interface.
Links
- Code:
adb-web/ - BFF entrypoint:
adb-web/apps/bff/src/index.ts - Module ownership entry:
MODULE_OWNERSHIP.md - The real Cloudflare port: Onboarding a new engineer,
apps/ui/CLAUDE.md
Open questions
adb-web/CLAUDE.mditself says "provenance and intended migration timeline are unclear — treat documentation here as advisory, not authoritative, until the engineer confirms." That is still true; this page does not resolve why this scaffold exists alongside the actively developed Cloudflare port at the repo root, only that it does and what state it is in. PerBUG_FIX_PLAYBOOK.md, treatadb-web/as read-only until the engineer classifies it (delete, archive, or revive) — no agent should propose changes here without that decision first.