Files
brapi-java/AGENTS.md
2026-05-28 17:25:32 +08:00

28 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

1.尽量不要动brapi自己写好的java代码不要改路径接口定义返回值
2.一般我只会让你加前端,或者加一些删除等简单的后端接口,千万不要破坏原接口的路径,入参定义,出参定义。
3.下拉框的数据要缓存下来,同一选项源不要重复请求接口。
4.前端首页(及同类入口页)加载首页数据时,副作用只触发一次查询,避免 Strict Mode 或重复 mount 导致多次请求。
5.保存、提交类操作要做防抖debounce防止连续点击重复提交。
6.每完成一份 `docs/dev/**` 下的开发文档对应功能(页面、接口、校验等与文档要求一致)后,在该文档末尾追加完成标注,格式如下:
```markdown
---
**状态:已完成**
```
- 仅在该文档描述的功能全部落地时标注;部分实现(如仅后端、缺页面或缺校验)不要标注。
- 若文档末尾已有「状态:已完成」,不要重复追加。
- `docs/dev/**/README.md` 等索引/说明类文档无需标注。
7.`docs/dev` 目录按编号对应「章」的口语称呼,沟通时按此理解:
| 口语 | 目录 |
| --- | --- |
| 第一章 | `docs/dev/01-core` |
| 第二章 | `docs/dev/02-germplasm-seed` |
| 第三章 | `docs/dev/03-genotyping` |
| 第四章 | `docs/dev/04-germplasm` |
- 用户说「开发第一章 / 做第一章 xxx」即指 `01-core` 下对应文档与功能;第二、三、四章同理。
- `docs/dev/backend` 等其它子目录不适用「第 X 章」称呼,需按具体路径理解。
- **第二、四章重叠表**:若第二章已实现,第四章对应文档可标注「与第二章共用实现」,无需重复开发。