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

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

## 目录说明

| 路径（相对主库根目录） | 说明 |
|------------------------|------|
| `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 规则、**tools/** 脚本。原 **legacy-demo** 已移除（功能已迁入插件 + `Web/`）。 |

## 环境要求

- **.NET 10 SDK**（`server/global.json` 指定 `10.0.x`；入口 `Admin.NET.Web.Entry` 目标 `net10.0`）。
- **Node.js ≥ 18** + **pnpm**（`Web/package.json` 中 `packageManager: pnpm@10.32.1`）。
- **MySQL**（连接串见 `server/Admin.NET.Application/Configuration/Database.json` 等）。

## 快速开始

1. 启动后端：在 **`server/Admin.NET.Web.Entry/`** 下 `dotnet run`（端口见 `launchSettings.json`，常见为 **5005**）。
2. **Development** 下插件会对 `ado_*` 表做 **CodeFirst**（见 [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md)）。
3. 启动管理端：在 **`Web/`** 下 `pnpm install`（或 `npm install`）、`pnpm dev`；`VITE_API_URL` 指向后端。

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

**另一台电脑克隆后**：在主库根目录执行 `powershell -ExecutionPolicy Bypass -File ".\ai-dop-platform\tools\aidop_init.ps1"`（详见 [docs/NEW_MEMBER_ONBOARDING_ZERO_TO_ONE.md](docs/NEW_MEMBER_ONBOARDING_ZERO_TO_ONE.md)）；并确认 **`server/.../Database.json`** 中的数据库本机可达。

**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`）。

## 重要说明

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