chore: sync current workspace to dev

This commit is contained in:
qzl
2026-02-24 18:18:42 +08:00
parent 105cf82d21
commit 08571cfc95
79 changed files with 1899 additions and 844 deletions
+18 -10
View File
@@ -1,19 +1,27 @@
## 目录结构
## Repository Structure
- `infra/`: 基础设施与运维(Docker、脚本、部署相关)
- `backend/`: FastAPI 后端
- `apps/`: Flutter 手机端
- `docs/`: 文档与方案
- `infra/`: Infrastructure and operations (Docker, scripts, deployment).
- `backend/`: FastAPI backend.
- `apps/`: Flutter mobile app.
- `docs/`: Documentation and design/planning artifacts.
## Agent 规则分层
## Rules Hierarchy
- 根目录 `AGENTS.md` 为通用规则,所有修改均需遵守
- 编辑 `backend/` 目录时,必须同时遵守 `backend/AGENTS.md`
- 编辑 `apps/` 目录时,必须同时遵守 `apps/AGENTS.md`
- This root `AGENTS.md` defines global rules and applies to all changes.
- When editing `backend/`, you must also follow `backend/AGENTS.md`.
- When editing `apps/`, you must also follow `apps/AGENTS.md`.
## Docker 启动
## Docker Startup
Always start services with the env file:
```bash
docker compose --env-file .env -f infra/docker/docker-compose.yml up -d
```
## Git Branch and Worktree Policy
- Use `dev` as the default base branch for day-to-day development.
- New development worktrees must be created from `dev` (never from `main`).
- Do not develop or commit directly on `main` outside explicit release/merge workflows.
- Do not rewrite `main` history unless explicitly requested (including reset and force push).