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

本目录位于 **Ai-DOP 主库**（Gitee `sky-guo/ai-dop`）内，与 **`server/`**（.NET 后端）、**`Web/`**（官方 Vue 管理端）**同一 Git 仓库**，无需再与 `references` 外的副本对齐。

## 目录说明

| 路径（相对主库根目录） | 说明 |
|------------------------|------|
| `server/` | .NET 解决方案（`Admin.NET.sln`）；**`server/Plugins/Admin.NET.Plugin.AiDOP/`** 为 AiDOP 业务插件（`api/Order`、`api/Plan`、`api/WorkOrder` 等）。 |
| `Web/` | 官方管理端前端；`prepare` 会安装 **pre-push** hook。 |
| `ai-dop-platform/`（本目录） | 团队文档、Cursor 规则、**legacy-demo**、**tools/** 脚本。 |

## 环境要求

- **.NET 8 SDK**（与 `TargetFrameworks` 一致；若使用 net10 需对应 SDK）。
- **Node.js**（`Web/` 与 `legacy-demo/frontend`）。
- **MySQL**（连接串见 `server/Admin.NET.Application/Configuration/Database.json` 等）。

## 快速开始

1. 启动后端：在 **`server/Admin.NET.Web.Entry/`** 下 `dotnet run --framework net8.0`（端口见 `launchSettings.json`，常见为 **5005**）。
2. **Development** 下插件会对 `ado_*` 表做 **CodeFirst**（见 [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md)）。
3. 旧 Demo：`legacy-demo/frontend` 执行 `npm install` 与 `npm run dev`（`/api` 代理到 5005）。

更细步骤见 [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md)。

**Cursor 续作**（工作区为 **`ai-dop-platform/`** 时）：先 `@docs/PROJECT_HANDOFF.md`，再 `@docs/CURRENT_TASKS.md`。若工作区为主库根目录，路径为 `@ai-dop-platform/docs/...`。

本机若仍使用 **`SourceCode/ai-dop-platform`**，建议改为指向 **`…/references/Admin.NET/ai-dop-platform`** 的 **目录联接（junction）**，与主库内本目录为同一内容（见上层 `SourceCode/README.md`）。

## 重要说明

- Demo 接口上的 **`[AllowAnonymous]`** 仅便于联调；**上线前**请改为鉴权或菜单权限。
- 与上游 Admin.NET 的大范围差异请用分支管理并写清合并策略；业务迭代优先落在插件与 `Web/` 扩展。