AiDOPWarehouse/ai-dop-platform/docs/ARCHITECTURE.md

架构说明（基线版）

系统定调

• 主系统：Ai-DOP 在 Admin.NET 上全新建设与演进——运行入口为 Admin.NET.Web.Entry，领域与 API 在 Admin.NET.Plugin.*（当前为 AiDOP） 中扩展，管理端与业务 UI 以主库内官方 Web/ 工程为载体（与后端双进程联调，见 docs/GETTING_STARTED.md）。
• 旧版独立 Demo（原 legacy-demo，Vue + 独立 EF 后端）已从本仓库移除；兼容契约由 Admin.NET.Plugin.AiDOP 的 MVC 路由与 Web/ 页面承接。若需对照历史实现，请查 Git 历史或团队归档。

总览

flowchart LR
  subgraph client [浏览器]
    AdminWeb[官方 Web + Ai-DOP 页]
  end
  subgraph backend [Admin.NET]
    Web[Web.Entry]
    Core[Web.Core / Furion]
    Plugin[Plugin.AiDOP]
    Sugar[SqlSugar + MySQL]
  end
  AdminWeb -->|VITE_API_URL| Web
  Web --> Core
  Core --> Plugin
  Plugin --> Sugar

• 呈现层：主路径为 Web/（权限、菜单、租户、审批及 Ai-DOP 业务页）。
• 应用层：Admin.NET 提供认证、多租户、系统管理；AiDOP 领域 在 Admin.NET.Plugin.AiDOP 中扩展。
• 数据层：业务表使用 SqlSugar 映射，表名与旧系统对齐（ado_*），便于数据迁移与对照。

插件职责

组件	职责
Entity/	AdoOrder、AdoPlan、AdoWorkOrder 与表一一对应。
Controllers/	兼容旧 Demo 的 MVC 路由 + [NonUnify] 响应。
Dto/	请求/响应模型，与历史 Demo DTO 对齐。
Startup.cs	开发环境 CodeFirst；可按需注册更多服务。

与旧系统的关系

• 历史 Gitee Demo：原独立前后端已从仓库删除；HTTP 形状与业务落点以 插件 + Web/ 为准。
• 旧 SQL Server / 存储过程：新平台默认 MySQL、逻辑在应用层；分阶段把原存储过程行为迁到服务与配置（不在本基线文档展开）。

安全基线（后续硬化）

• 当前部分 Demo 接口使用 [AllowAnonymous] 以降低联调成本。
• 上线前应改为与 Admin.NET 一致的 JWT + 权限标识，或仅对内网开放，并由 API 网关做认证。

上游 Admin.NET

Ai-DOP 主库（本机常为 D:\Projects\Ai-DOP\SourceCode\references\Admin.NET）在 同一克隆 内包含 server/、Web/、ai-dop-platform/。与 Gitee 官方 zuohuaijun/Admin.NET 同步时：

1. 在独立分支合并或 rebase 官方稳定分支。
2. 再编译并跑冒烟测试（登录、菜单、插件 API）。
3. 记录与本项目相关的破坏性变更（Furion / SqlSugar / 启动配置）。