跟新项目文档

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

@@ -41,16 +41,18 @@ offerpie_python_ai/
     │   ├─ skill_gap_analyzer/    # 技能差距分析 + 定制简历 AI 模块
     │   │   ├─ prompts.py             # 差距分析 + 简历优化 + Agent 规划（原子化操作）/ 单条记录修改 / 新增记录 Prompt 模板 + MODULE_SCHEMAS
     │   │   └─ analyzer.py            # AI 调用逻辑（差距分析 + summary优化 + 经历优化 + Agent规划 + 单条记录修改 + 新增记录）
-    │   └─ job_agent/             # 求职助手 Agent 对话 AI 模块
-    │       ├─ prompts.py             # 对话 System Prompt 模板
-    │       └─ chat.py                # AI 对话引擎（构造 prompt + 拼 messages + 调 LLM + 解析返回）
+    │   └─ job_agent/             # 求职助手 Agent AI 模块
+    │       ├─ prompts.py             # 对话 System Prompt + 岗位简历优化 Prompt 模板
+    │       ├─ chat.py                # AI 对话引擎（构造 prompt + 拼 messages + 调 LLM + 解析返回）
+    │       └─ resume_optimizer.py    # 岗位简历优化 AI 引擎（summary优化 + 经历优化，独立 chain）
     │
     ├─ api/                       # **路由层**（REST API 接口）
     │   ├─ health.py              # 健康检查接口 GET /health/
     │   ├─ resume.py              # 简历接口 POST /resume/upload（上传文件AI解析）
     │   ├─ resume_diagnose.py     # 简历诊断接口（POST 触发诊断 / GET 查询报告 / PUT 标记处理+用户评价 / POST 润色优化）
-    │   ├─ skill_gap.py           # 技能差距分析 + 定制简历接口（差距分析 / 生成定制简历 / 查询 / 编辑 / 回滚 / AI对话编辑）
-    │   └─ job_agent_chat.py      # 求职助手对话接口 POST /job-agent/chat
+    │   ├─ skill_gap.py           # 技能差距分析接口（差距分析 / 生成定制简历 / AI对话编辑）
+    │   ├─ customize_resume.py    # 定制简历接口（查询 / 修改 / 回滚）
+    │   └─ job_agent_chat.py      # 求职助手接口（POST /job-agent/chat 对话、POST /job-agent/optimize-resume 岗位简历优化）
     │
     ├─ models/                    # **ORM 模型层**（SQLAlchemy 声明式映射）
     │   ├─ func_permission.py             # 功能权限定义表（bg_func_permission）
@@ -92,11 +94,11 @@ offerpie_python_ai/
 |------|----------|-------------|
 | **config** | 统一配置管理，基于 Pydantic Settings，支持 .env 文件加载 | `Settings`（数据库、Redis、LLM供应商、JWT、CORS、日志等全部配置项） |
 | **core** | 核心基础设施：数据库连接、Redis连接、鉴权、日志、中间件、异常处理、统一响应 | `database.py`、`redis.py`、`auth.py`、`middleware.py`、`exceptions.py`、`logger.py`、`StandardResponse` |
-| **ai** | AI 模型管理 + 业务 AI 能力 | `LLM` 枚举、`resume_extractor/`（简历并行提取）、`resume_diagnoser/`（简历诊断）、`skill_gap_analyzer/`（技能差距分析 + 定制简历优化 + Agent 原子化规划 + 单条记录修改/新增）、`job_agent/`（求职助手对话） |
-| **api** | REST API 路由定义 | `health.py`（健康检查）、`resume.py`（简历上传解析）、`resume_diagnose.py`（简历诊断）、`skill_gap.py`（技能差距分析 + 定制简历）、`job_agent_chat.py`（求职助手对话） |
+| **ai** | AI 模型管理 + 业务 AI 能力 | `LLM` 枚举、`resume_extractor/`（简历并行提取）、`resume_diagnoser/`（简历诊断）、`skill_gap_analyzer/`（技能差距分析 + 定制简历优化 + Agent 原子化规划 + 单条记录修改/新增）、`job_agent/`（求职助手对话 + 岗位简历优化） |
+| **api** | REST API 路由定义 | `health.py`（健康检查）、`resume.py`（简历上传解析）、`resume_diagnose.py`（简历诊断）、`skill_gap.py`（技能差距分析 + 生成定制简历 + AI对话编辑）、`customize_resume.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对话编辑）、`resume_loader`（简历统一查询，返回ResumeDetail）、`customize_resume_store`（定制简历Redis存取，自动回滚备份）、`JobAgentChatService`（求职助手对话→查简历→调AI模块） |
+| **services** | 业务逻辑实现 | `FuncPermissionService`（功能权限校验、扣减、回退）、`ResumeParseService`（简历文件解析→AI结构化→入库）、`ResumeDiagnoseService`（简历诊断→AI并行分析→评级→入库）、`SkillGapService`（技能差距分析→定制简历生成→AI对话编辑）、`resume_loader`（简历统一查询，返回ResumeDetail）、`customize_resume_store`（定制简历Redis存取+数据构建，自动回滚备份）、`JobAgentChatService`（求职助手对话+岗位简历优化） |
 
 ## 3️⃣ 技术栈
 | 类别 | 技术选型 | 说明 |