本项目是一款面向餐饮连锁品牌的门店全生命周期数字化管理SaaS平台,覆盖门店从意向签约、营建施工、运营监控到关停归档的完整业务流程。核心功能模块包括:门店签约管理(身份证自动解析、合同编号生成、门店索引唯一性校验)、营建任务看板(12项标准任务流程、预计上线时间推算、超时催办升级机制)、运营数据看板(多维度筛选聚合、真单计算、30天趋势分析)、平台数据导入(美团/饿了么Excel自动映射、异常队列处理、24小时批量回滚)、智能告警系统(12种检测规则、证照到期分级预警、数据异常自动识别)、AI知识库(RAG文档问答、自然语言数据查询、门店健康度诊断、周报月报自动生成)、财务对账(补单录入、绩效计算、等级评定)、操作日志审计(全操作留痕、归档查询)等。系统支持5角色权限隔离(管理员/招商/营建/运营/财务),实现了部门级数据隔离和财务字段脱敏展示。
1. 整体架构采用pnpm monorepo组织,前端Vite+React18+AntDesign构建SPA,后端NestJS10+Prisma5+PostgreSQL15提供RESTful API和WebSocket实时推送,Redis负责缓存与会话存储,前后端共用packages/shared类型与工具包保证类型一致性。
2. 负责的核心模块及成果:
- 门店签约模块:实现了合同编号自动生成、门店索引唯一性算法(品牌+城市+街道-店名简写-特殊标签)、身份证信息自动解析(性别/生日/年龄/星座)、签约事务内二次校验防并发穿透;签约流程自动化使单店录入时间从15分钟缩短至3分钟。
- 营建管理模块:设计了12项标准任务模板克隆机制、任务状态机驱动(任务完成自动触发门店状态流转)、预计上线时间自动推算(基于estimatedDays累加)、营建超时三级催办(24h单聊→48h群聊→38天总工期)。
- 平台数据导入:实现了多平台字段映射配置化(支持美团/饿了么等不同列名映射)、CSV编码自动识别(UTF-8/GBK/GB2312)、Excel日期多格式解析、批量预取优化将O(N)查询降为O(1)、每50行批量事务写入,支持单次导入万级数据。
- 智能告警系统:实现了12种告警检测算法(连续天数检测、同商圈均值对比、环比异常识别)、dedupKey幂等写入防重复、暂停营业免告警过滤、每天早8点Cron自动检测。
- AI/Wiki模块:构建了RAG架构(DashScope 1536维Embedding+pgvector余弦相似检索+DeepSeek LLM生成)、SSE流式输出、LLM并发Semaphore控制(最多10并发)、相同prompt 1小时缓存、Function Calling联网搜索、数据安全防线(LLM调用不传门店名只传脱敏数字)。
- 运营看板:实现了多维度Prisma groupBy聚合、真单计算逻辑(settlementAmount-manualAmount)、双口径曝光数据(区间累加vs日均)、REST 30秒轮询+WebSocket双模式大屏数据推送。
3. 遇到的难点与解决方案:
- 并发签约冲突:使用Prisma $transaction包裹签约操作,事务内二次校验合同号和索引唯一性,配合唯一约束捕获P2002错误返回友好提示,彻底解决了并发条件下重复签约问题。
- 跨平台字段名差异:设计了PlatformMapping配置化方案,一个核心字段对应多个候选列名(如"结算金额"匹配"商家实收"/"结算金额"),新平台只需新增映射配置无需改代码,实现了平台接入的开闭原则。
- 连续天数告警检测:需要按(contractNo, platform)分组检查连续N天满足条件,采用日期