# Ai-DOP 平台（团队基线）

本目录是 **Ai-DOP 数字化运营** 的团队工作区：在 **Admin.NET** 上挂载业务插件，并保留旧 **Gitee Demo** 作为对照与前端来源。

**源码根目录**：`D:\Projects\Ai-DOP\SourceCode`（本仓库为其下的 `ai-dop-platform`；Admin.NET 在同级 `references`）。

## 目录说明

| 路径 | 说明 |
|------|------|
| `../references/Admin.NET/`（相对本仓库根目录） | Admin.NET 上游源码（建议跟踪官方稳定分支，如 `v2`）。 |
| `../references/Admin.NET/server/Plugins/Admin.NET.Plugin.AiDOP/` | **AiDOP 业务插件**：订单 / 计划 / 工单 API（SqlSugar + 与旧 Demo 一致的 `api/Order`、`api/Plan`、`api/WorkOrder`）。 |
| `legacy-demo/` | 迁入的 Vue + 原独立后端；页面与交互参考，新后端以插件为准。 |
| `docs/` | 架构与上手文档。 |
| `.cursor/rules/` | Cursor 团队规则（边界、栈、风格）。 |

## 环境要求

- **.NET 8 SDK**（与 Admin.NET `TargetFrameworks` 一致；若使用 net10 需对应 SDK）。
- **Node.js**（跑 `legacy-demo/frontend`）。
- **MySQL**（连接串配置在 Admin.NET 的 `Configuration/Database.json` 等，与官方文档一致）。

## 快速开始

1. 用 Visual Studio / Rider / `dotnet run` 启动 **`Admin.NET.Web.Entry`**（项目在 `../references/Admin.NET/server/Admin.NET.Web.Entry/`；默认 HTTP 端口见该项目的 `Properties/launchSettings.json`，一般为 `http://localhost:5005`）。
2. 开发环境下插件会对表 `ado_orders`、`ado_plans`、`ado_work_orders` 执行 **CodeFirst 建表**（仅 `Development`）。
3. 在 `legacy-demo/frontend` 执行 `npm install` 与 `npm run dev`；Vite 已将 `/api` 代理到 `5005`。

更细的步骤与路由说明见 [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md)。

**重启 Cursor 或新开对话后要接着干活**（工作区为 **`SourceCode\ai-dop-platform`** 时）：

1. **先读总览**：`@docs/PROJECT_HANDOFF.md` — 项目目标、功能清单、进度、目录与下一步顺序。  
2. **再按清单执行**：`@docs/CURRENT_TASKS.md` — 环境、双 SDK、验收勾选、即时待办。

若工作区根是 **`SourceCode` 父目录**，则改为：`@ai-dop-platform/docs/PROJECT_HANDOFF.md` 与 `@ai-dop-platform/docs/CURRENT_TASKS.md`。（推荐仍打开 **`ai-dop-platform`** 为根，路径最简。）

## 重要说明

- Demo 业务接口当前使用 **`[AllowAnonymous]`**，便于接旧前端；**上线前**请改为鉴权或菜单权限控制。
- 请勿向 `../references/Admin.NET` 提交与上游无关的大范围修改；业务迭代放在插件或本仓库单独分支并记录与上游的差异策略。