Ai-DOP 项目总览（给 Cursor / 新对话快速恢复上下文）

使用方式：重启 Cursor 或新开聊天后，先 @ 本文件。路径取决于工作区根目录：

根目录为 …/ai-dop-platform：@docs/PROJECT_HANDOFF.md
根目录为 …/SourceCode：@ai-dop-platform/docs/PROJECT_HANDOFF.md

更细的验收勾选见 CURRENT_TASKS.md（同样：在 SourceCode 根下则 @ai-dop-platform/docs/CURRENT_TASKS.md）。

1. 项目是什么

名称：Ai-DOP（数字化运营平台），在 Admin.NET 通用权限与多租户能力之上做行业业务。
团队：约 3～4 人，按模块全栈；共享内核（权限、租户、公共组件）需有人把关，避免各自改乱。
工作区：源码统一在 D:\Projects\Ai-DOP\SourceCode。其中 ai-dop-platform 为团队文档、Cursor 规则、旧 Demo 前端 + 对照后端；真实运行主线是同级 references 下的 Admin.NET 源码 + AiDOP 插件。

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\   # ★ 项目源码根目录（本机约定）
├── README.md                    # SourceCode 层说明
├── ai-dop-platform/             # 本仓库：文档、规则、legacy-demo
│   ├── .cursor/rules/           # 团队 Cursor 规则
│   ├── docs/                    # 本 handoff、GETTING_STARTED、ARCHITECTURE、CURRENT_TASKS
│   └── legacy-demo/             # 旧 Gitee Demo（前端 + 原 EF 后端，作对照）
└── references/
    └── Admin.NET/
        └── server/
            ├── Admin.NET.sln
            ├── Plugins/
            │   └── Admin.NET.Plugin.AiDOP/   # ★ AiDOP 业务插件（实体、DTO、兼容 MVC API）
            └── Admin.NET.Web.Entry/           # ★ 启动项目（默认端口常為 5005）

相对路径：从 SourceCode/ai-dop-platform 根到解决方案为 ../references/Admin.NET/server/Admin.NET.sln。

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

拉取/固定 Admin.NET（如 Gitee v2）于 SourceCode/references/Admin.NET。
建立 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 ../references/Admin.NET/server/Admin.NET.sln -c Debug 通过。
配置 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 或后续新插件中扩展。
不要把与上游无关的大改直接混进 references/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.2 KB 文件历史 原始文件