iOSBuildServer/CLAUDE.md

iOS Build Server

FastAPI + Vue 3 iOS app auto-packaging service. Supports Ad_Hoc and App_Store builds with web UI, real-time logs, multi-user auth, and health monitoring.

Tech Stack

• Backend: Python 3.9+, FastAPI, SQLAlchemy (SQLite), JWT auth
• Frontend: Vue 3, Vite, Vue Router
• Tests: pytest (backend), vitest (frontend)
• Deploy: macOS launchd, deploy.sh management script

Key Commands

./start.sh              # Dev mode (backend + frontend hot reload)
./deploy.sh build       # Install deps + build frontend
./deploy.sh start/stop/restart/status
./deploy.sh test        # Run all tests (backend + frontend)

Architecture

• backend/routers/ — API routes: auth, users, config, apps, tasks
• backend/services/ — build_service (packaging), build_queue (async queue), log_streamer (WebSocket)
• backend/deps.py — JWT auth dependency used by all protected routes
• backend/config.py — loads .env, defines all config constants
• frontend/src/views/ — BuildView, HistoryView, ConfigView
• config.json — runtime config (apps, schemes, servers, upload, branches, versions) managed via web UI
• Versions are per-track: each release branch has its own track (master/main keeps the historical release track, others are named after the branch, e.g. develop; build number auto-increments on App_Store), and all self-test branches share the feature track (never increments); each branch's track name lives in config["branch_track"], track records in config["versions"]["tracks"] carry kind (release/feature)

Conventions

• All backend routes require JWT auth except /api/auth/login and /api/health
• Admin-only routes: user management (/api/users/*) and all of /api/config/* except /api/config/apps*
• Config stored in config.json (apps/schemes/servers), .env (infra), SQLite build_config table (build settings)
• Chinese UI and documentation throughout