03 · 数据模型
一、现有表(nine-admin main @ 6060c5a,直接复用)
agent_clients —— 智能体身份
| 字段 | 用途 | 主脑系统里的位置 |
|---|---|---|
id |
主键 | 编号 JZ-AG-00X 的来源 |
name |
客户端名(如 joey-mac-jczx) | 岗位/客户端名 |
owner |
归属人/用途备注 | 所属管理人 |
device_uuid |
设备绑定 machine_uuid | 与 agent_machines.machine_uuid 对应 |
token_digest / token_prefix |
agt_ token(明文不落库) |
归档鉴权 |
last_used_at |
最近调用 | 最后同步时间 |
documents_count / total_bytes |
缓存计数 | 档案占用 |
revoked_at / expires_at |
撤销/过期 | 状态判定参考 |
agent_machines —— 设备
agent_client_id, machine(主机名), machine_uuid, first/last_remote_ip, first/last_seen_at
→ 机器码 = machine_uuid;last_seen_at 决定「连通 / 不通」。
agent_documents —— 档案本体(核心)
agent_client_id, kind(soul|memory|skill|session), path, title, current_sha256, current_size, first/last_uploaded_at, machine_uuid, deleted_at
| kind | 客户端来源 | 界面名字 | 主脑系统用到的地方 |
|---|---|---|---|
soul |
SOUL.md |
性格 | 抽屉「性格」tab、档案分析、派单携带档案 |
memory |
memories/** |
历史记忆 | 抽屉「历史记忆」、记忆档案 |
skill |
skills/** |
技能 | 抽屉「技能」、SKILL 档案(27 条) |
session |
transcripts/** |
历史会话 | 抽屉「历史会话」、会话档案、无关会话统计 |
其他复用
agent_upload_batches(同步批次)、staffers(员工)、admin_roles / admin_privileges(权限点)、
tickets(工单)、user_action_logs(操作审计)、push_configs / fault_reports(客户端通道)。
二、需要新增的表(6 张)
目标:让「100 个位」「岗位」「SKILL 状态」「分析结果」「派单台账」「技能动作留痕」有地方落,否则界面上的一切都是空的。
1. brain_slots —— 100 个智能体位
create_table :brain_slots do |t|
t.integer :seq, null: false # 1..100,界面上 JZ-AG-001
t.string :label # 自定义名称(可空)
t.string :post_name # 岗位名称(冗余,便于查询)
t.bigint :agent_client_id # 空 = 空置
t.string :machine_uuid
t.string :manager_owner # 所属管理人(= agent_clients.owner 快照)
t.string :status, default: 'empty' # empty / configured / online / busy / offline
t.datetime :configured_at
t.timestamps
end
add_index :brain_slots, :seq, unique: true
add_index :brain_slots, :agent_client_id
add_index :brain_slots, [:machine_uuid], unique: true, where: "machine_uuid IS NOT NULL" # 一台设备不能占两位
2. posts(岗位表)
create_table :posts do |t|
t.string :name, null: false # 电力行业售前顾问 …
t.string :code
t.text :duty # 岗位职责
t.boolean :active, default: true
t.timestamps
end
add_index :posts, :name, unique: true
3. staff_posts(人员 ↔ 岗位,含离职与接替)
create_table :staff_posts do |t|
t.bigint :staffer_id, null: false
t.bigint :post_id, null: false
t.date :started_on
t.date :ended_on # 非空 = 已离岗
t.bigint :handover_to_staffer_id # 接替人(原岗复活用)
t.timestamps
end
「原岗复活」= 找
ended_on非空岗位的handover_to_staffer_id,取其名下智能体。
4. skill_registry(技能状态与计数)
create_table :skill_registry do |t|
t.string :code, null: false # skill-rail-vehicle-assembly-check
t.string :name, null: false
t.bigint :post_id
t.bigint :agent_document_id # 指向 agent_documents(kind=skill) 本体
t.string :status, default: 'available' # in_use / available / deprecated
t.integer :uses_count, default: 0
t.datetime :last_used_at
t.datetime :deprecated_at
t.text :note
t.timestamps
end
add_index :skill_registry, :code, unique: true
add_index :skill_registry, [:post_id, :status]
5. skill_ops_logs(四个动作的留痕)
create_table :skill_ops_logs do |t|
t.bigint :skill_registry_id, null: false
t.string :action, null: false # learn / assign / copy / revive
t.bigint :target_slot_id # 指派/复活的目标位
t.bigint :operator_staffer_id
t.string :result # ok / failed
t.text :note
t.timestamps
end
6. brain_analyses + dispatch_records
create_table :brain_analyses do |t|
t.date :period_from, null: false
t.date :period_to, null: false
t.string :model, null: false # deepseek-flash / gpt-4o …
t.integer :token_usage
t.integer :duration_ms
t.string :status, default: 'pending' # pending / running / done / failed
t.jsonb :result # 人人+逐智能体判定结果
t.timestamps
end
create_table :dispatch_records do |t|
t.string :kind, null: false # task(派智能体)/ ticket(派员工)
t.bigint :source_id # 工单 id 或任务 id
t.bigint :target_slot_id # kind=task
t.bigint :target_staffer_id # kind=ticket
t.string :model # 本次推荐用的模型
t.jsonb :recommendation # 模型原始建议(审计用)
t.bigint :confirmed_by_staffer_id
t.datetime :confirmed_at
t.timestamps
end
三、口径(必须与线上一致)
| 项 | 口径 |
|---|---|
| 积分 ↔ 金额 | 1 积分 = 8.9 元(0.50 积分 ≈ ¥4.45) |
| 余额 | 只认 ATP users.quota,本地不存余额 |
| 「已设置」智能体 | brain_slots.agent_client_id IS NOT NULL(= 集群档案里非空置的框) |
| 档案分析覆盖范围 | 必须 = 已设置数量,空置位不参与 |
| 连通判定 | agent_machines.last_seen_at 在 N 分钟内(建议 10 分钟)→ 连通;否则不通 |
| 任务中 | 有未完成的 dispatch_record(kind=task) 指向该位 |
| 无关会话 | transcripts 每条打标 relevance(业务相关 / 无关),判定时汇总占比 |