Release Notes

Celoria 美甲沙龙管理平台 - 版本发布记录与路线规划

v1.0 CURRENT
v1.1 NEXT
v2.0+ FUTURE

v1.0 — 首次交付

2026-02-26 目标: qqnails 自用店上线 分支: new-main @ ed5e5bc
覆盖美甲沙龙日常运营全链路：预约 → 签到 → 服务 → 支付 → 日结 → 报表。 Web 管理后台 + iPad 店内自助终端 + 客人在线预约，支持中英双语。
40
功能模块 (Specs)
927
API 路由 (受保护)
732
测试文件
36
RBAC 权限
📦 交付终端

Web App

管理后台 + 员工面板 + 客人预约
Next.js 15 / TypeScript

iPad Kiosk

店内自助签到/预约/服务展示
Flutter iOS

公开预约页

客人扫码/链接自助预约
Web 响应式

帮助中心

用户文档 42 篇 + 搜索
MDX 静态站

已完成
本版不含
🏪 核心运营 9 项
  • ✓
    预约系统
    创建/编辑/取消/看板视图/日历视图/重复预约/冲突检测
    013-appointment-booking · 82/82 tasks
  • ✓
    签到队列
    Walk-in 排队 + 预约签到 + 队列管理 + 实时看板
    checkin module
  • ✓
    员工排班
    周模板/日历/可用性过滤/排班生成
    026-weekly-schedule-templates · 41/41 tasks
  • ✓
    客户管理
    档案/标签/自动分群/笔记/消费历史/三级客户模型
    019-guest-tagging
  • ✓
    支付与收款
    支付链接/手动记录/拆分支付(按服务/按人/手动)
    030-split-payment + payment links
  • ✓
    日结关账
    5 步 Checklist 流程/小费分配/现金清点/差异报告
    028-daily-reconciliation · 65/65 tasks
  • ✓
    报表分析
    日报/财务/员工绩效/运营/自定义时间范围
    020-reporting-analytics · 179/179 tasks
  • ✓
    Web 在线预约
    客人自助预约/购物车/Group Booking/员工选择/时段选择
    014-web-booking · E2E 22 tests
  • ✓
    iPad 自助终端
    服务展示/签到/预约/3 布局 × 3 主题/视频背景/Web 管理后台
    058-ipad-app · 56/56 tasks
📣 营销系统 7 项
  • ✓
    邮件模板 + Campaign 发送
    模板创建/编辑/变量插入/预览/批量发送/发送历史追踪
    047-experiment-config + 049-template-variables
  • ✓
    SMS 模板 + 通知
    短信模板/预约确认提醒/营销触达/Twilio Toll-Free
    018-marketing-automation · 118/118 tasks
  • ✓
    自动化触发规则
    触发模板(生日祝福/服务跟进/回访提醒/新客欢迎)/定时调度
    018 automation-rules + trigger-templates
  • ✓
    AI 邮件图片生成
    AI Canvas 设计/逐客渲染/6 套邮件模板
    071-ai-email-image-generator · 60/60 tasks
  • ✓
    Guest 标签 + 分群
    自动标签引擎/规则评估/活跃度-生日-消费标签/分群定向触达
    019-guest-tagging
  • ✓
    折扣 + 促销管理
    折扣码创建/使用/促销活动配置/前台展示
    discounts + promotion modules
  • ✗
    Research Platform / A/B Testing
    DAG 工作流/实验策略/数据分析 — 内部学术工具，v1.0 不对外开放
    047/076 · 代码在 new-main 但不作为交付功能
🎁 增值功能 5 项
  • ✓
    礼品卡
    购买/兑换/余额管理/批量创建/到期管理
    023-gift-cards · 51/51 tasks
  • ✓
    会员积分 + Loyalty Batch 1
    等级体系/积分/升降级/推荐码/预付费套餐/订阅会员/Loyalty Dashboard
    017 + 068-B1 · 84+70 tasks
  • ✓
    Guest App 定制
    品牌 Logo/布局/Banner 轮播/促销/积分展示
    055-guest-app-customization · 103/103 tasks
  • ✓
    Settings 统一管理
    Default/Override 表格/跨域一致性/安全迁移
    001-settings-default-override · 44/44 tasks
  • ✓
    帮助中心
    42 篇用户文档/FlexSearch 全文搜索/5 大分类
    051-user-guide-docs
🔐 平台与安全 8 项
  • ✓
    RBAC 权限体系
    36 权限 / 门店级 Scope / 等级模型 / 927 路由全覆盖
    011 + 063 + 065 + 069 + 074
  • ✓
    多租户架构
    Schema-based 隔离 / URL 路由 / 统一数据访问层
    009 + 044 + 048
  • ✓
    Guest 认证
    两层模型(匿名/识别/注册) + OTP 验证
    060-guest-auth-redesign · 159 tests
  • ✓
    统一错误码
    E#### 错误码 / traceId 链路追踪 / 双格式响应
    050-unified-error-codes · 57/57 tasks
  • ✓
    API 注册系统
    统一管理 / 冲突检测 / 自动文档生成
    042-api-registry · 87/87 tasks
  • ✓
    数据库恢复加固
    安全恢复 / 全库备份 / 软删除
    066-database-recovery-hardening
  • ✓
    性能优化
    React Query / N+1 修复 / 懒加载
    046-performance-optimization · 32/32 tasks
  • ✓
    中英双语 i18n
    next-intl / 102 页面 / 42+ 翻译命名空间
    001-theme-i18n-enhancement (Web)

v1.0 不包含

  • 员工 App (employee_mobile_app/) — Web 端可替代日常操作
  • POS 硬件终端 (pos_app/) — 后端已完成，待真机联调
  • 员工打卡/考勤 — 第一期不需要
  • 团队沟通/公告管理 (077) — 代码已开发，第二期合并
  • 可视化邮件编辑器 (070) — 开发中
  • Loyalty Batch 2 — 储值卡/佣金/自助扣款待规划
  • A/B Testing / 研究平台 (076) — 内部学术工具
  • 薪资佣金系统 (075) — Draft 状态

v1.1 — 员工体验 + 运营深化

预计: 2026 Q1-Q2 重点: 员工工具 + 支付硬件 + 营销编辑器
上线员工移动端和 POS 硬件终端，强化店内运营效率。 同时完成可视化邮件编辑器，提升营销能力。
代码已完成
开发中
待启动
👩‍💼 方向 A: 员工体验 + 内部运营 4 项
  • ✓
    团队沟通 + 公告管理
    聊天范围设置 / 管理员公告 CRUD / E2E 测试已覆盖
    077 · 16 commits ready, 仅需合并
  • ✓
    员工 App 上线
    打卡(含 GPS) / 排班查看 / 聊天 / 小费 / 报表 / 14 功能模块
    employee_mobile_app · 需测试 + bug fix
  • ●
    POS 硬件联调
    CodePay P5 Android 终端 / Intent Mode 支付 / 真机测试
    067-pos-payment-intent · 后端+Web 已完成
  • ✓
    员工打卡/考勤
    PIN 打卡 / GPS 定位 / 时卡 / 工资单集成
    048 + 077 GPS · 代码已完成
📣 方向 B: 客户体验 + 营销 3 项
  • ●
    可视化邮件编辑器
    GrapesJS 拖拽编辑 / 往返保真保存 / 变量插入
    070-visual-email-editor · 开发中
  • ◇
    预约订金 + 爽约费
    预约押金收取 / no-show 扣费 / 取消政策
    053-booking-deposit-cancellation-policy · Draft
  • ◇
    Loyalty Batch 2
    储值卡 / 佣金结算 / 自助扣款 / 统一扣款
    068-loyalty-enhancement B2 · 0/51 tasks

v2.0+ — 远期规划

预计: 2026 Q2+ 方向: 商业化 + 平台扩展 + 高级功能
从自用店验证完毕后，开始面向外部租户开放，构建完整的 SaaS 商业化能力。
商业化准备
优先级: P1
面向外部客户开放前的关键准备工作
056 租户 Onboarding 045 租户功能权限 075 薪资佣金系统
客户体验增强
优先级: P2
提升客户端预约和服务体验
052 Waitlist 自动填充 054 预约前置表单 059 第三方预约入口 (Google/IG/FB)
质量与基础设施
优先级: P2
持续提升系统质量和开发效率
062 前端权限执行 (剩 9 处) 059 测试覆盖率提升 073 图驱动种子数据 001-theme Flutter i18n
创新功能
优先级: P3
差异化竞争力和高级功能
072 评价奖励计划 076 A/B Testing 研究平台 AI 语音系统 (Phase 4)