Changelog

[v1.0.10] - 2026-05-19

文档更新

• 根 README 全面升级至第 7 代架构文档：gen/ 隔离层、sqlc 数据层契约、DAO 测试体系
• tikrok-services README 全面重写：数据访问层架构、事务模式、测试分层、错误处理

[v1.0.9] - 2026-05-18

sqlc 数据层重构（第 7 代核心）

• sqlc.yaml 配置优化：emit_interface: true、query_parameter_limit: 3、emit_pointers_for_null_types: true
• 41 处 SELECT * 全部替换为显式列名
• DAO 构造器从 *db.Queries 变更为 db.Querier 接口，实现 Mock 可测试
• 消除 200+ 处 sql.NullX 手动转换代码
• 20 个 DAO 实现 WithTx(*sql.Tx) DAO 事务抽象

测试基础设施

• 5 个服务生成 MockQuerier （ gomock + mockgen ）
• 63 个 DAO 单元测试：auth(26)、order(19)、tunnel(19)
• 创建 pkg/testutil/sqlctest 包：轻量 Docker MySQL 测试助手
• 2 个集成测试：HandlePaymentCallback 事务原子性验证
• 9 个 Bash API 测试脚本覆盖全 API 面

错误处理

• 所有 GetByID/GetByEmail 将 sql.ErrNoRows 封装为 BizError（ ErrNotFound ）
• 逻辑层不再处理原始 sql.ErrNoRows

[v1.0.8] - 2026-05-17

gen/ 接口隔离层

• 创建 gen/ 目录：5 个纯 RPC 接口模块（ auth/user/order/product/tunnel ）
• 每个 gen 模块仅 15 行 go.mod 、~2.7K go.sum ，不含业务代码
• 修改 proto go_package 指向 gen/ 模块路径
• 更新所有服务导入路径从 app/*/kitex_gen 指向 gen/*
• Gateway 消费方只依赖 gen/*，不接触 app/*
• gen/ 模块可安全对外发布（不泄露业务实现）

Docker 部署优化

• 切换为预编译二进制多阶段构建
• 版本管理自动化（ VERSION 文件 + build-images.sh ）
• Docker Compose 版本自增 + 旧镜像清理

[v1.0.7] - 2026-05-16

多模块工作区重构

• 7 个子模块独立 go.mod/go.sum，由 go.work 统一管理
• 消除内部 replace 依赖，模块可独立构建
• BizError 实现 GRPCStatus() 方法，支持 gRPC 错误码透明传输
• 修复所有记录创建时缺失 CreatedAt 时间戳的问题
• 测试脚本错误码断言统一修复

[v1.0.6] - 2026-05-15

GORM → sqlc+Goose 迁移

• 移除 GORM ，替换为 sqlc 代码生成框架 + Goose 迁移工具
• 创建 22 个数据库迁移文件（ 00001-00022 ）
• sqlc 生成类型安全的数据访问代码（ Queries 结构体）
• 降低默认免费配额限制
• 提交全部 sqlc 生成代码及查询文件

Code Review 修复

• Uber Go 风格指南修复：goroutine 生命周期、全局变量、切片容量
• 安全修复：内部 API 认证、IDOR 、资源泄漏、CORS
• 泛型工具函数 + 100 Go Mistakes 修复
• 连接泄漏、并发安全、Context 传播、Etcd 锁重构
• Jeepay 子模块引用更新（连接泄漏修复）
• 订单数据流修复、静默错误处理、种子数据补充

[v1.0.5] - 2026-05-14

生产部署安全加固

• Vault 加密敏感配置
• 微服务角色分离
• MySQL 自动备份
• Ansible 集成 tikrok-services 微服务部署

流量计费链路完善

• HandleTrafficReport/ReportTraffic/Heartbeat 持久化
• 内部 API 和流量上报路由注册
• ServiceConnector 统一管理 gRPC 连接

Gateway 精简重构

• 删除 SQLite 存储层，容器化部署
• 删除 payment/sso/sse 子系统（迁移至 tikrok-services ）
• 删除业务逻辑 handler 和中间件（迁移至 tikrok-services ）
• 重写 gRPC 客户端，使用 HTTP gateway 替代直接 gRPC 调用

[v1.0.4] - 2026-05-13

安全与稳定性

• 修复管理员端点 403 和列表返回 null 的问题
• 修复 API Key 认证和令牌失效（ Logout 递增 TokenVersion ）
• 修复 MySQL 保留关键字 key 导致查询失败
• 修复 API Key 创建时零日期 MySQL 拒绝
• 添加 Gin 中间件 X-API-Key 认证
• 更新 Swagger 文档补充缺失路由和 definitions
• 后端全部缺失的 gRPC RPC 方法实现

[v1.0.3] - 2026-05-12

微服务功能完善

• HTTP Gateway 从 Hertz 迁移到 Gin 框架
• 9 个 Bash API 测试脚本（认证、密码、API Key 、配额、隧道、管理后台）
• etcd 服务发现修复：Docker 环境地址注册
• Swagger 文档和端到端测试基础设施
• Casdoor SSO 集成（ OAuth/OIDC 回调、用户同步）
• ServiceConnector 统一 gRPC 连接管理器

[v1.0.2] - 2026-05-11

平台基础设施

• 微服务集群 Docker 容器部署（ 12 容器 5 层依赖）
• 商品与授权系统设计
• Goose 数据库迁移任务和部署步骤
• etcd 服务实现自动重连与性能优化
• 修复 CRITICAL 和 WARNING 级别安全问题及代码缺陷

[v1.0.1] - 2026-05-10

• 项目全面清理与 gateway → tikrokd-server 重命名
• SDK 重构：移除所有非共享网络库包
• 完成 SDK 模块化，提炼 tikrok-sdk 核心包

[v1.0.0] - 2026-05-09

初始架构定型

• 第 6 代 gRPC + Gin 微服务架构
• SDK 模块化（ quic/protocol/tunnel/mux/discovery/pool/metrics ）
• QUIC 数据面与服务端（ tikrokd-server ）
• 客户端 CLI （ tikrok ）
• etcd 服务注册与发现
• MySQL + Redis 持久化
• JWT + API Key 认证
• Prometheus + Grafana 监控
• Ansible 自动化部署
• 36 项 E2E 自动化验证
• Jeepay 支付、Casdoor SSO 集成