csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
66 Commits 1 Branch 0 Tags
08736d2692bcd6e0c9b7f1cd25b6fff9f0fe9026
Commit Graph

22 Commits

Author SHA1 Message Date
huang
589197e284 添加 Docker 和 CI/CD 配置（无 SSH 方案）
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 0s
Details
2026-01-19 14:56:40 +08:00
huang
028cfaa7aa feat: 实现权限检查功能并添加Redis缓存优化 
- 完成 CheckPermission 方法的完整实现（账号→角色→权限查询链）
- 实现 Redis 缓存机制，大幅提升权限查询性能（~12倍提升）
- 自动缓存失效：角色/权限变更时清除相关用户缓存
- 新增完整的单元测试和集成测试（10个测试用例全部通过）
- 添加权限检查使用文档和缓存机制说明
- 归档 implement-permission-check OpenSpec 提案

性能优化：
- 首次查询: ~18ms（3次DB查询 + 1次Redis写入）
- 缓存命中: ~1.5ms（1次Redis查询）
- TTL: 30分钟，自动失效机制保证数据一致性
 2026-01-16 18:15:32 +08:00
huang
18f35f3ef4 feat: 完成B端认证系统和商户管理模块测试补全 
主要变更：
- 新增B端认证系统（后台+H5）：登录、登出、Token刷新、密码修改
- 完善商户管理和商户账号管理功能
- 补全单元测试（ShopService: 72.5%, ShopAccountService: 79.8%）
- 新增集成测试（商户管理+商户账号管理）
- 归档OpenSpec提案（add-shop-account-management, implement-b-end-auth-system）
- 完善文档（使用指南、API文档、认证架构说明）

测试统计：
- 13个测试套件，37个测试用例，100%通过率
- 平均覆盖率76.2%，达标

OpenSpec验证：通过（strict模式）
 2026-01-15 18:15:17 +08:00
huang
9c399df6bc feat(auth): 新增系统启动时自动初始化默认超级管理员功能 
- 新增默认管理员自动初始化逻辑，系统启动时检查并创建超级管理员账号
- 支持通过配置文件自定义账号信息（优先级：配置文件 > 代码默认值）
- 新增 CreateSystemAccount 方法用于系统内部账号创建
- 新增默认管理员配置项和常量定义
- 更新 README.md 添加默认账号使用说明
- 归档 OpenSpec 变更提案及完整文档

相关文件：
- internal/bootstrap/admin.go: 管理员初始化逻辑
- internal/service/account/service.go: 系统账号创建方法
- pkg/config/config.go: 默认管理员配置结构
- pkg/constants/constants.go: 默认值常量定义
- docs/add-default-admin-init/功能说明.md: 完整功能文档
 2026-01-14 10:53:42 +08:00
huang
2570269c8d feat(wallet,tag): 钱包和标签系统多租户改造 
核心变更：
- 钱包表：删除 user_id，添加 resource_type/resource_id（绑定资源而非用户）
- 标签表：添加 enterprise_id/shop_id（实现三级隔离：全局/企业/店铺）
- GORM Callback：自动数据权限过滤
- 迁移脚本：可重复执行，已验证回滚功能

钱包归属重构原因：
- 旧设计：钱包绑定用户账号，个人客户卡/设备转手后新用户无法使用余额
- 新设计：钱包绑定资源（卡/设备/店铺），余额随资源流转

标签三级隔离：
- 平台全局标签：所有用户可见
- 企业标签：仅该企业可见（企业内唯一）
- 店铺标签：该店铺及下级可见（店铺内唯一）

测试覆盖：
- 9 个单元测试验证标签多租户过滤（全部通过）
- 迁移和回滚功能测试通过（测试环境）
- OpenSpec 验证通过

变更 ID: fix-wallet-tag-multi-tenant
迁移版本: 000008
参考: openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/
 2026-01-13 16:52:37 +08:00
huang
6e2dc325d7 新增钱包、换卡、标签系统的数据模型和规范 
本次提交完成 add-wallet-transfer-tag-models 提案的实施和归档：

## 新增功能模块
- 钱包系统：用户/代理钱包管理，支持充值、扣款、退款、乐观锁防并发
- 换卡记录：物联卡更换历史追溯，包含套餐快照（JSONB）
- 标签系统：设备/IoT卡/号卡的统一标签管理
- 运营商渠道：四大运营商（CMCC/CUCC/CTCC/CBN）的渠道管理

## 数据库变更
- 新增 6 张表：tb_wallet, tb_wallet_transaction, tb_recharge_record, tb_card_replacement_record, tb_tag, tb_resource_tag
- 修改 2 张表：tb_carrier（新增渠道字段）, tb_order（新增混合支付字段）
- 迁移版本：v6 → v7（执行时间 282.5ms）

## 代码变更
- 新增 8 个 Go 模型（符合统一规范：gorm.Model + BaseModel）
- 新增 40+ 个常量定义（含完整中文注释）
- 新增 7 个 Redis Key 生成函数
- 修复模型规范：移除重复字段，统一使用 gorm.Model 嵌入

## 文档变更
- 新增 3 个业务文档：数据模型设计、字段说明、迁移验证报告
- 更新 AGENTS.md：新增 Model 模型规范和常量注释规范
- 新增 4 个 OpenSpec 规范：wallet, carrier, card-replacement, tag
- 更新 1 个 OpenSpec 规范：iot-order（支持混合支付）

## 验证通过
- ✅ LSP 诊断：所有模型和常量文件无错误
- ✅ OpenSpec 验证：openspec validate --strict 通过
- ✅ 迁移执行：表结构创建成功，索引正确
- ✅ 提案归档：2026-01-13-add-wallet-transfer-tag-models

变更文件统计：29 个文件，新增 3682 行
 2026-01-13 15:47:32 +08:00
huang
867e97af11 重构：统一 IoT 模型到 internal/model/ 目录 
将所有 IoT 相关的数据模型从 internal/iot/model/ 迁移到 internal/model/，
实现全局统一的模型层架构，符合项目横向分层设计原则。

变更内容：
- 迁移 11 个 IoT 模型文件（carrier, iot_card, device, order, package 等）
- 删除 internal/iot/model/ 目录
- 更新文档中的模型路径引用（25 处）
- 创建重构总结文档
- 归档 OpenSpec 变更为 2026-01-12-refactor-iot-model-location
- 创建 model-organization 规格文档

验证结果：
- 编译通过（go build 成功）
- 静态分析通过（go vet 无错误）
- 代码格式通过（go fmt 无变更）
- 无 Go 代码引用旧路径

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-12 16:01:53 +08:00
huang
034f00e2e7 实现 IoT SIM 管理模块数据模型和数据库结构 
- 添加 IoT 核心业务表：运营商、IoT 卡、设备、号卡、套餐、订单等
- 添加分佣系统表：分佣规则、分佣记录、运营商结算等
- 添加轮询和流量管理表：轮询配置、流量使用记录等
- 添加财务和系统管理表：佣金提现、换卡申请等
- 实现完整的 GORM 模型和常量定义
- 添加数据库迁移脚本和详细文档
- 集成 OpenSpec 工作流工具（opsx 命令和 skills）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-12 15:44:23 +08:00
huang
743db126f7 重构数据权限模型并清理旧RBAC代码 
核心变更：
- 数据权限过滤从基于账号层级改为基于用户类型的多策略过滤
- 移除 AccountStore 中的 GetSubordinateIDs 等旧方法
- 重构认证中间件，支持 enterprise_id 和 customer_id
- 更新 GORM Callback，根据用户类型自动选择过滤策略（代理/企业/个人客户）
- 更新所有集成测试以适配新的 API 签名
- 添加功能总结文档和 OpenSpec 归档

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 15:08:11 +08:00
huang
9c6d4a3bd4 实现个人客户微信认证和短信验证功能 
- 添加个人客户微信登录和手机验证码登录接口
- 实现个人客户设备、ICCID、手机号关联管理
- 添加短信发送服务（HTTP 客户端）
- 添加微信认证服务（含 mock 实现）
- 添加 JWT Token 生成和验证工具
- 创建数据库迁移脚本（personal_customer 关联表）
- 修复测试文件中的路由注册参数错误
- 重构 scripts 目录结构（分离独立脚本到子目录）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 11:42:38 +08:00
huang
a36e4a79c0 实现用户和组织模型（店铺、企业、个人客户） 
核心功能：
- 实现 7 级店铺层级体系（Shop 模型 + 层级校验）
- 实现企业管理模型（Enterprise 模型）
- 实现个人客户管理模型（PersonalCustomer 模型）
- 重构 Account 模型关联关系（基于 EnterpriseID 而非 ParentID）
- 完整的 Store 层和 Service 层实现
- 递归查询下级店铺功能（含 Redis 缓存）
- 全面的单元测试覆盖（Shop/Enterprise/PersonalCustomer Store + Shop Service）

技术要点：
- 显式指定所有 GORM 模型的数据库字段名（column: 标签）
- 统一的字段命名规范（数据库用 snake_case，Go 用 PascalCase）
- 完整的中文字段注释和业务逻辑说明
- 100% 测试覆盖（20+ 测试用例全部通过）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-09 18:02:46 +08:00
huang
6fc90abeb6 实现服务启动时自动生成OpenAPI文档 
主要变更:
1. 新增 cmd/api/docs.go 实现文档自动生成逻辑
2. 修改 cmd/api/main.go 在服务启动时调用文档生成
3. 重构 cmd/gendocs/main.go 提取生成函数
4. 更新 .gitignore 忽略自动生成的 openapi.yaml
5. 新增 Makefile 支持 make docs 命令
6. OpenSpec 框架更新和变更归档

功能特性:
- 服务启动时自动生成 OpenAPI 文档到项目根目录
- 保留独立的文档生成工具 (make docs)
- 生成失败时记录错误但不影响服务启动
- 所有代码已通过 openspec validate --strict 验证

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-09 12:25:50 +08:00
huang
2d566a9820 1. 需求确认 
2. 结构的一些变更
 2026-01-06 11:07:04 +08:00
huang
7a8aac1f73 需求疑问准备 2025-12-19 16:10:33 +08:00
huang
ad946af5ee add: 提交部分表设计 
update: 1.所有model嵌入gorm公用model 2.所有model嵌入BaseModel
 2025-12-15 11:32:33 +08:00
huang
4455b39e42 添加分佣文档说明 2025-11-28 11:24:39 +08:00
huang
eaa70ac255 feat: 实现 RBAC 权限系统和数据权限控制 (004-rbac-data-permission) 
主要功能:
- 实现完整的 RBAC 权限系统（账号、角色、权限的多对多关联）
- 基于 owner_id + shop_id 的自动数据权限过滤
- 使用 PostgreSQL WITH RECURSIVE 查询下级账号
- Redis 缓存优化下级账号查询性能（30分钟过期）
- 支持多租户数据隔离和层级权限管理

技术实现:
- 新增 Account、Role、Permission 模型及关联关系表
- 实现 GORM Scopes 自动应用数据权限过滤
- 添加数据库迁移脚本（000002_rbac_data_permission、000003_add_owner_id_shop_id）
- 完善错误码定义（1010-1027 为 RBAC 相关错误）
- 重构 main.go 采用函数拆分提高可读性

测试覆盖:
- 添加 Account、Role、Permission 的集成测试
- 添加数据权限过滤的单元测试和集成测试
- 添加下级账号查询和缓存的单元测试
- 添加 API 回归测试确保向后兼容

文档更新:
- 更新 README.md 添加 RBAC 功能说明
- 更新 CLAUDE.md 添加技术栈和开发原则
- 添加 docs/004-rbac-data-permission/ 功能总结和使用指南

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-11-18 16:44:06 +08:00
huang
fb83c9a706 feat: 实现统一错误处理系统 (003-error-handling) 
- 新增统一错误码定义和管理 (pkg/errors/codes.go)
- 新增全局错误处理器和中间件 (pkg/errors/handler.go, internal/middleware/error_handler.go)
- 新增错误上下文管理 (pkg/errors/context.go)
- 增强 Panic 恢复中间件 (internal/middleware/recover.go)
- 新增完整的单元测试和集成测试
- 新增功能文档 (docs/003-error-handling/)
- 新增功能规范 (specs/003-error-handling/)
- 更新 CLAUDE.md 和 README.md
 2025-11-15 12:17:44 +08:00
huang
984ccccc63 docs(constitution): 新增数据库设计原则(v2.4.0) 
在项目宪章中新增第九条原则"数据库设计原则"，明确禁止使用数据库外键约束和ORM关联标签。

主要变更：
- 新增原则IX：数据库设计原则（Database Design Principles）
- 强制要求：数据库表不得使用外键约束
- 强制要求：GORM模型不得使用ORM关联标签（foreignKey、hasMany等）
- 强制要求：表关系必须通过ID字段手动维护
- 强制要求：关联数据查询必须显式编写，避免ORM魔法
- 强制要求：时间字段由GORM处理，不使用数据库触发器

设计理念：
- 提升业务逻辑灵活性（无数据库约束限制）
- 优化高并发性能（无外键检查开销）
- 增强代码可读性（显式查询，无隐式预加载）
- 简化数据库架构和迁移流程
- 支持分布式和微服务场景

版本升级：2.3.0 → 2.4.0（MINOR）
 2025-11-13 13:40:19 +08:00
huang
1f71741836 完成 Phase 10 质量保证，项目达到生产部署标准 
主要变更：
- ✅ 完成所有文档任务（T092-T095a）
  * 创建中文 README.md 和项目文档
  * 添加限流器使用指南
  * 更新快速入门文档
  * 添加详细的中文代码注释

- ✅ 完成代码质量任务（T096-T103）
  * 通过 gofmt、go vet、golangci-lint 检查
  * 修复 17 个 errcheck 问题
  * 验证无硬编码 Redis key
  * 确保命名规范符合 Go 标准

- ✅ 完成测试任务（T104-T108）
  * 58 个测试全部通过
  * 总体覆盖率 75.1%（超过 70% 目标）
  * 核心模块覆盖率 90%+

- ✅ 完成安全审计任务（T109-T113）
  * 修复日志中令牌泄露问题
  * 验证 Fail-closed 策略正确实现
  * 审查 Redis 连接安全
  * 完成依赖项漏洞扫描

- ✅ 完成性能验证任务（T114-T117）
  * 令牌验证性能：17.5 μs/op（~58,954 ops/s）
  * 响应序列化性能：1.1 μs/op（>1,000,000 ops/s）
  * 配置访问性能：0.58 ns/op（接近 CPU 缓存速度）

- ✅ 完成质量关卡任务（T118-T126）
  * 所有测试通过
  * 代码格式和静态检查通过
  * 无 TODO/FIXME 遗留
  * 中间件集成验证
  * 优雅关闭机制验证

新增文件：
- README.md（中文项目文档）
- docs/rate-limiting.md（限流器指南）
- docs/security-audit-report.md（安全审计报告）
- docs/performance-benchmark-report.md（性能基准报告）
- docs/quality-gate-report.md（质量关卡报告）
- docs/PROJECT-COMPLETION-SUMMARY.md（项目完成总结）
- 基准测试文件（config, response, validator）

安全修复：
- 移除 pkg/validator/token.go 中的敏感日志记录

质量评分：9.6/10（优秀）
项目状态：✅ 已完成，待部署
 2025-11-11 16:53:05 +08:00
huang
9600e5b6e0 做一次小小的备份,等会又删掉了 2025-11-11 10:09:45 +08:00
huang
37c4404293 初始化项目结构 2025-11-10 15:57:21 +08:00