blackteay/ThinkAdmin
1
0
Fork 0
mirror of https://gitee.com/zoujingli/ThinkAdmin.git synced 2026-06-07 04:28:11 +08:00
Code Issues Projects Releases Wiki Activity
ThinkAdmin/docs/architecture/plugin-boundaries.md
Anyon 6f4056f64d docs(architecture): 完善 v8 架构与迁移说明 
补充 v8 重构后的架构文档、组件说明和迁移记录，方便后续维护者理解插件边界。

主要内容：

- 更新根 README，说明 v8 插件分层、系统模块、交付命令和验证流程。

- 新增组件明细、插件边界、路由分发、软删除和稳定性文档。

- 记录 Storage 合并到 System、旧 View 移除和 Helper 并入 System 的决策。

- 补充文档注释报告和后续重构计划，便于持续演进。
2026-05-08 15:31:22 +08:00

3.1 KiB
Raw Blame History

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。