📚 Celoria 开发笔记

技术架构 · 产品设计 · 竞品调研 · 商业策略 · 融资准备

没有匹配的笔记

Pitch Deck — March 2026 (Post-Pivot)

20 slides · AI-Native Operations · Agent Mode vs Editor Mode · Cursor 类比 · Category Validation · 全屏演示 (← → 翻页, F 全屏)

创建于 2026-03-19 · 蓝驰创投 meeting prep · 中文版

项目总览

版本发布记录：v1.0 首次交付（40 功能模块 / 927 API / 732 测试）、v1.1 规划、远期路线图

更新于 2026-02-26

可视化看板：所有 Spec 完成情况、进度条、Phase 筛选、搜索。已完成 41 个 / 进行中 2 个 / 整体 99%

更新于 2026-02-06

浏览所有功能规格文档（324 个 Markdown 文件），支持分类筛选、搜索、实时渲染

更新于 2026-02-07

会议: v1.1 版本规划

v1.0 现状总结 + v1.1 方向决策：Referral 推荐奖励(P1)、收银台管理、部分退款、小费增强、Training/SOP

更新于 2026-03-03

架构文档

系统架构图

前端、后端、数据库三层架构总览，包含登录流程和预约功能的完整时序图

更新于 2026-02-01

Feature Flag 灰度发布

自建 Feature Flag 系统原理：三层过滤判断逻辑、按租户灰度、百分比灰度、灰度发布工作流 SOP、业界方案对比

更新于 2026-02-08

跨端统一错误处理

Web / Employee App / Guest App 三端错误处理现状分析、三种本地化方案对比、E#### 错误码设计范式

更新于 2026-02-06

SaaS 稳定性保障与模块化架构

行业调研（Zenoti/Boulevard/Fresha/Vagaro）：熔断器、优雅降级、Testing Trophy、事件驱动解耦

更新于 2026-02-06

并发预约竞态条件分析

TOCTOU 漏洞分析、Advisory Lock + EXCLUDE 约束方案、业界最佳实践对比（从沙龙到 12306）

更新于 2026-02-08

Schema / FK / JOIN 概念

数据库 Schema 结构定义、FK 约束（写入时校验）vs JOIN 查询（读取时关联）的区别，以及 Celoria 项目 FK 现状分析

更新于 2026-02-08

客户端缓存策略模式

5 种经典缓存策略（Cache-First / Network-First / SWR / Network-Only / Cache-Only）对比、决策树、Celoria 各端实际应用映射

更新于 2026-02-20

模板变量树设计

Service 和 Marketing 两种模板类型的变量系统设计，包含根变量、子变量、计算字段完整定义

更新于 2026-02-04

模板数据管道审计

4 套上下文系统的 47+25+20+14 个模板变量完整数据源追踪，4 处管道断裂修复记录，时间衰减加权算法说明

更新于 2026-02-17

Email Template 架构重设计

四层分离模型（Event → Rule → Variable Schema → Template）、变量合约 SSOT 设计、前后端命名不一致问题诊断、编辑器体验改进方向

更新于 2026-03-01

设计体系架构

Apple / Google Material / Atomic Design 三大方法论对比，Flutter ThemeExtension 实践，分层 Token 体系，反模式与业界案例

更新于 2026-02-06

设计与开发工作流

Design System + Code-First 的 Solo Dev 工作流：为什么不做全量设计稿、何时例外、日常操作手册、文件组织规范

更新于 2026-02-07

Web Design System Pipeline

从 Pencil 设计规范到租户可定制主题的完整管线：两层 Token 体系、oklch 色彩空间、CSS 变量级联覆盖、四阶段组件改造计划

更新于 2026-02-08

Widgetbook 组件预览

Celoria UI 共享组件库可视化预览：12 个组件 × 3 个主题（Guest Gold / Employee Indigo / Kiosk Teal），支持设备切换

更新于 2026-02-07

Agent 架构 (Post-Pivot 2026-03)

Event-Driven Agent Architecture

门店运营系统工作流重构 — 从 GUI 驱动到事件驱动的 Agent 架构思维导图 + Critique

创建于 2026-03-19

Multi-Agent Implementation & Cost Control

5-Layer 实现方案、Hybrid 成本模型 ($12/store)、数据库设计、技术选型决策、8周路线图

创建于 2026-03-19

Agent Group Map & Action Inventory

6+1 分组 × 15 个 Sub-Agent × 106 Actions 的完整 API 可用性审计

创建于 2026-03-19

Voice Walk-in Tech Test

持续监听 + 实体提取 + 渐进式填充。Web Speech API + 规则匹配技术验证原型

创建于 2026-03-21

Dynamic Pricing Algorithms

Contextual Bandits、Thompson Sampling、Bayesian Optimization — 小数据下的动态定价算法选型与实现

创建于 2026-03-22

Dynamic Pricing 交互式教学

动手实验 Thompson Sampling、Contextual Bandit、利润优化、跨店蚕食 — 可视化 Beta 分布演化

创建于 2026-03-22

RBAC & 权限系统

认证 vs 授权

为什么 auth-middleware 和 permission-middleware 是分开的？中间件分离设计原理

更新于 2026-02-01

RBAC 权限控制矩阵

36 个租户级权限 × 18 个资源分类，每个权限管哪些 API 路由、支持什么等级、决策流程图、搜索筛选

更新于 2026-02-17

RBAC 请求链路与测试

请求从进入到权限校验的完整链路、中间件执行顺序、测试策略

更新于 2026-02-09

权限策略对比

不同权限实现策略的对比分析与选型决策

更新于 2026-02-09

Superadmin 权限自动分配触发器

PostgreSQL AFTER INSERT 触发器原理：NEW 隐式变量、ON CONFLICT 防重、事务一致性，确保 superadmin 始终拥有完整权限

更新于 2026-02-11

Product Design

CUJ 四步走方法论

从用户旅程(CUJ)到 User Flow → BDD 场景 → E2E 测试的完整产品设计方法论，适用于所有 App

更新于 2026-02-07

CUJ 跟踪清单

逐条追踪每个 CUJ 是否已人工确认，记录确认状态、确认时间与版本。当前已标记 Kiosk App。

更新于 2026-02-10

7 个关键用户旅程：预约、购物车、深度链接、预约管理、认证、账户、门店选择

更新于 2026-02-07

Employee App CUJ

9 个关键用户旅程：打卡、排班、认证、服务、换班请假、聊天、公告、报表、设置

更新于 2026-02-07

3 个关键用户旅程：Walk-in 签到、Walk-in 预约、管理员配置。状态机驱动导航

更新于 2026-02-07

Web: 门店与服务 CUJ

6 个关键用户旅程：门店 CRUD、营业时间、服务目录、服务-门店关联、预约配置。Default-All 关联模型

更新于 2026-02-08

Web: 忠诚度与礼品卡 CUJ

7 个关键用户旅程：会员等级、积分管理、礼品卡购买/兑换/使用/管理、忠诚度报表。VIP vs 会员双轨体系

更新于 2026-02-08

Web: 平台管理 CUJ

7 个关键用户旅程：租户生命周期、上下文切换、备份恢复、Feature Flag、平台分析、系统监控、签到终端

更新于 2026-02-08

Research Platform EUJ

DAG Workflow 营销自动化平台端到端用户旅程分析。健康度评分、7 个 GAP 发现、导航结构问题、API 完整清单

更新于 2026-02-24

支付系统

POS 支付状态机全景

PaymentCubit 8 态 + VoidCubit 5 态完整状态机、三层防护（终端自动重置 / 全局 Watchdog / Intent 超时）、端到端时序图、10 种异常场景保护矩阵

更新于 2026-02-18

CodePay RSA 认证

CodePay 支付网关 RSA 签名认证流程、密钥管理、请求签名验证

更新于 2026-02-07

POS 终端配对流程与原理

一次性配对码、Placeholder Record 模式、Device Token 认证、完整时序图、pos_devices 表结构、安全考量

更新于 2026-02-16

支付状态恢复与韧性

sessionStorage 持久化、轮询安全网、自动恢复、beforeunload 拦截，以及 CodePay 直接操作不可知的局限分析

更新于 2026-02-12

幂等性在支付系统中的实践

从概念到实战：POS 手动确认 duplicate key 真实故障、先查再插修复方案、四种幂等策略对比、决策树、Tip 金额冲突分析

更新于 2026-02-19

Checkout 价格计算链路

单一数据源设计：逐项计税 Penny Rounding 问题、6 步派生计算链、税额反推恒等式、组件引用关系图、完整数值验算

更新于 2026-02-21

预约定金在线收款流程 (UP)

Universal Processing 在线支付定金的完整流程设计

更新于 2026-03-03

POS Tip Adjust 失败兜底

三种失败场景（POS 报错/超时/回调丢失）完整兜底机制：60s 超时调度、CodePay 对账查询、手动 Fallback 录入、状态机流转、前端双 Popover UI

更新于 2026-03-09

业务流程

Web 预约重构 - Group Appointment

Web 公开预约流程重构设计：对齐 Mobile App 单选流程、购物车弹框、多 Guest Group Appointment、共享服务层架构

更新于 2026-02-05

预约状态流转规范

Appointment 的 10 种状态、付款/退款流程、取消规则、状态转换矩阵

更新于 2026-02-02

Appointment 表结构详解

10 张核心表全链路：预约 → 分组 → 账单 → 交易 → 退款，每个字段含义、ENUM 类型、ER 图、数据流时序图

更新于 2026-02-16

Marketing Automation 执行流程

手动发送 vs 自动触发、MessagingService 集成、TriggerEngine 调度、定时任务处理流程

更新于 2026-02-04

Payroll 佣金系统配置指南

三级级联机制（Employee → Job Title → Tenant Default）、三种 Payout Model 详解、1099 承包商处理、为什么不按门店 Override

更新于 2026-03-02

Day End Closeout 竞品调研

对标 Zenoti，覆盖 Phorest / Shift4 / Vagaro / Mangomint：五步标准流程、Register Closure 数据模型、Feature Matrix、美甲店特殊考量

更新于 2026-02-17

Zenoti 锁账机制白话说明

用 1 页讲清楚 lock 的真实影响：锁后能做/不能做、例外路径、与 Celoria 日结锁定的对应关系

更新于 2026-02-12

租户入驻流程

多租户 SaaS 的租户注册、Schema 创建、初始化配置、激活流程

更新于 2026-02-05

配置同步行业调研

Firebase Remote Config / LaunchDarkly / Shopify / Square / Zenoti 六大平台配置传播方案对比，Polling + ETag 推荐架构

更新于 2026-02-18

Mobile & Flutter

Mobile App 技术栈

Guest App 与 Employee App 的 Flutter 技术栈、共同依赖、差异对比、后端 API 端点映射、认证流程

更新于 2026-02-05

Mobile App Slots API

可用时段 API 设计：时间段计算、员工可用性、冲突检测、缓存策略

更新于 2026-02-04

BLoC/Cubit 模式指南

Flutter BLoC/Cubit 状态管理模式详解、最佳实践、常见陷阱

更新于 2026-02-06

Guest App UX 测试方法论

Guest App 用户体验测试框架、测试场景设计、可用性评估指标

更新于 2026-02-06

Testing & QA

实时测试看板：运行进度、通过率、覆盖率、失败详情、趋势图。npm run test:dashboard 启动

更新于 2026-02-06

Test Architecture

项目分层架构 & 测试覆盖范围：7 层架构图、5 种测试类型详解、对比表、测试金字塔、请求生命周期

更新于 2026-02-06

单元测试 vs 集成测试

核心区别在于测试边界而非调用数量，判断标准是是否使用真实外部依赖

更新于 2026-02-04

测试覆盖率 & 统一测试系统

Jest 覆盖率详解 + 统一测试运行器（465+ 测试文件）：npm run test:all 命令、脚本参数、报告目录

更新于 2026-02-06

Flaky Test 修复指南

不稳定测试的常见原因、排查方法和修复模式

更新于 2026-02-06

性能测试调研报告

现状诊断（假测试问题）、系统瓶颈分析、行业三层测试实践、k6/Artillery/autocannon 工具对比、三阶段实施计划

更新于 2026-02-07

种子数据规格

性能测试租户完整种子数据规格：110 张表、25 亿条数据、9 层依赖关系、保留策略、150 店 × 2 年模拟

更新于 2026-02-08

DB 数据流依赖关系图

四种真实数据流（Trigger / Business Logic / Seed / FK）的交互式可视化，边类型过滤，孤立表检测

更新于 2026-02-08

字段血缘分析策略

全量血缘 vs 异常检测的决策过程：字段健康生命周期模型、8 类异常维度、三源交叉比对方案

更新于 2026-02-09

种子数据保真度策略

perf-seed 应复用 service 层逻辑而非 bulk INSERT：四种边类型健康度分析、分层保真度方案、已知缺陷清单

更新于 2026-02-08

竞品调研

竞品功能矩阵 (全行业)

12 大品类 83 项功能逐一对标 11 家竞品（Zenoti/Boulevard/Mangomint/Phorest/Mindbody/Vagaro/Fresha/DaySmart/GlossGenius/MaSe/Booksy），含定价卡片、完成度评分、类别筛选

创建于 2026-03-09

竞品分析 (7 家)

7 家美业 SaaS 竞品深度分析：定价/定位/中文支持、市场分层、Celoria 差异化优势、关键洞察与行动建议

更新于 2026-02-08

竞品成本计算器

交互式成本对比工具：拖动滑杆设置月营业额，实时对比 Fresha/Celoria/Mangomint/GlossGenius 总成本

更新于 2026-02-08

MaSe 产品深度调研

MaSe（MASE之家）实机深度调研：11 模块全景、32 报表矩阵、35+ 设置项、RBAC 权限树、计费流程、CRM 深度、与 Celoria 12 项对标差距分析

创建于 2026-03-10

Guest App 首页促销模块竞品调研

8 款主流美容预约 App 首页促销设计对比、卡片信息结构、交互模式、经验教训

更新于 2026-02-05

自动标签竞品分析

10 家美业竞品 + 3 家通用平台对标。Celoria vs Zenoti 差距分析，Computed Traits 发展路线图

更新于 2026-02-08

Membership 竞品分析

Membership 系统竞品深度对比：PROSE/Zenoti/Boulevard/Vagaro/Phorest/Mangomint 功能矩阵、订阅 vs 忠诚度双轨模型、增强路线图

更新于 2026-02-17

Payroll & Commission 竞品深度调研

8 家竞品佣金/薪酬全景：Zenoti 3 模型 + 7(i) / Mase 800+算法 / Mangomint Interactive Payroll / Greater-Of / 阶梯佣金

更新于 2026-02-22

AI Insights Engine 竞品调研

087 AI 洞察引擎全景调研：20+ 美业竞品矩阵、AI Native 标杆深度调研（Toast IQ/Ramp/ServiceTitan Atlas/Shopify Sidekick）

更新于 2026-03-06

Youmigo 产品分析

AI Agent 双边市场分析：飞轮机制、供给侧摩擦消除、多 Agent vs 全能 Agent 思辨、对 Celoria 034-agent-mode 的启示

更新于 2026-03-20

营销实验平台

A/B 测试对比 AI 语音 vs AI 短信 vs 人工触达效果。策略编辑器、客群筛选、实验配置、效果分析

更新于 2026-02-03

AI 交互设计指南

推荐书籍/播客、5 条核心原则、Cursor/Linear/Notion/v0 案例分析、Celoria AI 实践路线图

更新于 2026-02-08

Everything Claude Code 观点集

12 个核心观点：Token 优化、验证循环、Hook 架构、Rules 分层、多代理编排、持续学习系统等

更新于 2026-02-07

营销创意库

跨行业营销灵感收集：社交送礼/闺蜜拼单/游戏化忠诚度/UGC社区/限时闪购/节日自动化/订阅计划，含优先级矩阵与竞品对照

创建于 2026-03-11

商业策略 & 融资

支付费率对比 UP vs MaSe

基于 10 月真实账单的全面费率分析：IC+ vs Flat Rate、谈判后 0.06%+$0.04 加价、固定月费明细与优化建议、Chargeback 机制详解

更新于 2026-03-02

支付利润分成模型 (70%)

Universal Processing 70% Revenue Share: 基于 QQ Nails 真实账单的完整利润计算、竞品费率对标、规模化预测、之前模型修正

更新于 2026-03-08

美业定价跟进纪要

对标 MenuSifu / Chowbus 的收费打法，沉淀 Celoria 三层定价、渠道返佣、60 天 A/B 实验与决策阈值

更新于 2026-02-27

双轨制合伙人计划

Referrer（推荐人，subscription credit）+ City Partner（城市合伙人，现金 residual）双轨制架构、收入模拟器、双城试点、风险控制

更新于 2026-03-09

合伙人招募页 (Partner-Facing)

给城市合伙人看的收入预期、职责清单、收入模拟器、FAQ，不含内部敏感数据

创建于 2026-03-09

C端 vs B端 SaaS 策略

C 端与 B 端的获客、融资、增长、竞争壁垒五维对比。为什么"快速抢占市场"在 B 端不成立，以及 Celoria 正确的竞争策略。

创建于 2026-03-13

Chowbus & MenuSifu 0→1 全纪录

两家华人科技公司从零起步的完整故事：创始人扫街、融资策略、销售网络构建、售后体系、团队架构、转型决策

创建于 2026-03-11

美业竞品 0→1 创业全纪录

11 家美业 SaaS 竞品创始故事：融资路径、增长策略、10 条 Celoria 启示

创建于 2026-03-11

SF/LA Trip Action Plan

旧金山（找人找钱找认知）+ 洛杉矶（找客户找市场验证扩张）行动计划：华人创业者圈子、Coffee Chat 策略、融资路径

创建于 2026-03-11

竞品 & 品类融资全景

12 家公司深度调研：5 家 YC "AI OS for Vertical" + 7 家 Beauty SaaS — 创始人背景、投资机构、媒体评论、融资策略启示

创建于 2026-03-19

VC Fund Landscape (40+ 基金全景)

40+ 家基金调研：美业投资关系图、垂类 AI 投资、vertical SaaS portfolio、行动清单、portfolio conflict 分析

创建于 2026-03-19

VC Target List (垂类基金)

4 层级 15 家 VC 调研：投过 Boulevard/Zenoti/Vagaro 的基金、Vertical SaaS seed 基金、约谈策略与 portfolio conflict 分析

创建于 2026-03-18

Pitch Deck — March 2026 (Post-Pivot)

20 slides · AI-Native Operations · Agent Mode vs Editor Mode · Cursor 类比 · Category Validation · 浏览器全屏演示

创建于 2026-03-19

蓝驰创投 - Agent Architecture

多层多专家 Agent 架构 VC 沟通要点、Agent Mode/Editor Mode 产品形态、质疑应对、关键数字速查

创建于 2026-03-19

YUE Application Draft

HongShan YUE accelerator application — all form fields with plain text drafts

创建于 2026-03-19

VC FAQ - Competitive Advantage

Core competitive advantages, competitive landscape analysis, and investor Q&A prep

创建于 2026-03-19

产品思考 (Product Thinking)

产品战略全景：从行业结构到产品定位

23 章完整战略分析。Part I: YC Agent Economy、ACP/MCP/A2A 协议、Merchant of Record。Part II: 交付物不可分离=平台不成立、不可绕过层、三种商业模式、大众点评、数据飞轮、SOP 内核。Part III: Toast 深度对标、交易型vs关系型、竞品技术调研、市场规模、小店不用软件的原因、扩展路径、PMF 验证、30字定位

创建于 2026-03-20 · 23 章 · 持续更新

Weekly Progress Reports

Week 1 - Thesis Proposal

AI-Mediated Service Communication 项目介绍、研究问题、时间线

Jan 13-19, 2026

Week 2 - Foundation

系统架构设计、RBAC 权限系统、多租户架构实现

Jan 20-26, 2026

Week 3 - Experiment Platform

营销实验平台规格设计、Demo 原型、Week 2 vs Week 3 对比

Jan 27 - Feb 3, 2026

Week 4 - Practitioner Focus

从业者视角的实验平台重构、用户研究定位、产品框架调整

Week 5 - Node-Based Platform

节点式研究平台实现、DAG 工作流引擎、14 个后端服务模块

Feb 10-16, 2026

Week 6 - Making the Invisible Visible

冰山模型：如何展示不可见的后端工作、Demo Day 三层展示策略

Feb 17-23, 2026

Week 6 - Production Process

~1,700 字长文：从线框到网站、从技术 Demo 到展示空间的生产过程反思

Feb 17-23, 2026

DevOps

API 文档管理系统

Scalar + swagger-jsdoc + 覆盖率检测 + 角色 Token 注入。660 端点 100% 覆盖，CI 集成，实时检查

更新于 2026-02-07

API 文档管理规划

API 文档管理长期方案、工作流程规划

更新于 2026-02-07

可观测性三支柱

Logs + Metrics + Traces 业界标准方案。工具全景图（ELK/Loki/Prometheus/Sentry/OTel）、实施路径

更新于 2026-02-05

错误排查 Playbook

用户报错排查标准流程：日志查询、traceId 追踪、堆栈分析、脚本工具

更新于 2026-02-05

Git Commit 质量门禁

Pre-commit Hook 6 步流水线：语法检查、错误码验证、i18n、审计、lint-staged、覆盖率门禁

更新于 2026-02-08

日志保留策略

SaaS 行业日志保留标准（PCI DSS/SOC 2/GDPR）、主流平台做法对比、Celoria 各日志表保留时长与清理方案

更新于 2026-02-07

MDM 部署指南

Kiosk App 的 MDM 部署方案、Jamf/ABM 配置

更新于 2026-02-05

PM2 进程管理指南

ecosystem.config.js 配置详解、常用命令、进程监控与日志管理

更新于 2026-02-03

DB 备份与恢复完全指南

从零理解生产数据库 5 层防线：WAL+PITR 时间机器、逻辑备份、迁移回滚、软删除、审计日志、灾难恢复演练

更新于 2026-02-16

Post-Mortems

数据库连接池泄漏排查

Jest 并行测试导致连接池爆炸（40+ connections），排查过程与 globalTeardown 修复方案

更新于 2026-02-04

PG Transaction Aborted 踩坑

current transaction is aborted 错误的根因分析、事务状态机、SAVEPOINT 防御模式

更新于 2026-02-05

Flutter BLoC + GoRouter 导航踩坑

GoRouter 在 build() 中重建、BLoC 状态丢失、pumpAndSettle 超时等 Flutter E2E 测试教训

更新于 2026-02-05

Flutter 测试策略：Mock vs Real

Mock 和 Real API 测试策略对比、适用场景、MockInterceptor 设计模式

更新于 2026-02-06

事务层吞掉业务错误

tenantDb.transaction() 把 AppError 包装成 TransactionError，导致 107 处事务调用的业务校验错误全部返回 500

更新于 2026-02-12

Next.js .next 缓存反复损坏

PM2 通过 npm 管理 Next.js 导致 SIGTERM 信号丢失，配合内存限制矛盾 + config 幽灵重启，Webpack 写入被截断

更新于 2026-02-12

Kiosk Mock Drift 案例

Kiosk App Mock 数据与真实数据漂移导致的测试不稳定问题分析与解决方案

更新于 2026-02-07

小红书内容创作

小红书内容管理

内容点子管理面板：状态筛选、优先级排序、标签搜索。灵感→创作→发布全流程追踪

更新于 2026-02-07

小红书运营策略

基于竞品实时调研的完整运营方案：账号矩阵、内容金字塔、爆款模板、增长策略、KPI 体系

更新于 2026-03-09

招募合伙人帖子

技术合伙人招募帖草稿：个人背景、项目阶段、岗位需求、配图建议、发布注意事项

更新于 2026-03-13

💡 快速打开方式

在项目根目录运行：npm run notes

⌘K 搜索 · 侧边栏点击收起按钮才会收起