@happyvertical/smrt-human-resources

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 1.4万

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

中文使用文档
文档目录8 节
  1. 安装
  2. 访问
  3. 日期
  4. 就业
  5. 资格
  6. 事件和期满
  7. 扩大就业
  8. Svelte 组件

@happyvertical/smrt-人力资源

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

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

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

安装

pnpm add @happyvertical/smrt-human-resources

访问

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

const actor = { tenantId, profileId: managerProfileId };

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

日期

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

就业

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不论地位如何 一个主机 提前记录结束日期应超过日期,或 通知被锁定.

资格

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 共发布 120 个版本,首次发布于 2026/10/15;过去 12 个月发布了 120 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-human-resources 的常见问题

@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 和提交记录判断。