该技能用于在架构设计、需求规格说明、实现或审计 PMS、POS、餐厅、酒店、度假村、旅馆、场地、餐饮或食品服务软件时使用。它被定位为一份实施契约,并不代表任何现有产品已经完整。使用时应配合需求、模块化 SaaS、PHP/API/数据库、安全、财务、离线优先、可观测性、测试、UX 及专业文档等技能。
产品边界:将系统建模为一个包含有限业务域的运营平台,包括租户/物业/门店、房间与房价、客人、预订、入住与账单(folio)、客房清洁、维修、宴会、餐厅桌台/订单/KOT/KDS、菜单/配方/库存、支付、班次与日结、财务集成、报表与后台管理。PMS 与 POS 工作流应可独立使用,只共享显式且可对账的契约。
核心工程规则:所有租户/物业/门店查询都必须限定作用域,并进行负向测试;角色与能力检查在服务端执行。房间状态、预订、入住、账单、客房清洁任务、订单、KOT、支付、班次与夜审都需要显式的状态机;非法转换应安全失败并生成审计事件。已入账的收费、支付、退款、库存移动、KOT 和审计事件只能追加或通过冲正处理;使用幂等键,并通过出站/队列处理通知、财税调用与集成。金额、税费、折扣、小费/服务费、押金、房费、城市挂账、配方出成率、损耗与对账都要有明确的账户/维度归属,日记账逻辑统一经由规范财务过账服务。离线/暂存运行必须声明哪些操作可安全排队、冲突如何解决、用户如何看到过期状态、如何防止重复订单/支付,不得静默覆盖。支付、短信/WhatsApp、财税、渠道管理、地图、身份与分析等外部供应商边界应隔离,契约需包含超时、重试、签名、幂等、对账与降级模式行为。当前规模下优先采用模块化单体加持久队列;只有在实测负载、隔离、团队归属或故障域足以证明必要时,才引入服务。
酒店实施切片:物业/房型/房间/容量/设施与房态看板;可用性、预订重叠保护、房价计划、限制、押金、取消/未到、团队预留与预订来源;客人档案/身份同意、入住/散客、住宿、账单、房费、拆分/转移、支付/退款与退房;客房清洁分配/检查、维修工单与停用房;夜审/营业日、城市挂账、对账、运营报表与宴会/会议收费。
餐厅实施切片:门店/区域/桌台/预订/等候名单与桌台状态;菜单/分类/菜品/修饰项/供应状态、价格历史、配方/BOM/出成率;订单/座位/上菜顺序/备注/过敏标记、KOT 路由、站点/KDS 计时、重打/作废与经理授权;账单、服务费/小费、折扣、拆分/转移、房账、支付/退款、班次开关与现金对账;收货、库存、损耗/变质、菜单工程、配送/宴会、食品安全日志、财务过账与报表。
测试与发布契约:每个切片都需具备适用场景下的正常、校验、权限、租户隔离、并发、重试/幂等、回滚/冲正、离线/重连、设备/浏览器、无障碍、性能及渲染/UAT 证据。应测试房间重叠、过期可用性、重复支付、部分 KOT 失败、负库存、入账后作废、税费/财税中断、连接丢失、夜审重跑、跨物业访问与备份恢复。代码或界面只是被观察到;发布状态需要可执行证据与负责人签字。
证据类型:正确性(场景与状态转换证据,Markdown 表格加测试输出)、安全(租户、角色与供应商边界发现,JSON 或 Markdown)、数据安全(账务、库存与幂等追踪,JSON/YAML 带稳定 ID)、性能(工作负载与延迟结果,版本化基准记录)、可运维性(恢复与负责人运行手册,Markdown 加事件证据)、UX 质量(无障碍与设备状态证据,测试矩阵加渲染/UAT 记录)、发布证据(已签字的就绪与回滚记录,Markdown/JSON 清单)。
在获得证明前应有意排除:原始卡存储、生物识别客人身份、区块链账本、元宇宙/VR 作为核心、机器人、无法解释的 AI 定价、广泛的 OTA/渠道管理、社交信息流、微服务集群,以及没有参与者、状态、业务结果、控制、判定基准、依赖与负责人的功能。反模式包括:把路由、迁移或界面当作证明(应执行验收切片);共享数据库而无租户/物业/门店血缘(应在仓储、API、任务、报表与导出边界强制作用域);对资金、订单或财税调用重试而无幂等(应持久化键并对账供应商响应);离线模式静默覆盖状态(应显示过期、冲突与恢复,只排队安全事件);在运营控制之前加入 AI 或集成。
示例:对于最后一间房预订,应使用物业范围事务、唯一库存约束、幂等键与审计事件来建模预订命令;并发尝试第二笔预订、强制重试并恢复备份。只有当一笔预订胜出、另一笔获得安全结果、账单/报表状态对账一致且事件链完整时,该切片才算通过。参考资料:docs/skill-routing-index.md 与 docs/source-registers/hospitality-currentness-2026-09.json。