diff --git a/.kiro/steering/项目结构说明.md b/.kiro/steering/项目结构说明.md index 61453ac..a590fcf 100644 --- a/.kiro/steering/项目结构说明.md +++ b/.kiro/steering/项目结构说明.md @@ -73,14 +73,17 @@ offerpie_python_ai/ │ └─ snowflake.py # 雪花 ID 生成工具(next_id) │ ├─ schemas/ # **Schema 层**(Pydantic 请求/响应/缓存模型) - │ ├─ skill_gap.py # 技能差距分析 Schema(SkillGapParam、CustomizeResumeParam、AiEditParam、CustomizeResume 等) + │ ├─ skill_gap.py # 技能差距分析 Schema(SkillGapParam、CustomizeResumeParam、AiEditParam) + │ ├─ customize_resume.py # 定制简历 Schema(CustomizeResume、ResumeProfile、Education、Work、Internship、Project、Competition、Paragraph) │ └─ job_agent_chat.py # 求职助手对话 Schema(JobAgentChatParam、JobAgentChatDto、ToolParams) │ └─ services/ # **业务逻辑层** ├─ func_permission_service.py # 功能权限服务(校验+扣减+回退,逻辑与Java端一致) ├─ resume_parse_service.py # 简历解析服务(文件解析→AI结构化→写入主表+5张子表) ├─ resume_diagnose_service.py # 简历诊断服务(加载简历→AI并行诊断→统计评级→写入报告) - ├─ skill_gap_service.py # 技能差距分析服务(差距分析→定制简历生成/查询/编辑/回滚→AI对话编辑) + ├─ skill_gap_service.py # 技能差距分析服务(差距分析→定制简历生成→AI对话编辑) + ├─ resume_loader.py # 简历统一查询模块(按ID查/自动选默认+5张子表,返回 ResumeDetail dataclass) + ├─ customize_resume_store.py # 定制简历 Redis 存取模块(保存自动回滚备份、查询、回滚) └─ job_agent_chat_service.py # 求职助手对话服务(查简历→序列化→调AI模块完成对话) ``` @@ -93,7 +96,7 @@ offerpie_python_ai/ | **api** | REST API 路由定义 | `health.py`(健康检查)、`resume.py`(简历上传解析)、`resume_diagnose.py`(简历诊断)、`skill_gap.py`(技能差距分析 + 定制简历)、`job_agent_chat.py`(求职助手对话) | | **models** | SQLAlchemy ORM 模型,与 Java 端共享同一数据库 | `FuncPermission`、`UserFuncPermissionStock`、`UserFuncUsageLog`、`UserResume`、`UserResumeEducation`/`Work`/`Internship`/`Project`/`Competition`、`ResumeDiagnosisReport`、`ResumeDiagnosisIssue`、`Job`(只读)、`JobAgentConfig` | | **tool** | 无状态通用工具,不依赖数据库/Redis/用户上下文 | `file_parser.py`(PDF/Word/TXT 文件解析为纯文本)、`json_helper.py`(AI 输出 JSON 解析,去 markdown 代码块 + json_repair 容错)、`snowflake.py`(雪花ID生成) | -| **services** | 业务逻辑实现 | `FuncPermissionService`(功能权限校验、扣减、回退)、`ResumeParseService`(简历文件解析→AI结构化→入库)、`ResumeDiagnoseService`(简历诊断→AI并行分析→评级→入库)、`SkillGapService`(技能差距分析→定制简历生成/查询/编辑/回滚→AI对话编辑(原子化操作:delete直接删/update按记录并发/add并发生成))、`JobAgentChatService`(求职助手对话→查简历→调AI模块) | +| **services** | 业务逻辑实现 | `FuncPermissionService`(功能权限校验、扣减、回退)、`ResumeParseService`(简历文件解析→AI结构化→入库)、`ResumeDiagnoseService`(简历诊断→AI并行分析→评级→入库)、`SkillGapService`(技能差距分析→定制简历生成→AI对话编辑)、`resume_loader`(简历统一查询,返回ResumeDetail)、`customize_resume_store`(定制简历Redis存取,自动回滚备份)、`JobAgentChatService`(求职助手对话→查简历→调AI模块) | ## 3️⃣ 技术栈 | 类别 | 技术选型 | 说明 |