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 个主规范文件

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

cmd/gendocs/main.go

@@ -7,9 +7,6 @@ import (
 	"github.com/gofiber/fiber/v2"
 
 	"github.com/break/junhong_cmp_fiber/internal/bootstrap"
-	"github.com/break/junhong_cmp_fiber/internal/handler/admin"
-	"github.com/break/junhong_cmp_fiber/internal/handler/callback"
-	"github.com/break/junhong_cmp_fiber/internal/handler/h5"
 	"github.com/break/junhong_cmp_fiber/internal/routes"
 	"github.com/break/junhong_cmp_fiber/pkg/openapi"
 )
@@ -33,39 +30,7 @@ func generateAdminDocs(outputPath string) error {
 	app := fiber.New()
 
 	// 3. 创建 Handler（使用 nil 依赖,因为只需要路由结构）
-	handlers := &bootstrap.Handlers{
-		AdminAuth:                   admin.NewAuthHandler(nil, nil),
-		H5Auth:                      h5.NewAuthHandler(nil, nil),
-		Account:                     admin.NewAccountHandler(nil),
-		Role:                        admin.NewRoleHandler(nil, nil),
-		Permission:                  admin.NewPermissionHandler(nil),
-		Shop:                        admin.NewShopHandler(nil),
-		ShopAccount:                 admin.NewShopAccountHandler(nil),
-		ShopCommission:              admin.NewShopCommissionHandler(nil),
-		CommissionWithdrawal:        admin.NewCommissionWithdrawalHandler(nil),
-		CommissionWithdrawalSetting: admin.NewCommissionWithdrawalSettingHandler(nil),
-		Enterprise:                  admin.NewEnterpriseHandler(nil),
-		EnterpriseCard:              admin.NewEnterpriseCardHandler(nil),
-		EnterpriseDevice:            admin.NewEnterpriseDeviceHandler(nil),
-		EnterpriseDeviceH5:          h5.NewEnterpriseDeviceHandler(nil),
-		Authorization:               admin.NewAuthorizationHandler(nil),
-		CustomerAccount:             admin.NewCustomerAccountHandler(nil),
-		MyCommission:                admin.NewMyCommissionHandler(nil),
-		IotCard:                     admin.NewIotCardHandler(nil),
-		IotCardImport:               admin.NewIotCardImportHandler(nil),
-		Device:                      admin.NewDeviceHandler(nil),
-		DeviceImport:                admin.NewDeviceImportHandler(nil),
-		AssetAllocationRecord:       admin.NewAssetAllocationRecordHandler(nil),
-		Storage:                     admin.NewStorageHandler(nil),
-		Carrier:                     admin.NewCarrierHandler(nil),
-		PackageSeries:               admin.NewPackageSeriesHandler(nil),
-		Package:                     admin.NewPackageHandler(nil),
-		ShopSeriesAllocation:        admin.NewShopSeriesAllocationHandler(nil),
-		ShopPackageAllocation:       admin.NewShopPackageAllocationHandler(nil),
-		AdminOrder:                  admin.NewOrderHandler(nil),
-		H5Order:                     h5.NewOrderHandler(nil),
-		PaymentCallback:             callback.NewPaymentHandler(nil),
-	}
+	handlers := openapi.BuildDocHandlers()
 
 	// 4. 注册所有路由到文档生成器
 	routes.RegisterRoutesWithDoc(app, handlers, &bootstrap.Middlewares{}, adminDoc)