# lightboat

**Repository Path**: gxsq/lightboat

## Basic Information

- **Project Name**: lightboat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LightBoat Backend

LightBoat 后端服务，基于 Java 21 + Spring Boot 3.5 构建的企业级后台管理系统，提供完整的权限管理、系统配置和业务支撑能力。

## 安装步骤

```bash
# 进入项目目录
cd 00-backend

# 编译并安装所有模块（跳过测试）
mvn -pl boot-admin -am install -DskipTests

# 启动应用
mvn -pl boot-admin spring-boot:run
```

## 使用说明

### 数据库配置

数据库连接信息：

- 数据库名：`lightboatdb`
- 用户名：`lightboat`
- 密码：`lightboat`
- 端口：`5432`
- 主机：`localhost`

### 数据库初始化步骤

```bash
# 1. 创建数据库用户
CREATE USER lightboat WITH PASSWORD 'lightboat';

# 2. 创建数据库
CREATE DATABASE lightboatdb OWNER lightboat;

# 3. 执行初始化脚本
psql -U lightboat -d lightboatdb -f lightboat_v1_00.sql

# 4. 执行后续SQL脚本（按日期顺序）
psql -U lightboat -d lightboatdb -f sql/postgresql/2026-05-19-add-department-code.sql
psql -U lightboat -d lightboatdb -f sql/postgresql/2026-05-20-add-user-phone-sensitive-columns.sql
psql -U lightboat -d lightboatdb -f sql/postgresql/2026-05-20-code-based-permission-framework.sql
psql -U lightboat -d lightboatdb -f sql/postgresql/2026-05-22-grant-lightboat-schema-permissions.sql
psql -U lightboat -d lightboatdb -f sql/postgresql/2026-05-22-sync-menu-icons.sql
psql -U lightboat -d lightboatdb -f sql/postgresql/2026-05-26-demo-customer-menu.sql
```

### 默认登录账号

| 用户名 | 密码 | 角色 | 备注 |
|--------|------|------|------|
| admin | admin | 超级管理员 | 拥有系统所有权限 |
| huke | huke | 普通用户 | 用于测试普通权限 |

### 运行命令

```bash
# 开发环境运行
mvn -pl boot-admin spring-boot:run

# 打包构建
mvn -pl boot-admin -am package -DskipTests

# 运行打包后的 Jar
java -jar boot-admin/target/sa-parent-3.0.0.jar

# 运行测试
mvn test
```

## 主要功能

- **用户管理**：用户的增删改查、角色分配、密码管理
- **角色管理**：角色创建、权限配置、用户关联
- **部门管理**：部门树结构管理、部门用户分配
- **菜单管理**：系统菜单配置、权限关联
- **权限管理**：基于代码的权限框架、数据范围控制
- **日志管理**：操作日志、登录日志记录与查询
- **文件管理**：文件上传、下载、预览功能
- **数据脱敏**：敏感数据加密存储与脱敏展示
- **API加密**：接口请求响应加密通信
- **三级防护**：安全防护配置与管理

## 模块结构

- `platform-common`：共享平台能力与基础支撑
- `platform-web`：Web框架接入、接口文档、全局异常处理
- `platform-security`：认证安全相关启动配置
- `platform-persistence`：数据源、MyBatis、Redis、缓存与重复提交装配
- `domain-system`：系统管理域核心业务
- `boot-admin`：启动与部署模块

## 依赖项

| 依赖           | 版本      | 说明       |
| ------------ | ------- | -------- |
| Java         | 21      | 编程语言     |
| Spring Boot  | 3.5.14  | 应用框架     |
| MyBatis Plus | 3.5.16  | ORM框架    |
| Sa-Token     | 1.45.0  | 权限认证框架   |
| Redisson     | 3.52.0  | Redis客户端 |
| PostgreSQL   | 42.7.11 | 数据库驱动    |
| Druid        | 1.2.28  | 连接池      |
| Knife4j      | 4.6.0   | API文档    |
| Hutool       | 5.8.44  | 工具库      |

## 许可证

MIT License

##