# 智能招聘助手 / HR助手
## 智聘通招聘系统 v0.1

**项目别名：**
- 智能招聘助手
- HR助手
- 智聘通
- HR智能系统

**版本号：** v0.1（初始版本）

**创建日期：** 2026年3月4日

---

## 📋 项目概述

微智电子内部人事招聘管理系统，实现面试登记、MBTI性格测试、简历生成、数据统计等全流程数字化管理。

---

## 🎯 核心功能

### 1. 面试登记（前台）
- ✅ 公司介绍展示（微智电子品牌展示）
- ✅ 基本信息填写（姓名、性别、年龄、电话、邮箱、地址）
- ✅ 照片上传（现场拍摄或相册选择）
- ✅ 家庭情况（婚姻状况、紧急联系人）
- ✅ 教育经历（学历、学校、专业）
- ✅ 求职信息（岗位、工作年限、薪资期望、上家公司）
- ✅ 个人优势/工作经历描述

### 2. MBTI性格测试
- ✅ 30道精选题目（从200道题库筛选）
- ✅ 4维度性格分析（E-I、S-N、T-F、J-P）
- ✅ 16种人格类型判定
- ✅ 性格优势展示（只显示优点）
- ✅ 适合工作方向建议

### 3. 电子简历
- ✅ 自动展示登记信息
- ✅ 照片显示
- ✅ 唯一候选人编号（如 ZS202403040001）
- ✅ MBTI测试结果展示
- ✅ 支持打印

### 4. 后台管理
- ✅ 实时数据统计（总人数、待面试、今日新增、本周新增）
- ✅ 候选人列表（支持搜索、筛选）
- ✅ 数据导出Excel
- ✅ 合并显示（服务器+本地数据）

---

## 🛠 技术架构

### 前端
- HTML5 + CSS3 + JavaScript
- 响应式设计（支持手机/电脑）
- 纯前端实现，无需编译

### 后端
- Node.js + HTTP模块
- MySQL 5.7 数据库
- RESTful API设计

### 数据库
- **主数据库：** MySQL 5.7 @ 10.1.4.4:3306
  - 数据库名：zhipintong
  - 表：candidates
- **备用存储：** 浏览器 localStorage
  - 用于手机端离线保存
  - 自动与服务器数据合并

---

## 📁 文件结构

```
/usr/share/nginx/html/tools/recruitment_v2/
├── index.html          # 公司介绍 + 登记表单
├── mbti.html          # MBTI性格测试（30道题）
├── resume.html        # 电子简历展示
├── admin.html         # 后台管理
├── api-config.js      # API配置（前端）
└── api/
    ├── server.js      # Node.js后端服务
    ├── package.json   # npm配置
    └── ...            # 依赖模块
```

---

## 🌐 访问地址

| 页面 | 链接 |
|------|------|
| **面试登记** | http://118.126.91.196/tools/recruitment_v2/index.html |
| **后台管理** | http://118.126.91.196/tools/recruitment_v2/admin.html |
| **API服务** | http://118.126.91.196:3002 |

---

## 💾 数据库配置

```javascript
const DB_CONFIG = {
    host: '10.1.4.4',
    port: 3306,
    user: 'root',
    password: 'Ms19880219',
    database: 'zhipintong'
};
```

### 表结构
candidates 表字段：
- id (VARCHAR 20) - 候选人唯一编号
- name, gender, age, phone, email - 基本信息
- photo (LONGTEXT) - 照片Base64
- address - 居住地址
- marriage, emergency_name, emergency_phone, emergency_relation - 家庭情况
- education, school, major - 教育经历
- position, work_years, salary, last_company - 求职信息
- advantage, work_experience - 个人描述
- mbti_type, mbti_name, mbti_strengths, mbti_jobs - MBTI结果
- status - 面试状态
- create_time, update_time - 时间戳

---

## 📱 使用流程

```
面试者扫码/访问
    ↓
查看公司介绍（微智电子品牌展示）
    ↓
向下滚动开始登记
    ↓
填写个人信息（带*必填）+ 上传照片
    ↓
提交 → 跳转MBTI测试
    ↓
完成30道性格测试题
    ↓
查看性格分析结果（可截图保存）
    ↓
查看电子简历
    ↓
确认提交 / 修改信息
    ↓
数据保存到MySQL + 本地存储
    ↓
HR后台查看所有数据
```

---

## 🚀 后续开发计划

### v0.2 计划功能
- [ ] 公司介绍视频/PPT自动播放
- [ ] 面试题目库（按岗位定制）
- [ ] 短信通知（提交后自动发送）
- [ ] 数据权限管理（不同HR看不同数据）
- [ ] 面试评价功能

### v0.3 计划功能
- [ ] 二维码生成（每个人唯一二维码）
- [ ] 礼品领取确认
- [ ] 数据统计图表可视化
- [ ] 导出PDF简历
- [ ] 微信扫码直接访问

### v1.0 完整功能
- [ ] 完整的招聘流程管理
- [ ] 多角色权限（管理员/HR/面试官）
- [ ] 面试预约系统
- [ ] Offer管理
- [ ] 入职流程跟踪

---

## 📝 开发记录

**v0.1 已完成（2026-03-04）**
- ✅ 基础登记系统
- ✅ MBTI测试（30题）
- ✅ 电子简历生成
- ✅ 后台管理
- ✅ MySQL数据库集成
- ✅ 手机/电脑双端支持

**已知问题**
- 手机端网络不稳定时可能提示失败（已自动保存到本地）
- 照片上传较大时可能超时

**优化建议**
- 后续添加照片压缩功能
- 添加离线提交队列，网络恢复后自动同步
- 添加数据备份机制

---

## 👥 项目成员

- **产品经理：** 李茂林
- **技术对接：** AI开发助手
- **使用部门：** 人事部（周丽华）

---

## 📞 联系方式

如有问题，请联系技术部门或查看服务器日志。

---

**备份路径：** `/root/.openclaw/workspace/versions/智能招聘助手_v0.1/`

**备份日期：** 2026年3月4日
