Deep Dive

The repo as it actually exists.

This page maps the current local codebase to real applications, real packages, real routes, and real outputs so the story on fifa.unykorn.org matches the implementation.

Runnable Apps

Applications and entrypoints

App	Entrypoint	Port	Purpose
FastAPI Orchestrator	`apps/orchestrator/main.py`	8400	Campaign generation, prompt build, export/download, provider routing
Next.js Guest Web	`apps/web`	3000 / 3001	Tap FIFA demo routes and concierge UI
Dashboard	`apps/dashboard/public/index.html`	mounted on 8400	Job queue, output grid, status monitoring

Route Groups

Backend surface

Health and status: /health, /v1/status
Prompt engine: /v1/prompt/build, /v1/prompt/asset-types, /v1/prompt/styles
Rights: /v1/rights/check, /v1/rights/sanitize
Campaigns: /v1/campaigns/create, /v1/campaigns/run, /v1/campaigns/tap-fifa, exports and ZIP download
Jobs and outputs: /v1/generate, /v1/jobs, /v1/outputs
Providers: /v1/providers, /v1/providers/cloudflare/*

Frontend Surface

Guest experience

Home launcher: professional mode hub with infrastructure framing
Tap routes: directions, food, rewards, help, VIP
Concierge API: /api/v1/agentic/concierge-assist returns next step, nearby POIs, sponsor offer, reward, language, confidence
Presentation layer: premium sponsor card, route map, persistent phone/help controls

Repository Map

Core directories that matter

apps/
  orchestrator/   FastAPI control plane
  web/            Next.js Tap FIFA guest experience
  dashboard/      Static operator dashboard

packages/
  campaigns/      Campaign expansion and Tap FIFA injection
  prompts/        Prompt templates and style presets
  rights/         Rights and sanitization rules
  workflows/      ComfyUI client and polling engine
  rendering/      Blender automation
  media/          Export profiles, resize, FFmpeg helpers
  providers/      External provider adapters, including Cloudflare Workers AI
  tap_fifa/       Brand-specific configuration

config/
  models.json     Model registry and local generation engines
  workflows.json  Asset and workflow mapping

docs/
  index.html      Public landing page
  platform.html   Deep repo summary
  architecture.html
  media-studio.html
  downloads.html