1

2025-11-24 13:23:42 +08:00
commit 5d7444cd65
156 changed files with 50653 additions and 0 deletions
--- a/_doc/简历功能使用前置条件.md
+++ b/_doc/简历功能使用前置条件.md
@@ -0,0 +1,239 @@
+# 简历存储功能 - 前置条件和使用说明
+
+## ⚠️ 重要前置条件
+
+在使用简历存储功能之前，必须确保以下条件已满足：
+
+### 1. 数据库表已创建
+
+#### ✅ `pla_account` 表（平台账户表）
+
+此表存储设备与平台账户的绑定关系，**必须先有记录**才能存储简历。
+
+**表结构**:
+```sql
+CREATE TABLE `pla_account` (
+  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '自增ID',
+  `name` varchar(50) NOT NULL DEFAULT '' COMMENT '账户名',
+  `sn_code` varchar(50) NOT NULL DEFAULT '' COMMENT '设备SN码',
+  `platform_type` varchar(50) NOT NULL DEFAULT '' COMMENT '平台类型(boss/liepin)',
+  `login_name` varchar(50) NOT NULL DEFAULT '' COMMENT '登录名',
+  `pwd` varchar(50) NOT NULL DEFAULT '' COMMENT '密码',
+  `keyword` varchar(50) NOT NULL DEFAULT '' COMMENT '关键词',
+  `search_url` varchar(50) NOT NULL DEFAULT '' COMMENT '搜索页网址',
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+```
+
+**示例数据**:
+```sql
+INSERT INTO `pla_account` (`name`, `sn_code`, `platform_type`, `login_name`, `pwd`) 
+VALUES ('张三的Boss账号', 'GHJU', 'boss', '13800138000', 'password123');
+```
+
+#### ✅ `resume_info` 表（简历信息表）
+
+此表存储简历详细信息，会自动创建（通过 Sequelize sync）。
+
+**关键字段**:
+- `id` - 简历UUID（主键）
+- `sn_code` - 设备SN码（关联设备）
+- `account_id` - 账户ID（**关联 pla_account.id**）
+- `platform` - 平台类型（boss/liepin）
+
+### 2. 数据关联关系
+
+```
+┌─────────────────┐         ┌──────────────────┐
+│  pla_account    │         │   resume_info    │
+├─────────────────┤         ├──────────────────┤
+│ id (自增)       │◄────────│ account_id       │
+│ sn_code         │         │ sn_code          │
+│ platform_type   │         │ platform         │
+│ login_name      │         │ fullName         │
+│ pwd             │         │ ...              │
+└─────────────────┘         └──────────────────┘
+```
+
+**查询逻辑**:
+1. 通过 `sn_code` + `platform` 查询 `pla_account` 表
+2. 获取 `pla_account.id` 作为 `account_id`
+3. 将 `account_id` 存入 `resume_info` 表
+
+### 3. 环境配置
+
+#### 数据库连接
+确保数据库连接配置正确（`config/config.js`）
+
+#### AI服务配置（可选）
+如需AI分析功能，需配置 DeepSeek API：
+
+```env
+DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxx
+DEEPSEEK_API_URL=https://api.deepseek.com/v1/chat/completions
+DEEPSEEK_MODEL=deepseek-chat
+```
+
+## 🚀 使用流程
+
+### 步骤1: 创建平台账户记录
+
+在调用简历存储功能之前，必须先在 `pla_account` 表中创建账户记录：
+
+```javascript
+const db = require('./api/middleware/dbProxy');
+const pla_account = db.getModel('pla_account');
+
+// 创建账户记录
+await pla_account.create({
+    name: '张三的Boss账号',
+    sn_code: 'GHJU',
+    platform_type: 'boss',
+    login_name: '13800138000',
+    pwd: 'password123',
+    keyword: '前端工程师',
+    search_url: 'https://www.zhipin.com/web/geek/job'
+});
+```
+
+### 步骤2: 同步数据库表结构
+
+运行同步脚本确保表结构正确：
+
+```bash
+node scripts/sync_resume_table.js
+```
+
+### 步骤3: 调用简历存储功能
+
+```javascript
+const jobManager = require('./api/middleware/job/jobManager');
+
+// 获取在线简历（自动存储）
+const resumeData = await jobManager.get_online_resume(
+    'GHJU',              // 设备SN码（必须在 pla_account 中存在）
+    mqttClient,          // MQTT客户端
+    { platform: 'boss' } // 平台类型（必须与 pla_account.platform_type 匹配）
+);
+```
+
+## ❌ 常见错误
+
+### 错误1: "未找到设备 GHJU 在平台 boss 的账户信息"
+
+**原因**: `pla_account` 表中没有对应的记录
+
+**解决方案**:
+```javascript
+// 检查是否存在账户记录
+const account = await pla_account.findOne({
+    where: { sn_code: 'GHJU', platform_type: 'boss' }
+});
+
+if (!account) {
+    // 创建账户记录
+    await pla_account.create({
+        name: '账户名称',
+        sn_code: 'GHJU',
+        platform_type: 'boss',
+        login_name: '登录名',
+        pwd: '密码'
+    });
+}
+```
+
+### 错误2: "Unknown column 'sn_code' in 'field list'"
+
+**原因**: 数据库表结构未同步
+
+**解决方案**:
+```bash
+# 运行同步脚本
+node scripts/sync_resume_table.js
+
+# 或手动执行SQL
+ALTER TABLE `resume_info` 
+ADD COLUMN `sn_code` VARCHAR(50) NOT NULL DEFAULT '' COMMENT '设备SN码',
+ADD COLUMN `account_id` VARCHAR(50) NOT NULL DEFAULT '' COMMENT '用户ID';
+```
+
+### 错误3: "account_id 不能为空"
+
+**原因**: `pla_account` 查询失败或返回 null
+
+**解决方案**:
+1. 确认 `sn_code` 和 `platform_type` 匹配
+2. 检查 `pla_account` 表中是否有对应记录
+3. 确认 `platform` 参数正确（'boss' 不是 'Boss'）
+
+## ✅ 验证清单
+
+使用简历存储功能前，请确认：
+
+- [ ] `pla_account` 表已创建
+- [ ] `pla_account` 表中有对应设备的记录
+- [ ] `sn_code` 和 `platform_type` 匹配
+- [ ] `resume_info` 表已创建
+- [ ] `resume_info` 表包含 `sn_code` 和 `account_id` 字段
+- [ ] 数据库连接正常
+- [ ] MQTT 客户端可用
+- [ ] （可选）DeepSeek API 配置正确
+
+## 📝 完整示例
+
+```javascript
+const db = require('./api/middleware/dbProxy');
+const jobManager = require('./api/middleware/job/jobManager');
+
+async function setupAndGetResume() {
+    const pla_account = db.getModel('pla_account');
+    
+    // 1. 检查或创建账户记录
+    let account = await pla_account.findOne({
+        where: { sn_code: 'GHJU', platform_type: 'boss' }
+    });
+    
+    if (!account) {
+        console.log('创建账户记录...');
+        account = await pla_account.create({
+            name: '测试账号',
+            sn_code: 'GHJU',
+            platform_type: 'boss',
+            login_name: '13800138000',
+            pwd: 'password123'
+        });
+        console.log('账户创建成功，ID:', account.id);
+    } else {
+        console.log('账户已存在，ID:', account.id);
+    }
+    
+    // 2. 获取简历（自动存储）
+    console.log('获取在线简历...');
+    const resumeData = await jobManager.get_online_resume(
+        'GHJU',
+        mqttClient,
+        { platform: 'boss' }
+    );
+    
+    console.log('简历获取成功！');
+    console.log('姓名:', resumeData.baseInfo?.name);
+    
+    // 3. 验证存储结果
+    const resume_info = db.getModel('resume_info');
+    const savedResume = await resume_info.findOne({
+        where: { sn_code: 'GHJU', platform: 'boss', isActive: true }
+    });
+    
+    console.log('简历已保存，ID:', savedResume.id);
+    console.log('关联账户ID:', savedResume.account_id);
+    console.log('竞争力评分:', savedResume.aiCompetitiveness);
+}
+```
+
+## 🔗 相关文档
+
+- 详细功能说明: `_doc/简历存储和分析功能说明.md`
+- 数据库同步指南: `_doc/数据库表同步指南.md`
+- 快速参考: `_doc/简历功能快速参考.md`
+- 示例代码: `examples/resume_storage_example.js`
+