---
description: 需求到交付的协作流程 —— 新增功能、修改代码、联调与自测时的执行顺序
globs: ["**/*"]
---

# 协作流程

## 接到需求后的执行顺序
1. **先确认契约**：与后端确认接口路径、请求/响应字段、分页结构、错误码；未确认前不得凭猜测写页面。
2. **先写类型**：在 `src/types/{module}/` 下定义 `Query / VO / Form`。
3. **再写 API**：`src/api/{module}/index.ts`。
4. **最后写页面**：列表 → 表单弹窗 → 详情（按需）。
5. **自测**：`pnpm type-check` 与 `pnpm lint` 必须通过；再手动走通「空数据 / 查询 / 新增 / 编辑 / 删除 / 无权限 / 接口报错」七条路径。

## 代码修改原则
- 修改前先读完整文件与相关调用方，禁止盲目整文件重写。
- 优先用局部小改动（ targeted edit ）解决；确需重构时先说明影响面。
- 不要顺手重构无关代码、不要调整无关格式、不要删除他人注释。
- 不要新增未被要求的功能、文档文件（README/md）或测试用例。

## 产出要求
- 生成的代码必须可直接运行：补齐 import、类型、路由注册、store 注册等所有必要接线。
- 新增页面必须在对应路由/菜单中注册，并保证能真实访问。
- 新增依赖需说明用途与体积影响，优先选择已在技术栈内的方案。

## 禁止事项
- 提交前遗留 `console.log`、调试代码、TODO 未处理项。
- 使用已废弃 API（Vue 2 写法、`$refs` 字符串、`filters`、Element UI 组件名）。
- 为了跑通而放宽类型、加 `any`、`@ts-ignore`、关闭 ESLint 规则。