Skip to content
Merged

Web #25

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
3 changes: 3 additions & 0 deletions demo/dim_stack/.gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
*.xml linguist-language=Java
*.sql linguist-language=Java
*.yml linguist-language=Java
88 changes: 88 additions & 0 deletions demo/dim_stack/.github/workflows/build.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
name: Build and Release
on:
workflow_dispatch:

permissions:
contents: write

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: Verify migration baseline (init.sql vs database_version.txt)
run: |
MIG_DIR=backend/dimstack-app/src/main/resources/db/migration
latest=$(ls "$MIG_DIR"/V*.sql | sed -E 's#.*/V([0-9]+)__.*#\1#' | sort -n | tail -1)
baseline=$(tr -d '[:space:]' < "$MIG_DIR/database_version.txt")
echo "latest migration = V$latest, database_version.txt = $baseline"
if [ "$latest" != "$baseline" ]; then
echo "::error::database_version.txt($baseline) 与最新迁移脚本(V$latest) 不一致, 新装库会漏掉迁移内容"
exit 1
fi

- uses: actions/cache@v4
with:
path: ~/.m2/repository
key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
restore-keys: ${{ runner.os }}-maven-

- name: Set up JDK 17
uses: actions/setup-java@v4
with:
java-version: 17
distribution: 'temurin'

- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: '22'

- name: Install frontend dependencies
run: |
cd frontend
npm install

- name: Build frontend
run: |
cd frontend
npm run build

- name: Clean backend static directory
run: |
mkdir -p backend/dimstack-app/src/main/resources/static
rm -rf backend/dimstack-app/src/main/resources/static/*

- name: Copy frontend build to backend static
run: |
mkdir -p backend/dimstack-app/src/main/resources/static
cp -r frontend/dist/* backend/dimstack-app/src/main/resources/static/

- name: Build backend with Maven
run: |
cd backend
mvn clean package -DskipTests

- name: Create release package
run: |
cd backend
mkdir release
cp dimstack-app/target/*.jar release/
cd release
zip -r dim_stack-release.zip *

- name: Upload build artifact
uses: actions/upload-artifact@v4
with:
name: dimstack-release
path: backend/release/dim_stack-release.zip

- name: Create Release
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
gh release create "v${{ github.run_number }}" \
--title "Release v${{ github.run_number }}" \
--notes "Automated release" \
backend/release/dim_stack-release.zip
39 changes: 39 additions & 0 deletions demo/dim_stack/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
backend/dimstack-app/target/
backend/dimstack-app/docs/
backend/dimstack-app/src/main/resources/static/
backend/dimstack-plugin-api/target/
dimstack_expansion_server/target/
dimstack_expansion_server/docs/
frontend/node_modules/
frontend/dist/
.idea/
upload/
logs/
systemconfig/target/
.vscode/
application-setup.properties
/systemconfig/dependency-reduced-pom.xml
qodana.yaml
cli/.vscode
cli/src/o
cli/src/nuitka-crash-report.xml
firefly-theme/
examples/plugins/**/target/
plugin_example/**/target/
/plugins/
plugin-startup.log

# 初始化生成的配置(含数据库密码等敏感信息)与运行期数据目录
/config/
/data/
# 根目录游离的构建产物与 IDE 文件
/BOOT-INF/
/*.jar
*.iml
# 前端共享依赖 vendor 产物(npm prebuild/predev 自动生成)
frontend/public/vendor/

# 开发测试用的主题与示例插件(不入库)
/themes/
/enterprise-theme/
/examples/
24 changes: 24 additions & 0 deletions demo/dim_stack/Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
FROM alpine:latest

LABEL maintainer="lingview <official@lingview.xyz>"

RUN sed -i 's|https\?://dl-cdn.alpinelinux.org/alpine|https://mirrors.tuna.tsinghua.edu.cn/alpine|g' /etc/apk/repositories

RUN apk update
RUN apk add --no-cache openjdk21-jre wget

RUN addgroup -g 1001 -S dimstack && \
adduser -u 1001 -S dimstack -G dimstack

RUN mkdir -p /dim_stack && \
chown -R dimstack:dimstack /dim_stack

WORKDIR /dim_stack

RUN wget -O dimstack-1.0-SNAPSHOT.jar https://update.apilinks.cn/dimstack/dimstack-1.0-SNAPSHOT.jar && \
chown dimstack:dimstack dimstack-1.0-SNAPSHOT.jar

USER dimstack

ENTRYPOINT ["java", "-XX:+UseContainerSupport", "-XX:MaxRAMPercentage=75.0", "-jar", "dimstack-1.0-SNAPSHOT.jar"]
CMD ["--server.port=2222"]
21 changes: 21 additions & 0 deletions demo/dim_stack/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2025-2026 lingview and contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
119 changes: 119 additions & 0 deletions demo/dim_stack/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
# 次元栈 · Dim Stack

> 一个简单易用的个人博客系统

![Spring Boot](https://img.shields.io/badge/Spring_Boot-4.1.0-green.svg)

![React](https://img.shields.io/badge/React-19.1.1-%2361DAFB.svg)

![Node.js](https://img.shields.io/badge/Node.js-22.16.0-43853D.svg)

![Database](https://img.shields.io/badge/Database-MySQL-4479A1.svg)

![Database](https://img.shields.io/badge/Database-Redis-DC382D.svg)

---

## 🌟 项目简介

**次元栈** 是基于 Spring Boot 4 全新构建的个人博客系统。

**官方 QQ 群**:577040366(群内可体验预览版)

### 核心功能

- 📝 内容管理(CMS)
- 💬 用户互动:评论、点赞
- 🔖 标签分类:支持跨圈层内容组织
- 👥 用户系统:个人主页、文章发布管理、完整 RBAC 权限系统
- 📱 响应式前端,支持移动端浏览
- 📦 支持首页、文章页服务端渲染(SSR)
- 🤖 大模型内容审核&生成
- 🖼️ 智能图片压缩
- 🔍 SEO 优化:动态 Sitemap、Robots、搜索引擎友好

### Star History
<a href="https://www.star-history.com/?repos=lingview%2Fdim_stack&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=lingview/dim_stack&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=lingview/dim_stack&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=lingview/dim_stack&type=date&legend=top-left" />
</picture>
</a>

---

## 🛠 技术栈

| 层级 | 技术选型 |
| --- | --- |
| **后端** | Java 17+,Spring Boot 4,MySQL 5.7+,Redis |
| **前端** | React 19,Vite,Tailwind CSS v4 |
| **构建** | Maven(后端),npm(前端) |
| **部署** | Docker,Linux,Windows |

---

## 快速开始

### 运行要求

- JDK 17+(推荐 21+)
- MySQL 5.7+
- Redis 5+(可选)

### 启动步骤

1. 运行 jar 包:
```bash
java -jar dimstack-1.0-SNAPSHOT.jar
```
2. 浏览器访问终端输出的地址,进入初始化向导
3. 填写配置完成后重启服务

详细部署教程请查看:[部署文档](docs/deployment.md)

---

## 文档导航

### 系统部署&构建

- [部署&构建](docs/deployment.md)

### 功能说明

- [大模型审核与生成](docs/features/llm_generation_and_review.md)
- [智能图片压缩](docs/features/image-compression.md)
- [外部资源本地化](docs/features/external-resources.md)
- [外置存储](docs/features/storage.md)
- [代码注入(自定义 Head/Footer)](docs/features/code-injection.md)
- [SEO 优化与大模型读取](docs/features/seo.md)
- [评论区功能](docs/features/comments.md)
- [访问控制Key&Agent调用说明](docs/features/key.md)

### 架构说明

- [系统启动流程](docs/architecture/startup-flow.md)
- [缓存模式](docs/architecture/cache-mode.md)

### 主题
- [面向主题开发者接口文档](docs/themes/themes-frontend-routing-guide.md)

### 插件
- [面向插件开发者接口文档](docs/plugins/plugin-development-guide.md)

### 项目脚本
- [项目脚本使用说明(包括构建维护等脚本)](docs/features/script_usage_instructions.md)

### 老版本迁移
- [老版本升级说明](docs/legacy.md)

---

### 💡 特别感谢

感谢所有为本项目贡献代码、提出问题和提供反馈的开发者。
感谢开源社区持续的支持与贡献。

如果你在本项目中做出了贡献,请提交 PR 将你的名字加入到致谢名单中!
28 changes: 28 additions & 0 deletions demo/dim_stack/backend/check_role_permission.sql
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
-- 查看作者(READER)权限
SELECT r.name AS role_name, p.code, p.name AS permission_name
FROM role_permission rp
JOIN role r ON rp.role_id = r.id
JOIN permission p ON rp.permission_id = p.id
WHERE r.code = 'READER';

-- 查看作者(AUTHOR)权限
SELECT r.name AS role_name, p.code, p.name AS permission_name
FROM role_permission rp
JOIN role r ON rp.role_id = r.id
JOIN permission p ON rp.permission_id = p.id
WHERE r.code = 'AUTHOR';


-- 查看作者(POST_MANAGER)权限
SELECT r.name AS role_name, p.code, p.name AS permission_name
FROM role_permission rp
JOIN role r ON rp.role_id = r.id
JOIN permission p ON rp.permission_id = p.id
WHERE r.code = 'POST_MANAGER';

-- 查看作者(ADMIN)权限
SELECT r.name AS role_name, p.code, p.name AS permission_name
FROM role_permission rp
JOIN role r ON rp.role_id = r.id
JOIN permission p ON rp.permission_id = p.id
WHERE r.code = 'ADMIN';
Loading
Loading