# CRM Java 参考快照（按需拷贝）

原 CRM Java 的**只读工作副本**，在**编写对应后台接口之前**拷贝，对照翻译成 Python。代码不可运行，勿放入 `backend/`。

## 原则（SHALL）

| 做法 | 说明 |
|------|------|
| **用到什么，快照什么** | 实施 `06-steps.md` 的某一步时，只拷贝该步列出的 Java 文件 |
| **权威源** | 并列仓库 `../shanxia/crm/backend/ruoyi-modules/ruoyi-crm/` |
| **快照时机** | 开始写该步 Python **之前**，不是方案阶段一次性全量拷贝 |
| **翻译后** | 在 `04-api-spec.md` 打 ✅，不必删除快照（便于 diff 回归） |

## 拷贝命令

```bash
# 报价单 — 示例：实施「列表」步前
./docs/crm-migration/scripts/snapshot-java.sh quote \
  service/impl/CrmQuoteServiceImpl.java \
  mapper/CrmQuoteMapper.java \
  resources/mapper/crm/CrmQuoteMapper.xml

# 供方信息 — 示例：实施供方模块前
./docs/crm-migration/scripts/snapshot-java.sh supplier-info \
  controller/CrmSupplierInfoController.java \
  service/impl/CrmSupplierInfoServiceImpl.java \
  domain/CrmSupplierInfo.java
```

## 目录索引

| 模块 | 目录 | 说明 |
|------|------|------|
| 报价单 | [quote/](quote/) | 含首批探索性拷贝；后续以按步追加为准 |
| 供方 | `supplier-info/` | 实施 P0 时创建 |
| 合同 create | `contract/` | 实施 P1 时创建 |

## 与前端「拷贝 Vue」的对应关系

| 前端 | 后端 |
|------|------|
| 一次性拷贝整个 `views/crm/quote/` | **不**一次性拷贝全部 Java |
| 改 Vue 时打开对应文件 | 写某 API 前快照该 API 涉及的 Controller + ServiceImpl + Mapper |