# @happyvertical/smrt-bookings 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-bookings/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:55:23.519Z
中文译文更新时间：2026-11-17T17:44:37.449Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40happyvertical/smrt-bookings
原文对照：https://npmcn.com/package/%40happyvertical/smrt-bookings/?lang=original
项目主页：https://github.com/happyvertical/smrt#readme
源码仓库：https://github.com/happyvertical/smrt

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：196 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-11-03T17:40:45.846Z
- 最新版本发布：2026-11-17T07:55:23.294Z
- 近 30 天下载量：4703（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

SMRT的操作员管理服务预订

## 安装

```sh
npm install @happyvertical/smrt-bookings
```

也可以使用：`pnpm add @happyvertical/smrt-bookings`、`yarn add @happyvertical/smrt-bookings`、`bun add @happyvertical/smrt-bookings`

## README

# s-m-r-t 预订

`@happyvertical/smrt-bookings` 保留专用开发者时间(小时、日、日), 或操作员宣布的地方监督窗口。 没有 启动代理,收取付款,发送通知,或者撰写商业记录.

应用 `migrateBookingsV1` 接下来 `migrateBookingsV2` 一次通过 主机使用 PostgreSQL 数据库手柄的部署迁移分类账。 V2为 添加剂:增加了提供单位、价格和显示栏、预订数量, 和每个建议窗口和被冻结的价格,回填现有行,不 丢弃数据。 和V1一样,它不是一能的。 使用普通的 PostgreSQL 连接或 组合 `BookingService`; 服务拥有其交易并明确使用 阅读承诺。 它不按要求创建计划。 没有ORM 收藏, CRUD 路由,或生成的 CLI 或 MCP 写入会被注册.

1.  接线员可以提供供货并宣布可以提供 提供者 UUID 。 对保留的所有服务使用相同的提供者身份 同一个人 声明取代了提供者所配置的窗口 . Windows不能重叠,必须具有正整数容量. 标记于 每个供应商每个本地日期都有一个精确的监督窗口。 变化 不允许任何主动保留.
2.  指定的客户联系人或代其行事的经营者要求 允许提供。 监督请求需要一个项目。 残废 提供停止新请求; 操作员可以完成待处理的请求.
3.  操作员提出一个提供者、窗口和条款修订,并精确 商定的措辞。 监督还需要经核准的项目计划ID和 版本。 每个建议都是不可改变的。 联系人同意其确切身份. 取代该提案是目前同意的。 请求、建议和 已同意,没有能力.
4.  运营商确认确切同意的建议书. 服务锁定 预订然后是稳定的提供者行、检查权限和当前 并检查每个半开放部分。 独家 小时区块全部重叠;监管消耗一个单位. 两个活动 同一项目的监督保留时间和世界协调时的确切间隔是: 甚至拒绝不同的供应商。 未成功的确认假 重新试验或修订的建议和同意.
5.  运营商可以拒绝待决请求或取消待决或确认的请求 以有因缘入住. 取消确认的预订发布能力 (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`。测试包装条款并删除一个一次性数据库.

## 常见问题

### @happyvertical/smrt-bookings 是什么？

SMRT的操作员管理服务预订

### 如何安装 @happyvertical/smrt-bookings？

在项目目录运行 npm install @happyvertical/smrt-bookings，或使用 pnpm add / yarn add / bun add。

### @happyvertical/smrt-bookings 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @happyvertical/smrt-bookings 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @happyvertical/smrt-bookings 可以商用吗？

@happyvertical/smrt-bookings 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @happyvertical/smrt-bookings 的下载量有多少？

根据 npm 官方下载统计，@happyvertical/smrt-bookings 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,703 次，日均约 157 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @happyvertical/smrt-bookings 还在维护吗？

最新版本 0\.62\.1 发布于 2026/11/17（今天）；至今共发布 31 个版本，其中过去 12 个月发布了 31 个；首次发布于 2026/11/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

