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

22 lines
1.6 KiB
Markdown
Raw Normal View History

# 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)。