shz-backend/.codex/skills/shz-pc-debug/references/project-topology.md

SHZ 项目结构

工作区	职责	调试时的用途
/Users/lapuda/code/shz-backend	后端项目	调查 API 路由、授权、业务服务、定时任务、持久化和服务器错误。在此使用项目日志和受保护的数据库 skill。
/Users/lapuda/code/shz-admin	PC 前端	调查 PC 求职者、监管管理员和企业 UI 路由、组件、客户端状态、请求构造和浏览器交互。
/Users/lapuda/code/shz-employment-service	小程序	仅调查小程序特有行为，或与 PC 应用共用的接口/认证/业务逻辑问题。

选择最小范围

1. 捕获浏览器证据后，在 shz-admin 中开始 PC 视觉、交互、导航或请求缺失问题的调查。
2. 在 shz-backend 中开始 API 状态、响应、权限、服务器异常或数据库数据问题的调查。
3. 当浏览器请求或响应表明故障跨越客户端/服务器边界时，同时调查 shz-admin 和 shz-backend。
4. 只有证据表明涉及同一个接口或业务行为时，才加入 shz-employment-service。PC 独有问题不得修改小程序代码。

跨仓库安全工作

1. 使用 CodeGraph、运行检查或编辑文件前，先进入选定的工作区。
2. 独立检查每个仓库的工作树，并保留无关改动。
3. 广泛文本搜索前，在选定工作区尝试使用 CodeGraph。如果索引不可用，不得创建索引；改用 rg。
4. 对每个发生变更的仓库运行聚焦验证。除非当前用户请求明确授权提交和部署，否则不得部署、重启服务或修改远程环境；获得授权后遵循 deployment.md。