RuoYi-Vue-Plus ๆฏๅบไบ Spring Boot 3.3 + Vue 3.5 + TypeScript ็็ฐไปฃๅไผไธ็บงๅผๅๅนณๅฐใๆฌ้กน็ฎๅจRuoYi-Vue-Plusๅบ็กๆถๆไธ๏ผๅผๅไบๅฎๆด็PMS๏ผProperty Management System๏ผ้ ๅบ็ฎก็็ณป็ป๏ผๆถต็ไบ้ ๅบๆฅๅธธ่ฟ่ฅ็ๆ ธๅฟไธๅกๆต็จ๏ผๅ ๆฌ้ข่ฎข็ฎก็ใๅฎขๆฟ็ฎก็ใ่ดขๅก็ป็ฎใๅบๅญๆงๅถ็ญๅ่ฝๆจกๅใ
๐ ๅฎๆดๅผๅๆๅ: ๆฅ็ RuoYi-Vue-Plus้กน็ฎๅผๅๅฎๆดๆๅ.md ่ทๅ่ฏฆ็ป็ๅผๅๆต็จ่ฏดๆ
- ๅฎๆด็ไธๅกๆต็จ: ไป้ข่ฎขใๅ ฅไฝๅฐ้ๆฟใ็ป็ฎ็ๅ จๆต็จ็ฎก็
- ๆบ่ฝๅบๅญ็ฎก็: ๅฎๆถๅบๅญ็ๆง๏ผ้ฒๆญข่ถ ๅฎ๏ผๆฏๆๅจๆๅฎไปท
- ็ตๆดป็่ดขๅก็ณป็ป: ๅค็งๆฏไปๆนๅผ๏ผ่ชๅจๅฏน่ดฆ๏ผๅฎๆด็่ดขๅกๆฅ่กจ
- ๅค็งๆทๆถๆ: ๆฏๆ้ๅขๅ่ฟ่ฅ๏ผๅค้จๅบ็ฌ็ซ็ฎก็
- ้ ็ฝฎๅ็ฎก็: ็ณป็ปๅๆฐ็ตๆดป้ ็ฝฎ๏ผๆฏๆไธ็บง็ปงๆฟ๏ผ็ณป็ปโ็งๆทโ้จๅบ๏ผ
- ๆฐๆฎๅฎๅ จ: ๆๆไฟกๆฏๅ ๅฏๅญๅจ๏ผๅฎๆด็ๆไฝๆฅๅฟ
- ้ซๆง่ฝ: Redis็ผๅญไผๅ๏ผๆฏๆ้ซๅนถๅ่ฎฟ้ฎ
- ็งปๅจ็ซฏๆฏๆ: ๅๅบๅผ่ฎพ่ฎก๏ผๆฏๆ็งปๅจ่ฎพๅค่ฎฟ้ฎ
- Java: JDK 17+ (ๆจ่ 17 ๆ 21)
- Node.js: 18.0+ (ๆจ่ 20.x LTS)
- ๆฐๆฎๅบ: MySQL 8.0+ ๆ PostgreSQL 13+
- ็ผๅญ: Redis 6.0+
- ๆๅปบๅทฅๅ ท: Maven 3.8+, pnpm
- Git: 2.0+
# ๅๅปบๆฐๆฎๅบ
mysql -u root -p
CREATE DATABASE ruoyi_vue_plus DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
# ๅๅปบ็จๆทๅนถๆๆ
CREATE USER 'ruoyi'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON ruoyi_vue_plus.* TO 'ruoyi'@'%';
FLUSH PRIVILEGES;
# ๅฏผๅ
ฅๅบ็กๆฐๆฎ
mysql -u ruoyi -p ruoyi_vue_plus < sql/mysql/ruoyi_vue_plus.sql
mysql -u ruoyi -p ruoyi_vue_plus < sql/mysql/quartz.sql# 1. ่ฟๅ
ฅๅ็ซฏ้กน็ฎ็ฎๅฝ
cd ruoyi-vue-plus
# 2. ไฟฎๆน้
็ฝฎๆไปถ
# ็ผ่พ ruoyi-admin/src/main/resources/application-dev.yml
# ้
็ฝฎๆฐๆฎๅบ่ฟๆฅๅRedis่ฟๆฅ
# 3. ็ผ่ฏๅนถๅฏๅจ
mvn clean compile
mvn spring-boot:run -pl ruoyi-admin
# ๆ่
ๆๅ
่ฟ่ก
mvn clean package -DskipTests
java -jar ruoyi-admin/target/ruoyi-admin.jar# 1. ่ฟๅ
ฅๅ็ซฏ้กน็ฎ็ฎๅฝ
cd ruoyi-plus-soybean
# 2. ๅฎ่ฃ
ไพ่ต (ๆจ่ไฝฟ็จ pnpm)
pnpm install
# 3. ๅฏๅจๅผๅๆๅกๅจ
pnpm dev
# ่ฎฟ้ฎ http://localhost:5173
# ้ป่ฎค่ดฆๅท๏ผadmin / admin123# ไฝฟ็จ Docker Compose ไธ้ฎๅฏๅจๆๆๆๅก
docker-compose up -d
# ๆฅ็ๆๅก็ถๆ
docker-compose ps
โ ๏ธ ้่ฆๆ็คบ: ่ฏฆ็ป็้จ็ฝฒ้ ็ฝฎใๅผๅ่ง่ใๅธธ่ง้ฎ้ข่งฃๅณ็ญ่ฏทๅ่ๅฎๆดๅผๅๆๅๆๆกฃ
| ๆจกๅ | ๅ่ฝ่ฏดๆ |
|---|---|
| ่ฎขๅ็ฎก็ | ้ข่ฎขๅๅปบใ็กฎ่ฎคใๅ ฅไฝใ้ๆฟใๅๆถ็ญๅฎๆดๆต็จ |
| ่ดขๅก็ฎก็ | ่ดฆๅ็ฎก็ใๆถๆฌพ้ๆฌพใไบคๆ่ฎฐๅฝใ่ดขๅกๆฅ่กจ |
| ๅบๅญ็ฎก็ | ๅฎๆถๅบๅญใๅบๅญๅฟซ็ งใ่ถ ๅฎไฟๆคใๅบๅญ้ขๆต |
| ๅฎขๆฟ็ฎก็ | ๆฟๅ่ฎพ็ฝฎใๆฟ้ด็ถๆใๆฟไปท็ญ็ฅใๆฟ้ด้ๅฎ |
| ๅฎขๆท็ฎก็ | ๅฎขๆทๆกฃๆกใๅๅฒ่ฎฐๅฝใไผๅ็ฎก็ใ้ปๅๅ |
| ๆฅ่กจไธญๅฟ | ็ป่ฅๆฅ่กจใ่ดขๅกๆฅ่กจใๅ ฅไฝ็ๅๆใๆถ็็ฎก็ |
| ๆจกๅ | ๅ่ฝ่ฏดๆ |
|---|---|
| ็จๆท็ฎก็ | ็จๆท่ดฆๅทใ่ง่ฒๅ้ ใๆ้ๆงๅถ |
| ้จ้จ็ฎก็ | ็ป็ปๆถๆใ้จๅบ็ฎก็ใๆฐๆฎ้็ฆป |
| ่ๅ็ฎก็ | ๅจๆ่ๅใๆ้ฎๆ้ใ่ทฏ็ฑ้ ็ฝฎ |
| ๅญๅ ธ็ฎก็ | ็ณป็ปๅญๅ ธใไธๅกๅญๅ ธใๅจๆ้ ็ฝฎ |
| ๅๆฐ้ ็ฝฎ | ็ณป็ปๅๆฐใไธๅกๅๆฐใๆๆไฟกๆฏๅ ๅฏ |
| ้็ฅๅ ฌๅ | ็ณป็ปๅ ฌๅใๆถๆฏๆจ้ใ็ซๅ ไฟก |
| ๆฅๅฟ็ฎก็ | ๆไฝๆฅๅฟใ็ปๅฝๆฅๅฟใๅผๅธธๆฅๅฟ |
| ็ณป็ป็ๆง | ๅจ็บฟ็จๆทใๆๅก็ๆงใ็ผๅญ็ๆง |
ruoyi-vue-plus-pms/
โโโ docs/ # ๆๆกฃ็ฎๅฝ
โ โโโ api/ # APIๆๆกฃ
โ โโโ user/ # ็จๆทๆๅ
โ โโโ deploy/ # ้จ็ฝฒๆๅ
โ โโโ developer/ # ๅผๅๆๆกฃ
โโโ ruoyi-admin/ # ๅฏๅจๆจกๅ
โโโ ruoyi-common/ # ๅ
ฌๅ
ฑๆจกๅ
โโโ ruoyi-modules/ # ไธๅกๆจกๅ
โ โโโ ruoyi-system/ # ็ณป็ปๆจกๅ
โ โโโ ruoyi-pms/ # PMSๆจกๅ
โโโ ruoyi-plus-soybean/ # ๅ็ซฏ้กน็ฎ
โโโ sql/ # ๆฐๆฎๅบ่ๆฌ
- ๅบ็กๆกๆถ: Spring Boot 3.3.6
- ๆ้ๆกๆถ: Sa-Token 1.39.0
- ๆฐๆฎๅบ: MySQL 8.0+ / PostgreSQL 13+
- ็ผๅญ: Redis 6.0+ + Redisson
- ORMๆกๆถ: MyBatis-Plus 3.5.9
- ๆฐๆฎๅบ่ฟๆฅๆฑ : HikariCP
- ๅทฅๅ ท็ฑป: Hutool 5.8.24
- Excelๅค็: EasyExcel 3.3.3
- ้ช่ฏๆกๆถ: Hibernate Validator
- ไปปๅก่ฐๅบฆ: XXL-JOB
- JSONๅค็: Jackson
- ๆๅปบๅทฅๅ ท: Maven 3.8+
- ๅบ็กๆกๆถ: Vue 3.5+ (Composition API)
- ๅผๅ่ฏญ่จ: TypeScript 5.8+
- ๆๅปบๅทฅๅ ท: Vite 6.3+
- ่ทฏ็ฑ็ฎก็: Vue Router 4.5+ + elegant-router 1.0.2
- ็ถๆ็ฎก็: Pinia 3.0+
- UIๆกๆถ: Naive UI 2.41+
- CSSๆกๆถ: UnoCSS (ๅๅญๅ)
- HTTPๅฎขๆท็ซฏ: Axios
- ๅ ็ฎก็: pnpm
- ไปฃ็ ่ง่: ESLint + Prettier
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅ็ซฏๅบ็จๅฑ โ
โ Vue3 + TypeScript + Vite โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ็ฝๅ
ณๅฑ โ
โ Nginxๅๅไปฃ็ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅบ็จๅฑ โ
โ Spring Boot + Sa-Token โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ่ฎขๅๆๅก โ ่ดขๅกๆๅก โ ๅบๅญๆๅก โ ้
็ฝฎๆๅก โ ็ณป็ปๆๅก โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆฐๆฎๅฑ โ
โ MyBatis Plus + Redis โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅญๅจๅฑ โ
โ MySQL + Redis โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- ่ฎค่ฏๆๆ: ๅบไบSa-Token็่ฎค่ฏๆๆๆบๅถ
- ๆฐๆฎๅ ๅฏ: ๆๆไฟกๆฏAES-256-GCMๅ ๅฏๅญๅจ
- ๆฅๅฃๅฎๅ จ: ้ฒ้ๆพๆปๅปใ้ฒSQLๆณจๅ ฅใXSS่ฟๆปค
- ๆฐๆฎ่ฑๆ: ๆๆๆฐๆฎๅฑ็คบ่ชๅจ่ฑๆ
- ๆไฝๅฎก่ฎก: ๅฎๆด็ๆไฝๆฅๅฟ่ฎฐๅฝ
- ่ฎฟ้ฎๆงๅถ: ๅบไบRBAC็ๆ้ๆงๅถ
- ็ผๅญ็ญ็ฅ: ๅค็บง็ผๅญๆถๆ๏ผRedis็ผๅญ็ญ็นๆฐๆฎ
- ๆฐๆฎๅบไผๅ: ็ดขๅผไผๅใๆฅ่ฏขไผๅใ่ฏปๅๅ็ฆป
- ๅผๆญฅๅค็: ๆถๆฏ้ๅๅค็่ๆถๆไฝ
- ่ฟๆฅๆฑ : HikariCP้ซๆง่ฝ่ฟๆฅๆฑ
- ๅ็ซฏไผๅ: ่ทฏ็ฑๆๅ ่ฝฝใ็ปไปถๆ้ๅผๅ ฅใ่ตๆบๅ็ผฉ
- ๅๅ ๆต่ฏ: JUnit5 + Mockito๏ผ่ฆ็ๆ ธๅฟไธๅก้ป่พ
- ้ๆๆต่ฏ: Spring Boot Test๏ผๆต่ฏๅฎๆดไธๅกๆต็จ
- ๅ็ซฏๆต่ฏ: Vitest + Vue Test Utils
- E2Eๆต่ฏ: Playwright่ชๅจๅๆต่ฏ
| ๆๆกฃ | ็จ้ | ้็จๅบๆฏ | ๆจ่ๅบฆ |
|---|---|---|---|
| RuoYi-Vue-Plus้กน็ฎๅผๅๅฎๆดๆๅ | ๐ฏ ๅฎๆด็ๅผๅๆต็จ่ฏดๆ | ๆทฑๅ ฅๅญฆไน ๅผๅ่ง่ | โญโญโญโญโญ |
| README-DEV-SETUP.md | โก ๅฟซ้็ฏๅข้ ็ฝฎ | ๅฟซ้ๆญๅปบๅผๅ็ฏๅข | โญโญโญโญ |
| APIๅ่ๆๆกฃ | ๐ RESTful APIๆฅๅฃๆๆกฃ | ๆฅๅฃๅผๅๅ้ๆ | โญโญโญ |
| ็จๆทๆไฝๆๅ | ๐ค ็ณป็ปไฝฟ็จ่ฏดๆ | ไธๅก็จๆท | โญโญโญ |
| ้จ็ฝฒๆๅ | ๐ ็ไบง็ฏๅข้จ็ฝฒ | ่ฟ็ปด้จ็ฝฒ | โญโญโญ |
| ๅผๅ่ ๆๅ | ๐ป ๅผๅ่ง่ๅๆไฝณๅฎ่ทต | ๅข้ๅผๅ | โญโญโญโญ |
- ๆฐๆๅ ฅ้จ: ๅ ้ ่ฏปๆฌๆๆกฃไบ่งฃ้กน็ฎๆฆ่ง
- ็ฏๅขๆญๅปบ: ๆฅ็ README-DEV-SETUP.md
- ่ฏฆ็ปๅผๅ: ๆทฑๅ ฅๅญฆไน ๅฎๆดๅผๅๆๅ
- ้จ็ฝฒไธ็บฟ: ๅ่ ้จ็ฝฒๆๅ
- ๆ้ไฝ็ณป: ๅบไบ็จๆท็ฑปๅ็ๆ้ๆงๅถ (super_admin, tenant_admin, sys_user, app_user)
- ๅฝๅ่ง่:
- URL่ทฏๅพไฝฟ็จ kebab-case (
/system/user/reset-pwd) - ๆ้ๆ ่ฏไฝฟ็จๅๅทๅๅฑ (
system:user:list) - ็ปไปถๅไฝฟ็จ PascalCase ไธๅคๅ่ฏ็ปๅ
- URL่ทฏๅพไฝฟ็จ kebab-case (
- ไปฃ็ ่ดจ้: TypeScriptไธฅๆ ผ็ฑปๅๆฃๆฅ๏ผESLint้ถ้่ฏฏๆ ๅ
- ๅๅ็ซฏๅไฝ: elegant-router่ทฏ็ฑ็ณป็ป๏ผ็กฎไฟๅๅ็ซฏๆฐๆฎไธ่ดๆง
feat: ๆทปๅ ๆฐๅ่ฝ
fix: ไฟฎๅคbug
docs: ๆดๆฐๆๆกฃ
style: ไปฃ็ ๆ ผๅผ่ฐๆด
refactor: ้ๆไปฃ็
perf: ๆง่ฝไผๅ
test: ๅขๅ ๆต่ฏ
chore: ๆๅปบๆๅทฅๅ
ทๅๅจ- Fork ๆฌไปๅบ
- ๆฐๅปบๅ่ฝๅๆฏ๏ผ
git checkout -b feature/your-feature - ๆไบคไปฃ็ ๏ผ
git commit -m 'feat: ๆทปๅ ๆไธชๅ่ฝ' - ๆจ้ๅๆฏ๏ผ
git push origin feature/your-feature - ๆฐๅปบ Pull Request
- ๅ็ซฏ: Java็ผ่ฏ้่ฏฏ 0ไธช๏ผไปฃ็ ้ๅค็ โค 5%
- ๅ็ซฏ: TypeScript้่ฏฏ 0ไธช๏ผESLint้่ฏฏ 0ไธช
- ๆต่ฏ่ฆ็็: โฅ 80%
ๆฌ้กน็ฎ้็จ MIT ๅผๆบๅ่ฎฎ
- RuoYi-Vue-Plus - ๅผบๅคง็ๅบ็กๅผๅๆกๆถ
- Soybean Admin - ไผ็ง็Vue3ๅ็ซฏๆกๆถ
- Dromara - ๅผๆบ็ป็ปๆฏๆ
Copyright ยฉ 2024 PMS Team. All rights reserved.