kon_tian 数据库设计文档

# kon_tian 数据库设计文档

**生成时间**: 2025年11月13日 18:57:08  
**数据库名**: kon_tian

**数据库连接信息**：用户名：kon_tian 、密码：cfBzhTSp5S6L3ZGW、数据库：kon_tian  ，ssh连接：ssh -p 16622 root@202.79.167.25 、ssh密码：Lt#160120

**表总数**: 67  
**存储引擎**: InnoDB

---

## 目录

1. [数据库概述](#数据库概述)
2. [表分类](#表分类)
3. [表详细设计](#表详细设计)
4. [表关系说明](#表关系说明)
5. [存储过程](#存储过程)
6. [触发器](#触发器)

---

## 数据库概述

kon_tian 是一个多平台社交账号管理系统的核心数据库，主要功能包括：

- **用户管理**: 支持用户注册、登录、权限管理
- **多平台好友管理**: WhatsApp、Telegram、Line、Instagram、Messenger、Skype、TikTok、X(Twitter)、Google Voice等
- **粉丝获取与管理**: 接粉任务、粉丝统计、重粉检测
- **自动化任务**: 自动化任务调度、执行日志
- **消息会话**: 会话管理、快捷回复
- **翻译与AI**: 多语言翻译、GPT集成
- **系统管理**: 部门、角色、权限、菜单管理
- **TRC20数字货币**: 地址监控、交易记录
- **日志审计**: 操作日志、登录日志、消费日志

---

## 表分类

### 用户相关表 (8)

- `kt_user`
- `kt_user_active`
- `kt_user_agent`
- `kt_user_friend_group`
- `kt_user_port`
- `kt_user_profile`
- `kt_user_send_stats`
- `kt_user_stats`

### 好友管理表 (11)

- `kt_bot_im_friend`
- `kt_friend_add_stats`
- `kt_gv_friend`
- `kt_ins_friend`
- `kt_line_friend`
- `kt_messenger_friend`
- `kt_skype_friend`
- `kt_tg_friend`
- `kt_tiktok_friend`
- `kt_whats_friend`
- `kt_x_friend`

### 粉丝管理表 (5)

- `kt_fans`
- `kt_fans_link`
- `kt_fans_link_jump_record`
- `kt_fans_session`
- `kt_fans_task`

### 自动化任务表 (3)

- `kt_automation_sync_queue`
- `kt_automation_task`
- `kt_automation_task_log`

### 会话和消息表 (6)

- `kt_last_msg`
- `kt_reply`
- `kt_reply_group`
- `kt_reply_history`
- `kt_session`
- `kt_session_options`

### 翻译和GPT相关表 (5)

- `kt_gpt`
- `kt_gpt_translate_temp`
- `kt_language`
- `kt_language_param`
- `kt_language_set`

### 系统管理表 (13)

- `sys_agent`
- `sys_config`
- `sys_dept`
- `sys_dept_agent`
- `sys_log`
- `sys_log_crash`
- `sys_log_dept_balance`
- `sys_menu`
- `sys_param`
- `sys_role`
- `sys_role_menu`
- `sys_user`
- `sys_user_role`

### TRC20相关表 (5)

- `trc20_address_relations`
- `trc20_address_stats`
- `trc20_monitor_address`
- `trc20_transactions`
- `trc20_user_remarks`

### 日志表 (3)

- `log_user_consume`
- `log_user_login`
- `log_user_quota`

### 其他表 (8)

- `invite_code`
- `kt_config`
- `kt_country_platform`
- `kt_dept_pay_his`
- `kt_risk_ctrl_log`
- `kt_risk_rule`
- `kt_short_link`
- `kt_tg2user`

---

## 表详细设计

### 用户相关表

#### kt_user

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| dept_id | bigint | ✓ | MUL | NULL | - | 部门id |
| username | varchar(100) | ✗ | - | NULL | - | 用户名 |
| nickname | varchar(100) | ✓ | - | NULL | - | 昵称 |
| salt | varchar(100) | ✓ | - | NULL | - | 盐 |
| password | varchar(100) | ✓ | - | NULL | - | 密码 |
| phone | varchar(100) | ✓ | - | NULL | - | 手机号 |
| avatar | varchar(500) | ✓ | - | NULL | - | 头像 |
| quota_day | int | ✓ | - | 0 | - | 天数配额 |
| quota_gpt_day | int | ✓ | - | 0 | - | gpt天数配额 |
| quota_char | bigint | ✓ | - | 0 | - | 字符配额 |
| register_ip | varchar(100) | ✓ | - | NULL | - | 注册ip |
| register_addr | varchar(100) | ✓ | - | NULL | - | 注册地址 |
| last_login_time | datetime | ✓ | - | NULL | - | 最后登录时间 |
| last_login_ip | varchar(100) | ✓ | - | NULL | - | 最后登录ip |
| last_login_addr | varchar(100) | ✓ | - | NULL | - | 最后登录地址 |
| is_lock | int | ✓ | - | 0 | - | 0正常,1已锁定 |
| is_auto_deduct | int | ✓ | - | 0 | - | 是否自动扣减 |
| target_language | varchar(255) | ✓ | - | NULL | - | 译文 |
| client_version | varchar(255) | ✓ | - | NULL | - | 客户端版本 |
| last_active_time | varchar(255) | ✓ | - | NULL | - | 最后活跃时间 |
| reply_share_code | varchar(255) | ✓ | - | NULL | - | 回复分享码 |
| consume_mode | int | ✓ | MUL | 2 | - | 消费模式1天数2字符3端口 |
| invite_code | char(8) | ✓ | - | NULL | - | 邀请码 |
| invite_uid | bigint | ✓ | - | NULL | - | 邀请用户 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| timezone_offset | decimal(4,2) | ✓ | - | 8.00 | - | 用户时区偏移量（相对UTC，单位：小时。例如：中国8.00，美国PST -8.00，印度5.50） |

**索引字段**: `dept_id, consume_mode`

---

#### kt_user_active

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| user_id | bigint | ✗ | PRI | NULL | - | 用户ID |
| last_active_time | timestamp | ✓ | - | NULL | - | 最后活动时间 |
| last_reduce_quota | date | ✓ | - | NULL | - | 最后配额扣减时间 |

**主键**: `user_id`

---

#### kt_user_agent

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| type | varchar(255) | ✓ | MUL | NULL | - | 应用类型 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `type`

---

#### kt_user_friend_group

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_user_port

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_user_profile

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gender | int | ✓ | - | NULL | - | 性别 |
| personality | varchar(255) | ✓ | - | NULL | - | 性格 |
| birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| marital_status | int | ✓ | - | NULL | - | 婚姻状况 |
| career | varchar(255) | ✓ | - | NULL | - | 职业 |
| hobby | varchar(255) | ✓ | - | NULL | - | 爱好 |
| nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| etp_exp | varchar(255) | ✓ | - | NULL | - | 创业经历 |
| emo_exp | varchar(255) | ✓ | - | NULL | - | 情感经历 |
| other | varchar(255) | ✓ | - | NULL | - | 其他 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_user_send_stats

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_user_stats

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| t_send_word_count | bigint | ✓ | - | 0 | - | 发送的字符翻译统计 |
| t_word_count | bigint | ✓ | - | 0 | - | 翻译字符统计 |
| t_preview_word_count | bigint | ✓ | - | 0 | - | 翻译预览字符统计 |
| t_gpt_word_count | bigint | ✓ | - | 0 | - | gpt翻译统计 |
| t_gpt_reply_word_count | bigint | ✓ | - | 0 | - | gpt回复统计 |
| time | bigint | ✓ | - | NULL | - | 统计的时间戳 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

### 好友管理表

#### kt_bot_im_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(255) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_friend_add_stats

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 主键 |
| dept_id | bigint | ✗ | MUL | NULL | - | 团队ID |
| user_id | bigint | ✓ | MUL | NULL | - | 用户ID（NULL表示团队汇总） |
| platform_type | int | ✓ | - | NULL | - | 平台类型（NULL表示全平台汇总） |
| stat_hour | datetime | ✗ | - | NULL | - | 统计小时 |
| friend_count | int | ✗ | - | 0 | - | 添加好友数 |
| session_count | int | ✗ | - | 0 | - | 活跃账号数 |
| data_version | varchar(50) | ✓ | - | NULL | - | 数据版本号 |
| last_update_time | datetime | ✓ | MUL | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 最后更新时间 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

**主键**: `id`

**索引字段**: `dept_id, user_id, last_update_time`

---

#### kt_gv_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方gv账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(255) | ✓ | - | NULL | - | 其他备注 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_ins_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方ins账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(255) | ✓ | - | NULL | - | 其他备注 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_line_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | mediumtext | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方line的id |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | varchar(255) | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(4096) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_messenger_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(4096) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方的id |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(255) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_skype_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方whatsapp账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(1024) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(1024) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(1024) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(1024) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(1024) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(1024) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(1024) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(1024) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_tg_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | mediumtext | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方tg的id |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | varchar(255) | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(255) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_tiktok_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | mediumtext | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方tiktok账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(255) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(255) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(255) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(255) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(255) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(255) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(255) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(255) | ✓ | - | NULL | - | 其他备注 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_whats_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方whatsapp账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(1024) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(1024) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(1024) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(1024) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(1024) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(1024) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(1024) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(2048) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

#### kt_x_friend

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(20) | ✗ | - | en | - | 语种 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| target_account | varchar(255) | ✓ | MUL | NULL | - | 对方whatsapp账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| remark_name | varchar(1024) | ✓ | - | NULL | - | 姓名 |
| remark_birthday | varchar(1024) | ✓ | - | NULL | - | 生日 |
| remark_age | varchar(255) | ✓ | - | NULL | - | 年龄 |
| remark_income | varchar(1024) | ✓ | - | NULL | - | 收入 |
| remark_profession | varchar(1024) | ✓ | - | NULL | - | 职业 |
| remark_like | varchar(1024) | ✓ | - | NULL | - | 爱好 |
| remark_location | varchar(1024) | ✓ | - | NULL | - | 所在地 |
| remark_nationality | varchar(255) | ✓ | - | NULL | - | 国籍 |
| remark_marital_status | int | ✓ | - | NULL | - | 婚姻状态 |
| remark_is_cut | int | ✓ | - | NULL | - | 是否已切 |
| remark_cut_count | int | ✓ | - | NULL | - | 已切次数 |
| remark_intention | varchar(1024) | ✓ | - | NULL | - | 意向度 |
| remark_transaction_account | varchar(255) | ✓ | - | NULL | - | 交易账号 |
| remark_is_certified | int | ✓ | - | NULL | - | 是否通过认证 |
| remark_virtual_platform | varchar(255) | ✓ | - | NULL | - | 虚拟币平台 |
| remark_recharge_amount | varchar(255) | ✓ | - | NULL | - | 充值金额 |
| other_remark | varchar(1024) | ✓ | - | NULL | - | 其他备注 |
| begin_time | date | ✓ | - | NULL | - | 开始时间 |
| group_ids | varchar(255) | ✓ | - | NULL | - | 分组 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| added_time | bigint | ✓ | - | NULL | - | 好友添加时间戳（Unix秒，客户端传入） |
| phone | bigint unsigned | ✓ | MUL | NULL | - | 手机号（纯数字） |

**索引字段**: `target_account, phone`

---

### 粉丝管理表

#### kt_fans

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| user_id | bigint | ✗ | MUL | NULL | - | 所属用户-业务员 |
| is_group | int | ✓ | - | NULL | - | 是否群组 |
| avatar | varchar(500) | ✓ | - | NULL | - | 对方头像 |
| type | int | ✓ | - | NULL | - | 类型,1whatsapp |
| is_repeat | int | ✓ | - | 0 | - | 是否重粉 |
| current_repeat_num | int | ✗ | - | 0 | - | 当时重复的个数 |
| target_account | varchar(255) | ✓ | - | NULL | - | 对方账号 |
| powder_type | int | ✓ | - | 0 | - | 粉类型0被动1主动 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `user_id`

---

#### kt_fans_link

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| name | varchar(255) | ✓ | - | NULL | - | 名称 |
| is_only_online | int | ✓ | - | 1 | - | 仅在线 |
| is_user_bind | int | ✓ | - | 1 | - | 用户绑定 |
| bind_type | int | ✓ | - | 1 | - | 绑定方式1ip地址2cookie |
| link_type | int | ✓ | - | 1 | - | 短链平台,0是本机1是is.gd,2是x.gd,3是goo.su |
| switch_method | int | ✓ | - | 1 | - | 切换方式,1是轮询方式2是随机方式 |
| suffix | varchar(255) | ✓ | - | NULL | - | 自定义后缀 |
| url | varchar(255) | ✓ | - | NULL | - | 链接 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_fans_link_jump_record

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_fans_session

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| target_count | int | ✓ | - | 0 | - | 目标接粉量 |
| status | int | ✓ | MUL | 0 | - | 状态0离线1登录页面2在线3主动下线 |
| fans_count | int | ✓ | - | 0 | - | 有效粉量 |
| jump_fans_count | int | ✓ | - | 0 | - | 跳粉次数 |
| first_login_time | datetime | ✓ | - | NULL | - | 首登时间 |
| last_active_time | datetime | ✓ | - | NULL | - | 最后活动时间 |
| stop_time | datetime | ✓ | - | NULL | - | 停止时间 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `status`

---

#### kt_fans_task

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| name | varchar(255) | ✓ | - | NULL | - | 任务名 |
| code | varchar(255) | ✓ | - | NULL | - | 接粉码 |
| fans_count | int | ✓ | - | 0 | - | 总-不重复的有效粉数 |
| repeat_fans_count | int | ✓ | - | 0 | - | 总重粉数 |
| repeat_fans_type | tinyint(1) | ✗ | - | 0 | - | 重粉统计类型 |
| status | int | ✓ | - | 0 | - | 状态0准备中1启动2已结束 |
| dept_id | bigint | ✓ | - | NULL | - | 部门id |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

### 自动化任务表

#### kt_automation_sync_queue

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 队列ID |
| user_id | bigint | ✗ | MUL | NULL | - | 用户ID |
| task_id | varchar(100) | ✗ | - | NULL | - | 任务ID |
| action | varchar(20) | ✗ | - | NULL | - | 操作类型: create, update, delete, status, progress |
| data | json | ✗ | - | NULL | - | 待同步数据 |
| retry_count | int | ✓ | - | 0 | - | 重试次数 |
| status | varchar(20) | ✓ | - | pending | - | 同步状态: pending, processing, success, failed |
| error_msg | text | ✓ | - | NULL | - | 错误信息 |
| created_at | timestamp | ✓ | MUL | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| processed_at | timestamp | ✓ | - | NULL | - | 处理时间 |

**主键**: `id`

**索引字段**: `user_id, created_at`

---

#### kt_automation_task

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 任务ID |
| user_id | bigint | ✗ | MUL | NULL | - | 用户ID |
| task_id | varchar(100) | ✗ | - | NULL | - | 任务唯一标识符 |
| name | varchar(255) | ✗ | - | NULL | - | 任务名称 |
| type | varchar(50) | ✗ | - | NULL | - | 任务类型 |
| status | varchar(20) | ✗ | - | idle | - | 任务状态: idle, running, paused, completed, failed |
| config | json | ✓ | - | NULL | - | 任务配置（JSON格式） |
| progress | int | ✓ | - | 0 | - | 任务进度（0-100） |
| result | json | ✓ | - | NULL | - | 任务执行结果 |
| error_msg | text | ✓ | - | NULL | - | 错误信息 |
| is_deleted | tinyint(1) | ✓ | - | 0 | - | 软删除标记 |
| sync_version | int | ✓ | - | 1 | - | 同步版本号 |
| last_sync_time | timestamp | ✓ | MUL | NULL | - | 最后同步时间 |
| created_at | timestamp | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| updated_at | timestamp | ✓ | MUL | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 更新时间 |

**主键**: `id`

**索引字段**: `user_id, last_sync_time, updated_at`

---

#### kt_automation_task_log

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 日志ID |
| task_id | bigint | ✗ | MUL | NULL | - | 任务ID（关联kt_automation_task） |
| user_id | bigint | ✗ | MUL | NULL | - | 用户ID |
| log_level | varchar(10) | ✗ | - | info | - | 日志级别: debug, info, warning, error |
| message | text | ✗ | - | NULL | - | 日志消息 |
| details | json | ✓ | - | NULL | - | 详细信息（JSON格式） |
| timestamp | bigint | ✗ | MUL | NULL | - | 日志时间戳（毫秒） |
| batch_id | varchar(50) | ✓ | MUL | NULL | - | 批次ID（用于批量同步） |
| created_at | timestamp | ✓ | MUL | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

**主键**: `id`

**索引字段**: `task_id, user_id, timestamp, batch_id, created_at`

---

### 会话和消息表

#### kt_last_msg

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| target_account | varchar(255) | ✗ | PRI | NULL | - | 对方账号 |
| from_user | varchar(255) | ✗ | - | NULL | - | 消息来源 |
| app | int | ✗ | - | NULL | - | 账号类型 |
| to_user | varchar(255) | ✗ | - | NULL | - | 消息目标用户 |
| msgid | varchar(255) | ✗ | - | NULL | - | 消息 Id |
| msg | varchar(1024) | ✗ | - | NULL | - | 最后一条消息 |
| time | int | ✗ | - | NULL | - | 时间戳 |

**主键**: `target_account`

---

#### kt_reply

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| group_id | bigint | ✓ | MUL | NULL | - | 所属快捷回复组 |
| user_id | bigint | ✓ | MUL | NULL | - | 所属用户id |
| type | int | ✓ | - | NULL | - | 类型,1文本2图片,3语音4视频 |
| remark | varchar(255) | ✓ | - | NULL | - | 备注 |
| content | varchar(10240) | ✓ | - | NULL | - | 回复内容 |
| sort | int | ✓ | - | 0 | - | 排序 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `group_id, user_id`

---

#### kt_reply_group

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| name | varchar(255) | ✓ | - | NULL | - | 组名 |
| sort | int | ✓ | - | 0 | - | 排序 |
| share_code | char(12) | ✓ | MUL | NULL | - | 分组分享码 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `share_code`

---

#### kt_reply_history

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| target_account | varchar(255) | ✓ | - | NULL | - | 对方账号 |
| reply_id | bigint | ✓ | MUL | NULL | - | 快捷回复id |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `reply_id`

---

#### kt_session

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | - | id |
| user_id | bigint | ✓ | MUL | NULL | - | 用户id |
| type | int | ✓ | - | 1 | - | 类型,1whatsapp2Facebook3messenger4tg5line6custom |
| u_id | varchar(255) | ✓ | - | NULL | - | 会话uuid,缓存用 |
| account | varchar(255) | ✓ | MUL | NULL | - | 账号 |
| nickname | varchar(255) | ✓ | - | NULL | - | 昵称 |
| avatar | text | ✓ | - | NULL | - | 头像 |
| unread_count | int | ✓ | - | 0 | - | 未读消息数 |
| useragent | varchar(300) | ✓ | - | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36 | - | 浏览器标识 |
| is_use_plugins | tinyint(1) | ✓ | - | 0 | - | 访客是否可使用浏览器插件 |
| referrer | varchar(255) | ✓ | - | NULL | - | 访客来源 |
| remark | varchar(255) | ✓ | - | NULL | - | 备注 |
| proxy | varchar(255) | ✓ | - | NULL | - | 代理 |
| fans_code | varchar(255) | ✓ | - | NULL | - | 当前正在进行的接粉码 |
| fans_task_id | bigint | ✓ | - | NULL | - | 当前的接粉任务 |
| fans_task_status | int | ✓ | - | 0 | - | 0暂停1启动 |
| is_del | tinyint(1) | ✓ | - | 0 | - | 是否已删除 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| options | json | ✓ | - | NULL | - | 额外字段JSON |

**主键**: `id`

**索引字段**: `user_id, account`

---

#### kt_session_options

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| key | varchar(50) | ✗ | UNI | NULL | - | 配置项键名 |
| label | varchar(100) | ✗ | - | NULL | - | 显示标签 |
| show_condition | varchar(50) | ✓ | - | always | - | 显示条件: always, debug, advance |
| default_value | tinyint(1) | ✓ | - | 0 | - | 默认值 |
| sort | int | ✓ | - | 0 | - | 排序值 |
| is_enabled | tinyint(1) | ✓ | MUL | 1 | - | 是否启用 |

**索引字段**: `key, is_enabled`

---

### 翻译和GPT相关表

#### kt_gpt

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_gpt_translate_temp

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_language

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| language | varchar(255) | ✗ | - | NULL | - | 通用语种-英文 |
| sort | int | ✓ | - | 0 | - | 排序 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_language_param

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| version | varchar(255) | ✓ | - | NULL | - | 版本号deepl填写1或者2 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_language_set

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| sort | int | ✓ | - | 0 | - | 排序 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

### 系统管理表

#### sys_agent

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| name | varchar(100) | ✗ | - | NULL | - | 代理名称 |
| label | varchar(100) | ✗ | - | NULL | - | 代理标签 |
| url | varchar(255) | ✗ | - | NULL | - | 代理URL |
| icon | varchar(255) | ✓ | - | NULL | - | 代理图标 |
| type | varchar(50) | ✗ | - | NULL | - | 代理类型 |
| api_key | varchar(255) | ✓ | - | NULL | - | API密钥 |
| create_time | datetime | ✗ | - | NULL | - | 创建时间 |
| thumb | text | ✓ | - | NULL | - | 缩略图 |

---

#### sys_config

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| key | varchar(255) | ✗ | PRI | NULL | - | 配置项 |
| value | text | ✗ | - | NULL | - | 配置项的值 |
| descript | text | ✓ | - | NULL | - | 详情 |
| sort | int | ✓ | - | NULL | - | 排序 |

**主键**: `key`

---

#### sys_dept

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| name | varchar(50) | ✗ | - | NULL | - | 部门名称 |
| sort | int | ✓ | - | 0 | - | 排序 |
| parent_id | bigint | ✓ | MUL | 0 | - | 上级id |
| balance | decimal(20,10) | ✓ | - | 0.0000000000 | - | 余额 |
| overdraw_balance | decimal(20,10) | ✓ | - | 0.0000000000 | - | 可透支余额 |
| day_price | decimal(20,10) | ✓ | - | 0.0000000000 | - | 天数价格/天 |
| char_price | decimal(20,10) | ✓ | - | 0.0000000000 | - | 字符价格/个 |
| port_price | decimal(20,10) | ✓ | - | 0.0000000000 | - | 端口价格/个 |
| gpt_day_price | decimal(20,10) | ✓ | - | 0.0000000000 | - | Gpt天数价格 |
| gmt_update | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| is_del | int | ✓ | - | 0 | - | 是否删除 |
| fans_range | tinyint | ✓ | - | 1 | - | 重粉类型 |

**索引字段**: `parent_id`

---

#### sys_dept_agent

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| dept_id | bigint | ✗ | - | NULL | - | 部门 id |
| agent_id | bigint | ✗ | - | NULL | - | Agent id |
| sort | int(10) unsigned zerofill | ✗ | - | 0000000000 | - | 排序 |
| gmt_update | timestamp | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新时间 |
| gmt_create | timestamp | ✓ | - | NULL | - | 创建时间 |

---

#### sys_log

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| event | varchar(1024) | ✗ | - | NULL | - | 时间描述 |

---

#### sys_log_crash

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### sys_log_dept_balance

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| mode | int | ✓ | - | 0 | - | 模式:0直接修改1增加2减少 |
| value | decimal(10,2) | ✓ | - | 0.00 | - | 操作的数值 |
| old_value | decimal(10,2) | ✓ | - | 0.00 | - | 操作前的数值 |
| operate_user_id | bigint | ✗ | MUL | NULL | - | 操作人 |
| remark | varchar(255) | ✓ | - | NULL | - | 备注 |
| type | int | ✓ | - | 0 | - | 类型 1:天数 2字符 3端口 4Gpt天数 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `operate_user_id`

---

#### sys_menu

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| parent_id | bigint | ✓ | MUL | 0 | - | 所属上级 |
| name | varchar(20) | ✗ | - |  | - | 名称 |
| type | int | ✗ | - | 0 | - | 类型(1:菜单,2:按钮,3外链) |
| path | varchar(100) | ✓ | - | NULL | - | 路由地址 |
| component | varchar(100) | ✓ | - | NULL | - | 组件路径 |
| perms | varchar(100) | ✓ | - | NULL | - | 权限标识 |
| icon | varchar(100) | ✓ | - | NULL | - | 图标 |
| sort | int | ✓ | - | 0 | - | 排序 |
| status | tinyint | ✓ | - | 0 | - | 状态(0:正常,1:禁用) |
| is_cache | tinyint | ✓ | - | 0 | - | 是否缓存 |
| route_name | varchar(255) | ✓ | - | NULL | - | 路由名 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新时间 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

**索引字段**: `parent_id`

---

#### sys_param

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | - | id |
| name | varchar(255) | ✗ | - | NULL | - | 键 |
| value | varchar(255) | ✓ | - | NULL | - | 值 |
| info | varchar(255) | ✓ | - | NULL | - | 描述 |
| is_open | int | ✓ | - | 1 | - | 是否启用 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**主键**: `id`

---

#### sys_role

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| role_name | varchar(20) | ✗ | - |  | - | 角色名称 |
| role_code | varchar(20) | ✓ | - | NULL | - | 角色编码 |
| description | varchar(255) | ✓ | - | NULL | - | 描述 |
| status | int | ✓ | - | 0 | - | 状态（0：正常 1：禁用） |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新时间 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

---

#### sys_role_menu

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新时间 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

---

#### sys_user

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| dept_id | bigint | ✓ | MUL | NULL | - | 部门id |
| tron_pay_url | varchar(255) | ✓ | - | NULL | - | 波场支付地址 |
| eth_pay_url | varchar(255) | ✓ | - | NULL | - | 以太坊支付地址 |
| is_team | int | ✓ | - | 1 | - | 是否是团队 |
| is_admin | int | ✗ | - | 0 | - | 是否管理员 |
| is_lock | int | ✓ | - | 0 | - | 是否被禁用 |
| last_login_time | datetime | ✓ | - | NULL | - | 最后登录时间 |
| last_login_ip | varchar(100) | ✓ | - | NULL | - | 最后登录ip |
| last_login_addr | varchar(100) | ✓ | - | NULL | - | 最后登录地址 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

**索引字段**: `dept_id`

---

#### sys_user_role

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| role_id | bigint | ✗ | MUL | 0 | - | 角色id |
| user_id | bigint | ✗ | MUL | 0 | - | 用户id |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新时间 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

**索引字段**: `role_id, user_id`

---

### TRC20相关表

#### trc20_address_relations

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 主键ID |
| from_address | varchar(42) | ✗ | MUL | NULL | - | 发送地址 |
| to_address | varchar(42) | ✗ | MUL | NULL | - | 接收地址 |
| first_tx_time | datetime | ✗ | - | NULL | - | 首次交易时间 |
| last_tx_time | datetime | ✗ | - | NULL | - | 最后交易时间 |
| tx_count | int | ✓ | MUL | 0 | - | 交易次数 |
| total_amount | decimal(30,6) | ✓ | MUL | 0.000000 | - | 总交易金额 |
| avg_amount | decimal(30,6) | ✓ | - | 0.000000 | - | 平均交易金额 |
| max_amount | decimal(30,6) | ✓ | - | 0.000000 | - | 最大交易金额 |
| min_amount | decimal(30,6) | ✓ | - | 0.000000 | - | 最小交易金额 |
| create_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| update_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 更新时间 |

**主键**: `id`

**索引字段**: `from_address, to_address, tx_count, total_amount`

---

#### trc20_address_stats

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 主键ID |
| address | varchar(42) | ✗ | UNI | NULL | - | TRC20地址 |
| tx_in_count | int | ✓ | MUL | 0 | - | 转入交易次数 |
| tx_out_count | int | ✓ | - | 0 | - | 转出交易次数 |
| total_in_amount | decimal(30,6) | ✓ | MUL | 0.000000 | - | 总转入金额 |
| total_out_amount | decimal(30,6) | ✓ | - | 0.000000 | - | 总转出金额 |
| current_balance | decimal(30,6) | ✓ | - | 0.000000 | - | 当前余额 |
| trx_balance | decimal(30,6) | ✓ | - | 0.000000 | - | 当前 trx |
| unique_in_addresses | int | ✓ | - | 0 | - | 转入地址数 |
| unique_out_addresses | int | ✓ | - | 0 | - | 转出地址数 |
| first_tx_time | datetime | ✓ | - | NULL | - | 首次交易时间 |
| last_tx_time | datetime | ✓ | - | NULL | - | 最后交易时间 |
| risk_score | int | ✓ | MUL | 0 | - | 风险评分(0-100) |
| risk_tags | json | ✓ | - | NULL | - | 风险标签 |
| create_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| update_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 更新时间 |

**主键**: `id`

**索引字段**: `address, tx_in_count, total_in_amount, risk_score`

---

#### trc20_monitor_address

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 主键ID |
| address | varchar(42) | ✗ | UNI | NULL | - | TRC20地址 |
| remark | varchar(200) | ✓ | - | NULL | - | 地址备注 |
| monitor_status | tinyint(1) | ✓ | MUL | 1 | - | 监测状态:1-监测中,0-已停止 |
| sync_status | tinyint | ✓ | - | 0 | - | 同步状态：0-未同步，1-同步中，2-已停止 |
| last_sync_time | datetime | ✓ | - | NULL | - | 最后同步时间 |
| last_sync_block | bigint | ✓ | - | 0 | - | 最后同步的区块高度 |
| create_time | datetime | ✓ | MUL | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| update_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 更新时间 |
| create_by | varchar(50) | ✓ | - | NULL | - | 创建人 |

**主键**: `id`

**索引字段**: `address, monitor_status, create_time`

---

#### trc20_transactions

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| id | bigint | ✗ | PRI | NULL | auto_increment | 主键ID |
| tx_id | varchar(64) | ✗ | UNI | NULL | - | 交易哈希 |
| from_address | varchar(42) | ✗ | MUL | NULL | - | 发送地址 |
| to_address | varchar(42) | ✗ | MUL | NULL | - | 接收地址 |
| amount | decimal(30,6) | ✗ | MUL | NULL | - | 交易金额 |
| token_symbol | varchar(20) | ✓ | - | USDT | - | 代币符号 |
| token_contract | varchar(42) | ✓ | - | NULL | - | 代币合约地址 |
| block_number | bigint | ✗ | MUL | NULL | - | 区块高度 |
| block_timestamp | datetime | ✗ | MUL | NULL | - | 区块时间 |
| status | varchar(20) | ✓ | - | SUCCESS | - | 交易状态 |
| fee | decimal(20,6) | ✓ | - | 0.000000 | - | 交易手续费 |
| memo | text | ✓ | - | NULL | - | 交易备注 |
| raw_data | json | ✓ | - | NULL | - | 原始交易数据 |
| create_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |

**主键**: `id`

**索引字段**: `tx_id, from_address, to_address, amount, block_number, block_timestamp`

---

#### trc20_user_remarks

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| user_id | varchar(64) | ✗ | MUL | NULL | - | 用户ID |
| address | varchar(64) | ✗ | MUL | NULL | - | TRC20地址 |
| remark | varchar(255) | ✓ | - | NULL | - | 用户备注 |
| create_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| update_time | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP | 更新时间 |

**索引字段**: `user_id, address`

---

### 日志表

#### log_user_consume

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| value | bigint | ✓ | - | NULL | - | 操作的数值 |
| old_value | bigint | ✓ | - | NULL | - | 操作前的数值 |
| type | int | ✗ | - | NULL | - | 类型 1:天数 2字符 3端口 4Gpt天数 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### log_user_login

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| ip | varchar(45) | ✓ | MUL | NULL | - | IP地址 |

**索引字段**: `ip`

---

#### log_user_quota

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| mode | int | ✓ | - | NULL | - | 模式 1:添加 2:减少 |
| value | bigint | ✓ | - | NULL | - | 操作的数值 |
| old_value | bigint | ✓ | - | NULL | - | 操作前的数值 |
| type | int | ✗ | - | NULL | - | 类型 1:天数 2字符 |
| remark | varchar(255) | ✓ | - | NULL | - | 备注 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

### 其他表

#### invite_code

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| type | tinyint(1) | ✗ | - | 0 | - | 用户类型 0:sys 1:user |

---

#### kt_config

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| mode | int | ✓ | - | 1 | - | 1本地翻译2远程翻译 |
| back_domain | varchar(255) | ✓ | - | NULL | - | 后台域名 |
| img_domain | varchar(255) | ✓ | - | NULL | - | 图片域名 |
| fans_white_list | varchar(1000) | ✓ | - | NULL | - | 粉白名单 |
| update_channel_url | varchar(255) | ✓ | - | NULL | - | 更新频道地址 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |
| website | varchar(255) | ✓ | - | NULL | - | 前端 web |

---

#### kt_country_platform

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_dept_pay_his

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| from_address | varchar(255) | ✗ | - | NULL | - | 转出地址 |
| to_address | varchar(255) | ✓ | - | NULL | - | 收款地址 |
| type | int | ✓ | - | NULL | - | 交易类型 |
| contract | varchar(255) | ✓ | - | NULL | - | 合约地址 |
| time | datetime | ✓ | - | NULL | - | 交易时间 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_risk_ctrl_log

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| is_handler | int | ✓ | - | 0 | - | 是否已处理 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_risk_rule

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| type | int | ✗ | - | NULL | - | 1关键字2正则 |
| action_type | int | ✗ | - | NULL | - | 操作类型 |
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_short_link

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| gmt_update | datetime | ✓ | - | NULL | on update CURRENT_TIMESTAMP | 更新日期 |
| gmt_create | datetime | ✓ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建日期 |

---

#### kt_tg2user

**字段列表**:

| 字段名 | 类型 | 允许空 | 键 | 默认值 | 额外 | 说明 |
|--------|------|--------|-----|--------|------|------|
| tg | char(20) | ✗ | PRI | NULL | - | TG账号 |
| user_id | bigint | ✗ | - | NULL | - | 用户ID |
| create_time | timestamp | ✗ | - | CURRENT_TIMESTAMP | DEFAULT_GENERATED | 创建时间 |
| nickname | char(64) | ✓ | MUL | NULL | - | 飞机昵称 |
| prompt | text | ✓ | - | NULL | - | 提示词 |
| reply_prompt | text | ✓ | - | NULL | - | 引用提示词 |

**主键**: `tg`

**索引字段**: `nickname`

---

## 表关系说明

### 核心表关系图 (Mermaid)

```mermaid
erDiagram
    "sys_dept" |o--|| "sys_dept" : "parent_id"
    "sys_dept" |o--o{ "sys_user" : "dept_id"
    "sys_dept" |o--o{ "kt_user" : "dept_id"
    "sys_user" |o--o{ "sys_user_role" : "user_id"
    "sys_role" |o--o{ "sys_user_role" : "role_id"
    "sys_role" |o--o{ "sys_role_menu" : "role_id"
    "sys_menu" |o--o{ "sys_role_menu" : "menu_id"
    "kt_user" |o--o{ "kt_session" : "user_id"
    "kt_user" |o--o{ "kt_user_stats" : "user_id"
    "kt_user" |o--o{ "log_user_login" : "user_id"
    "kt_session" |o--o{ "kt_whats_friend" : "account"
    "kt_session" |o--o{ "kt_tg_friend" : "account"
    "sys_dept" |o--o{ "kt_fans_task" : "dept_id"
    "kt_fans_task" |o--o{ "kt_fans" : "fans_task_id"
    "kt_fans_task" |o--o{ "kt_fans_session" : "fans_task_id"
    "kt_user" |o--o{ "kt_fans" : "user_id"
    "kt_fans_session" |o--o{ "kt_fans" : "fans_session_id"
    "kt_session" |o--o{ "kt_fans_session" : "session_id"
    "trc20_monitor_address" |o--o{ "trc20_transactions" : "address"

"kt_fans" {
        bigint user_id [FK] "所属用户-业务员"
        bigint fans_task_id [FK] ""
        bigint fans_session_id [FK] ""
    }
    "kt_fans_session" {
        bigint session_id [FK] ""
        bigint fans_task_id [FK] ""
    }
    "kt_fans_task" {
        bigint id [PK] ""
        bigint dept_id [FK] "部门id"
    }
    "kt_session" {
        bigint id [PK] "id"
        bigint user_id [FK] "用户id"
        bigint fans_task_id [FK] "当前的接粉任务"
    }
    "kt_tg_friend" {
        varchar(255) group_ids [FK] "分组"
    }
    "kt_user" {
        bigint id [PK] ""
        bigint dept_id [FK] "部门id"
        bigint invite_uid [FK] "邀请用户"
    }
    "kt_user_stats" {
        bigint id [PK] ""
        bigint user_id [FK] ""
    }
    "kt_whats_friend" {
        varchar(255) group_ids [FK] "分组"
    }
    "log_user_login" {
        bigint id [PK] ""
    }
    "sys_dept" {
        bigint id [PK] "id"
        bigint parent_id [FK] "上级id"
    }
    "sys_menu" {
        bigint id [PK] "id"
        bigint parent_id [FK] "所属上级"
    }
    "sys_role" {
        bigint id [PK] "id"
    }
    "sys_role_menu" {
        bigint id [PK] "id"
    }
    "sys_user" {
        bigint id [PK] "id"
        bigint dept_id [FK] "部门id"
    }
    "sys_user_role" {
        bigint id [PK] "id"
        bigint role_id [FK] "角色id"
        bigint user_id [FK] "用户id"
    }
    "trc20_monitor_address" {
        bigint id [PK] "主键ID"
    }
    "trc20_transactions" {
        bigint id [PK] "主键ID"
    }
```

### 隐式关系（基于字段名分析）

虽然数据库中没有显式的外键约束，但通过字段名可以推断出以下关系：

#### 用户相关关系

- `kt_user.id` → 各好友表的 `account` 字段（通过用户登录关联）
- `kt_user.dept_id` → `sys_dept.id` （用户所属部门）
- `sys_user.dept_id` → `sys_dept.id` （系统用户所属部门）
- `invite_log.userid` → `kt_user.id` （邀请用户）
- `invite_log.invite_userid` → `kt_user.id` （被邀请用户）

#### 粉丝相关关系

- `kt_fans.user_id` → `kt_user.id` （粉丝所属业务员）
- `kt_fans.fans_task_id` → `kt_fans_task.id` （粉丝所属任务）
- `kt_fans.fans_session_id` → `kt_fans_session.id` （粉丝所属会话）
- `kt_fans_session.session_id` → `kt_session.id` （关联主会话）
- `kt_fans_session.fans_task_id` → `kt_fans_task.id` （会话关联任务）
- `kt_fans_link.fans_task_id` → `kt_fans_task.id` （短链关联任务）
- `kt_fans_task.dept_id` → `sys_dept.id` （任务所属部门）

#### 自动化任务关系

- `kt_automation_task.user_id` → `kt_user.id` （任务所属用户）
- `kt_automation_task_log.task_id` → `kt_automation_task.id` （日志关联任务）
- `kt_automation_task_log.user_id` → `kt_user.id` （日志所属用户）
- `kt_automation_sync_queue.user_id` → `kt_user.id` （同步队列所属用户）

#### 系统管理关系

- `sys_dept.parent_id` → `sys_dept.id` （部门树形结构）
- `sys_user_role.user_id` → `sys_user.id` （用户角色关联）
- `sys_user_role.role_id` → `sys_role.id` （用户角色关联）
- `sys_role_menu.role_id` → `sys_role.id` （角色菜单关联）
- `sys_role_menu.menu_id` → `sys_menu.id` （角色菜单关联）

#### 日志关系

- `log_user_login.userid` → `kt_user.id` 或 `sys_user.id`
- `log_user_consume.user_id` → `kt_user.id`
- `log_user_quota.user_id` → `kt_user.id`
- `log_user_quota.dept_id` → `sys_dept.id`

#### 好友表关系

所有好友表（kt_whats_friend, kt_tg_friend, kt_line_friend, kt_ins_friend等）都有类似的关系：
- `account` 字段关联到 `kt_user` 或 `kt_session`
- `target_account` 表示对方账号
- `group_ids` 关联到 `kt_user_friend_group`

---

## 存储过程

数据库中共有 **40个存储过程**，主要分为以下几类：

### 1. 好友添加系列存储过程

每个平台都有3个版本的好友添加存储过程（v1, v2, v3）：

#### WhatsApp好友
- `add_whats_friend` - WhatsApp好友添加（v1）
- `add_whats_friend_v2` - WhatsApp好友添加（v2）
- `add_whats_friend_v3` - WhatsApp好友添加（v3）

#### Telegram好友
- `add_tg_friend` - Telegram好友添加
- `add_tg_friend_v2` - Telegram好友添加（v2）
- `add_tg_friend_v3` - Telegram好友添加（v3）

#### Line好友
- `add_line_friend` - Line好友添加
- `add_line_friend_v2` - Line好友添加（v2）
- `add_line_friend_v3` - Line好友添加（v3）

#### Instagram好友
- `add_ins_friend` - Instagram好友添加
- `add_ins_friend_v2` - Instagram好友添加（v2）
- `add_ins_friend_v3` - Instagram好友添加（v3）

#### Messenger好友
- `add_messenger_friend` - Messenger好友添加
- `add_messenger_friend_v2` - Messenger好友添加（v2）
- `add_messenger_friend_v3` - Messenger好友添加（v3）

#### Skype好友
- `add_skype_friend` - Skype好友添加
- `add_skype_friend_v2` - Skype好友添加（v2）
- `add_skype_friend_v3` - Skype好友添加（v3）

#### TikTok好友
- `add_tiktok_friend` - TikTok好友添加
- `add_tiktok_friend_v2` - TikTok好友添加（v2）
- `add_tiktok_friend_v3` - TikTok好友添加（v3）

#### Google Voice好友
- `add_gv_friend` - Google Voice好友添加
- `add_gv_friend_v2` - Google Voice好友添加（v2）
- `add_gv_friend_v3` - Google Voice好友添加（v3）

#### X (Twitter)好友
- `add_x_friend` - X好友添加
- `add_x_friend_v2` - X好友添加（v2）
- `add_x_friend_v3` - X好友添加（v3）

### 2. 用户统计相关存储过程

- **`AddUserStatistics`** - 用户字符统计和自动扣减
  - 批量处理用户的发送字数、翻译字数、GPT字数等统计
  - 自动扣减用户配额
  
- **`AddUserSendStatistics`** - 用户发送统计
  - 统计用户的消息发送数据

- **`GetUserStatistics`** - 获取用户统计信息
  - 查询用户的各项统计数据

- **`GetUserFriendStats`** - 获取用户好友统计
  - 统计用户在各平台的好友数量

- **`GetActiveCountByUid`** - 获取用户活跃账号数
  - 查询用户的活跃账号数量

- **`sp_get_all_user_stats`** - 获取所有用户统计
  - 批量获取用户统计信息

### 3. 配额管理存储过程

- **`DecreaseQuota`** - 扣减配额
  - 用户使用服务时扣减相应配额

- **`DecreaseQuota_V2`** - 扣减配额（v2版本）
  - 改进版的配额扣减逻辑

### 4. 工具类存储过程

- **`generate_unique_code`** - 生成唯一邀请码
  - 为新用户生成不重复的邀请码

- **`generate_invite_codes_for_existing_users`** - 为已有用户生成邀请码
  - 批量为现有用户补充邀请码

- **`getTreeList`** - 获取树形列表
  - 用于部门树等树形结构数据的查询

### 5. 调试用存储过程

- **`debug_whats_v3_detailed`** - WhatsApp v3详细调试
- **`debug_with_real_insert`** - 实际插入调试

---

## 触发器

数据库中共有 **18个触发器**，用于自动化数据处理：

### 1. 粉丝管理触发器

#### `update_kt_fans` (BEFORE INSERT on kt_fans)
**功能**: 插入粉丝时自动判断是否为重粉
- 根据任务的 `repeat_fans_type` 设置判断规则：
  - `0`: 不处理重粉
  - `1`: 按团队统计重粉（同dept_id下的重复账号）
  - `2`: 按工单统计重粉（同fans_task_id下的重复账号）
  - `3`: 全局统计重粉（整个数据库中的重复账号）
- 自动设置 `is_repeat` 和 `current_repeat_num` 字段

#### `update_fans_count` (AFTER INSERT on kt_fans)
**功能**: 插入粉丝后自动更新统计数据
- 如果 `is_repeat = 0`（非重粉）:
  - 更新 `kt_fans_session.fans_count`（会话有效粉量+1）
  - 更新 `kt_fans_task.fans_count`（任务总粉量+1）
- 如果 `is_repeat = 1`（重粉）:
  - 更新 `kt_fans_task.repeat_fans_count`（任务重粉数+当前重复数）

### 2. 会话管理触发器

#### `update_last_active_time` (BEFORE UPDATE on kt_fans_session)
**功能**: 更新会话最后活动时间
- 当会话状态为 1（登录页面）或 2（在线）时
- 自动更新 `last_active_time` 为当前时间

### 3. 好友更新时间触发器

#### `update_line_uptime` (BEFORE UPDATE on kt_line_friend)
**功能**: 更新Line好友的更新时间

#### `update_tg_uptime` (BEFORE UPDATE on kt_tg_friend)
**功能**: 更新Telegram好友的更新时间

#### `update_whats_uptime` (BEFORE UPDATE on kt_whats_friend)
**功能**: 更新WhatsApp好友的更新时间

### 4. 用户管理触发器

#### `before_user_insert` (BEFORE INSERT on kt_user)
**功能**: 用户插入前检查用户名唯一性
- 确保用户名不重复
- 如果重复则抛出错误

#### `after_insert_kt_user` (AFTER INSERT on kt_user)
**功能**: 用户插入后自动创建登录日志记录
- 在 `log_user_login` 表中创建初始记录

#### `before_user_update` (BEFORE UPDATE on kt_user)
**功能**: 用户更新前检查用户名唯一性
- 确保修改后的用户名不与其他用户重复

#### `before_username_update` (BEFORE UPDATE on kt_user)
**功能**: 用户名变更时同步更新昵称
- 当用户名改变时，自动将昵称设置为新用户名

#### `after_update_kt_user` (AFTER UPDATE on kt_user)
**功能**: 用户登录时记录日志
- 检测 `last_login_time` 字段变化
- 自动在 `log_user_login` 表中插入登录记录
- 记录IP、版本号、MAC地址等信息

### 5. 系统用户触发器

#### `after_sys_user_insert` (AFTER INSERT on sys_user)
**功能**: 系统用户插入后自动生成邀请码
- 调用 `generate_unique_code` 存储过程生成邀请码
- 在 `invite_code` 表中插入记录

#### `add_log` (AFTER UPDATE on sys_user)
**功能**: 系统用户登录日志记录
- 检测 `last_login_time` 字段变化
- 记录登录IP和版本信息

### 6. 部门管理触发器

#### `before_insert_dept` (BEFORE INSERT on sys_dept)
**功能**: 部门插入时自动计算路径
- 根据 `parent_id` 自动生成部门路径 `path`
- 顶级部门: `/部门ID/`
- 子部门: `/父路径/部门ID/`

#### `before_update_dept` (BEFORE UPDATE on sys_dept)
**功能**: 部门更新时重新计算路径
- 当 `parent_id` 改变时，重新计算 `path`
- 自动更新 `gmt_update` 时间

#### `update_dept_path` (AFTER INSERT on sys_dept_path_queue)
**功能**: 批量更新部门子树路径
- 当部门移动时，批量更新所有子部门的路径
- 使用队列表 `sys_dept_path_queue` 异步处理
- 处理完成后自动清理队列记录

### 7. 部门充值触发器

#### `tr_kt_dept_pay_his_insert_with_balance` (BEFORE INSERT on kt_dept_pay_his)
**功能**: 部门充值时自动记录余额变动日志
- 计算充值前的部门余额（Java已经先扣减了金额）
- 在 `sys_log_dept_balance` 表中插入充值记录
- 记录充值金额、交易ID、转出/转入地址等信息

### 8. 配额日志触发器

#### `trg_before_insert_log_user_quota` (BEFORE INSERT on log_user_quota)
**功能**: 插入配额日志时自动补充部门ID
- 如果 `dept_id` 为空，从 `kt_user` 表查询用户的 `dept_id`
- 确保配额日志完整记录部门信息

---

## 数据库特点总结

### 设计特点

1. **无外键约束**: 数据库采用无外键约束设计，通过应用层和触发器保证数据一致性
2. **触发器驱动**: 大量使用触发器实现业务逻辑自动化
3. **存储过程批处理**: 使用存储过程处理批量操作，提高性能
4. **软删除**: 部分表使用 `is_deleted` 字段实现软删除
5. **时间戳追踪**: 普遍使用 `gmt_create` 和 `gmt_update` 字段追踪记录时间

### 性能优化

1. **索引策略**: 在关键查询字段（user_id, account, target_account等）建立索引
2. **JSON字段**: 使用JSON类型存储灵活配置数据
3. **分区思想**: 通过 `dept_id` 实现逻辑分区
4. **批量操作**: 存储过程支持批量数据处理

### 数据一致性

1. **触发器保证**: 
   - 自动更新统计数据
   - 自动维护关联关系
   - 自动记录操作日志
2. **唯一性约束**: 关键字段使用UNIQUE索引
3. **默认值**: 合理设置字段默认值

---

## 附录

### 平台类型编码

根据表结构推断，系统支持以下平台：

| 平台 | 好友表 | 说明 |
|------|--------|------|
| WhatsApp | kt_whats_friend | 即时通讯 |
| Telegram | kt_tg_friend | 即时通讯 |
| Line | kt_line_friend | 即时通讯 |
| Instagram | kt_ins_friend | 社交媒体 |
| Messenger | kt_messenger_friend | 即时通讯 |
| Skype | kt_skype_friend | 即时通讯 |
| TikTok | kt_tiktok_friend | 短视频 |
| X (Twitter) | kt_x_friend | 社交媒体 |
| Google Voice | kt_gv_friend | 语音通话 |
| BotIM | kt_bot_im_friend | 机器人IM |

### 重要字段说明

- **powder_type**: 粉类型，0=被动粉，1=主动粉
- **is_repeat**: 是否重粉，0=否，1=是
- **repeat_fans_type**: 重粉统计类型，0=默认，1=按团队，2=按工单，3=全局
- **status**: 不同表有不同含义
  - kt_fans_session: 0=离线，1=登录页面，2=在线，3=主动下线
  - kt_fans_task: 0=准备中，1=启动，2=已结束

---

**文档结束**