20260730231110

code/fms/开发规范.md

@@ -29,11 +29,14 @@
 - [NEVER] 修改通用接口的 URL、参数、返回值结构或处理逻辑。
 - [MUST] 如通用接口确实无法满足需求：先说明原因 + 拟修改内容 + 影响范围，取得用户确认后再实施。
 - [MUST] `bigint` 类型（如 `b_id`）序列化到前端时必须转为**字符串**。
+- [MUST] 通用查询默认**不传 `search_columns` / `searchColumns`**；除非明确需要限制返回字段且已确认字段存在，否则采用接口默认返回。
+- [MUST] `config/dbconfigs` 中的旧库仅用于参考表结构、历史数据和差异排查；除非用户明确指定，不修改旧库结构或数据。
 
 ## 4. 前端实现
 
 - [MUST] 表格使用项目封装的 **`fms-table`** 组件，不从零实现表格。
-- [MUST] 表单输入控件**不添加 `placeholder`**，用 `label` 或说明文字表达意图。
+- [MUST] 表单输入控件**不添加 `placeholder`**，`label` 只写字段名称，不追加“留空则...”这类操作提示信息。
+- [MUST] 使用 **`FmsTree`** 时不设置 `root-title`，根节点标题由组件内部统一维护。
 - [MUST] 优先复用项目现有组件和 Antdv Next 组件能力，不重复造轮子。
 - [SHOULD] 页面中出现 ≥2 处相同/相近功能时，提取为可复用组件、composable 或 service 方法。
 - [SHOULD] 抽取复用以确有收益为前提，不为简单逻辑增加无意义的封装。