# 需求:新工位入职套件(环境体检+按人入职卡)

状态: done(2026-10-16 已落地:onboard.py 五命令+ONBOARDING-STANDARD+onboard.json 落地;本机 check 全绿,new→verify=0 / 缺账号=1 / 未建档=2 三路径实测,test_onboard 25 例绿)
归属: 公司运营(团队建设/新工位落地)
来源: boss 直投(会话)
日期: 2026-10-16
建议: 做,新电脑要让人快速知道 NAS 账号与规范;靠人口头带=漏、培训材料=过期即假,做成 CLI+按人卡片(环境体检可机判)

## 现状

- boss 直投原话:「我要怎么方便接纳成员,公司现在有一个工位,是新电脑,我需要让他快速知道相关规范,如 NAS 团队个人账号密码,环境,如 python 几」。当前没有任何入职载体:NAS 个人账号开通全凭口头交代,环境版本(Python/Node/pnpm/Rust/Git 各是几)无人写下来,规范入口散在 `docs/工程规范/` 20+ 篇与 `ops/README.md` 里,新人不知道从哪读起。
- 机检口径缺失:没有任何命令能回答「这台新电脑能不能开工」;`ops/ports.json`、`ops/products/` 有正本,唯独「人」没有登记与体检。
- 2026-10-16 实测两个会静默坑新人的环境事实:本机 `winget` 不存在(装法不能只写 winget);PATH 里 `bash` 先命中 `C:\WINDOWS\system32\bash.exe`(WSL),而公司执行通道是 Git Bash。

## 方案

1. `ops/onboard.json`:数据正本(环境基线 12 项含 `path_hint`、账号 5 类含开通路径、必读 8 篇、红线 10 条、首日三步),加一条=加一行数据。
2. `ops/onboard.py`:CLI 五命令 `check`(工具版本 vs 基线 + NAS 四项连通,含 `.cmd` shim 经 cmd /c 转发)/`new`(开成员档案)/`card`(出含本人口令的一页纸)/`list`(工位一览)/`verify`(上岗验收,退出码 0/1/2)。
3. 成员档案 `~/.pinnadash/onboarding/<拼音名>.json`(git 外,口令由 boss 填,不进对话/日报/日志);入职卡默认落 `.runtime/onboarding/`(gitignore)。
4. 口径正本 `docs/工程规范/ONBOARDING-STANDARD.md`(账号归属与生命周期、版本基线理由、验收判据、明确不做);`ops/README.md` 挂指针。
5. 测试 `ops/test_onboard.py`(25 例,含版本解析/可选工具标记/账号缺口/卡片格式/真数据必过校验;先红后绿)。

## 验收标准

- [x] `python ops/onboard.py check` 本机实跑全绿(12 工具 + 4 连通,tcp 13000/13306 + `git ls-remote` 凭据 + `~/.npmrc` 令牌)
- [x] 实跑 `new → 填账号 → verify` 退出 0;未填账号退出 1;未建档退出 2(三条路径实测)
- [x] 入职卡含账号/口令/基线实测/必读/红线六节,离线出卡不跳号,路径用 POSIX 形态
- [x] `python -m pytest ops/test_onboard.py` 25 绿;全仓 `python ops/test_all.py` 兜底绿