招聘模块支持组织认证、付费发布招聘、后台审核和机会检索。请求与响应字段见测试环境 API 文档。

基本流程

发布者：

1. 保存组织资料，按当前认证要求上传材料，等待认证通过。
2. 创建招聘，选择套餐付款，并提交内容审核。付款和内容审核可以先后任意进行。
3. 主体认证有效、内容审核通过且服务端确认收款后，招聘开始展示并计时。
4. 后续可以编辑、续购或提前终止；编辑会重置内容审核，终止会处理适用的退款。

管理员：

1. 审核组织认证申请。
2. 审核招聘内容；当前主体认证有效才能通过，驳回会关闭招聘并处理退款。
3. 按需处理主体复审、撤销认证或关闭招聘。

发布者接口

组织认证

先读取认证要求，再填写组织资料和上传材料。材料采用 multipart 字段 materials.<key>，key、必填项及文件限制取自当前要求；申请提交后保留当时的要求和组织资料快照。

首次读取组织资料返回 404 时，先创建资料。认证是否有效以组织资料的 has_valid_verification 为准，不以某条历史申请的审核结果判断。被驳回后提交新申请。

创建、编辑和终止招聘

新建招聘为草稿，提交后等待审核。联系方式按类型保存 value 和 is_public，需要公开的条目须显式设置 is_public: true。已提交内容实际编辑后会重新待审；组织资料变化也会使原认证不再适用于当前主体，并重置关联招聘审核，由管理员重新处理。

重置审核不暂停或顺延已有展示时间，也不自动终止招聘或退款。已终止、审核驳回关闭的招聘不能重开，重新发布需创建新招聘。

购买与续购

1. 通过GET /api/recruitment/plans/读取服务端当前套餐：天数、总价（整数人民币分）和币种。空列表表示当前没有可购买套餐。
2. 调用POST /api/recruitment/my-jobs/{id}/purchase/，只提交选中的 days，以返回的 amount_cents 为成交金额。
3. 使用返回的 payment.sn 进入现有收银台：先读取GET /api/pay/v2/pay-method-choices/（传 sn），再调用POST /api/pay/v2/wxpay/{id}/pay/。当前招聘只支持微信支付，支付路径中的 id 使用完整 payment.sn。
4. 返回页面后刷新购买记录和招聘详情，以 payment_status=confirmed 确认业务收款，结合内容审核及展示区间显示状态，不能仅凭客户端支付回调显示已发布。确认会异步更新，pending 时稍后重读或重新进入页面刷新，不因一次返回待确认就判定付款失败。

续购沿用同一购买接口，需要主体有效、内容已通过审核且招聘未终止。有效期内续购接在原展示区间之后，过期续购在重新满足展示条件时起算；已付款但待审时尚未开始首次展示计时。

请求超时或返回 PURCHASE_PENDING 时，先查询购买记录（最新优先），恢复已有待支付订单，避免重复下单。套餐调价不改变已有订单；已选套餐下单时仍由服务端重新查价，付款前展示实际订单金额。

终止或驳回后，通过购买记录中的 refund 查看退款。pending/processing 为处理中，succeeded 为成功，manual 为需人工处理且后续仍可能更新，failed 为异常，not_required 为无需退款。退款金额以服务端为准；未使用天数向上取整，不足一天按一天计算。

公开招聘与机会

两个搜索接口均使用 lat、lng。招聘搜索会结合当前用户专长；不提供定位时，只匹配远程职位或明确选择的城市。搜索和普通列表的用途不同，不要用搜索空结果判断全站是否没有招聘。

公开详情只返回当前可展示招聘，待审、终止或过期时返回 404；发布者查看自己的招聘使用管理详情。编辑和续购不会提升列表排名。

混合结果通过 kind=job/demand 区分来源，并跳转各自详情。两类数字 ID 可能相同；需求搜索还可能因匹配不同专长重复出现同一需求。登录用户自己的招聘不出现在混合入口，使用“我的招聘”查看。

管理员接口

组织认证与复审

发布者列表可传 review_due=true 查找需复审主体；复审到期是提醒，不会自动撤销认证。明确撤销认证会关闭关联招聘并处理退款，与普通组织资料变更不同。

认证审核前读取申请详情，expected_revision 使用 subject_revision，expected_organization_snapshot 使用完整 organization_snapshot。遇到版本冲突时重新读取并审核，不自动沿用旧结论。

招聘审核与关闭

审核前读取招聘详情，提交当前 content_version、current_subject_snapshot.revision 和完整主体快照；字段对应 API 中的三个 expected 参数。版本冲突时重新取详情并审核。当前主体无有效认证时仍可驳回，但不能通过。