用函子Zion写需求时必须显式列出数据表字段,因其直接生成DTO、SQL和校验规则;字段缺失会导致ORM映射失败、API返回null或代码生成中断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用函子Zion写需求时,必须把数据表字段列进去,否则开发无法准确映射业务逻辑到数据库结构,字段缺失会导致接口返回空值、查询报错或数据写入失败。
为什么字段必须显式列出
函子Zion不是纯文本需求文档工具,它会将字段名直接生成为后端DTO字段、SQL查询列和校验规则。比如需求中写“用户需查看订单金额”,若不注明字段是order_amount还是total_price,Zion默认按驼峰规则生成orderAmount,但数据库实际字段可能是amt,此时ORM层映射失败,API返回null。
字段未声明还会触发Zion的强约束检查:当检测到业务描述中出现“状态”“时间”“编号”等关键词,而字段列表里无对应列(如status、create_time、order_no),Zion会中断代码生成并报错【字段引用未声明】。
字段怎么列才符合Zion规范
方法一:在需求正文内嵌字段定义块
在业务描述段落末尾,用三个反引号包裹字段表,列名必须与数据库物理字段完全一致(含大小写、下划线):
```
字段 | 类型 | 说明
---|---|---
user_id | BIGINT | 用户唯一标识,主键
nick_name | VARCHAR(50) | 昵称,允许为空
is_vip | TINYINT | 是否VIP,1=是,0=否
```
方法二:单独挂载字段清单附件
上传一个CSV文件,首行为field_name,data_type,description,内容必须UTF-8无BOM编码。Zion只读取第一张Sheet,且跳过空行和注释行(以#开头)。注意:CSV中字段名若含空格或特殊字符,Zion会直接拒绝解析。
方法三:关联已有数据库元数据
在Zion项目设置页点击「绑定数据源」→选择已配置的MySQL/PostgreSQL实例→输入库名→勾选目标表→点击同步。Zion会自动拉取information_schema.COLUMNS中的COLUMN_NAME、DATA_TYPE、COLUMN_COMMENT,并标记IS_NULLABLE为必填/可选。这一步操作起来很简单,直接把表名输进去就行。
字段列出来之后要做什么
第一步:核对字段是否覆盖所有业务动词涉及的数据点
逐句扫描需求文本,找出所有带“显示”“筛选”“校验”“更新”“导出”的句子,确保每个动词后面的对象都有对应字段。例如“支持按下单时间范围筛选”→必须有created_at字段;“导出含优惠券抵扣金额的明细”→必须有coupon_deduction字段。漏掉任一字段,Zion生成的SQL WHERE子句就会缺条件。
第二步:确认字段类型与业务语义匹配
比如“手机号”字段不能写phone VARCHAR(20)就完事,要检查Zion是否识别为敏感字段——只有标注phone STRING @sensitive,才会自动启用脱敏策略;同理,“金额”字段必须声明为amount DECIMAL(12,2),若写成FLOAT,Zion会在生成Java代码时抛出精度警告。
第三步:为多值字段添加约束说明
遇到JSON字段(如ext_info JSON)、逗号分隔字符串(如tag_list VARCHAR(255)),必须在说明栏写清结构。例如:ext_info JSON @structure={"address":"string","points":"int"}。否则Zion无法生成对应的Java Record类,编译直接失败。











