AiDOPWarehouse/ai-dop-platform

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。

重启 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 提交与上游无关的大范围修改；业务迭代放在插件或本仓库单独分支并记录与上游的差异策略。