# 1024-lab/smart-admin architecture

> Architecture diagram of the GitHub repository 1024-lab/smart-admin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1024-lab/smart-admin
- Repository: https://github.com/1024-lab/smart-admin

## Overview

SmartAdmin is a multi-version administration platform: Vue web clients and a Uni-App mobile client use Spring Boot APIs for login, system administration, business/OA workflows, and support features. The principal workflow is an administrator signing in, managing system or business data, and receiving API results through the client. README documents security, data-scope, logging, code generation, and OA capabilities; sampled source gives detail on login, employee management, and code-generation variables. Several subsystem links below are documented capabilities rather than verified call chains.

Main entry points: [`smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/AdminApplication.java`](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/AdminApplication.java) (Spring API), [`smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java`](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java) (Login service), [`smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/employee/service/EmployeeService.java`](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/employee/service/EmployeeService.java) (Employee management), [`smart-admin-web-javascript/src/main.js`](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-web-javascript/src/main.js) (JavaScript web)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web_js["JavaScript web<br/>[main.js]"]
  node_web_ts["TypeScript web<br/>[main.ts]"]
  node_mobile["Mobile app<br/>[main.js]"]
end

subgraph group_identity["Identity and access"]
  node_api_app["Spring API"]
  node_login["Login service<br/>[LoginService.java]"]
  node_request_guard["Request guard"]
end

subgraph group_admin["Administration and OA"]
  node_employees["Employee management"]
  node_departments["Departments"]
  node_menus_roles["Menus and roles<br/>[MenuService.java]"]
  node_data_scope["Data scope"]
  node_categories_goods["Catalog and goods"]
  node_oa["OA workflows"]
end

subgraph group_platform["Platform services"]
  node_database[("Relational database")]
  node_codegen["Code generator"]
  node_code_vars["Code variables"]
  node_audit["Audit and logs"]
  node_files["File storage"]
  node_redis["Redis support<br/>[RedisService.java]"]
  node_mail["Mail support<br/>[MailService.java]"]
  node_response["API response<br/>[ResponseDTO.java]"]
end

node_admin_user(("Administrator"))

node_admin_user -->|"uses"| node_web_js
node_admin_user -->|"uses"| node_web_ts
node_admin_user -->|"uses"| node_mobile
node_web_js -.->|"requests"| node_api_app
node_web_ts -.->|"requests"| node_api_app
node_mobile -.->|"requests"| node_api_app
node_api_app -.->|"hosts"| node_login
node_login -->|"looks up account"| node_employees
node_login -->|"stores code"| node_redis
node_login -->|"sends code"| node_mail
node_api_app -.->|"configures"| node_request_guard
node_employees -.->|"persists records"| node_database
node_departments -.->|"persists records"| node_database
node_menus_roles -.->|"persists permissions"| node_database
node_data_scope -.->|"filters access"| node_database
node_categories_goods -.->|"persists catalog"| node_database
node_oa -.->|"persists OA data"| node_database
node_employees -->|"reads department"| node_departments
node_codegen -.->|"builds variables"| node_code_vars
node_code_vars -.->|"emits code"| node_codegen
node_api_app -.->|"records changes"| node_audit
node_api_app -.->|"stores uploads"| node_files
node_api_app -.->|"returns result"| node_response

click node_web_js "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-web-javascript/src/main.js"
click node_web_ts "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-web-typescript/src/main.ts"
click node_mobile "https://github.com/1024-lab/smart-admin/blob/master/smart-app/src/main.js"
click node_api_app "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/AdminApplication.java"
click node_login "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java"
click node_request_guard "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/interceptor/AdminInterceptor.java"
click node_employees "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/employee/service/EmployeeService.java"
click node_departments "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/department/service/DepartmentService.java"
click node_menus_roles "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/menu/service/MenuService.java"
click node_data_scope "https://github.com/1024-lab/smart-admin/tree/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/datascope"
click node_categories_goods "https://github.com/1024-lab/smart-admin/tree/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/business"
click node_oa "https://github.com/1024-lab/smart-admin/tree/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/business/oa"
click node_codegen "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/codegenerator/service/CodeGeneratorTemplateService.java"
click node_code_vars "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/codegenerator/service/variable/backend/ControllerVariableService.java"
click node_audit "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/datatracer/service/DataTracerChangeContentService.java"
click node_files "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/file/service/FileStorageCloudServiceImpl.java"
click node_redis "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/redis/RedisService.java"
click node_mail "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/mail/MailService.java"
click node_response "https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-base/src/main/java/net/lab1024/sa/base/common/domain/ResponseDTO.java"

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_web_js,node_web_ts,node_mobile toneBlue
class node_api_app,node_login,node_request_guard toneAmber
class node_employees,node_departments,node_menus_roles,node_data_scope,node_categories_goods,node_oa toneMint
class node_database,node_codegen,node_code_vars,node_audit,node_files,node_redis,node_mail,node_response toneRose
class node_admin_user toneIndigo
```

## Components

### User clients

- [JavaScript web](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-web-javascript/src/main.js): `smart-admin-web-javascript/src/main.js`
- [TypeScript web](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-web-typescript/src/main.ts): `smart-admin-web-typescript/src/main.ts`
- [Mobile app](https://github.com/1024-lab/smart-admin/blob/master/smart-app/src/main.js): `smart-app/src/main.js`

### Identity and access

- [Spring API](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/AdminApplication.java): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/AdminApplication.java`
- [Login service](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java): `smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java`
- [Request guard](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/interceptor/AdminInterceptor.java): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/interceptor/AdminInterceptor.java`

### Administration and OA

- [Employee management](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/employee/service/EmployeeService.java): `smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/employee/service/EmployeeService.java`
- [Departments](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/department/service/DepartmentService.java): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/department/service/DepartmentService.java`
- [Menus and roles](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/menu/service/MenuService.java): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/menu/service/MenuService.java`
- [Data scope](https://github.com/1024-lab/smart-admin/tree/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/datascope): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/datascope`
- [Catalog and goods](https://github.com/1024-lab/smart-admin/tree/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/business): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/business`
- [OA workflows](https://github.com/1024-lab/smart-admin/tree/master/smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/business/oa): `smart-admin-api-java17-springboot3/sa-admin/src/main/java/net/lab1024/sa/admin/module/business/oa`

### Platform services

- **Relational database**
- [Code generator](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/codegenerator/service/CodeGeneratorTemplateService.java): `smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/codegenerator/service/CodeGeneratorTemplateService.java`
- [Code variables](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/codegenerator/service/variable/backend/ControllerVariableService.java): `smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/codegenerator/service/variable/backend/ControllerVariableService.java`
- [Audit and logs](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/datatracer/service/DataTracerChangeContentService.java): `smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/datatracer/service/DataTracerChangeContentService.java`
- [File storage](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/file/service/FileStorageCloudServiceImpl.java): `smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/file/service/FileStorageCloudServiceImpl.java`
- [Redis support](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/redis/RedisService.java): `smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/redis/RedisService.java`
- [Mail support](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/mail/MailService.java): `smart-admin-api-java17-springboot3/sa-base/src/main/java/net/lab1024/sa/base/module/support/mail/MailService.java`
- [API response](https://github.com/1024-lab/smart-admin/blob/master/smart-admin-api-java8-springboot2/sa-base/src/main/java/net/lab1024/sa/base/common/domain/ResponseDTO.java): `smart-admin-api-java8-springboot2/sa-base/src/main/java/net/lab1024/sa/base/common/domain/ResponseDTO.java`

### Other components

- **Administrator**

## Connections

- Administrator → JavaScript web: uses
- Administrator → TypeScript web: uses
- Administrator → Mobile app: uses
- JavaScript web → Spring API: requests
- TypeScript web → Spring API: requests
- Mobile app → Spring API: requests
- Spring API → Login service: hosts
- Login service → Employee management: looks up account (evidence: `smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java`)
- Login service → Redis support: stores code (evidence: `smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java`)
- Login service → Mail support: sends code (evidence: `smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/login/service/LoginService.java`)
- Spring API → Request guard: configures
- Employee management → Relational database: persists records
- Departments → Relational database: persists records
- Menus and roles → Relational database: persists permissions
- Data scope → Relational database: filters access
- Catalog and goods → Relational database: persists catalog
- OA workflows → Relational database: persists OA data
- Employee management → Departments: reads department (evidence: `smart-admin-api-java8-springboot2/sa-admin/src/main/java/net/lab1024/sa/admin/module/system/employee/service/EmployeeService.java`)
- Code generator → Code variables: builds variables
- Code variables → Code generator: emits code
- Spring API → Audit and logs: records changes
- Spring API → File storage: stores uploads
- Spring API → API response: returns result
