@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}在那个日子.