csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
41 Commits 1 Branch 0 Tags
2570269c8d187a5a579258535f382f4f34da492f
Commit Graph

21 Commits

Author SHA1 Message Date
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
1b9080e3ab 实现角色权限体系重构 
本次提交完成了角色权限体系的重构，主要包括：

1. 数据库迁移
   - 添加 tb_permission.platform 字段（all/web/h5）
   - 更新 tb_role.role_type 注释（1=平台角色，2=客户角色）

2. GORM 模型更新
   - Permission 模型添加 Platform 字段
   - Role 模型更新 RoleType 注释

3. 常量定义
   - 新增角色类型常量（RoleTypePlatform, RoleTypeCustomer）
   - 新增权限端口常量（PlatformAll, PlatformWeb, PlatformH5）
   - 添加角色类型与用户类型匹配规则函数

4. Store 层实现
   - Permission Store 支持按 platform 过滤
   - Account Role Store 添加 CountByAccountID 方法

5. Service 层实现
   - 角色分配支持类型匹配校验
   - 角色分配支持数量限制（超级管理员0个，平台用户无限制，代理/企业1个）
   - Permission Service 支持 platform 过滤

6. 权限校验中间件
   - 实现 RequirePermission、RequireAnyPermission、RequireAllPermissions
   - 支持 platform 字段过滤
   - 支持跳过超级管理员检查

7. 测试用例
   - 角色类型匹配规则单元测试
   - 角色分配数量限制单元测试
   - 权限 platform 过滤单元测试
   - 权限校验中间件集成测试（占位）

8. 代码清理
   - 删除过时的 subordinate 测试文件
   - 移除 Account.ParentID 相关引用
   - 更新 DTO 验证规则

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 09:51:52 +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
4df3c12328 少提交的东西 2026-01-06 11:07:29 +08:00
huang
e907315afa 处理返回编码未设置的问题 2025-12-20 10:23:50 +08:00
huang
478e37903b 添加callback,迁移文件 2025-12-15 14:37:34 +08:00
huang
d66323487b refactor: align framework cleanup with new bootstrap flow 
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
 2025-11-19 12:47:25 +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
ea0c6a8b16 测试一下修复一部分问题 2025-11-11 18:15:39 +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
39c5b524a9 备份一下 2025-11-11 15:53:01 +08:00
huang
e98dd4d725 做完了一部分,备份一下,防止以外删除 2025-11-11 15:16:38 +08:00
huang
9600e5b6e0 做一次小小的备份,等会又删掉了 2025-11-11 10:09:45 +08:00
huang
37c4404293 初始化项目结构 2025-11-10 15:57:21 +08:00