# Somirk-admin

**Repository Path**: lancemorii-git/somirk-admin

## Basic Information

- **Project Name**: Somirk-admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Somirk Admin

基于 Spring Boot 3 + Vue 3 的个人专属后台管理脚手架。

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Java 17、Spring Boot 3.2、MyBatis-Plus、Sa-Token、Redis、MySQL、Quartz |
| 前端 | Vue 3.4、Vite 5、TypeScript、Naive UI、Pinia |

## 项目结构

```
somirk-admin
├── somirk-common       # 公共基础模块
├── somirk-infra        # 基础设施（DB、Redis、OSS、短信、推送、WebSocket 等）
├── somirk-core         # 业务核心（system、auth、file、gen、message）
├── somirk-api          # 接口层（admin-api）
├── somirk-job          # 定时任务
├── somirk-starter      # 启动入口
├── somirk-ui           # 管理后台前端
└── sql/somirk-system.sql
```

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 7.0+
- Node.js 18+

### 1. 初始化数据库

```sql
CREATE DATABASE `somirk-system` DEFAULT CHARACTER SET utf8mb4;
```

```bash
mysql -u root -p somirk-system < sql/somirk-system.sql
```

### 2. 修改配置

编辑 `somirk-starter/src/main/resources/application-dev.yml`，配置 MySQL 和 Redis 连接信息。

### 3. 启动后端

```bash
mvn clean install
cd somirk-starter
mvn spring-boot:run
```

后端默认运行在 `http://localhost:8080`

### 4. 启动前端

```bash
cd somirk-ui
npm install
npm run dev
```

前端默认运行在 `http://localhost:3000`

### 默认账号

| 账号 | 密码 |
|------|------|
| admin | admin123 |

## 核心功能

- RBAC 权限管理（用户、角色、菜单、部门、岗位）
- 系统监控（在线用户、定时任务、服务监控、缓存监控）
- 日志管理（登录日志、操作日志）
- 消息中心（系统公告、即时通讯）
- 文件管理、代码生成器
- 密码登录 + 短信验证码登录

## 开发约定

新增业务模块：

1. `somirk-core/somirk-system/entity` — 实体
2. `somirk-core/somirk-system/mapper` — Mapper
3. `somirk-core/somirk-system/service` — Service
4. `somirk-api/somirk-admin-api/controller` — Controller

权限控制：`@SaCheckPermission`  
操作日志：`@Log` 注解

## 作者

**Somirk**