qzl
e161ca22c4
- 删除冗余的 chat_history_repository 和 home_mock_data - 简化 ag_ui_event fromJson 使用工厂映射表 - 提取 ChatBloc 事件处理方法，添加 loadHistory/loadMoreHistory - HomeScreen 集成 ChatBloc 实现历史消息加载和下拉刷新 - 更新 AGENTS.md 文档约束
49 lines
1.6 KiB
Markdown
49 lines
1.6 KiB
Markdown
# Project Development Guide
|
|
|
|
This file serves as the entry point for project development, directing to appropriate constraint files based on development context.
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
social-app/
|
|
├── apps/ # Flutter mobile app
|
|
├── backend/ # FastAPI backend service
|
|
├── infra/ # Infrastructure (Docker, deployment scripts)
|
|
└── docs/ # Documentation and design/planning artifacts
|
|
```
|
|
|
|
## Rules Hierarchy
|
|
|
|
Follow this hierarchy when developing:
|
|
|
|
```
|
|
~/.config/opencode/AGENTS.md # Global core rules (skills, agents, process)
|
|
├── This file (root AGENTS.md) # Project-level entry
|
|
│ ├── backend/AGENTS.md # Backend-specific rules
|
|
│ └── apps/AGENTS.md # Frontend-specific rules
|
|
```
|
|
|
|
## Development Guidance
|
|
|
|
| Development Context | Follow Rules |
|
|
|--------------------|--------------|
|
|
| Backend Python dev | [backend/AGENTS.md](backend/AGENTS.md) |
|
|
| Flutter mobile dev | [apps/AGENTS.md](apps/AGENTS.md) |
|
|
| Infrastructure/ops | This file + infra/ directory conventions |
|
|
| API doc changes | Sync to `docs/runtime/runtime-route.md` |
|
|
|
|
## Git Workflow
|
|
|
|
- Default branch: `dev`
|
|
- Feature development: use worktree `git worktree add -b feature/xxx ../feature-xxx dev`
|
|
- Never develop directly on `main`
|
|
- **Never push to remote unless explicitly requested by user**
|
|
|
|
## Supabase Services
|
|
|
|
Project uses locally hosted Supabase for development.
|
|
|
|
- Docker config: `infra/docker/docker-compose.yml`
|
|
- Start services: `cd infra/docker && docker compose up -d`
|
|
- Stop services: `cd infra/docker && docker compose down`
|