添加个人信息编辑

.kiro/steering/代码开发风格文档.md

@@ -70,10 +70,10 @@ inclusion: manual
 
 ## POJO 规范
 
-- DTO：入参对象 + 校验注解，放在 `pojo/dto/{功能模块}/` 下，功能模块一般是对应 Service 类名的简写，如 `pojo/dto/login/SmsLoginDto.java`
-- VO：出参对象，放在 `pojo/vo/` 下，如 `pojo/vo/LoginVo.java`
+- Param：入参对象 + 校验注解，放在 `pojo/param/{功能模块}/` 下，功能模块一般是对应 Service 类名的简写，如 `pojo/param/login/SmsLoginParam.java`
+- DTO：出参对象（接口返回给前端的数据），放在 `pojo/dto/{功能模块}/` 下，如 `pojo/dto/login/SmsLoginDto.java`
+- VO：多场景共享的复合对象，放在 `pojo/vo/` 下，如 `pojo/vo/RouteMenuVo.java`
 - PO：对应数据库表字段，统一放在 `manager` 模块的 `pojo/po/` 下
-- Param：查询参数对象，放在 `pojo/param/{功能模块}/` 下
 
 ## 获取当前登录用户
 
@@ -118,4 +118,11 @@ inclusion: manual
 - PO 类加 `@TableName(value = "bg_xxx")`，主键加 `@TableId(type = IdType.ASSIGN_ID)`
 - 查询使用 `LambdaQueryWrapper` 构建条件，避免硬编码字段名
 - 简单的 CRUD 直接使用 MyBatis-Plus 的 `BaseMapper` 方法和 `LambdaQueryWrapper`，只有复杂查询（多表关联、子查询等）才写 Mapper XML SQL
-- Mapper 接口继承 `BaseMapper<T>`
+- Mapper 接口继承 `BaseMapper<T>`
+
+### JSON 字段规范
+- 数据库中存储 JSON 的字段，PO 中必须使用对应的 Java 类型（`List<String>`、`List<Long>`、`List<XxxObject>` 等），不使用 `String`
+- 通过 MyBatis-Plus 的 `@TableField(typeHandler = JacksonTypeHandler.class)` 注解实现自动序列化/反序列化
+- 含有 TypeHandler 字段的 PO，`@TableName` 必须加 `autoResultMap = true`，如 `@TableName(value = "bg_xxx", autoResultMap = true)`
+- JSON 数组存简单值用 `List<String>` 或 `List<Long>`，存复杂结构则抽象为独立的 VO 类（如 `DescriptionParagraph`），放在 `manager/pojo/vo/` 下
+- Param 和 Dto 中对应字段直接使用相同的 Java 类型，Controller 层通过 `BeanUtils.copyProperties` 直接拷贝，不做手动 JSON 转换