用途
本技能定义租户感知的 ERP 销售点（POS）操作的应用与服务契约，适用于实现或审查 pos.php、agent-pos.php 和 encode-sales.php 等销售表面。目标是让快速销售录入与租户隔离、成品库存真值、制造时机、支付幂等性、权限控制、会计过账和审计证据保持一致。
主要能力
- 明确区分三个运营 POS 表面：pos.php 为通用店铺 POS；agent-pos.php 严格为销售代理过账销售；encode-sales.php 手工记录已发生的销售。
- 建立租户范围的默认客户配置（如 pos_default_customer_id，通常为 Walk-in），由服务器端解析并在所有 POS 页面加载前验证有效性。
- 要求每个可售产品 1:1 映射到一个成品库存项；制造环节消耗配方原料并产出成品，销售过账仅扣减该成品库存项。
- 使用单一规范事务服务或显式适配器统一处理发票、支付、库存移动、总账过账和审计溯源，并强制租户范围、客户验证、产品身份、批次/FEFO 可用性、价格及幂等性。
- 区分分支销售访问、销售代理访问和工厂/作业访问权限，防止权限传递越界。
- 将超时视为未知结果，使用相同幂等键重试并在展示新成功前对账持久化记录。
- 提供测试与证据包，覆盖租户、权限、失败、重放、库存时机及对账证据。
使用方式
技能以规则和工作流形式提供，需与外部设计引擎的 pos-and-retail-operations 技能及本地会计引擎配合使用。实施时按以下步骤：
- 盘点所有销售表面、路由、API、服务、存储过程、报告和测试，标记每个写入方和支付路径。
- 编写产品-成品库存映射，记录产品 ID、成品库存项 ID、配方原料 ID、批次、单位、价格、成本及制造/销售移动方向。
- 定义租户配置（设置、权限、UI、API 验证、审计元数据和演示种子数据）。
- 在所有页面渲染销售界面或启动异步目录调用前解析默认客户，并展示明确的加载、空、错误、禁用和配置必需状态。
- 将正常发票销售、手工录入、代理销售和收款统一路由到规范服务，保持重试和重放的相同请求/幂等契约。
- 在作业完成时过账原料到成品的制造移动，在销售过账时过账产品到成品库存的移动，并在同一事务中锁定和验证相关批次数量。
- 验证租户/分支范围、代理范围、工厂隔离、权限变更、无效默认客户、未映射产品、库存不足、重复键、支付超时、作废和冲销。
- 对账发票行、支付、库存台账、批次余额、总账日记账、客户余额和审计条目，并证明重放不会重复。
适用场景
- 构建或审计 ERP 中的 pos.php、agent-pos.php 或 encode-sales.php。
- 定义租户范围的 Walk-in/默认客户及其管理员权限。
- 将产品连接到成品库存、制造配方、批次和销售扣减。
- 将多个销售写入方、支付处理器或重试路径整合为单一边界。
- 联合测试租户、分支、销售代理、工厂、库存、发票、支付、总账和审计控制。
限制
- 不适用于仅视觉构图、排版、颜色或交互润色；这些由外部设计引擎负责。
- 不适用于报价→客户订单→交付→发票→收款的工作流；应设计为独立的订单到收款流程。
- 不适用于财务报表、法定规则或会计政策判断；应使用会计原则。
- 不适用于无 POS 特定事务或库存语义的通用前端架构。
- 缺失事实：具体实现语言、框架、部署环境、收费模式、价格、平台兼容性等暂未提供。