# Plugin Boundaries

## 相关文档

- [插件标准](./plugin-standard.md)
- [插件优先重构](./plugin-first-refactor.md)

## 当前分层

```mermaid
flowchart TD
    L["ThinkLibrary<br/>核心基础设施 / 门面 / 上下文 / Helper"] --> S["ThinkPlugsSystem<br/>后台壳层 / 认证 / 菜单 / 用户 / system_* / 存储中心 / 开发交付工具"]
    L --> W["ThinkPlugsWorker<br/>queue / process 运行时实现"]

    S --> W
    S --> SF["system_file<br/>存储驱动 / 上传接口"]
    S --> HT["plugin\\system\\helper\\*<br/>发布 / 迁移 / 打包工具"]
    S --> AC["ThinkPlugsAccount"]
    S --> P["ThinkPlugsPayment"]
    S --> WC["ThinkPlugsWechatClient"]
    S --> WS["ThinkPlugsWechatService"]
    S --> WM["ThinkPlugsWemall"]
    S --> U["ThinkPlugsWuma"]

    W --> P
    W --> WC
    W --> U

    AC --> P
    AC --> WM
    P --> WM
    WM --> U
```

## 表归属

```mermaid
flowchart LR
    SYS["ThinkPlugsSystem"] --> SB["system_base"]
    SYS --> SD["system_data"]
    SYS --> SO["system_oplog"]
    SYS --> SA["system_auth"]
    SYS --> SAN["system_auth_node"]
    SYS --> SM["system_menu"]
    SYS --> SU["system_user"]
    SYS --> SF["system_file"]

    WK["ThinkPlugsWorker"] --> SQ["system_queue"]
```

## Library 内部分层

```mermaid
flowchart TD
    SV["service<br/>AppService / NodeService / RuntimeService / QueueService / CacheSession / JwtToken"]
    RT["runtime<br/>SystemContext / NullSystemContext / RequestContext / RequestTokenService"]
    MW["middleware<br/>MultAccess"]
    RO["route<br/>Route / Url"]
    HP["helper<br/>Query / Form / Save / Delete / Validate / Builder"]
    MD["model / extend / contract"]

    MW --> SV
    RO --> SV
    HP --> RT
    HP --> MD
    RT --> SV
    SV --> MD
```

## 关键约束

- `ThinkLibrary` 不直接持有 `system_* / system_file / system_queue` 域真实表实现。
- `ThinkPlugsSystem` 同时承载系统后台壳层、`system_*` 核心数据和存储中心，不再拆分独立 `Admin` / `Storage` 插件。
- `ThinkPlugsWorker` 提供 `ProcessService / QueueService` 的真实实现，`ThinkLibrary` 只保留门面。
- `system_file` 迁移、文件管理和上传链路归 `ThinkPlugsSystem`，业务插件只消费 Storage 门面。
- `FaviconBuilder / ImageSliderVerify / JsonRpcHttpClient / JsonRpcHttpServer` 这类跨组件基础能力保留在 `ThinkLibrary`，业务插件只消费，不重复实现。

## 目录规范

- 每个业务插件只保留 `src / stc / tests` 三层顶级目录。
- `src` 下优先使用标准目录：`controller / lang / model / route / service / view`。
- 只有确实需要命令入口的插件才增加 `command` 目录。
- `src` 根目录只保留 `Service.php`，以及确实需要全局函数时才保留 `common.php`。
- 不再新增 `auth / runtime / system / support / integration / queue / storage / handle` 这类职责模糊目录；相关实现统一收敛到 `service` 或更明确的标准目录。

## 已有自动化守卫

- 代码位置边界：`ArchitectureBoundaryTest`
- 迁移归属边界：`MigrationOwnershipTest`
- Composer 依赖边界：`ComposerDependencyBoundaryTest`

这些测试已经纳入根 `composer test`。