Files

Dianaka123 9fcd7c1d63 POL-124: Migrate frontend from React Native to Next.js web app

- Replace mobile/ (Expo) with web/ (Next.js 16 + Tailwind + shadcn/ui)
- Pages: login, register, pending, championships, championship detail, registrations, profile, admin
- Logic/view separated: hooks/ for data, components/ for UI, pages compose both
- Types in src/types/ (one interface per file)
- Auth: Zustand store + localStorage tokens + cookie presence flag for proxy
- API layer: axios client with JWT auto-refresh

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-02-26 20:35:22 +03:00

3.2 KiB

Raw Blame History

CLAUDE.md — Pole Dance Championships App

Target Vision

See dancechamp-claude-code/ for full spec (3-app Supabase platform). Current implementation is a simplified MVP working toward that goal.

Quick Start

# Backend
cd backend && .venv/Scripts/python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

# Web frontend
cd web && npm run dev   # runs on http://localhost:3000

# Seed test data
cd backend && .venv/Scripts/python seed.py

Current Architecture

Backend: FastAPI + SQLAlchemy 2 (async) + aiosqlite (SQLite dev) + Alembic + bcrypt
Web: Next.js 15 (App Router) + Tailwind CSS + shadcn/ui + TanStack Query + Zustand
Auth: JWT access (15min) + refresh token rotation (7 days, SHA-256 hashed in DB)

Project Layout

backend/app/           FastAPI app (models, schemas, routers, crud, services)
backend/alembic/       Async migrations
backend/.venv/         Virtual env (use .venv/Scripts/python)
web/src/app/           Next.js App Router pages
web/src/lib/api/       Axios client + API modules (auth, championships, users)
web/src/store/         Zustand auth store
web/src/components/    Shared UI components
web/src/middleware.ts  Route protection
dancechamp-claude-code/ Target spec: SPEC.md, PLAN.md, DATABASE.md, DESIGN-SYSTEM.md, SCREENS.md

Gotchas

passlib + bcrypt 5.x incompatible — use bcrypt directly (NOT passlib)
Circular import: auth_service.py must NOT import crud_user
SQLAlchemy UUID: Use sqlalchemy.Uuid(as_uuid=True) not postgresql.UUID
Stale uvicorn: Kill with powershell.exe -NoProfile -Command "Get-Process python | Stop-Process -Force"
Web API URL: set NEXT_PUBLIC_API_URL in web/.env.local (default: http://localhost:8000/api/v1)

Test Credentials (run seed.py)

admin@pole.dev / Admin1234       (admin, approved)
organizer@pole.dev / Org1234     (organizer, approved)
member@pole.dev / Member1234     (member, approved)

API Routes

Auth: POST /api/v1/auth/{register,login,refresh,logout,me}
Championships: GET/POST/PATCH/DELETE /api/v1/championships
Registrations: POST/GET/PATCH/DELETE /api/v1/registrations
Users (admin): GET /api/v1/users, PATCH /api/v1/users/{id}/{approve,reject}
Health: GET /internal/health | Swagger: GET /docs

Code Conventions

Backend: Pydantic v2 schemas, async SQLAlchemy, from_attributes = True
Web: Functional components, TanStack Query for server state, Zustand for auth, shadcn/ui components
Registration: members auto-approved, organizers require admin approval

Environment

Windows 10, Python 3.12, Node.js
Docker NOT installed, PostgreSQL NOT installed (use SQLite for dev)
venv always in backend/.venv

Linear Workflow (MANDATORY)

Every action (coding, migrations, docs, planning, bug fixes) MUST have a Linear issue.

Before starting ANY task:

Check if a matching Linear issue exists in the "Pole dance app" workspace
If not — create one (title, description, priority)
Set status to In Progress before writing any code

After completing:

Set status to Done
Make a git commit with message: POL-N: <task title>
Report the issue number to the user (e.g. "Done — POL-42")

3.2 KiB Raw Blame History