# @happyvertical/smrt-human-resources 中文文档

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

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:53:56.580Z
中文译文更新时间：2026-11-17T10:40:01.803Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：780 kB，67 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：svelte ^5\.57\.0
- 首次发布：2026-10-15T04:15:56.567Z
- 最新版本发布：2026-11-17T07:53:56.372Z
- 近 30 天下载量：13570（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：120（近 12 个月 120 个）

## 中文简介

SMRT框架的人力资源记录:谁在一个组织工作,是什么,什么地位——有日期期限的就业,以及期满的资格

## 安装

```sh
npm install @happyvertical/smrt-human-resources
```

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

## README

# @happyvertical/smrt-人力资源

S-m-r-t的人力资源记录:谁为组织工作,作为什么,以及 与什么站着.

-   **就业**:每名房客和个人记录一张,雇员号码, 工人类型、位置、状况、日期和仅附加的更改历史.
-   **资格**: 管理下的定义清单(清单、认证、, 授权、培训、限制)和每个人持有的 发布和终止日期.

付款属于薪金、时间记录 `smrt-timesheets`登录和 权限 `smrt-users`和身份关系 `smrt-profiles`。 。 。 .

## 安装

```bash
pnpm add @happyvertical/smrt-human-resources
```

## 访问

每个模型都是租户范围(需要)、敏感和不出版 REST,MCP或CLI操作;收藏类同样关闭. 所有写作经过 `EmploymentService` 财务报告和审定财务报表 `QualificationService`申请首先授权代理人, 然后从信任的演员中构建一个服务:

```typescript
const actor = { tenantId, profileId: managerProfileId };
```

`profileId` 是一个 `smrt-profiles` 配置文件 ID 并记录在每次更改上. 模式拒绝 `save()` 财务报告和审定财务报表 `delete()` 服务之外(应用程序) 子类 `Employment` 可能保存自己的字段;见下文).

## 日期

日期是日历日期 `YYYY-MM-DD`没有时区。 转换一个 在问"哪一天"之前, 就业术语 `endedOn` 是工作的最后一天,包容.

## 就业

```typescript
import { EmploymentService } from '@happyvertical/smrt-human-resources';

const hr = new EmploymentService(
  db,
  { tenantId, profileId: managerProfileId },
  { onEvent: (event) => void notified.push(event.type) },
);

const employment = await hr.hire({
  profileId: workerProfileId,
  employeeNumber: 'E-1042',
  startedOn: '2026-01-05',
  position: 'Welder',
});

const check = await hr.check(workerProfileId, '2026-02-01');
// { ok: true, employmentId: employment.id, onLeave: false }

await hr.end(employment.id as string, {
  endedOn: '2026-03-31', // last day employed, inclusive
  reason: 'Season over',
});
const after = await hr.check(workerProfileId, '2026-04-01');
// { ok: false, reason: 'ended' }

const rehired = await hr.rehire(employment.id as string, {
  startedOn: '2026-06-01',
});
// rehired.id === employment.id; hr.terms(rehired.id) has two terms
```

-   结束时间可以在最后一天(通知期)之前记录。 存储 状态变为 `ended` 即刻,表示"目的已经记录",而不是 “今天不再就业”:该人员受雇人数不超过(包括) `endedOn`。与 `check(profileId, on)`, (中文(简体) ), `employedOn(on)`, (中文(简体) ), `asOf(employmentId, on)` 或者说 `findByUser(userId, on)`。软件包没有 时钟,当约会过后从不翻转状态.
-   每名房客都有一份工作。 复职者在 同样的记录,所以它的id是稳定的 对于任何引用它.
-   `check(profileId, on)` 财务报告和审定财务报表 `employedOn(on)` 答复中的日期 从存储状态。 有人仍在休假; `check` 报告 `onLeave`。 。 。 .
-   `changePosition`, (中文(简体) ), `changeWorkerType`, (中文(简体) ), `placeOnLeave` 财务报告和审定财务报表 `returnFromLeave` 日期变化; `history()` 返回它们,并 `asOf(employmentId, on)` 重放过去的日期.
-   `linkLogin` 财务报告和审定财务报表 `unlinkLogin` 记录在 `history()` 与他们的 `effectiveOn`,但它们没有重播,也没有安排:登录是 打电话后立即联系或清理,无论日期如何 `findByUser(userId, on)` 正在读取存储的登录。 解开未来的联系 白天,打电话 `unlinkLogin` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}在那个日子.
-   职位、工人类型和请假的变动在最新的 术语。 在作为最后术语的结束被记录之后,直到并包括 联合国 `endedOn`: 更改被记录并提升其通常的事件, 存储 状态保留 `ended`,而离开被验证 与重播的历史 (单位:千美元)`check().onLeave` 财务报告和审定财务报表 `asOf` 请回答。 最后一天之后的约会是 以 `HR_STATUS_TRANSITION` (提前退休);任期前的日期 开始于 `HR_INVALID`。 。 。 .
-   一个术语有自己的变化: `end` 拒绝 `endedOn` 早于一个 职位、工人类型或假期变化情况已在该术语中记录,以及 `rehire` 拒绝一个开始之前.
-   登录链接( N)`userId`)是可选的,一个登录属于一个 一次就业。 它与该职业,结束与否,直到 `unlinkLogin` 在那里澄清: `hire`, (中文(简体) ), `rehire` 财务报告和审定财务报表 `linkLogin` 拒绝 (单位:千美元)`HR_INVALID`任何其它工作都存有登录,所以一个工人 注意保持他们的登录, 没有人可以接受它。 要移动登录, 先解开它`unlinkLogin` 有关终止就业的工作. `findByUser(userId)` 只返回一个工作 存储状态不是 `ended`,所以它停止解决 一旦结束 记录. `findByUser(userId, on)` 从术语中解答: 与就业有关的术语涵盖: `on`不论地位如何 一个主机 提前记录结束日期应超过日期,或 通知被锁定.

## 资格

```typescript
import { QualificationService } from '@happyvertical/smrt-human-resources';

const qualifications = new QualificationService(db, actor, {
  onEvent: (event) => void events.push(event), // after commit; a throwing handler never rolls back
});
const firstAidTicket = await qualifications.define({
  key: 'first-aid',
  name: 'First aid',
  kind: 'certification',
  expires: true,
  validityMonths: 36,
});
const held = await qualifications.grant({
  qualificationId: firstAidTicket.id as string,
  profileId: workerProfileId,
  issuedOn: '2026-03-01', // expiresOn defaults to 2029-03-01
  certificateNumber: 'FA-20931',
  verified: true,
});
const gate = await qualifications.check(
  workerProfileId,
  firstAidTicket.id as string,
  '2029-03-02',
); // { ok: false, reason: 'expired' }
const renewal = await qualifications.renew(held.id as string, {
  issuedOn: '2029-02-15',
}); // a new row; `held` still answers for 2026-03-01..2029-03-01
const after = await qualifications.check(
  workerProfileId,
  firstAidTicket.id as string,
  '2029-03-02',
); // { ok: true, heldQualificationId: renewal.id, expiresOn: '2032-02-15' }
```

-   `check()` 在允许工作之前,是应用程序拨打的门。 当它 它没有说为什么: `not-held`, (中文(简体) ), `not-yet-issued`, (中文(简体) ), `expired`, (中文(简体) ), `suspended` 或者说 `revoked`。 。 。 .
-   过期是从日期算起的,所以支票不需要打扫.
-   各地按日期决定立. `suspend`, (中文(简体) ), `reinstate` 财务报告和审定财务报表 `revoke` 拿着 `effectiveOn` ; 存储 `status` 变化时间 一次也只说了上次录的. `check`, (中文(简体) ), `holders`, (中文(简体) ), `listForProfile` 财务报告和审定财务报表 `expiringWithin` 所有来自历史的答案, 接下来的修改规则也是如此: `suspend` 需要资格证明 既不暂停也不取消 `effectiveOn`, (中文(简体) ), `reinstate` 需要它吗 在那日,是暂时的,在最晚之前,不得有任何日期 中止或恢复.
-   `revoke` 被接受的日期从第一期之日起,除非 资格已经取消。 记录的撤销 日后(预定日期,或最后一天结束的工作) (前方)无所冻结:在生效之前,资格仍然可以 中止、恢复、续约或从早一天取消 最早的撤销是有效的。 存储 `revoked` 这是最后的,所以 这些后期的修改只是历史行,状态持续读取 `revoked`。 。 。 .
-   一个人一次有一次获得资格的现场补助金. `grant` 实值 被拒绝(`HR_ALREADY_HELD`除非他们已经掌握的一切 在新建时或之前取消 `issuedOn`: 计划撤销 2027年的补助金不允许于2026年发放新的补助金(续签现有补助金) 换句话说,过期的罚单被续签,不再发放.
-   一个定义 `scope` 说拥有资格的人是谁 A 类 `person` 资历在就业变动后得以维持。 一个 `employment` 一个是 撤销, 有正当理由 `employment-ended`,当该就业结束时: 在最后一天仍然不错 雇用和撤销 从第二天。 那个 截断总是获胜:它也适用于自己撤销的资格 预定在稍后日期举行,并在结束后批准或续约 被记录(在通知期间,或背日期),存储 `revoked` 时间 一次通过 `check` 只有最后一天才有工作 结局是 决定每个更新链: 最新的一行获得一个撤销和一个 `held-qualification.revoked` 事件,它更新的行被切断 链条,在断接之前或之前已经取消的链条则一无所获.
-   续作"一行"是一行新作"一行","一行"则会分享自己的地位. 暂停, 恢复 或撤销最近一行:当该行被中止或被撤销时,该行将其删除 续签不通过 `check` 要么 要么 要么 要么 要么 要么 拒绝续约(`HR_INVALID`) (中文(简体) ). 更改可在任何日期生效 从连锁店的第一个发行日期开始, 所以今天生效的票仍然可以 提前记录延期后中止或撤销: 与今天的日期同时续约,续约并不恢复地位 当它自己的发行日期到来.
-   续约不能在续约前结束`HR_INVALID`: 更新行 不停地回答自己的问题 所以更短的续约会结束 `check` 仍然通过。 以较短的资格代替资格,取消 从那天起,就给予新的.
-   在最近一次中止或恢复之前不能签发续签通知 所延长的行数`HR_INVALID`),或者当该行暂停时 发行日期`HR_STATUS_TRANSITION`:首先恢复,或者当行 在发布日期或之前撤销(`HR_INVALID`; 给予新的日期 在撤销时或取消之后). 取消生效的一行是 仍然有效,可以续签,所以罚单在通知时失效 周期没有被卡住: 续延带去截断( 待定) 撤销,或雇用最后一天后的某一天,如果是较早的话) 存储 `revoked`,并生成 `held-qualification.renewed` 财务报告和审定财务报表 `.revoked`。 。 。 .
-   `verify(heldQualificationId, { documentAssetId })` 将演员记录为 已经验证了文档,现在,并选择附加或替换它. 它不改变状态,不管地位如何,包括排队 存储 `revoked`。 。 。 .
-   `holders(qualificationId, on, { employedOnly: true })` 例如, 目前雇用的急救人员. `expiringWithin(days, today)` 列表 即将失效:通过的资格 `check` 打开 `today` (印发), 当天没有中止或撤销,没有延长) 白天在窗口内; `{ employedOnly: true }` 只留一个人 雇员 `today`。 。 。 .
-   空白的ID被拒绝使用 `HR_INVALID`· ; `check` 答题 `not-held`。 。 。 .
-   `seed(SUGGESTED_QUALIFICATIONS)` 创建一些共同定义; 从未 更改已经存在的.
-   资格不是允许的。 谁可以使用软件 留在 `smrt-users`;申请可能要求两者兼有.

## 事件和期满

两种服务都要求 `onEvent` 钩子, 更改后调用 : `employment.hired`, (中文(简体) ), `.ended`, (中文(简体) ), `.rehired`, (中文(简体) ), `.position-changed`, (中文(简体) ), `.worker-type-changed`, (中文(简体) ), `.leave-started`, (中文(简体) ), `.leave-ended`,以及 `held-qualification.granted`, (中文(简体) ), `.renewed`, (中文(简体) ), `.suspended`, (中文(简体) ), `.reinstated`, (中文(简体) ), `.revoked`, (中文(简体) ), `.expired`。交付是最佳的;将其与自己的活动相接 如果你需要更多的车.

用您的根数据库控件构建服务 。 每个突变开始 其自己的交易(`beginTransaction()`承诺,然后交付 事件。 建立在已经存在于交易中的控件上的服务( `tx` 转至 `db.transaction()`,保存点范围,或 `beginTransaction()` 因此 它拒绝每一个变异 `HR_TRANSACTION_UNSUPPORTED` 写作 无;读还行. 这种手柄或者没有 `beginTransaction` 或者说 拒绝它与SDK的 `NestedTransactionError` (当地能力) SQLite 适配器,用于 `vector` 编号 : `notifications`;服务从未开放 一个嵌入式交易。 因此,不能将HR突变作为原子 其他工作在电话交易中.

该包在SQLite和PostgreSQL上进行测试. 病因正常化(至 canonical 小写 UUIDs) 仅在 PostgreSQL; 在任何其他适配器上, DuckDB 包括,通过峡谷小写 自己UUID.

包裹里没有东西按时间表运行 打电话 `qualifications.sweepExpired(today)` 从您的调度器记录已过期 资格和接受情况 `held-qualification.expired`它按日期决定, 所以停售或通知期间的票 记录也。 预定的扫荡应该通过 `{ since }`,在一天或之前 最后一天,它的前一次运行覆盖, 所以它不重读所有的历史. 提醒是应用程序的业务.

## 扩大就业

添加带有同名子类的应用程序字段 `employments` 页:1 子类上重报封闭地表:曝光不继承. 通过自己的收藏读取您的子类 `save()` 自有田园 a 服务创建的行。 此软件包拥有的列( E)`tenantId`, (中文(简体) ), `profileId`, (中文(简体) ), `userId`, (中文(简体) ), `employerProfileId`, (中文(简体) ), `employeeNumber`, (中文(简体) ), `workerType`, (中文(简体) ), `position`, (中文(简体) ), `status`) 仅通过 `EmploymentService`: 保存 改变其中之一,或者插入一行,抛出 `HR_WRITE_FORBIDDEN`。 。 。 .

## Svelte 组件

`@happyvertical/smrt-human-resources/svelte` 输出道具驱动组件 : 雇员名单、雇员表、个人资格 过期状态和过期顺位列表。 主机通过 服务并传递纯视图对象.

`EmployeeList` 显示存储状态。 上个学期 `endedOn` 作为 `endsOn` (第四个论点是: `toEmployeeView`),行也读作 2026-12-31的最后一日 被通知的工人不会被误认为是 左边 该组件从未将日期与今天进行比较.

`EmployeeForm` 永远救不了 换个新工作就回来了 `startedOn`;用于编辑 它返回一个需要的 `effectiveOn` (预补自 `today` 说明 寄件者通过 `changePosition`, (中文(简体) ), `changeWorkerType`, (中文(简体) ), `linkLogin` 或者说 `unlinkLogin` 对于每个改变的值。 职位和工人类型的变化 于该日期生效; 登录链接或解链接立即生效, 因此 a 未来日期编辑, 也可以清除登录, 立即解锁它 。 一个主机 想要将登录保存到日期,应该将解锁拉回 调用 `unlinkLogin` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}在那个日子.

## 常见问题

### @happyvertical/smrt-human-resources 是什么？

SMRT框架的人力资源记录:谁在一个组织工作,是什么,什么地位——有日期期限的就业,以及期满的资格

### 如何安装 @happyvertical/smrt-human-resources？

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

### @happyvertical/smrt-human-resources 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

