每个分支各有一条独立轨道(轨道名即分支名,master/main 沿用历史名 release), 轨道类型 kind 只决定构建号行为:release 上架自增、feature 自测不自增。 - branch_track 映射分支 → 轨道名,新增分支自动建同名轨道 - 迁移:旧的共用 release / feature 轨按分支拆开并复制已用构建号, 拆完没有分支引用的旧共用轨直接删除;无自测分支时保留 feature 轨作模板 - 分支管理页的下拉只改轨道类型(是否自增),不再影响版本号归属 - 打包设置页按分支分块填写版本号 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BJaZ913U5GVdTkYHiRpvDU
1.8 KiB
1.8 KiB
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, tasksbackend/services/— build_service (packaging), build_queue (async queue), log_streamer (WebSocket)backend/deps.py— JWT auth dependency used by all protected routesbackend/config.py— loads .env, defines all config constantsfrontend/src/views/— BuildView, HistoryView, ConfigViewconfig.json— runtime config (apps, schemes, servers, upload, branches, versions) managed via web UI- Versions are per-branch: every branch owns a track in
config["versions"]["tracks"], named after the branch (master/main keeps the historical namerelease);config["branch_track"]maps branch → track name, and each track'skindisrelease(build number auto-increments on App_Store) orfeature(never increments)
Conventions
- All backend routes require JWT auth except
/api/auth/loginand/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), SQLitebuild_configtable (build settings) - Chinese UI and documentation throughout