# Ai-DOP 项目总览（给 Cursor / 新对话快速恢复上下文）

**使用方式**：重启 Cursor 或新开聊天后，先 **@ 本文件**。路径取决于工作区根目录：

- 根目录为 **`…/ai-dop-platform`**：`@docs/PROJECT_HANDOFF.md`
- 根目录为 **Ai-DOP 主库根**（含 `server/`、`Web/`）：`@ai-dop-platform/docs/PROJECT_HANDOFF.md`

更细的验收勾选见 [CURRENT_TASKS.md](CURRENT_TASKS.md)（主库根下则 `@ai-dop-platform/docs/CURRENT_TASKS.md`）。

---

## 1. 项目是什么

- **名称**：Ai-DOP（数字化运营平台），在 **Admin.NET** 通用权限与多租户能力之上做行业业务。
- **团队**：约 3～4 人，**按模块全栈**；共享内核（权限、租户、公共组件）需有人把关，避免各自改乱。
- **工作区**：**Ai-DOP 主库**为 **单一 Git 仓库**（Gitee `sky-guo/ai-dop`，本机常克隆在 `SourceCode/references/Admin.NET`）。**`ai-dop-platform/`** 与 **`server/`**、**`Web/`** 同库：文档与规则、工具脚本与 **.NET 后端 + 官方 Web + 插件** 一并拉取与提交（原 **legacy-demo** 已移除）。

---

## 2. 技术路线（已定方向）

| 维度 | 新系统 | 旧系统（迁移来源） |
|------|--------|-------------------|
| 后端框架 | **Admin.NET**（Furion、SqlSugar、动态 API 惯例） | 独立 ASP.NET + EF Core Demo |
| 数据库 | **MySQL** | 曾为 SQL Server 等 |
| 存储过程 | **新系统不新增存储过程**；原 SP 逻辑分阶段下沉到 **应用层 + 配置/规则/流程引擎** | 依赖 SP 的部分需逐步迁移 |
| 形态 | **SaaS**、多租户；上线策略倾向 **开关 / 滚动发布 / expand-contract**，控制停机 | — |
| 集成 | 先 **只读工厂库副本**，再 **API**；长期 **轻数据服务 → 数据中台** | — |

前端：**Vue 3 + Element Plus**，主库 **`Web/`**（含 Ai-DOP 业务扩展页）。

---

## 3. 功能清单（基线范围）

### 3.1 已在旧 Demo 中出现、且已迁到 Admin.NET 插件的对照能力

以下在 **插件 `Admin.NET.Plugin.AiDOP`** 中已实现 **与旧 Demo 一致的 REST 契约**（表名 `ado_*`，便于数据迁移对照）：

- **订单**：`api/Order`（列表分页、详情、增删改）。
- **计划**：`api/Plan`（同上）。
- **工单**：`api/WorkOrder`（同上 + `POST .../{id}/complete` 完工）。

旧 Demo 里另有 **JWT/Auth、租户/用户/角色** 等示例；**正式能力以 Admin.NET 核心为准**，不再以 Demo 独立后端为权威。

### 3.2 管理端与业务页（`Web/`）

原独立 Demo 中的看板、列表等能力按产品优先级在 **`Web/src/views`**（含 `aidop/` 等）持续落地；开发时以 **插件 API + Admin.NET 菜单权限** 为落点。

### 3.3 全平台级（来自前期共识，非本仓库一次做完）

- 旧 **SQL Server** 数据 → **MySQL** 迁移与双写/切换策略。
- **Excel/报价** 等周边工具可在 `D:\Projects\Ai-DOP\` 根目录下用脚本维护（与 **`SourceCode`** 并列）；**与 Admin.NET 仓库解耦**，需要时单独任务处理。
- **工厂只读库、API、数据中台**：分阶段，不在当前插件基线范围内一次交付。

---

## 4. 仓库与目录结构（务必分清）

```
D:\Projects\Ai-DOP\SourceCode\references\Admin.NET\   # ★ Ai-DOP 主库（本机路径示例）
├── server/                      # .NET 解决方案（Admin.NET.sln、插件、Web.Entry）
│   ├── Admin.NET.sln
│   ├── Plugins/
│   │   └── Admin.NET.Plugin.AiDOP/   # ★ AiDOP 业务插件
│   └── Admin.NET.Web.Entry/          # ★ 启动项目（默认端口常为 5005）
├── Web/                         # 官方 Vue 管理端
└── ai-dop-platform/             # 文档、Cursor 规则、tools
    ├── .cursor/rules/
    └── docs/
```

**相对路径**：从 **`ai-dop-platform/`** 根到解决方案为 **`../server/Admin.NET.sln`**。若 Cursor 打开 **主库根目录**，则为 **`server/Admin.NET.sln`**。  
本机 **`SourceCode/ai-dop-platform`** 建议改为指向 **`…/references/Admin.NET/ai-dop-platform`** 的 **目录联接（junction）**，避免与主库内文档双份漂移。

---

## 5. 已完成的基线工作（截至文档编写时）

- [x] 拉取/固定 **Ai-DOP 主库**（如 Gitee `v2`）；内容与上游 Admin.NET 同树，含 **`server/`**、**`Web/`**、**`ai-dop-platform/`**。
- [x] 建立 **`Admin.NET.Plugin.AiDOP`**：SqlSugar 实体 `AdoOrder` / `AdoPlan` / `AdoWorkOrder`；MVC 控制器 **`api/Order`、`api/Plan`、`api/WorkOrder`**；`[NonUnify]` 保持与旧前端一致的 JSON 形状；**Development** 下 **CodeFirst.InitTables**。
- [x] 解决方案与 **Web.Core** 已 **引用插件** 并 **`AddApplicationPart`** 注册控制器程序集。
- [x] `ai-dop-platform`：**README**、**GETTING_STARTED**、**ARCHITECTURE**、**CURRENT_TASKS**、**.cursor/rules**。
- [x] **legacy-demo** 已从仓库移除；联调使用 **`Web/`** + **`Admin.NET.Web.Entry`**。
- [x] 本机可安装 **.NET 8 SDK**（用户目录或全局）；**多目标 net10 需再装 .NET 10 SDK** 才能完整 restore/build（见 CURRENT_TASKS）。

---

## 6. 当前进行到哪一步 / 下一步建议顺序

**当前阶段**：**基线已搭好**，进入 **环境验证 + 业务扩展**。

建议顺序（与 [CURRENT_TASKS.md](CURRENT_TASKS.md) 勾选一致）：

1. **本机 SDK**：`dotnet --list-sdks` 同时有 **8.0.x 与 10.0.x**；缺 10 时按 CURRENT_TASKS 在无占用 `dotnet.exe` 情况下安装。
2. **编译**：`dotnet build ../server/Admin.NET.sln -c Debug` 通过（主库根下则 `server/Admin.NET.sln`）。
3. **配置 MySQL**（Admin.NET 官方配置方式），启动 **Web.Entry**，确认 **Development** 下 **ado_*** 表可用。
4. **前端联调**：**`Web/`** 起 dev，登录后抽查 **GET /api/Order** 等兼容接口与业务页。
5. **安全硬化**：评估移除 **`[AllowAnonymous]`**，挂菜单/权限；生产关闭依赖 **CodeFirst** 的建表方式。
6. **产品迭代**：按模块完善 **`Web/`** 页面与 **Admin.NET 登录态、动态 API 或现有兼容 API**。

---

## 7. 风险与约定

- **不要**在 `Admin.NET.Core` 里堆业务代码；业务在 **`Admin.NET.Plugin.AiDOP`** 或后续新插件中扩展。
- **不要**把与上游无关的大改直接混进 **本主库**；与官方 Admin.NET 差异应用分支/文档说明。
- Demo 接口 **匿名可访问** 仅用于开发联调，**上线前必须收紧**。

---

## 8. 相关文档索引

| 文档 | 用途 |
|------|------|
| [PROJECT_HANDOFF.md](PROJECT_HANDOFF.md) | **本文**：总览、功能、进度、续作入口 |
| [CURRENT_TASKS.md](CURRENT_TASKS.md) | 环境备忘、编译注意、验收勾选、待办 |
| [GETTING_STARTED.md](GETTING_STARTED.md) | 逐步启动与 API 路由表 |
| [ARCHITECTURE.md](ARCHITECTURE.md) | 结构示意与插件职责 |
| [NEW_MEMBER_ONBOARDING_ZERO_TO_ONE.md](NEW_MEMBER_ONBOARDING_ZERO_TO_ONE.md) | 新成员保姆级 0->1 接入指南 |

---

**维护**：里程碑或范围变化时，请更新 **§5 / §6** 与本文件日期；同事接手时优先改 **CURRENT_TASKS** 勾选状态。