# xuey490/fssadmin architecture

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

- Interactive diagram: https://gitdiagram.com/xuey490/fssadmin
- Repository: https://github.com/xuey490/fssadmin

## Overview

FSSADMIN is a Vue administration frontend backed by a PHP framework and business application, with optional plugins and three documented server runtimes. The principal flow is an administrator’s HTTP request through the runtime and framework routing/middleware into a controller and domain service, then back as JSON for the frontend. The README documents capabilities beyond sampled code; those branches are included at subsystem level. Several feature implementations and frontend API call sites were not sampled, so their internal edges are omitted.

Main entry points: [`server/framework/Core/Framework.php`](https://github.com/xuey490/fssadmin/blob/main/server/framework/Core/Framework.php) (Request framework), [`web/src/App.vue`](https://github.com/xuey490/fssadmin/blob/main/web/src/App.vue) (Admin interface), [`server/app/Controllers/SystemController.php`](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/SystemController.php) (System management), [`server/app/Controllers/AuthController.php`](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/AuthController.php) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime framework"]
  node_server_modes["Server modes<br/>[server.php]"]
  node_framework["Request framework<br/>[Framework.php]"]
  node_routing["Attribute routing"]
  node_middleware["Middleware and security"]
  node_container["Service container<br/>[Container.php]"]
  node_controller_base["Controller base<br/>[BaseController.php]"]
  node_json_response["JSON responses"]
  node_tenant_context["Tenant context<br/>[TenantContext.php]"]
end

subgraph group_business["Admin business"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_user_permissions["Users and permissions<br/>[SysUser.php]"]
  node_admin_management["System management"]
  node_content["Article management"]
  node_scheduled_tasks["Scheduled tasks"]
  node_developer_tools["Generation and database tools"]
  node_monitoring["Server and Redis monitoring"]
  node_logs["Login and operation logs"]
end

subgraph group_frontend["Web admin"]
  node_web_app["Admin interface<br/>[App.vue]"]
  node_web_routes["Frontend routes<br/>[asyncRoutes.ts]"]
  node_web_auth["Frontend authentication<br/>[useAuth.ts]"]
  node_web_api["API modules"]
  node_web_state["Frontend state"]
end

subgraph group_extensions["Extensions"]
  node_plugins["Plugin lifecycle<br/>[PluginManager.php]"]
  node_plugin_api["Plugin management API"]
  node_blog_plugin["Blog plugin<br/>[PostController.php]"]
end

node_admin(("Administrator"))
node_http(("HTTP client"))

node_admin -->|"uses"| node_web_app
node_web_app -.->|"navigates"| node_web_routes
node_web_app -.->|"authenticates"| node_web_auth
node_web_app -.->|"stores state"| node_web_state
node_web_app -.->|"requests data"| node_web_api
node_web_api -.->|"sends requests"| node_http
node_http -->|"sends request"| node_server_modes
node_server_modes -->|"dispatches"| node_framework
node_framework -->|"matches routes"| node_routing
node_framework -->|"dispatches through"| node_middleware
node_framework -->|"resolves services"| node_container
node_framework -->|"invokes controller"| node_controller_base
node_controller_base -->|"creates response"| node_json_response
node_auth -->|"reads user"| node_user_permissions
node_auth -->|"uses tenant context"| node_tenant_context
node_admin_management -->|"uses user model"| node_user_permissions
node_admin_management -.->|"offers monitoring"| node_monitoring
node_http -.->|"requests content"| node_content
node_http -.->|"manages tasks"| node_scheduled_tasks
node_http -.->|"uses tools"| node_developer_tools
node_admin_management -->|"uses log services"| node_logs
node_plugin_api -->|"manages plugins"| node_plugins
node_plugins -.->|"loads extension"| node_blog_plugin

click node_server_modes "https://github.com/xuey490/fssadmin/blob/main/server/server.php"
click node_framework "https://github.com/xuey490/fssadmin/blob/main/server/framework/Core/Framework.php"
click node_routing "https://github.com/xuey490/fssadmin/blob/main/server/framework/Core/AttributeRouteLoader.php"
click node_middleware "https://github.com/xuey490/fssadmin/blob/main/server/framework/Middleware/MiddlewareDispatcher.php"
click node_container "https://github.com/xuey490/fssadmin/blob/main/server/framework/Container/Container.php"
click node_controller_base "https://github.com/xuey490/fssadmin/blob/main/server/framework/Basic/BaseController.php"
click node_json_response "https://github.com/xuey490/fssadmin/blob/main/server/framework/Basic/BaseJsonResponse.php"
click node_tenant_context "https://github.com/xuey490/fssadmin/blob/main/server/framework/Tenant/TenantContext.php"
click node_auth "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/AuthController.php"
click node_user_permissions "https://github.com/xuey490/fssadmin/blob/main/server/app/Models/SysUser.php"
click node_admin_management "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/SystemController.php"
click node_content "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/ArticleController.php"
click node_scheduled_tasks "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/CrontabController.php"
click node_developer_tools "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/GenerateController.php"
click node_monitoring "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/System/RedisController.php"
click node_logs "https://github.com/xuey490/fssadmin/blob/main/server/app/Services/LoginLogService.php"
click node_web_app "https://github.com/xuey490/fssadmin/blob/main/web/src/App.vue"
click node_web_routes "https://github.com/xuey490/fssadmin/blob/main/web/src/router/routes/asyncRoutes.ts"
click node_web_auth "https://github.com/xuey490/fssadmin/blob/main/web/src/hooks/core/useAuth.ts"
click node_web_api "https://github.com/xuey490/fssadmin/tree/main/web/src/api"
click node_web_state "https://github.com/xuey490/fssadmin/tree/main/web/src/store"
click node_plugins "https://github.com/xuey490/fssadmin/blob/main/server/framework/Plugin/PluginManager.php"
click node_plugin_api "https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/System/PluginController.php"
click node_blog_plugin "https://github.com/xuey490/fssadmin/blob/main/server/plugins/blog/Controllers/PostController.php"

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_server_modes,node_framework,node_routing,node_middleware,node_container,node_controller_base,node_json_response,node_tenant_context,node_http toneBlue
class node_auth,node_user_permissions,node_admin_management,node_content,node_scheduled_tasks,node_developer_tools,node_monitoring,node_logs toneAmber
class node_web_app,node_web_routes,node_web_auth,node_web_api,node_web_state toneMint
class node_plugins,node_plugin_api,node_blog_plugin toneRose
class node_admin toneIndigo
```

## Components

### Runtime framework

- [Server modes](https://github.com/xuey490/fssadmin/blob/main/server/server.php): `server/server.php`
- [Request framework](https://github.com/xuey490/fssadmin/blob/main/server/framework/Core/Framework.php): `server/framework/Core/Framework.php`
- [Attribute routing](https://github.com/xuey490/fssadmin/blob/main/server/framework/Core/AttributeRouteLoader.php): `server/framework/Core/AttributeRouteLoader.php`
- [Middleware and security](https://github.com/xuey490/fssadmin/blob/main/server/framework/Middleware/MiddlewareDispatcher.php): `server/framework/Middleware/MiddlewareDispatcher.php`
- [Service container](https://github.com/xuey490/fssadmin/blob/main/server/framework/Container/Container.php): `server/framework/Container/Container.php`
- [Controller base](https://github.com/xuey490/fssadmin/blob/main/server/framework/Basic/BaseController.php): `server/framework/Basic/BaseController.php`
- [JSON responses](https://github.com/xuey490/fssadmin/blob/main/server/framework/Basic/BaseJsonResponse.php): `server/framework/Basic/BaseJsonResponse.php`
- [Tenant context](https://github.com/xuey490/fssadmin/blob/main/server/framework/Tenant/TenantContext.php): `server/framework/Tenant/TenantContext.php`

### Admin business

- [Authentication](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/AuthController.php): `server/app/Controllers/AuthController.php`
- [Users and permissions](https://github.com/xuey490/fssadmin/blob/main/server/app/Models/SysUser.php): `server/app/Models/SysUser.php`
- [System management](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/SystemController.php): `server/app/Controllers/SystemController.php`
- [Article management](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/ArticleController.php): `server/app/Controllers/ArticleController.php`
- [Scheduled tasks](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/CrontabController.php): `server/app/Controllers/CrontabController.php`
- [Generation and database tools](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/GenerateController.php): `server/app/Controllers/GenerateController.php`
- [Server and Redis monitoring](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/System/RedisController.php): `server/app/Controllers/System/RedisController.php`
- [Login and operation logs](https://github.com/xuey490/fssadmin/blob/main/server/app/Services/LoginLogService.php): `server/app/Services/LoginLogService.php`

### Web admin

- [Admin interface](https://github.com/xuey490/fssadmin/blob/main/web/src/App.vue): `web/src/App.vue`
- [Frontend routes](https://github.com/xuey490/fssadmin/blob/main/web/src/router/routes/asyncRoutes.ts): `web/src/router/routes/asyncRoutes.ts`
- [Frontend authentication](https://github.com/xuey490/fssadmin/blob/main/web/src/hooks/core/useAuth.ts): `web/src/hooks/core/useAuth.ts`
- [API modules](https://github.com/xuey490/fssadmin/tree/main/web/src/api): `web/src/api`
- [Frontend state](https://github.com/xuey490/fssadmin/tree/main/web/src/store): `web/src/store`

### Extensions

- [Plugin lifecycle](https://github.com/xuey490/fssadmin/blob/main/server/framework/Plugin/PluginManager.php): `server/framework/Plugin/PluginManager.php`
- [Plugin management API](https://github.com/xuey490/fssadmin/blob/main/server/app/Controllers/System/PluginController.php): `server/app/Controllers/System/PluginController.php`
- [Blog plugin](https://github.com/xuey490/fssadmin/blob/main/server/plugins/blog/Controllers/PostController.php): `server/plugins/blog/Controllers/PostController.php`

### Other components

- **Administrator**
- **HTTP client**

## Connections

- Administrator → Admin interface: uses
- Admin interface → Frontend routes: navigates
- Admin interface → Frontend authentication: authenticates
- Admin interface → Frontend state: stores state
- Admin interface → API modules: requests data
- API modules → HTTP client: sends requests
- HTTP client → Server modes: sends request
- Server modes → Request framework: dispatches (evidence: `server/server.php`)
- Request framework → Attribute routing: matches routes (evidence: `server/framework/Core/Framework.php`)
- Request framework → Middleware and security: dispatches through (evidence: `server/framework/Core/Framework.php`)
- Request framework → Service container: resolves services (evidence: `server/framework/Core/Framework.php`)
- Request framework → Controller base: invokes controller (evidence: `server/framework/Core/Framework.php`)
- Controller base → JSON responses: creates response (evidence: `server/framework/Basic/BaseController.php`)
- Authentication → Users and permissions: reads user (evidence: `server/app/Controllers/AuthController.php`)
- Authentication → Tenant context: uses tenant context (evidence: `server/app/Controllers/AuthController.php`)
- System management → Users and permissions: uses user model (evidence: `server/app/Controllers/SystemController.php`)
- System management → Server and Redis monitoring: offers monitoring
- HTTP client → Article management: requests content
- HTTP client → Scheduled tasks: manages tasks
- HTTP client → Generation and database tools: uses tools
- System management → Login and operation logs: uses log services (evidence: `server/app/Controllers/SystemController.php`)
- Plugin management API → Plugin lifecycle: manages plugins (evidence: `server/app/Controllers/System/PluginController.php`)
- Plugin lifecycle → Blog plugin: loads extension
