Join 是软工集市的招聘与开发者准入平台:看岗位、报名双选,通过三级答辩后进入技术部圆桌。join 的 server/ 约 1 万行 TypeScript,web/ 是 Vue 3,难点几乎全在规则和状态机。
三级身份:登录不等于开发者
| 层级 | 获得方式 | 含义 |
|---|---|---|
| 集市开发者 | UniSSO 登录即得 | 有账号、能浏览 |
| 项目开发者 | 报名 → 部门双选 → 本人确认 | 归属某个部门 |
| 圆桌成员 | 三级答辩通过 + 有席位 | 参与技术部决策 |
用户表用 developer_level(none / project / roundtable)区分层级,primary_department_id 记录归属,status 区分在职与退出。登录走 auth.ts 的 UniSSO 授权码流程,随后 syncUnissoDeveloper(server/src/services/developer-sync.ts)以统一身份为准,回写本地 developer_level 与外部 ID。
坑:部门通过后必须有一次「本人确认」。少了这一步,学生会在不知情的情况下被计入某部门,后面的答辩与席位统计全部失真。
岗位、报名与双选
岗位列表支持关键词、部门、方向、类型、地点筛选,详情页登录后可报名,记录写入 applications 表,初始状态 pending。
1 | GET /api/jobs 列表(keyword / dept / direction / type / location) |
双选状态机:pending → contacted → passed → confirmed,任一步可 rejected。沟通时记录时间、动机、投入;通过后学生端出现「待确认」,确认时才把 primary_department_id 写回用户。
两条约束都落在数据层:同一人对同一部门只允许一条有效报名(唯一索引 (user_id, dept_id));多个部门同时 passed 时,学生确认一个,其余自动失效,否则一个人会同时出现在多份名单里。
三级答辩
答辩状态为 level1 → level2 → level3 → passed / rejected / waitlist。发起前过五道校验:在职、非圆桌、已是项目开发者、有归属部门、无进行中答辩;canInitiateDefense(server/src/services/defense.ts)逐条给出失败原因,笼统的「无权限」不算反馈。
1 | // server/src/services/defense.ts |
坑:必须校验「没有进行中的答辩」。只校验等级,用户可以并发发起多场,评审人会被重复派单。
一级由本部门负责人评,只陈述事实(做了什么、投入多少),回避打分——本部门给自己人打分没有区分度。createDefense 建记录并生成一级任务,一级未提交则流程停住。
二级是跨部门交叉评审,评审人自动排除本部门负责人、本部门管理员和一级陈述人。判定规则里有两个容易写错的常数:
1 | // server/src/services/defense.ts |
needed 取 min(2, max(1, 评审人数)),是为了兼容只派 1 位评审的小场景:1 票即可定论;派 2 人以上时要求 2 票赞成。rejects === 0 不能省——否则两个评审一赞一反对也能通过,交叉评审就失去意义。
三级由资源方代表评,评的是资源诉求是否合理,与技术能力无关。判定同样是:至少 1 人提交、无人反对、至少 1 票赞成、平均分 ≥ 60;评审缺席由超管代行。同一套打分表硬套两级,会让三级变成重复评能力。
状态推进由 advanceDefense 完成:看当前级别,该级「可定论」才推进或终结,不可定论直接返回、不改状态。它必须幂等——评审提交、管理员刷新、定时任务都可能触发,ensureLevel2Reviews / ensureLevel3Reviews 内部要查重,否则会生成重复评审任务。评审长期不交或评审人离职时,用 forceDecide 强制裁决并记录谁、为什么;canSubmitReview 与 canViewDefense 分别控制评审资格与可见范围(申请人和评审人可见)。
席位与候补
部门席位 = 保底(≥ 1)+ 浮动(按规模与资源贡献)。departmentSeatStats(dept) 返回 total / occupied / available;答辩通过先看 available,有位进圆桌,没位进候补。
1 | // server/src/services/defense.ts |
递补按 id 升序,即答辩通过先后,不按报名时间——否则后来者会插到早就通过答辩的人前面。循环里每轮都要重算 available:一次算好再递减的话,finalizePass 内部又占一个席位,就会超发。releaseRoundtableSeat 释放席位后触发递补,recordSeatReview 记录复核意见。
公示、名人堂与简历
每次会议后由系统生成席位与晋升公示:currentSeatTable 出当前席位表,recentPromotions 取近期晋升,buildPublicityContent 拼正文,touchPublicity 记时间,applyPublicityToDepartments 回写部门快照;services/pdf.ts 再把公示渲染成 PDF 供下载存档。公示必须由数据生成,手写内容一旦与系统状态分叉,所有「以公示为准」的判断都会错。
名人堂 GET /api/hall(历届成员与贡献)与 FAQ GET /api/faqs(分类 / 搜索 / 折叠)分别由 services/hall.ts、routes/faqs.ts 提供。
简历有两个服务:parseResumeText(resume-parse.ts)把文本抽成教育、项目、技能等字段;resume-check.ts 检查必填、时间线倒挂、字数下限,返回问题清单但不阻断提交。解析结果只能辅助填写,不能直接入库——模型抽取会幻觉,必须用户确认后再保存。
管理与存储
/admin 按角色渲染标签页:超管看全部,部门管理员只看本部门,资源方代表只开放三级评审与被指派任务。前端隐藏标签只影响可见性,每个管理接口都要独立鉴权,否则直接调接口即可越权。
services/mail.ts 在报名、通过、答辩指派、公示等节点异步发信,模板与收件人按节点确定,必须可失败重试;同步发信遇到 SMTP 超时会拖死整个请求。
数据存在 JSON 里(db.getStore()),db.ts 负责 initDb、assertDbReady、ensureSeeds。「一年改几次」的规模够用,代价是并发写靠进程内串行化,好在写并发低频,可以接受。
面试速答
- 三级身份:集市开发者(登录即得)→ 项目开发者(双选 + 本人确认)→ 圆桌(答辩 + 席位)。
- 答辩前置:在职、非圆桌、已是项目开发者、有归属部门、无进行中答辩,五条缺一不可。
- 二级判定:
needed = min(2, max(1, 人数));无反对 + 赞成数达needApprovals+ 均分 ≥ 60,一票否决不能省。 - 三级判定:至少 1 人提交、无反对、≥ 1 赞成、均分 ≥ 60;评的是资源诉求。
- 席位:保底 ≥ 1 + 浮动;无位进候补,释放后按答辩通过顺序递补,循环内重算余量。
- 公示:由数据生成并导出 PDF;手改会导致状态分叉。
→ 下一篇:开发者平台:权限、部署与小程序





