eryao/docs/references/old-database-schema.md

Old 项目数据库表结构参考

本文档记录 old 文件夹中历史项目的数据库表结构定义。

---

一、login-service (后端服务)

1. users - 用户表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
phone_number	VARCHAR(20)	UNIQUE, NOT NULL	手机号
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

索引:

• idx_phone_number ON phone_number

---

2. verification_codes - 验证码表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
phone_number	VARCHAR(20)	NOT NULL	手机号
code	VARCHAR(6)	NOT NULL	验证码
expiration_time	TIMESTAMP	NOT NULL	过期时间
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间

索引:

• idx_vc_phone_number ON phone_number
• idx_vc_expiration ON expiration_time

---

3. user_profile - 用户资料表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
phone_number	VARCHAR(20)	UNIQUE, NOT NULL	手机号
nickname	VARCHAR(50)		昵称
avatar_url	VARCHAR(500)		头像URL
signature	VARCHAR(200)		个性签名
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

---

4. user_tokens - 用户令牌表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL	用户ID
token	VARCHAR(255)	NOT NULL	访问令牌
refresh_token	VARCHAR(255)		刷新令牌
expires_at	TIMESTAMP		过期时间
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间

---

5. user_feedback - 用户反馈表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL	用户ID
content	TEXT	NOT NULL	反馈内容
contact	VARCHAR(100)		联系方式
status	VARCHAR(20)	DEFAULT 'PENDING'	处理状态
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

---

6. user_coin - 用户金币表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	UNIQUE, NOT NULL	用户ID
coin_count	BIGINT	DEFAULT 0	金币数量
total_charged	BIGINT	DEFAULT 0	累计充值金币
total_consumed	BIGINT	DEFAULT 0	累计消费金币
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

---

7. notification - 通知表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL	用户ID
title	VARCHAR(100)	NOT NULL	通知标题
content	TEXT		通知内容
type	VARCHAR(20)		通知类型
is_read	BOOLEAN	DEFAULT FALSE	是否已读
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间

---

8. payment_record - 支付记录表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL	用户ID
order_id	VARCHAR(64)	NOT NULL	订单ID
amount	DECIMAL(10,2)	NOT NULL	支付金额
coin_amount	BIGINT	NOT NULL	购买金币数量
payment_method	VARCHAR(20)		支付方式
status	VARCHAR(20)	NOT NULL	支付状态
transaction_id	VARCHAR(100)		第三方交易号
paid_at	TIMESTAMP		支付时间
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间

---

9. payment_order - 支付订单表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
order_no	VARCHAR(64)	UNIQUE, NOT NULL	订单号
user_id	BIGINT	NOT NULL	用户ID
product_id	VARCHAR(50)	NOT NULL	商品ID
product_name	VARCHAR(100)	NOT NULL	商品名称
amount	DECIMAL(10,2)	NOT NULL	订单金额
status	VARCHAR(20)	NOT NULL	订单状态
pay_url	TEXT		支付链接
expire_time	TIMESTAMP		过期时间
created_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

---

10. sensitive_word_violations - 敏感词违规记录表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL, FK	用户ID
content_type	VARCHAR(20)	NOT NULL	内容类型：NICKNAME, SIGNATURE
violation_type	VARCHAR(30)	NOT NULL	违规类型：POLITICAL, ILLEGAL, VULGAR, ADVERTISING, PERSONAL_ATTACK
detection_service	VARCHAR(20)	DEFAULT 'LOCAL'	检测服务类型：LOCAL, ALIYUN
risk_level	VARCHAR(50)		阿里云风险等级
confidence	DOUBLE		阿里云置信度(0-1)
original_content	TEXT	NOT NULL	原始内容
matched_words	TEXT	NOT NULL	匹配到的敏感词(JSON)
aliyun_response	TEXT		阿里云完整响应
client_ip	VARCHAR(45)		客户端IP
user_agent	TEXT		用户代理
violation_time	DATETIME	NOT NULL	违规时间
created_at	DATETIME	DEFAULT CURRENT_TIMESTAMP	创建时间

索引:

• idx_user_id ON user_id
• idx_content_type ON content_type
• idx_violation_type ON violation_type
• idx_violation_time ON violation_time
• idx_user_violation_time ON (user_id, violation_time)
• idx_client_ip ON client_ip
• idx_detection_service ON detection_service
• idx_risk_level ON risk_level
• idx_confidence ON confidence

外键:

• user_id REFERENCES user_profile(id) ON DELETE CASCADE

---

11. user_divination_records - 用户解卦记录表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL	用户ID
trace_id	VARCHAR(64)	NOT NULL	请求追踪ID
question	TEXT	NOT NULL	用户问题
question_type	VARCHAR(50)	NOT NULL	问题类型
divination_data	LONGTEXT	NOT NULL	卦象详情JSON
deepseek_request	LONGTEXT	NOT NULL	发送给DeepSeek的请求JSON
deepseek_response	LONGTEXT		DeepSeek响应JSON
interpretation_result	LONGTEXT		解卦结果文本
api_success	BOOLEAN	NOT NULL, DEFAULT FALSE	API调用是否成功
error_message	TEXT		错误信息
api_duration_ms	BIGINT		API调用耗时(毫秒)
phone_number	VARCHAR(20)		用户手机号(冗余)
created_at	DATETIME	NOT NULL, DEFAULT CURRENT_TIMESTAMP	创建时间

索引:

• idx_user_id ON user_id
• idx_trace_id ON trace_id
• idx_phone_number ON phone_number
• idx_created_at ON created_at
• idx_api_success ON api_success
• idx_question_type ON question_type
• idx_user_created ON (user_id, created_at)

---

12. user_divination_history - 用户卦象历史同步表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NOT NULL, FK	用户ID
phone_number	VARCHAR(20)	NOT NULL	用户手机号
local_record_id	BIGINT		本地记录ID
json_data	LONGTEXT	NOT NULL	卦象详情JSON
ai_result	LONGTEXT	NOT NULL	AI解卦结果
question_type	VARCHAR(50)	NOT NULL	问题类型
question	TEXT	NOT NULL	用户问题
timestamp	BIGINT	NOT NULL	创建时间戳(毫秒)
is_active	BOOLEAN	NOT NULL, DEFAULT TRUE	是否有效
sync_time	DATETIME	NOT NULL, DEFAULT CURRENT_TIMESTAMP	同步时间
updated_at	DATETIME	NOT NULL, DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

索引:

• idx_user_phone ON (user_id, phone_number)
• idx_phone_active ON (phone_number, is_active)
• idx_user_active_time ON (user_id, is_active, timestamp)
• idx_local_record ON local_record_id
• idx_sync_time ON sync_time
• idx_question_type ON question_type

外键:

• user_id REFERENCES user_profile(id)

---

13. network_access_logs - 网络访问日志表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
user_id	BIGINT	NULL	用户ID
phone_number	VARCHAR(20)	NULL	用户手机号
client_ip	VARCHAR(45)	NOT NULL	客户端IP
client_port	INT	NULL	客户端端口
server_ip	VARCHAR(45)	NOT NULL	服务器IP
server_port	INT	NOT NULL	服务器端口
http_method	VARCHAR(10)	NOT NULL	请求方法
request_path	VARCHAR(500)	NOT NULL	请求路径
request_url	VARCHAR(1000)	NOT NULL	完整请求URL
user_agent	VARCHAR(1000)	NULL	User-Agent
device_info	TEXT	NULL	设备信息JSON
response_status	INT	NULL	HTTP响应状态码
processing_time_ms	BIGINT	NULL	处理耗时(毫秒)
request_size	BIGINT	NULL	请求体大小(字节)
response_size	BIGINT	NULL	响应体大小(字节)
x_forwarded_for	VARCHAR(500)	NULL	X-Forwarded-For
x_real_ip	VARCHAR(45)	NULL	X-Real-IP
referer	VARCHAR(1000)	NULL	Referer
operation_type	VARCHAR(50)	NULL	操作类型
operation_result	VARCHAR(20)	NULL	操作结果
error_message	TEXT	NULL	错误信息
session_id	VARCHAR(100)	NULL	会话ID
access_time	DATETIME	NOT NULL	访问时间
created_at	DATETIME	NOT NULL, DEFAULT CURRENT_TIMESTAMP	创建时间

索引:

• idx_user_id ON user_id
• idx_phone_number ON phone_number
• idx_client_ip ON client_ip
• idx_access_time ON access_time
• idx_operation_type ON operation_type
• idx_operation_result ON operation_result
• idx_client_ip_access_time ON (client_ip, access_time)
• idx_user_id_access_time ON (user_id, access_time)

---

14. app_version - 应用版本管理表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
version_name	VARCHAR(20)	UNIQUE, NOT NULL	版本名称(如v1.06)
version_code	INT	UNIQUE, NOT NULL	版本号(如106)
min_supported_version	VARCHAR(20)	NOT NULL	最低支持版本
min_supported_code	INT	NOT NULL	最低支持版本号
is_force_update	BOOLEAN	NOT NULL, DEFAULT FALSE	是否强制更新
update_message	TEXT		更新提示信息
download_url	VARCHAR(500)		下载链接
is_active	BOOLEAN	NOT NULL, DEFAULT TRUE	是否启用
created_at	DATETIME	NOT NULL, DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL, DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

索引:

• uk_version_name UNIQUE ON version_name
• uk_version_code UNIQUE ON version_code
• idx_is_active ON is_active
• idx_created_at ON created_at

---

二、app (Android 客户端本地 Room 数据库)

1. divination_record - 解卦记录表

字段	类型	约束	说明
id	BIGINT	PRIMARY KEY, AUTO_INCREMENT	主键ID
question_type	VARCHAR(50)	NOT NULL	问题类型
question	TEXT	NOT NULL	用户问题
hexagram_data	TEXT	NOT NULL	卦象数据JSON
ai_result	TEXT	NOT NULL	AI解卦结果
timestamp	BIGINT	NOT NULL	创建时间戳
is_synced	BOOLEAN	DEFAULT FALSE	是否已同步到云端
is_deleted	BOOLEAN	DEFAULT FALSE	是否已删除

---

三、数据库初始化文件位置

文件	说明
login-service/src/main/resources/db/init.sql	初始化表结构
login-service/src/main/resources/db/migration.sql	迁移脚本
login-service/src/main/resources/db/migration/V1_4__Create_sensitive_word_violations_table.sql	敏感词表创建
login-service/src/main/resources/db/migration/V1_5__Enhance_sensitive_word_violations_table.sql	敏感词表增强

---

四、Entity 类位置

Entity 类	表名	位置
UsersEntity	users	login-service/src/main/kotlin/com/eryao/login/entity/UsersEntity.kt
VerificationCode	verification_codes	login-service/src/main/kotlin/com/eryao/login/entity/VerificationCode.kt
User	user_profile	login-service/src/main/kotlin/com/eryao/login/entity/User.kt
UserToken	user_tokens	login-service/src/main/kotlin/com/eryao/login/entity/UserToken.kt
UserFeedback	user_feedback	login-service/src/main/kotlin/com/eryao/login/entity/UserFeedback.kt
UserCoin	user_coin	login-service/src/main/kotlin/com/eryao/login/entity/UserCoin.kt
Notification	notification	login-service/src/main/kotlin/com/eryao/login/entity/Notification.kt
PaymentRecord	payment_record	login-service/src/main/kotlin/com/eryao/login/entity/PaymentRecord.kt
PaymentOrder	payment_order	login-service/src/main/kotlin/com/eryao/login/entity/PaymentOrder.kt
SensitiveWordViolation	sensitive_word_violations	login-service/src/main/kotlin/com/eryao/login/entity/SensitiveWordViolation.kt
DivinationRecord	user_divination_records	login-service/src/main/kotlin/com/eryao/login/entity/DivinationRecord.kt
DivinationHistory	user_divination_history	login-service/src/main/kotlin/com/eryao/login/entity/DivinationRecord.kt
NetworkAccessLog	network_access_logs	login-service/src/main/kotlin/com/eryao/login/entity/NetworkAccessLog.kt
AppVersion	app_version	login-service/src/main/kotlin/com/eryao/login/entity/AppVersion.kt
DivinationRecord (Room)	divination_record	app/src/main/java/com/example/eryaoapp/database/DivinationRecord.kt