feat: 实现 C 端完整认证系统(client-auth-system)

实现面向个人客户的 7 个认证接口(A1-A7),覆盖资产验证、
微信公众号/小程序登录、手机号绑定/换绑、退出登录完整流程。

主要变更:
- 新增 PersonalCustomerOpenID 模型,支持多 AppID 多 OpenID 管理
- 实现有状态 JWT(JWT + Redis 双重校验),支持服务端主动失效
- 扩展微信 SDK:小程序 Code2Session + 3 个 DB 动态工厂函数
- 实现 A1 资产验证 IP 限流(30/min)和 A4 三层验证码限流
- 新增 7 个错误码(1180-1186)和 6 个 Redis Key 函数
- 注册 /api/c/v1/auth/* 下 7 个端点并更新 OpenAPI 文档
- 数据库迁移 000083:新建 tb_personal_customer_openid 表
This commit is contained in:
2026-03-19 11:33:41 +08:00
parent ec86dbf463
commit df76e33105
35 changed files with 4348 additions and 1362 deletions

View File

@@ -0,0 +1,58 @@
package postgres
import (
"context"
"github.com/break/junhong_cmp_fiber/internal/model"
"gorm.io/gorm"
)
// PersonalCustomerOpenIDStore 个人客户 OpenID 关联数据访问层
type PersonalCustomerOpenIDStore struct {
db *gorm.DB
}
// NewPersonalCustomerOpenIDStore 创建个人客户 OpenID Store
func NewPersonalCustomerOpenIDStore(db *gorm.DB) *PersonalCustomerOpenIDStore {
return &PersonalCustomerOpenIDStore{db: db}
}
// FindByAppIDAndOpenID 根据 AppID 和 OpenID 查询关联记录
func (s *PersonalCustomerOpenIDStore) FindByAppIDAndOpenID(ctx context.Context, appID, openID string) (*model.PersonalCustomerOpenID, error) {
var record model.PersonalCustomerOpenID
if err := s.db.WithContext(ctx).
Where("app_id = ? AND open_id = ?", appID, openID).
First(&record).Error; err != nil {
return nil, err
}
return &record, nil
}
// FindByUnionID 根据 UnionID 查询首条关联记录
func (s *PersonalCustomerOpenIDStore) FindByUnionID(ctx context.Context, unionID string) (*model.PersonalCustomerOpenID, error) {
var record model.PersonalCustomerOpenID
if err := s.db.WithContext(ctx).
Where("union_id = ?", unionID).
Order("id ASC").
First(&record).Error; err != nil {
return nil, err
}
return &record, nil
}
// Create 创建 OpenID 关联记录
func (s *PersonalCustomerOpenIDStore) Create(ctx context.Context, record *model.PersonalCustomerOpenID) error {
return s.db.WithContext(ctx).Create(record).Error
}
// ListByCustomerID 根据客户 ID 查询所有 OpenID 关联记录
func (s *PersonalCustomerOpenIDStore) ListByCustomerID(ctx context.Context, customerID uint) ([]*model.PersonalCustomerOpenID, error) {
var records []*model.PersonalCustomerOpenID
if err := s.db.WithContext(ctx).
Where("customer_id = ?", customerID).
Order("id ASC").
Find(&records).Error; err != nil {
return nil, err
}
return records, nil
}