# 架构说明（基线版）

## 系统定调

- **主系统**：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 历史**或团队归档。

## 总览

```mermaid
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 / 启动配置）。