Ios App Store
iOS App Store 发布工作流 — TestFlight 构建脚本、Info.plist 配置、IDFV/ATT 隐私字段、Privacy Manifest、IAP capability 与服务端 JWS 验证、APNs 推送、TestFlight train-closed 409 应对、隐私营养标签。
Flutter Coding Conventions
Flutter 应用通用工程规范 — 目录布局、Riverpod 状态管理、go_router 路由、Freezed 数据类、多租户 Provider 重置、持久化 ID 反查、AI 扣费 try/catch refundWithRetry、i18n 多语言、Coach Mark / WizardExitGuard / Contra UI 原语、buildNumber + Changelog 纪律。
Cn Android Flavor
中国大陆市场 Android Flavor — JPush 极光推送、微信 (fluwx) / 支付宝 (tobias) SDK、阿里云 Green 内容审核、`fonts.loli.net` 镜像、ICP 备案应用名规则、隐式标识技术说明文档模板、aapt 校验。**禁止包含 Firebase / Google Play Services**。
Social Login
多区域第三方登录 — ★ flavor 感知登录方式(cn: 微信/QQ/手机号;overseas: Google/Apple/邮箱;iOS 受 App Store 4.8 约束有三方登录必给 Apple Sign In)、四端客户端接入(sign_in_with_apple / google_sign_in / fluwx / tencent_kit)、★ 后端一律服务端验签(Apple identityToken JWS / Google id_token / 微信 code 换 openid+unionId / QQ access_token 验 openid)、统一账号打通(SocialIdentity 表 + unionId 聚合 + 账号合并策略)、登录后签发 JWT 并解析默认租户。
Nestjs Backend Conventions
NestJS + Prisma 后端开发规范 — Module/Controller/Service 分层、DTO + class-validator、Prisma schema 多租户字段(hotelId/storeId/tenantId 等)强约束、JWT @CurrentUser/@UseGuards 鉴权、Wave 0-3 契约优先流程、Redis/BullMQ/UploadService/内容审核接入、AI 扣费 consume/refundWithRetry 双保险、HTTP 错误 code 规范。
Flutter Multi Region Dev
Flutter 全区开发总入口路由器 — 启动新的多市场(中国 + 海外 + iOS)Flutter + NestJS 项目时优先调用。按上架范围决定加载哪些子 skill:backend-production-deploy / flutter-coding-conventions / nestjs-backend-conventions / frontend-backend-alignment / cn-android-flavor / ios-app-store / overseas-android-google-play。
Flutter Testing
Flutter + NestJS 多区域项目测试规范 — Flutter 单元测试(Notifier/Provider + ProviderContainer override)、widget 测试、golden 测试、★ flavor 条件编译测试(cn 不含 Firebase / overseas 不含 JPush 的静态与运行时验证)、多租户隔离测试、AI 扣费 refund 测试、NestJS service 单测(mock Prisma)、e2e(supertest + 测试库)、mocktail/jest mock 约定、覆盖率门禁。
Backend Production Deploy
NestJS + Prisma 后端生产部署 SOP — ask-before-write、dry-run rsync、uploads 双向补齐、Prisma db push、PM2 restart、健康检查。适用于「本地代码 + 远程 SSH 服务器 + PM2 + Nginx」架构。
Object Storage
对象存储多供应商抽象 — UploadService 统一接口后挂阿里云 OSS / 腾讯云 COS / AWS S3,按 UPLOAD_STORAGE env 切换零代码改动,本地 local 起步;直传 vs 后端中转、STS 临时凭证、私有 bucket 签名 URL、CDN 域名、跨区域(国内 OSS/COS + 海外 S3)路由、local↔生产 uploads 双向补齐过渡方案。
Frontend Backend Alignment
前后端对齐规范 — Freezed model ↔ Prisma schema 字段一致性、API 契约改动 → 文档同步、版本号双平台 bump、Changelog 三件套联动、cards 5 章节、AI 扣费三方同步(后端 pricing + 前端 i18n + ARB)、多租户 Provider 重置清单同步、团队 Owner 联系方式回传链路。
Ci Cd Github Actions
多区域 Flutter + NestJS 的 GitHub Actions CI/CD — PR 质量门禁(analyze/test/静态 grep)、★ 三 flavor(iOS / cn_android / overseas_android)矩阵构建、iOS 签名(fastlane match 或 App Store Connect API key)、Android keystore 经 GitHub Secrets 注入、cn 无 Google / overseas 无 JPush 的产物解包守卫、buildNumber 自动化、后端 rsync+pm2 部署 workflow(手动/tag 触发)。
Maps Location
多区域地图与定位 — ★ 按国家/地区路由地图源(中国大陆 → 高德直连;港澳台/海外 → Google Maps 经海外节点中转 或 Mapbox 直连),flavor 感知(cn 禁 Google → 只用高德;overseas 用 Google/Mapbox),后端 _resolveMapSource 决策 + Google API 在华走新加坡中转、静态图/地理编码/地点检索代理,前端条件加载地图 SDK,定位权限按需申请合规。
Observability
多区域 Flutter + NestJS 可观测性 — ★ flavor 感知的崩溃采集(cn 用 Sentry 自托管、overseas/iOS 可 Crashlytics,因 cn 禁 Firebase)、release 与 buildNumber 绑定、结构化后端日志(nestjs-pino + requestId/tenantId/userId + PII 脱敏)、前端 breadcrumb、健康检查与 uptime 监控、告警阈值、trace/correlation id 透传。
Overseas Android Google Play
海外 Google Play Android Flavor — Firebase / FCM 推送、Google Play Billing 内购、海外内容审核(Perspective / AWS Rekognition)、`google-services.json` 隔离、`.intl` 包名后缀。**禁止包含 JPush / 微信支付宝等中国市场 SDK**。