公民服务

平台同时提供面向公民的服务门户与面向经办人员的队列。两者建立在同一套数据模型之上：gov_services 目录、gov_applications 申请，以及只追加的事件时间线。

词汇表对齐 CPSV-AP 3.2.0（SEMIC — Public Service、Evidence、Life Event）；结果词汇表沿用荷兰 ZGW 模型。

两个界面

界面	面向谁	路径	权限
公民门户	任意已登录用户	/me/services、/me/applications、/me/references、/me/notifications、/me/payments、/me/appointments	需登录
经办队列	经理 / 经办人员	/manager/requests、/manager/dashboard	gov.review

办理模式

模式	含义
auto	直接从登记库读取并签发（证明、说明）。无人工介入——提交时在单个事务内完成。
manual	由经办人员审核并作出决定后才办结。

申请状态机

允许的状态迁移在领域层只声明一次，仓储层的 SQL 再以 WHERE status IN (...) 复核一遍——这样就堵住了两个决定同时到达时的竞态。

stateDiagram-v2
    [*] --> submitted
    submitted --> registered
    submitted --> cancelled
    registered --> in_review
    registered --> info_required
    registered --> approved
    registered --> completed
    registered --> rejected
    registered --> expired
    in_review --> info_required
    in_review --> approved
    in_review --> completed
    in_review --> rejected
    info_required --> in_review
    info_required --> approved
    info_required --> completed
    info_required --> rejected
    approved --> completed
    completed --> [*]
    rejected --> [*]
    cancelled --> [*]
    expired --> [*]

状态	含义
submitted	公民已提交
registered	正式受理——SLA 计时开始
in_review	经办人员审核中
info_required	等待公民补充材料
approved	已决定，但成果尚未交付（实体证件、证书）
completed	成果已签发
rejected · cancelled · expired	终态

approved 与 completed 的区别

如果成果可以当场签发（例如证明），申请会直接进入 completed——中间状态只是噪音。如果成果是实体物品，approved 表示"已决定、未交付"，随后才转为 completed。

结果词汇表

granted · refused · withdrawn · not_admissible · processed

各机构可以自行定义过程词汇表，但正是统一的结果词汇表才让报表与统计成为可能。

公民端端点

方法	路径	说明
GET	/api/v1/gov/services	服务目录
GET	/api/v1/gov/life-events	按人生事件分组
GET	/api/v1/gov/overview	首页汇总
GET · POST	/api/v1/gov/applications	列表 / 提交
GET	/api/v1/gov/applications/{id}/timeline	只追加的办理时间线
POST	/api/v1/gov/applications/{id}/cancel	公民撤回
POST	/api/v1/gov/applications/{id}/provide-info	补充材料
GET · POST	/api/v1/gov/references	证明：列表 / 申领
GET	/api/v1/gov/notifications	通知
POST	/api/v1/gov/notifications/{id}/read、/read-all	标记已读
GET	/api/v1/gov/payments	税费、规费、罚款
POST	/api/v1/gov/payments/{id}/pay	缴费
GET · POST	/api/v1/gov/appointments	预约
POST	/api/v1/gov/appointments/{id}/cancel	取消预约

所有写操作均受 govWrite 限流器保护（30/分钟，burst 15）。

经办队列

只有持有 gov.review 的用户才能访问 /api/v1/gov/officer/*。该检查作为路由级中间件执行，不在每个处理器中重复。

方法	路径	说明
GET	/officer/stats	队列汇总（与公民端概览分开）
GET	/officer/queue	可筛选的队列
GET	/officer/queue/{id}	单个申请
POST	/officer/queue/{id}/assign	分派给自己或他人
POST	/officer/queue/{id}/decide	作出决定（approved / rejected）
POST	/officer/queue/{id}/complete	签发成果并办结
POST	/officer/queue/{id}/request-info	向公民索取补充材料

公开目录

目录无需登录即可读取：

• GET /api/v1/catalog/services — 已发布的服务
• GET /api/v1/catalog/services/{id} — 单个服务护照
• GET /api/v1/catalog/life-events — 人生事件

其权威来源是服务登记（R1），参见服务登记与 Relay。服务在发布之前不会出现在公开目录中。