本页目录展开
  1. 三级身份:登录不等于开发者
  2. 岗位、报名与双选
  3. 三级答辩
  4. 席位与候补
  5. 公示、名人堂与简历
  6. 管理与存储
  7. 面试速答

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
2
3
4
GET  /api/jobs            列表(keyword / dept / direction / type / location)
GET /api/jobs/:id 详情
POST /api/jobs/:id/apply 报名(需登录)
GET /api/me/applications 我的报名

双选状态机: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
2
3
4
5
6
7
8
9
10
// server/src/services/defense.ts
export function canInitiateDefense(user: UserRow): { ok: boolean; reason: string } {
if (user.status !== 'active') return { ok: false, reason: '账号已退出开发者体系' };
if (user.developer_level === 'roundtable') return { ok: false, reason: '你已经是圆桌开发者' };
if (user.developer_level !== 'project') return { ok: false, reason: '需先通过部门双选成为项目开发者' };
if (!user.primary_department_id) return { ok: false, reason: '尚未归属任何部门' };
const active = activeDefenseOf(user.id);
if (active) return { ok: false, reason: `你已有一场进行中的答辩(#${active.id})` };
return { ok: true, reason: '' };
}

坑:必须校验「没有进行中的答辩」。只校验等级,用户可以并发发起多场,评审人会被重复派单。

一级由本部门负责人评,只陈述事实(做了什么、投入多少),回避打分——本部门给自己人打分没有区分度。createDefense 建记录并生成一级任务,一级未提交则流程停住。

二级是跨部门交叉评审,评审人自动排除本部门负责人、本部门管理员和一级陈述人。判定规则里有两个容易写错的常数:

1
2
3
4
5
6
7
8
9
10
11
12
13
// server/src/services/defense.ts
function level2Verdict(defenseId: number) {
const reviews = db.getStore().defense_reviews
.filter((r) => r.defense_id === defenseId && r.level === 2);
const done = submitted(reviews);
const needed = Math.min(2, Math.max(1, reviews.length));
if (done.length < needed) return { ready: false, pass: false };
const approvals = done.filter((r) => r.decision === 'approve').length;
const rejects = done.filter((r) => r.decision === 'reject').length;
const avg = avgScore(done);
const needApprovals = reviews.length === 1 ? 1 : 2;
return { ready: true, pass: rejects === 0 && approvals >= needApprovals && (avg === null || avg >= 60) };
}

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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// server/src/services/defense.ts
export function promoteWaitlist(departmentId: number): number {
const s = db.getStore();
const dept = s.departments.find((d) => d.id === departmentId);
if (!dept) return 0;
let promoted = 0;
while (true) {
const stats = departmentSeatStats(dept);
if (stats.available <= 0) break;
const next = s.defenses
.filter((d) => d.department_id === departmentId && d.status === 'waitlist')
.sort((a, b) => a.id - b.id)[0];
if (!next) break;
finalizePass(next, '席位释放,按候补顺序递补进入圆桌', '席位递补');
promoted += 1;
}
return promoted;
}

递补按 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;手改会导致状态分叉。

→ 下一篇:开发者平台:权限、部署与小程序