添加个人信息编辑

.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 转换

.kiro/steering/项目结构说明.md

@@ -21,16 +21,21 @@ offerpie/back-end
 │           │   └─ FuncPermissionAspect.java  # 功能权限校验切面（拦截注解，校验+扣减+异常回退）
 │           ├─ controller/
 │           │   ├─ LoginController.java    # 登录相关接口（发送验证码、短信登录）
-│           │   └─ RouteMenuController.java # 路由菜单接口（获取用户有效菜单树）
+│           │   ├─ RouteMenuController.java # 路由菜单接口（获取用户有效菜单树）
+│           │   └─ UserProfileController.java # 用户个人资料接口（主表+5张子表的查询与保存）
 │           ├─ service/
 │           │   ├─ LoginService.java        # 登录业务逻辑（验证码校验、自动注册、JWT生成、Cookie设置）
 │           │   ├─ UserRegisterService.java # 用户注册服务（注册逻辑、邀请码生成与绑定）
 │           │   ├─ FuncPermissionService.java  # 功能权限服务（校验、扣减、查询、添加库存、回退）
 │           │   ├─ RouteMenuService.java    # 路由菜单服务（查询、添加库存、获取用户菜单树）
+│           │   ├─ UserProfileService.java  # 用户个人资料服务（主表+5张子表的CRUD）
 │           │   └─ WxPayNotifyMessageAbstractImpl.java  # 微信支付回调实现
 │           └─ pojo/
+│               ├─ param/
+│               │   └─ userProfile/        # 个人资料入参（UserProfileParam、各子表Param）
 │               ├─ dto/
-│               │   └─ SmsLoginDto.java    # 短信登录入参（mobileNumber + code + inviteCode）
+│               │   ├─ SmsLoginDto.java    # 短信登录入参（mobileNumber + code + inviteCode）
+│               │   └─ userProfile/        # 个人资料出参（UserProfileDto、各子表Dto）
 │               └─ vo/
 │                   ├─ LoginVo.java        # 登录返回（userId + nick）
 │                   └─ RouteMenuVo.java    # 路由菜单树形VO（含children子菜单）
@@ -113,7 +118,7 @@ offerpie/back-end
             │   │   ├─ UserProfileProject.java         # 用户项目经历表（bg_user_profile_project）
             │   │   ├─ UserProfileCompetition.java     # 用户竞赛经历表（bg_user_profile_competition）
             │   │   └─ AppJobData.java                # 爬虫岗位原始数据表（app_job_data）
-            │   └─ vo/               # ViewObject（OssUrlVo 等）
+            │   └─ vo/               # ViewObject（OssUrlVo、DescriptionParagraph 等）
             └─ service/               # 业务 Service（OssService、SmsService、DictCacheService、JobCleanService、JobCleanTransactionService、CompanyCleanService、CompanyCleanTransactionService 等）
 ```
 > **设计理念** – 业务实体和 Mapper 位于 `manager`，B 端和 C 端共享；C 端特有的注解、切面、权限服务、路由菜单服务位于 `client-api`，避免 B 端误用；`common` 提供统一的技术支撑。