# 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](deployment.md)。