feat(userthemes): 新增用户主题管理功能

新增用户主题完整CRUD模块,含控制器、DO、Mapper、Service及VO定义,并补充错误码。
This commit is contained in:
2025-12-25 15:24:32 +08:00
parent 6c7cc367b5
commit 5c95baf336
5 changed files with 126 additions and 23 deletions

View File

@@ -67,6 +67,7 @@ The project uses a **modular monolith** architecture with the following key modu
- `yolo-spring-boot-starter-biz-*`: Business-specific components (tenant, data permission, IP)
- **yolo-module-system**: System management module (users, roles, permissions, dictionaries)
- **yolo-module-infra**: Infrastructure module (jobs, file storage, code generator, monitoring)
- **keyboard-server**: Business module for keyboard-specific features (custom controllers, services, DAL)
- **yolo-server**: Main application container (empty shell that aggregates modules)
### Layered Architecture
@@ -104,30 +105,17 @@ enums/ # Module-specific enums
- Connection: `jdbc:postgresql://localhost:5432/keyborad_db`
- Default credentials: root/123asd
### Database Scripts
SQL scripts are located in `sql/` directory with support for multiple databases:
- `sql/postgresql/` - PostgreSQL scripts
- `sql/mysql/` - MySQL scripts
- `sql/oracle/`, `sql/sqlserver/`, `sql/dm/`, `sql/kingbase/`, `sql/opengauss/` - Other DB support
### Database Conversion
Use `sql/tools/convertor.py` to convert MySQL scripts to other databases:
```bash
cd sql/tools
python3 convertor.py postgres > output.sql
```
### Quick Database Setup with Docker
```bash
cd sql/tools
docker compose up -d postgres
cd script/docker
docker compose up -d
```
## Configuration
### Application Profiles
- `application.yaml` - Base configuration
- `application-local.yaml` - Local development (port 48080)
- `application-local.yaml` - Local development (port 48081)
- `application-dev.yaml` - Development environment
### Key Configuration Properties
@@ -174,15 +162,15 @@ Configured via `spring.datasource.dynamic.datasource`:
## API Documentation
- **Swagger UI**: http://localhost:48080/swagger-ui
- **Knife4j UI**: http://localhost:48080/doc.html (enhanced Swagger UI)
- **OpenAPI JSON**: http://localhost:48080/v3/api-docs
- **Swagger UI**: http://localhost:48081/swagger-ui
- **Knife4j UI**: http://localhost:48081/doc.html (enhanced Swagger UI)
- **OpenAPI JSON**: http://localhost:48081/v3/api-docs
## Monitoring & Admin
- **Spring Boot Admin**: http://localhost:48080/admin
- **Actuator**: http://localhost:48080/actuator
- **Druid Monitor**: http://localhost:48080/druid (database connection pool)
- **Spring Boot Admin**: http://localhost:48081/admin
- **Actuator**: http://localhost:48081/actuator
- **Druid Monitor**: http://localhost:48081/druid (database connection pool)
## Common Issues
@@ -193,7 +181,7 @@ If you encounter startup issues, refer to: https://doc.iocoder.cn/quick-start/
Ensure PostgreSQL is running and credentials in `application-local.yaml` are correct.
### Port Conflicts
Default port is 48080. Change via `server.port` in configuration files.
Default port is 48081. Change via `server.port` in configuration files.
## Dependencies & Versions