ThinkAdmin/docs/architecture/plugin-boundaries.md

Plugin Boundaries

相关文档

• 插件标准
• 插件优先重构

当前分层

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

表归属

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 内部分层

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。