BoatOps Community inventory authority / local review

库存与运营事实源

0.0.1 local alpha

首个可运行候选版聚焦船期、HOLD、确认、改期、取消、组织隔离、幂等和库存 revision。BoatOps 对所有库存冲突拥有最终裁决权。

LOCAL ALPHA NOT DEPLOYED NOT RELEASED LICENSE NOT FROZEN
API 契约文档 健康检查

本版可检查内容

7库存 API 端点

查档、HOLD、释放、确认、改期、取消、revision。

8公开事件 Schema

最小同步 payload,不暴露客户 PII、成本或利润。

UTC时间存储

业务区间采用半开区间,组织时区单独返回。

幂等业务写入

相同命令和请求只产生一笔业务事实。

明确边界

这是本地候选,不是 Ayany 生产系统

  • 不包含真实船只、客户、订单、价格、合同、财务或生产凭据。
  • 未修改 WordPress、Google Sheet、ChannelHub、服务器或 OTA。
  • Plan B 时段、周转缓冲和 HOLD 默认时长仍为外部业务输入,不在源码中补造。
  • 本地自动化测试使用 SQLite;正式候选仍需 PostgreSQL 排斥约束与并发门禁。

Inventory Provider API v1

POST/api/v1/availability:check
POST/api/v1/holds
POST/api/v1/holds/{id}:release
POST/api/v1/bookings:confirm
POST/api/v1/bookings/{id}:amend
POST/api/v1/bookings/{id}:cancel
GET/api/v1/inventory/revision