Phase 4l: SvelteKit dashboard + wkq Tailscale hostname

forgejo_admin commented

2026-03-13 17:56:59 +00:00

Owner

Lineage

plan-2026-03-08-tryout-prep → Phase 4 → Phase 4l (SvelteKit dashboard)

Repo

forgejo_admin/basketball-api

User Story

As an admin at tryouts
I want a fast-iterating SvelteKit dashboard with a clean URL
So that I can see all player data and iterate on the UI in real time

Context

The server-rendered admin dashboard works but iteration is slow (commit → build → push → deploy). We need a local SvelteKit dev environment that connects directly to the production Postgres DB so UI changes appear instantly on save.

Also need a cleaner Tailscale hostname — wkq.tail5b443a.ts.net instead of basketball-api.tail5b443a.ts.net.

Two sub-deliverables:

4l-1: Custom Tailscale hostname

Create wkq Tailscale funnel pointing to the basketball-api k8s service
Both URLs work (old one doesn't break)

4l-2: Local SvelteKit dashboard

SvelteKit project in ~/pal-e-playground/wkq-dashboard/ (or similar)
Connects to basketball-api Postgres via kubectl port-forward
Shows: player completeness dashboard, player detail cards, registration status
Hot reload — change code, see it immediately in browser
Later: deploy to k8s behind the wkq hostname

File Targets

Files the agent should create:

~/pal-e-playground/wkq-dashboard/ — new SvelteKit project
Tailscale funnel config for wkq hostname

Files the agent should NOT touch:

src/basketball_api/ — existing API is fine

Acceptance Criteria

wkq.tail5b443a.ts.net resolves to the basketball-api service
SvelteKit project runs locally with npm run dev
Dashboard shows all players with completeness scoring
Player detail view shows all filled fields
Changes to SvelteKit code appear immediately in browser

Test Expectations

Manual: navigate to wkq hostname, see data
Manual: edit a SvelteKit component, see change instantly

Constraints

Use pal-e-playground for experiments (promote to real repo after design locks)
SvelteKit 2 + Tailwind for speed
Connect to Postgres directly (not through API) for now — speed over architecture
Must work on Tailscale network (not public internet)

Checklist

PR opened (if applicable)
Tests pass
No unrelated changes

project-westside-basketball

### Lineage `plan-2026-03-08-tryout-prep` → Phase 4 → Phase 4l (SvelteKit dashboard) ### Repo `forgejo_admin/basketball-api` ### User Story As an admin at tryouts I want a fast-iterating SvelteKit dashboard with a clean URL So that I can see all player data and iterate on the UI in real time ### Context The server-rendered admin dashboard works but iteration is slow (commit → build → push → deploy). We need a local SvelteKit dev environment that connects directly to the production Postgres DB so UI changes appear instantly on save. Also need a cleaner Tailscale hostname — `wkq.tail5b443a.ts.net` instead of `basketball-api.tail5b443a.ts.net`. Two sub-deliverables: **4l-1: Custom Tailscale hostname** - Create `wkq` Tailscale funnel pointing to the basketball-api k8s service - Both URLs work (old one doesn't break) **4l-2: Local SvelteKit dashboard** - SvelteKit project in `~/pal-e-playground/wkq-dashboard/` (or similar) - Connects to basketball-api Postgres via `kubectl port-forward` - Shows: player completeness dashboard, player detail cards, registration status - Hot reload — change code, see it immediately in browser - Later: deploy to k8s behind the wkq hostname ### File Targets Files the agent should create: - `~/pal-e-playground/wkq-dashboard/` — new SvelteKit project - Tailscale funnel config for wkq hostname Files the agent should NOT touch: - `src/basketball_api/` — existing API is fine ### Acceptance Criteria - [ ] `wkq.tail5b443a.ts.net` resolves to the basketball-api service - [ ] SvelteKit project runs locally with `npm run dev` - [ ] Dashboard shows all players with completeness scoring - [ ] Player detail view shows all filled fields - [ ] Changes to SvelteKit code appear immediately in browser ### Test Expectations - [ ] Manual: navigate to wkq hostname, see data - [ ] Manual: edit a SvelteKit component, see change instantly ### Constraints - Use pal-e-playground for experiments (promote to real repo after design locks) - SvelteKit 2 + Tailwind for speed - Connect to Postgres directly (not through API) for now — speed over architecture - Must work on Tailscale network (not public internet) ### Checklist - [ ] PR opened (if applicable) - [ ] Tests pass - [ ] No unrelated changes ### Related - `project-westside-basketball`

forgejo_admin referenced this issue

2026-03-13 18:31:48 +00:00

Add JSON roster API endpoint for playground dashboard #64

forgejo_admin commented

2026-03-13 19:50:51 +00:00

Author

Owner

Closing — 4l-1 (JSON API, PR #64) and 4l-2 (dashboard wired to API) are DEPLOYED. 4l-3 (custom hostname) remains as a stretch goal but not blocking tryouts.

forgejo_admin closed this issue

2026-03-13 19:50:52 +00:00

Rows
Columns

Phase 4l: SvelteKit dashboard + wkq Tailscale hostname #62