# twomiao/likeadmin architecture

> Architecture diagram of the GitHub repository twomiao/likeadmin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/twomiao/likeadmin
- Repository: https://github.com/twomiao/likeadmin

## Overview

Likeadmin is a Vue/TypeScript administration frontend backed by a ThinkPHP/PHP API. The principal workflow is an administrator using the SPA to manage system data; the frontend communicates with the backend, whose controllers validate requests and delegate domain operations. The README documents installation, login, permissions, workbench, organization, materials, settings, and code generation. Source excerpts and the index confirm several controller-to-logic and shared-layer relationships; other feature internals are represented at their exact directory paths because they were not sampled.

Main entry points: [`server/app/adminapi/logic/FileLogic.php`](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/FileLogic.php) (File operations), [`server/app/adminapi/lists/BaseAdminDataLists.php`](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/lists/BaseAdminDataLists.php) (Admin list base), [`admin/src/views`](https://github.com/twomiao/likeadmin/tree/master/admin/src/views) (Admin views), [`server/app/adminapi/logic/setting/StorageLogic.php`](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/setting/StorageLogic.php) (Storage settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Admin frontend"]
  node_spa["Admin SPA<br/>[App.vue]"]
  node_views["Admin views"]
  node_api["API client"]
  node_generatorui["Code tools UI"]
  node_materialui["Material library UI"]
  node_permissionui["Permissions UI"]
  node_organizationui["Organization UI"]
  node_settingsui["Settings UI"]
end

subgraph group_backend["Backend API"]
  node_controllers["Admin controllers"]
  node_baseadmin["Admin base controller"]
  node_filecontroller["File controller<br/>[FileController.php]"]
  node_storagecontroller["Storage controller"]
  node_generatorcontroller["Generator controller"]
  node_replycontroller["Reply controller"]
end

subgraph group_features["Product features"]
  node_filelogic["File operations<br/>[FileLogic.php]"]
  node_storage["Storage settings<br/>[StorageLogic.php]"]
  node_generator["Code generator<br/>[GeneratorLogic.php]"]
  node_officialreply["Official account replies"]
  node_featureareas["Management features"]
end

subgraph group_shared["Shared services"]
  node_config["Configuration service<br/>[ConfigService.php]"]
  node_lists["List framework<br/>[BaseDataLists.php]"]
  node_adminlists["Admin list base"]
  node_baselogic["Logic base<br/>[BaseLogic.php]"]
  node_filemodels[("File records")]
  node_categorymodel[("Article category record")]
  node_menumodel[("Navigation menu record<br/>[Menu.php]")]
  node_crontabmodel[("Scheduled task record<br/>[Crontab.php]")]
end

node_admin(("Administrator"))

node_admin -->|"uses"| node_spa
node_spa -->|"renders"| node_views
node_views -.->|"requests data"| node_api
node_api -.->|"calls API"| node_controllers
node_controllers -->|"extends"| node_baseadmin
node_filecontroller -->|"delegates"| node_filelogic
node_storagecontroller -->|"delegates"| node_storage
node_generatorcontroller -->|"delegates"| node_generator
node_replycontroller -->|"delegates"| node_officialreply
node_filelogic -->|"uses records"| node_filemodels
node_filelogic -->|"reads config"| node_config
node_storage -->|"reads/writes"| node_config
node_storage -->|"extends"| node_baselogic
node_filelogic -->|"extends"| node_baselogic
node_adminlists -->|"extends"| node_lists
node_views -.->|"manages"| node_featureareas
node_generatorui -.->|"uses generator"| node_generatorcontroller
node_materialui -.->|"manages files"| node_filecontroller
node_settingsui -.->|"configures storage"| node_storagecontroller
node_permissionui -.->|"manages access"| node_featureareas
node_organizationui -.->|"manages staff"| node_featureareas
node_filelogic -.->|"uses file lists"| node_adminlists
node_categorymodel -->|"listed by"| node_adminlists
node_menumodel -->|"listed by"| node_adminlists
node_crontabmodel -->|"listed by"| node_adminlists

click node_spa "https://github.com/twomiao/likeadmin/blob/master/admin/src/App.vue"
click node_views "https://github.com/twomiao/likeadmin/tree/master/admin/src/views"
click node_api "https://github.com/twomiao/likeadmin/tree/master/admin/src/utils/request"
click node_controllers "https://github.com/twomiao/likeadmin/tree/master/server/app/adminapi/controller"
click node_baseadmin "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/BaseAdminController.php"
click node_filecontroller "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/FileController.php"
click node_storagecontroller "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/setting/StorageController.php"
click node_generatorcontroller "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/tools/GeneratorController.php"
click node_replycontroller "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/channel/OfficialAccountReplyController.php"
click node_filelogic "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/FileLogic.php"
click node_storage "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/setting/StorageLogic.php"
click node_generator "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/tools/GeneratorLogic.php"
click node_officialreply "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/channel/OfficialAccountReplyLogic.php"
click node_featureareas "https://github.com/twomiao/likeadmin/tree/master/server/app/adminapi/controller"
click node_config "https://github.com/twomiao/likeadmin/blob/master/server/app/common/service/ConfigService.php"
click node_lists "https://github.com/twomiao/likeadmin/blob/master/server/app/common/lists/BaseDataLists.php"
click node_adminlists "https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/lists/BaseAdminDataLists.php"
click node_baselogic "https://github.com/twomiao/likeadmin/blob/master/server/app/common/logic/BaseLogic.php"
click node_filemodels "https://github.com/twomiao/likeadmin/tree/master/server/app/common/model/file"
click node_categorymodel "https://github.com/twomiao/likeadmin/blob/master/server/app/common/model/article/ArticleCategory.php"
click node_menumodel "https://github.com/twomiao/likeadmin/blob/master/server/app/common/model/decorate/Menu.php"
click node_crontabmodel "https://github.com/twomiao/likeadmin/blob/master/server/app/common/model/Crontab.php"
click node_generatorui "https://github.com/twomiao/likeadmin/tree/master/admin/src/views/dev_tools"
click node_materialui "https://github.com/twomiao/likeadmin/tree/master/admin/src/views/material"
click node_permissionui "https://github.com/twomiao/likeadmin/tree/master/admin/src/views/permission"
click node_organizationui "https://github.com/twomiao/likeadmin/tree/master/admin/src/views/organization"
click node_settingsui "https://github.com/twomiao/likeadmin/tree/master/admin/src/views/setting"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_spa,node_views,node_api,node_generatorui,node_materialui,node_permissionui,node_organizationui,node_settingsui toneBlue
class node_controllers,node_baseadmin,node_filecontroller,node_storagecontroller,node_generatorcontroller,node_replycontroller toneAmber
class node_filelogic,node_storage,node_generator,node_officialreply,node_featureareas toneMint
class node_config,node_lists,node_adminlists,node_baselogic,node_filemodels,node_categorymodel,node_menumodel,node_crontabmodel toneRose
class node_admin toneIndigo
```

## Components

### Admin frontend

- [Admin SPA](https://github.com/twomiao/likeadmin/blob/master/admin/src/App.vue): `admin/src/App.vue`
- [Admin views](https://github.com/twomiao/likeadmin/tree/master/admin/src/views): `admin/src/views`
- [API client](https://github.com/twomiao/likeadmin/tree/master/admin/src/utils/request): `admin/src/utils/request`
- [Code tools UI](https://github.com/twomiao/likeadmin/tree/master/admin/src/views/dev_tools): `admin/src/views/dev_tools`
- [Material library UI](https://github.com/twomiao/likeadmin/tree/master/admin/src/views/material): `admin/src/views/material`
- [Permissions UI](https://github.com/twomiao/likeadmin/tree/master/admin/src/views/permission): `admin/src/views/permission`
- [Organization UI](https://github.com/twomiao/likeadmin/tree/master/admin/src/views/organization): `admin/src/views/organization`
- [Settings UI](https://github.com/twomiao/likeadmin/tree/master/admin/src/views/setting): `admin/src/views/setting`

### Backend API

- [Admin controllers](https://github.com/twomiao/likeadmin/tree/master/server/app/adminapi/controller): `server/app/adminapi/controller`
- [Admin base controller](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/BaseAdminController.php): `server/app/adminapi/controller/BaseAdminController.php`
- [File controller](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/FileController.php): `server/app/adminapi/controller/FileController.php`
- [Storage controller](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/setting/StorageController.php): `server/app/adminapi/controller/setting/StorageController.php`
- [Generator controller](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/tools/GeneratorController.php): `server/app/adminapi/controller/tools/GeneratorController.php`
- [Reply controller](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/controller/channel/OfficialAccountReplyController.php): `server/app/adminapi/controller/channel/OfficialAccountReplyController.php`

### Product features

- [File operations](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/FileLogic.php): `server/app/adminapi/logic/FileLogic.php`
- [Storage settings](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/setting/StorageLogic.php): `server/app/adminapi/logic/setting/StorageLogic.php`
- [Code generator](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/tools/GeneratorLogic.php): `server/app/adminapi/logic/tools/GeneratorLogic.php`
- [Official account replies](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/logic/channel/OfficialAccountReplyLogic.php): `server/app/adminapi/logic/channel/OfficialAccountReplyLogic.php`
- [Management features](https://github.com/twomiao/likeadmin/tree/master/server/app/adminapi/controller): `server/app/adminapi/controller`

### Shared services

- [Configuration service](https://github.com/twomiao/likeadmin/blob/master/server/app/common/service/ConfigService.php): `server/app/common/service/ConfigService.php`
- [List framework](https://github.com/twomiao/likeadmin/blob/master/server/app/common/lists/BaseDataLists.php): `server/app/common/lists/BaseDataLists.php`
- [Admin list base](https://github.com/twomiao/likeadmin/blob/master/server/app/adminapi/lists/BaseAdminDataLists.php): `server/app/adminapi/lists/BaseAdminDataLists.php`
- [Logic base](https://github.com/twomiao/likeadmin/blob/master/server/app/common/logic/BaseLogic.php): `server/app/common/logic/BaseLogic.php`
- [File records](https://github.com/twomiao/likeadmin/tree/master/server/app/common/model/file): `server/app/common/model/file`
- [Article category record](https://github.com/twomiao/likeadmin/blob/master/server/app/common/model/article/ArticleCategory.php): `server/app/common/model/article/ArticleCategory.php`
- [Navigation menu record](https://github.com/twomiao/likeadmin/blob/master/server/app/common/model/decorate/Menu.php): `server/app/common/model/decorate/Menu.php`
- [Scheduled task record](https://github.com/twomiao/likeadmin/blob/master/server/app/common/model/Crontab.php): `server/app/common/model/Crontab.php`

### Other components

- **Administrator**

## Connections

- Administrator → Admin SPA: uses (evidence: `README.md`)
- Admin SPA → Admin views: renders (evidence: `admin/src/App.vue`)
- Admin views → API client: requests data
- API client → Admin controllers: calls API (evidence: `README.md`)
- Admin controllers → Admin base controller: extends (evidence: `server/app/adminapi/controller/BaseAdminController.php`)
- File controller → File operations: delegates (evidence: `server/app/adminapi/controller/FileController.php`)
- Storage controller → Storage settings: delegates (evidence: `server/app/adminapi/controller/setting/StorageController.php`)
- Generator controller → Code generator: delegates (evidence: `server/app/adminapi/controller/tools/GeneratorController.php`)
- Reply controller → Official account replies: delegates (evidence: `server/app/adminapi/controller/channel/OfficialAccountReplyController.php`)
- File operations → File records: uses records (evidence: `server/app/adminapi/logic/FileLogic.php`)
- File operations → Configuration service: reads config (evidence: `server/app/adminapi/logic/FileLogic.php`)
- Storage settings → Configuration service: reads/writes (evidence: `server/app/adminapi/logic/setting/StorageLogic.php`)
- Storage settings → Logic base: extends (evidence: `server/app/adminapi/logic/setting/StorageLogic.php`)
- File operations → Logic base: extends (evidence: `server/app/adminapi/logic/FileLogic.php`)
- Admin list base → List framework: extends
- Admin views → Management features: manages (evidence: `README.md`)
- Code tools UI → Generator controller: uses generator (evidence: `README.md`)
- Material library UI → File controller: manages files (evidence: `README.md`)
- Settings UI → Storage controller: configures storage
- Permissions UI → Management features: manages access (evidence: `README.md`)
- Organization UI → Management features: manages staff (evidence: `README.md`)
- File operations → Admin list base: uses file lists
- Article category record → Admin list base: listed by (evidence: `server/app/adminapi/lists/article/ArticleCategoryLists.php`)
- Navigation menu record → Admin list base: listed by (evidence: `server/app/adminapi/lists/decorate/MenuLists.php`)
- Scheduled task record → Admin list base: listed by (evidence: `server/app/adminapi/lists/crontab/CrontabLists.php`)
