# 智定AI v2.0 - 新功能设计方案

> 基于姜哥 5/14 新增需求整理
> 文档名：智定AI网页开发——open claw

---

## 一、工程师技术认证体系

### 功能设计

```
┌─────────────────────────────────────────────┐
│             工程师个人中心                        │
├─────────────────────────────────────────────┤
│   📋 基本信息                                │
│   ├── 头像 / 昵称 / 联系方式                    │
│   ├── 擅长任务描述（自由文本）                    │
│   └── 技能标签（多选：AI Agent/微调/RAG...）     │
│                                              │
│   📎 简历上传                                  │
│   ├── 支持 PDF / Word / 图片                   │
│   ├── 系统自动解析（提取技能、经验、项目）          │
│   └── 解析结果可手动编辑                        │
│                                              │
│   🏆 作品集                                    │
│   └── 已完成的任务自动生成作品集                  │
│                                              │
│   📊 任务成功率                                 │
│   ├── 初始 100%                               │
│   ├── 失败一单 -1%                             │
│   ├── 归零时需观看课程+答题恢复                   │
│   └── 显示在工程师主页                          │
└─────────────────────────────────────────────┘
```

### 数据库新增

```sql
-- 工程师认证表
CREATE TABLE engineer_cert (
  id SERIAL PRIMARY KEY,
  user_id INT REFERENCES users(id),
  skills_description TEXT,
  resume_url TEXT,
  resume_parsed JSON,       -- 解析出的技能/经验
  success_rate INT DEFAULT 100,  -- 任务成功率 0-100
  total_tasks INT DEFAULT 0,
  failed_tasks INT DEFAULT 0,
  verified BOOLEAN DEFAULT FALSE,
  created_at TIMESTAMP
);

-- 作品集表
CREATE TABLE portfolio (
  id SERIAL PRIMARY KEY,
  user_id INT REFERENCES users(id),
  order_id INT REFERENCES orders(id),
  title VARCHAR(200),
  description TEXT,
  files JSON,          -- 上传的交付文件列表
  created_at TIMESTAMP
);
```

---

## 二、双工程师任务模式

### 核心流程

```
需求方发布任务
    │
    ├── 平台收取 3% 服务费（如取消）
    │
    ├── 需求方设定：预算 + 第一版截止日期
    │
    ├── 工程师竞标
    │   └── 需求方与工程师沟通后选择 2 位工程师
    │
    ├── 资金托管
    │   ├── 总报酬的 20% 作为押金
    │   ├── 押金均分到 2 位工程师账户（各 10%）
    │   └── 80% 留存在平台
    │
    ├── 第一版开发
    │   ├── 两位工程师并行开发
    │   ├── 均需在第一版截止日期前提交
    │   └── 可与需求方充分沟通
    │
    ├── 需求方选择
    │   ├── 选中一方 → 该方获得全部报酬
    │   ├── 未选中方 → 仅获得 5% 押金
    │   │   ├── 平台收回剩余 5% 押金
    │   │   └── 退还需求方 15% + 80% = 95%
    │   └── 也可与双方充分沟通后继续推进
    │
    ├── 任务交付
    │   ├── 工程师上传交付资料
    │   ├── 点击"完成任务"
    │   ├── 需求方确认 → 报酬立即结转
    │   └── 系统自动生成该工程师作品集
    │
    └── 任务成功率
        ├── 失败一单 → -1%
        └── 归零 → 需学习课程+答题恢复
```

### 资金流向示例

```
假设任务报价 10,000 元：

          需求方充值 10,000 元
                  │
          ┌───────┴───────┐
          │               │
     押金 2,000(20%)   报酬 8,000(80%)
       (平台托管)       (平台托管)
          │
     ┌────┴────┐
     │         │
  工程师A    工程师B
  1,000(10%) 1,000(10%)

          │
        第一版截止
          │
     ┌────┴────┐
     │         │
  选中A       未选中B
     │         │
  拿到全部:   拿到 5% 押金:
  1,000+8,000 500元
  = 9,000元   退回需求方: 1,500元
              平台收: 0元(本例)
```

### 任务成功率的恢复机制

```
成功率 = 100% - 失败次数 × 1%

当成功率为 0% 时：
  → 强制进入"学习模式"
  → 观看平台 AI 开发课程视频
  → 完成课后测试题
  → 每通过一次测试 +5% 成功率
  → 恢复后即可继续接单
```

---

## 三、AI Agent 咨询师窗口

### 功能设计

```
┌─────────────────────────────────────────────┐
│         🤖 AI Agent 咨询师                    │
├─────────────────────────────────────────────┤
│                                              │
│  申请成为咨询师                                │
│  ├── 填写申请表（技能、经验、服务范围）           │
│  ├── 平台审核                                   │
│  └── 审核通过后展示在咨询师列表                  │
│                                              │
│  咨询师列表                                    │
│  ├── 按领域分类（AI Agent/微调/RAG...）         │
│  ├── 查看咨询师详情（资历、评价、案例）           │
│  └── 发起咨询预约                              │
│                                              │
│  咨询服务                                      │
│  ├── 企业描述自身状况                          │
│  ├── 咨询师出具 AI 解决方案建议                  │
│  ├── 方案可衍生为平台上的具体需求               │
│  └── 咨询费用单独结算（按次/按时）               │
│                                              │
└─────────────────────────────────────────────┘
```

---

## 四、数据库完整更新

```sql
-- 用户表新增字段
ALTER TABLE users ADD COLUMN success_rate INT DEFAULT 100;
ALTER TABLE users ADD COLUMN total_tasks INT DEFAULT 0;
ALTER TABLE users ADD COLUMN is_consultant BOOLEAN DEFAULT FALSE;

-- 工程师认证
CREATE TABLE engineer_certifications (
  id SERIAL PRIMARY KEY,
  user_id INT REFERENCES users(id),
  skill_description TEXT,
  resume_url TEXT,
  resume_parsed JSONB,
  status VARCHAR(20) DEFAULT 'pending', -- pending/approved/rejected
  created_at TIMESTAMP DEFAULT NOW(),
  updated_at TIMESTAMP DEFAULT NOW()
);

-- 作品集
CREATE TABLE portfolios (
  id SERIAL PRIMARY KEY,
  user_id INT REFERENCES users(id),
  order_id INT REFERENCES orders(id),
  title VARCHAR(200),
  description TEXT,
  files JSONB DEFAULT '[]',
  created_at TIMESTAMP DEFAULT NOW()
);

-- 咨询师
CREATE TABLE consultants (
  id SERIAL PRIMARY KEY,
  user_id INT REFERENCES users(id),
  title VARCHAR(100),
  specialties TEXT[],       -- 专长领域
  experience TEXT,
  hourly_rate DECIMAL(10,2),
  rating DECIMAL(2,1) DEFAULT 0,
  review_count INT DEFAULT 0,
  status VARCHAR(20) DEFAULT 'pending',
  created_at TIMESTAMP DEFAULT NOW()
);

-- 咨询预约
CREATE TABLE consultations (
  id SERIAL PRIMARY KEY,
  consultant_id INT REFERENCES consultants(id),
  user_id INT REFERENCES users(id),
  description TEXT,
  status VARCHAR(20) DEFAULT 'pending', -- pending/accepted/completed/cancelled
  fee DECIMAL(10,2),
  created_at TIMESTAMP DEFAULT NOW()
);

-- 学习课程
CREATE TABLE courses (
  id SERIAL PRIMARY KEY,
  title VARCHAR(200),
  content TEXT,
  questions JSONB DEFAULT '[]',  -- 课后题目
  created_at TIMESTAMP DEFAULT NOW()
);

-- 学习记录
CREATE TABLE study_records (
  id SERIAL PRIMARY KEY,
  user_id INT REFERENCES users(id),
  course_id INT REFERENCES courses(id),
  passed BOOLEAN DEFAULT FALSE,
  created_at TIMESTAMP DEFAULT NOW()
);
```

---

## 五、开发路线图

### 第一阶段：核心功能改造（当前 MVP 升级）

```
第1步：数据库改造
  → 新建 6 张表
  → 用户表增加字段

第2步：认证与成功率系统
  → 工程师认证 API + 前端
  → 简历上传 + 解析
  → 成功率计算逻辑

第3步：双工程师任务模式
  → 订单系统重写
  → 押金分配逻辑
  → 两方并行开发流程
  → 选中/未选中结算

第4步：支付系统
  → 支付宝接入
  → 微信支付接入
  → 用户自动提现

第5步：作品集系统
  → 完成任务自动生成
  → 作品集展示页面

第6步：AI 咨询师
  → 咨询师申请/审核
  → 咨询师列表
  → 预约系统

第7步：学习恢复系统
  → 课程内容
  → 答题测试
  → 成功率恢复

第8步：管理后台升级
  → 用户管理
  → 订单仲裁
  → 咨询师审核
  → 课程管理
```

### 第二阶段：完善优化

```
- 智能匹配算法（根据技能/成功率推荐任务）
- 项目看板/甘特图（跟踪双工程师进度）
- 即时通讯优化
- 移动端适配
```

---

## 六、技术变更清单

### 后端新增 API

```
# 认证
POST /api/certification/apply      # 提交认证申请
GET  /api/certification/status     # 查看认证状态

# 简历
POST /api/resume/upload            # 上传简历
GET  /api/resume/parsed            # 获取解析结果
PUT  /api/resume/parsed            # 编辑解析结果

# 双工程师订单（新增/修改）
POST /api/orders/:id/select-engineer  # 选中工程师
POST /api/orders/:id/submit-v1     # 提交第一版
POST /api/orders/:id/pick-winner   # 选中完成方
POST /api/orders/:id/release       # 释放资金

# 作品集
GET  /api/portfolios/:userId       # 查看某用户作品集

# 成功率
GET  /api/success-rate             # 查看成功率
POST /api/success-rate/study       # 学习课程恢复

# 咨询师
POST /api/consultants/apply        # 申请成为咨询师
GET  /api/consultants              # 咨询师列表
POST /api/consultations            # 预约咨询
GET  /api/consultations            # 我的咨询记录

# 课程
GET  /api/courses                  # 课程列表
GET  /api/courses/:id              # 课程详情+题目
POST /api/courses/:id/exam         # 提交答题
```

### 前端新增页面

```
/engineer/certification    - 认证申请页
/engineer/portfolio        - 作品集
/engineer/success-rate     - 成功率+学习
/consultants               - 咨询师列表
/consultants/apply         - 申请成为咨询师
/consultations             - 我的咨询
/courses                   - 课程列表
/courses/:id               - 课程学习+考试
```

---

> 📄 **当前状态**：方案设计完成，等待姜哥确认后开始编码实现
> 🐾 **小爪随时待命**
