s-m-r-t 预订
@happyvertical/smrt-bookings 保留专用开发者时间(小时、日、日),
或操作员宣布的地方监督窗口。 没有
启动代理,收取付款,发送通知,或者撰写商业记录.
应用 migrateBookingsV1 接下来 migrateBookingsV2 一次通过
主机使用 PostgreSQL 数据库手柄的部署迁移分类账。 V2为
添加剂:增加了提供单位、价格和显示栏、预订数量,
和每个建议窗口和被冻结的价格,回填现有行,不
丢弃数据。 和V1一样,它不是一能的。 使用普通的 PostgreSQL 连接或
组合 BookingService; 服务拥有其交易并明确使用
阅读承诺。 它不按要求创建计划。 没有ORM 收藏, CRUD
路由,或生成的 CLI 或 MCP 写入会被注册.
- 接线员可以提供供货并宣布可以提供 提供者 UUID 。 对保留的所有服务使用相同的提供者身份 同一个人 声明取代了提供者所配置的窗口 . Windows不能重叠,必须具有正整数容量. 标记于 每个供应商每个本地日期都有一个精确的监督窗口。 变化 不允许任何主动保留.
- 指定的客户联系人或代其行事的经营者要求 允许提供。 监督请求需要一个项目。 残废 提供停止新请求; 操作员可以完成待处理的请求.
- 操作员提出一个提供者、窗口和条款修订,并精确 商定的措辞。 监督还需要经核准的项目计划ID和 版本。 每个建议都是不可改变的。 联系人同意其确切身份. 取代该提案是目前同意的。 请求、建议和 已同意,没有能力.
- 运营商确认确切同意的建议书. 服务锁定 预订然后是稳定的提供者行、检查权限和当前 并检查每个半开放部分。 独家 小时区块全部重叠;监管消耗一个单位. 两个活动 同一项目的监督保留时间和世界协调时的确切间隔是: 甚至拒绝不同的供应商。 未成功的确认假 重新试验或修订的建议和同意.
- 运营商可以拒绝待决请求或取消待决或确认的请求 以有因缘入住. 取消确认的预订发布能力 (b) 保留确认的条款和历史. 预订和历史提案的范围为指定的联系人或 一个接线员。 预订审计历史仅限运营商使用.
出价、单位和价格
献礼有 kind (单位:千美元) unit (单位:千美元)hour, (中文(简体) ), day, (中文(简体) ), week 或者说 month) (中文(简体) ). 这个
类型是保留语义,单位是销售颗粒
祭品一旦存在 就会被冻结. developer-hour 保留它的名称用于计划
兼容性但指任何单位的专用专注: 它阻断
每一个重叠的保留,不需要任何项目或核准的计划.
supervision-day 共享监管能力,总有一个为期一天的单位
数量一.
祭品可以携带 priceCents (整数小单位)和一个ISO 4217
currency或两者都无效 对于一个不贵的报价。 价格, title
(120个字符), description (2000个字符)和 public 可更改
等会 一个请求有一个 quantity (违约1起,最多1000起). 提案冻结
献礼 unitPriceCents 财务报告和审定财务报表 currency 编辑 totalCents
(单位:千美元)unitPriceCents * quantity)在提议时,因此以后的价格变化不
更改提议或确认的预订。 付款和发票仍然是东道主拥有的.
一个专门的建议 要么 window (v1单窗口)或 windows, (中文(简体) ),
在一个区域进行排序,不重叠的片段。 建议 window 是间距
从开始到结束 windows 是保留部分;
核实检查和分配储备金各部分。 各部分必须
准确测量单位数量:
hour: 协调世界时各部分的时间数quantity几小时,所以分开 小时是罚款的, DST 折叠时间是过期的 .day:每个部分位于当地范围内quantity从第一天起 片段的日期和片段的触摸quantity不同的日子.week财务报告和审定财务报表month: 每个段位于半开放的局部间距[D0, D0 + quantity weeks or months),则月终受限制于 目标月长度。 某一段可在T00:00以连续的一天为准.
Windows 使用IANA区和表单的本地时间戳
2027-11-07T01:30-04:00。例如,使用与美洲/新约相抵消的方法。 抵消必须适用于该区的这一瞬间.
DST 折叠时, 偏移会识别不同的瞬间; 不存在的壁
时间被拒绝。 存储的建议书保留了本地输入和世界协调时的即时.
间隔包括开始和排除结束. 监视窗口
在一个本地日期开始和结束,或者在午夜开始下一个日期;
它不需要覆盖一整天,并可能跨越一个防日过渡.
使用 listBookings 查找相同的预定视图 get。一个
选项项目 UUID 缩小调用者现有范围内的结果.
运营商在其租户中看到所有的预订. 其他打电话者只看预订
用于联系主机地图到他们的演员. listOfferings 揭露
提供身份证、种类、单位、价格、所有权、说明、, public 并启用了旗帜.
有3个读者班:操作员看每张报章,读者图到一个
查看已启用的选项, 和没有联系人映射的读取器( 匿名)
或希望演员 东道主担保) 只看到允许的公开献礼.
public 只影响发现; request 还需要联系人.
listBookings 还接受 contactId 过滤器: 运算符可能缩小为任意
联系人和其他打电话的人只能自己点名.
运算符可以使用 listAvailability 检查现有的提供者窗口
在替换声明之前。 所有三种方法都使用 read 权力.
listOpenSlots 返回介于 from 财务报告和审定财务报表 to
(最多400天相隔),可选择供货商和供货商 quantity这是一个
纯读: 它没有保留, 也不取重试的密钥, 并且确认
在提供者锁下重新检查容量。 每个槽都带有 windows 改为
转到 propose逐个申报的小时提供
窗口; 日、 周、 月的供货, 将所申报的窗口捆绑在一起
(b) 监督报价清单
与其其余共享单元的监管窗口。 占用部分为
除外。 检测结果由启动后提供商按顺序排序,并使用
不透明 nextCursor,以 after。东道主决定谁可以通过
access(..., 'read')提供书目的读者人数与
listOfferings读者无法发现的献礼 not-found。 。 。 .
列表默认返回最多50项,并接受1至100项的限制.
结果由升起的UUID命令. 传回 nextCursor 作为
afterId 使用相同的过滤器获取另一页。 无效光标表示
页面到达结果的末尾.
牵头请求
在联系人有项目之前,可能存在专门的预订。 当主机
权限执行可选 verifyContact(context, contactId),请求
没有项目要求它确认租户和租户之间有联系
演员可以为此采取行动 verifyReferences 从来没有接受过这种接触。 这个
同样也适用于提议、同意和确认这种预订,条件是:
verifyReferences 仍然检查提供者。 无 verifyContact 联系人
转至 verifyReferences 和以前一样 监督总是需要一个项目.
一个操作员后来将工程与
attachProject(context, key, { bookingId, projectId }): 它需要一个活动
预订、核实联系人和项目一起进行,对同一人具有同源性
项目,拒绝不同的项目 conflict,并在历史中记录为
attach-project专用拨款从不包含项目,因此附加
不接触保留容量.
使用来自东道方的经认证的租户/代理人语境,从不来自请求
躯体。 主持人 BookingAuthority 提供当前运算符权限和
并必须核实外部引用
在租户中存在,并且彼此有关系。 关于监督建议和
在确认后,它必须核实准确的计划版本是否获得批准
为项目。 确认检查发生在提供者锁定之后;它是
而不是计划系统的分布式锁.
机关召回应当只读,不得调用订票命令.
每次写作都要对租户和业务进行重试。 承诺的钥匙 和正常的指令有效载荷相连 同一授权 重试返回原始收据; 拒绝不同的有效载荷或演员. 一个失败的命令卷回了它的更改和关键主张. 命令收据 和审计历史 承诺与预订, 所以失败的呼叫者拥有 通知不能撤销保留。 客户端可以后取 并分别协调人工开具发票.
只支持真实的 PostgreSQL 写入 。 为了进行包件测试,
使用情况 pnpm --filter @happyvertical/smrt-bookings test。运行单独的
PostgreSQL 套房,点 CI_POSTGRES_BASE_URL 在孤立的服务器上
数据库创建权限并运行 pnpm --filter @happyvertical/smrt-bookings test:postgres。测试包装条款并删除一个一次性数据库.