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（主库根下则 @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/ 同库：文档与规则、legacy-demo、工具脚本与 .NET 后端 + 官方 Web + 插件 一并拉取与提交。

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

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

前端：Vue 3 + Element Plus（当前主要在 legacy-demo/frontend）；后续可选迁入 Admin.NET 自带 Web 或保持独立 SPA。

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 旧 Demo 前端里的大量页面（产品/演示）

legacy-demo/frontend 含 首页模块、S0–S7 等视图、登录、订单/计划/工单列表页 等；其中不少为 看板/演示，与真实后端对接程度不一（部分仍为 TODO 或本地数据）。产品优先级需产品/业务再定，开发时以「插件 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 规则、legacy-demo、tools
    ├── .cursor/rules/
    ├── docs/
    └── legacy-demo/

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

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

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

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

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

建议顺序（与 CURRENT_TASKS.md 勾选一致）：

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

7. 风险与约定

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

8. 相关文档索引

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

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

PROJECT_HANDOFF.md 7.4 KB History Raw