feat: OpenAPI 契约对齐与框架优化

主要变更：
1. OpenAPI 文档契约对齐
   - 统一错误响应字段名为 msg（非 message）
   - 规范 envelope 响应结构（code, msg, data, timestamp）
   - 个人客户路由纳入文档体系（使用 Register 机制）
   - 新增 BuildDocHandlers() 统一管理 handler 构造
   - 确保文档生成的幂等性

2. Service 层错误处理统一
   - 全面替换 fmt.Errorf 为 errors.New/Wrap
   - 统一错误码使用规范
   - Handler 层参数校验不泄露底层细节
   - 新增错误码验证集成测试

3. 代码质量提升
   - 删除未使用的 Task handler 和路由
   - 新增代码规范检查脚本（check-service-errors.sh）
   - 新增注释路径一致性检查（check-comment-paths.sh）
   - 更新 API 文档生成指南

4. OpenSpec 归档
   - 归档 openapi-contract-alignment 变更（63 tasks）
   - 归档 service-error-unify-core 变更
   - 归档 service-error-unify-support 变更
   - 归档 code-cleanup-docs-update 变更
   - 归档 handler-validation-security 变更
   - 同步 delta specs 到主规范文件

影响范围：
- pkg/openapi: 新增 handlers.go，优化 generator.go
- internal/service/*: 48 个 service 文件错误处理统一
- internal/handler/admin: 优化参数校验错误提示
- internal/routes: 个人客户路由改造，删除 task 路由
- scripts: 新增 3 个代码检查脚本
- docs: 更新 OpenAPI 文档（15750+ 行）
- openspec/specs: 同步 3 个主规范文件

破坏性变更：无
向后兼容：是

internal/service/enterprise_device/service.go

@@ -2,7 +2,6 @@ package enterprise_device
 
 import (
 	"context"
-	"fmt"
 	"time"
 
 	"github.com/break/junhong_cmp_fiber/internal/model"
@@ -62,7 +61,7 @@ func (s *Service) AllocateDevices(ctx context.Context, enterpriseID uint, req *d
 	// 查询所有设备
 	var devices []model.Device
 	if err := s.db.WithContext(ctx).Where("device_no IN ?", req.DeviceNos).Find(&devices).Error; err != nil {
-		return nil, fmt.Errorf("查询设备信息失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备信息失败")
 	}
 
 	deviceMap := make(map[string]*model.Device)
@@ -79,7 +78,7 @@ func (s *Service) AllocateDevices(ctx context.Context, enterpriseID uint, req *d
 	// 检查已授权的设备
 	existingAuths, err := s.enterpriseDeviceAuthStore.GetActiveAuthsByDeviceIDs(ctx, enterpriseID, deviceIDs)
 	if err != nil {
-		return nil, fmt.Errorf("查询已有授权失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询已有授权失败")
 	}
 
 	resp := &dto.AllocateDevicesResp{
@@ -150,7 +149,7 @@ func (s *Service) AllocateDevices(ctx context.Context, enterpriseID uint, req *d
 			}
 
 			if err := tx.Create(deviceAuths).Error; err != nil {
-				return fmt.Errorf("创建设备授权记录失败: %w", err)
+				return errors.Wrap(errors.CodeInternalError, err, "创建设备授权记录失败")
 			}
 
 			// 构建设备ID到授权ID的映射
@@ -167,7 +166,7 @@ func (s *Service) AllocateDevices(ctx context.Context, enterpriseID uint, req *d
 
 			var bindings []model.DeviceSimBinding
 			if err := tx.Where("device_id IN ? AND bind_status = 1", deviceIDsToQuery).Find(&bindings).Error; err != nil {
-				return fmt.Errorf("查询设备绑定卡失败: %w", err)
+				return errors.Wrap(errors.CodeInternalError, err, "查询设备绑定卡失败")
 			}
 
 			// 3. 为每张绑定的卡创建授权记录
@@ -187,7 +186,7 @@ func (s *Service) AllocateDevices(ctx context.Context, enterpriseID uint, req *d
 				}
 
 				if err := tx.Create(cardAuths).Error; err != nil {
-					return fmt.Errorf("创建卡授权记录失败: %w", err)
+					return errors.Wrap(errors.CodeInternalError, err, "创建卡授权记录失败")
 				}
 			}
 
@@ -235,7 +234,7 @@ func (s *Service) RecallDevices(ctx context.Context, enterpriseID uint, req *dto
 	// 查询设备
 	var devices []model.Device
 	if err := s.db.WithContext(ctx).Where("device_no IN ?", req.DeviceNos).Find(&devices).Error; err != nil {
-		return nil, fmt.Errorf("查询设备信息失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备信息失败")
 	}
 
 	deviceMap := make(map[string]*model.Device)
@@ -248,7 +247,7 @@ func (s *Service) RecallDevices(ctx context.Context, enterpriseID uint, req *dto
 	// 检查授权状态
 	existingAuths, err := s.enterpriseDeviceAuthStore.GetActiveAuthsByDeviceIDs(ctx, enterpriseID, deviceIDs)
 	if err != nil {
-		return nil, fmt.Errorf("查询授权状态失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询授权状态失败")
 	}
 
 	resp := &dto.RecallDevicesResp{
@@ -292,13 +291,13 @@ func (s *Service) RecallDevices(ctx context.Context, enterpriseID uint, req *dto
 		err := s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 			// 1. 撤销设备授权
 			if err := s.enterpriseDeviceAuthStore.RevokeByIDs(ctx, deviceAuthsToRevoke, currentUserID); err != nil {
-				return fmt.Errorf("撤销设备授权失败: %w", err)
+				return errors.Wrap(errors.CodeInternalError, err, "撤销设备授权失败")
 			}
 
 			// 2. 级联撤销卡授权
 			for _, authID := range deviceAuthsToRevoke {
 				if err := s.enterpriseCardAuthStore.RevokeByDeviceAuthID(ctx, authID, currentUserID); err != nil {
-					return fmt.Errorf("撤销卡授权失败: %w", err)
+					return errors.Wrap(errors.CodeInternalError, err, "撤销卡授权失败")
 				}
 			}
 
@@ -333,7 +332,7 @@ func (s *Service) ListDevices(ctx context.Context, enterpriseID uint, req *dto.E
 
 	auths, total, err := s.enterpriseDeviceAuthStore.ListByEnterprise(ctx, opts)
 	if err != nil {
-		return nil, fmt.Errorf("查询授权记录失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询授权记录失败")
 	}
 
 	if len(auths) == 0 {
@@ -358,7 +357,7 @@ func (s *Service) ListDevices(ctx context.Context, enterpriseID uint, req *dto.E
 		query = query.Where("device_no LIKE ?", "%"+req.DeviceNo+"%")
 	}
 	if err := query.Find(&devices).Error; err != nil {
-		return nil, fmt.Errorf("查询设备信息失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备信息失败")
 	}
 
 	// 统计每个设备的绑定卡数量
@@ -366,7 +365,7 @@ func (s *Service) ListDevices(ctx context.Context, enterpriseID uint, req *dto.E
 	if err := s.db.WithContext(ctx).
 		Where("device_id IN ? AND bind_status = 1", deviceIDs).
 		Find(&bindings).Error; err != nil {
-		return nil, fmt.Errorf("查询设备绑定卡失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备绑定卡失败")
 	}
 
 	cardCountMap := make(map[uint]int)
@@ -410,7 +409,7 @@ func (s *Service) ListDevicesForEnterprise(ctx context.Context, req *dto.Enterpr
 
 	auths, total, err := s.enterpriseDeviceAuthStore.ListByEnterprise(ctx, opts)
 	if err != nil {
-		return nil, fmt.Errorf("查询授权记录失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询授权记录失败")
 	}
 
 	if len(auths) == 0 {
@@ -435,14 +434,14 @@ func (s *Service) ListDevicesForEnterprise(ctx context.Context, req *dto.Enterpr
 		query = query.Where("device_no LIKE ?", "%"+req.DeviceNo+"%")
 	}
 	if err := query.Find(&devices).Error; err != nil {
-		return nil, fmt.Errorf("查询设备信息失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备信息失败")
 	}
 
 	var bindings []model.DeviceSimBinding
 	if err := s.db.WithContext(skipCtx).
 		Where("device_id IN ? AND bind_status = 1", deviceIDs).
 		Find(&bindings).Error; err != nil {
-		return nil, fmt.Errorf("查询设备绑定卡失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备绑定卡失败")
 	}
 
 	cardCountMap := make(map[uint]int)
@@ -485,14 +484,14 @@ func (s *Service) GetDeviceDetail(ctx context.Context, deviceID uint) (*dto.Ente
 
 	var device model.Device
 	if err := s.db.WithContext(skipCtx).Where("id = ?", deviceID).First(&device).Error; err != nil {
-		return nil, fmt.Errorf("查询设备信息失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备信息失败")
 	}
 
 	var bindings []model.DeviceSimBinding
 	if err := s.db.WithContext(skipCtx).
 		Where("device_id = ? AND bind_status = 1", deviceID).
 		Find(&bindings).Error; err != nil {
-		return nil, fmt.Errorf("查询设备绑定卡失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "查询设备绑定卡失败")
 	}
 
 	cardIDs := make([]uint, 0, len(bindings))
@@ -504,7 +503,7 @@ func (s *Service) GetDeviceDetail(ctx context.Context, deviceID uint) (*dto.Ente
 	cardInfos := make([]dto.DeviceCardInfo, 0)
 	if len(cardIDs) > 0 {
 		if err := s.db.WithContext(skipCtx).Where("id IN ?", cardIDs).Find(&cards).Error; err != nil {
-			return nil, fmt.Errorf("查询卡信息失败: %w", err)
+			return nil, errors.Wrap(errors.CodeInternalError, err, "查询卡信息失败")
 		}
 
 		carrierIDs := make([]uint, 0, len(cards))
@@ -556,7 +555,7 @@ func (s *Service) SuspendCard(ctx context.Context, deviceID, cardID uint, req *d
 	if err := s.db.WithContext(skipCtx).Model(&model.IotCard{}).
 		Where("id = ?", cardID).
 		Update("network_status", 0).Error; err != nil {
-		return nil, fmt.Errorf("停机操作失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "停机操作失败")
 	}
 
 	return &dto.DeviceCardOperationResp{
@@ -574,7 +573,7 @@ func (s *Service) ResumeCard(ctx context.Context, deviceID, cardID uint, req *dt
 	if err := s.db.WithContext(skipCtx).Model(&model.IotCard{}).
 		Where("id = ?", cardID).
 		Update("network_status", 1).Error; err != nil {
-		return nil, fmt.Errorf("复机操作失败: %w", err)
+		return nil, errors.Wrap(errors.CodeInternalError, err, "复机操作失败")
 	}
 
 	return &dto.DeviceCardOperationResp{