# 主工程（CRM / 智慧校园）目录说明

Java 管理端、Vue 管理前端、主工程 Python 与 SQL 等均位于 **`crm/`** 下；报销子系统在仓库 **`bx/`**。

## 常用路径（均在仓库根目录执行）

| 用途 | 进入目录 |
|------|-----------|
| Maven / 热启动脚本 | `cd crm/backend` |
| 管理端前端 npm / Vite | `cd crm/web` |
| 主工程 Python（若使用） | `cd crm/py-backend` |

## 仓库根便捷脚本

无需先 `cd` 时，可在仓库根执行：

```bash
./scripts/crm.sh backend -- bash hot-start.sh
./scripts/crm.sh web -- npm run dev
./scripts/crm.sh py-backend -- bash start.sh
```

首次使用请赋予执行权限：`chmod +x scripts/crm.sh`

## CI

推送或 PR 修改 `crm/backend/**` 时，GitHub Actions 工作流 **`.github/workflows/crm-backend-validate.yml`** 会在 `crm/backend` 下执行 `mvn -DskipTests validate`。

## Graphify（前端知识图缓存）

历史缓存目录 **`crm/web/graphify-out/`** 已从仓库移除（其中 `manifest.json` / `cache` 等含旧绝对路径 `.../web/`）。

**重新全量生成**：在已安装 Graphify 技能的环境（如 Claude Code）对仓库根执行 **`/graphify crm/web`**，输出会再次出现在 `crm/web/graphify-out/`（详见技能 `graphify` 说明）。本机 CLI `graphify` 提供 `update <path>`、`watch <path>` 等，适用于**已有 `graph.json` 之后**的增量或监听；首次全量 pipeline 请用上述 `/graphify` 工作流。

## 文档与 SQL

- 本地启动与依赖：`工程本地启动指导.md`
- 热启动说明：`docs/backend/README-热启动脚本.md`
- 生产部署：`docs/backend/生产环境打包部署指南.md`
- 业务 SQL：`sql/`（如 `sql/crm/`）