目录规范

services/<module>/
└── __init__.py

必须项

router = APIRouter()

插件入口 router。

挂载规则

服务通过 config/services.json 映射到：

/services/{slug}

默认无权限依赖，如需权限控制请在服务内部自行添加。

示例：services/verify

该服务用于提供“统一验证页”，并从 config/map.json 读取关卡答案。

前置条件（见 配置文件说明）：

• config/services.json 启用 verify 服务条目；
• config/map.json 的每个关卡包含 answer 字段。

接口

• GET /services/verify/?slug=<slug>
  返回验证页面。
• POST /services/verify/verify
  请求体：{ "slug": "...", "answer": "..." }
  根据 map.json 的 answer 校验答案，正确则返回 token 与 next_url。

顺序规则 该服务与核心门禁一致：关卡顺序以 map.json 中 levels 的数组顺序为准，并且会跳过 enabled: false 的条目。