Voxel

Thu, 01 Oct 2026 00:00:00 +0800

Voxel 是一组按同一领域分层重建的全栈脚手架系列：Portal 与 Admin 独立后端、独立前端，目录、坐标与包名统一为 voxel-* / io.github.jiangbyte.voxel。后端对齐 Java（Spring Boot）、Python（FastAPI）、Go（Gin）；前端对齐 Vue 3 管理端、React 门户与 uni-app。另有七层纯骨架与带账户竖切的充实模板，供对照学习，不作业务拷贝范本。协议 Apache License 2.0。

相对「一份单体里切 admin/portal」，端隔离：Admin 只挂管理 API，Portal 只挂门户 API，前端互不引用对方源码。相对单语言脚手架，同一七层在三种运行时对齐。

flowchart TB subgraph fronts ["前端"] vue["voxel-admin Vue3"] react["voxel-portal React"] uniA["admin-uniapp"] uniP["portal-uniapp"] end subgraph backends ["后端 · Admin / Portal"] ja["Java 8000 / 8001"] py["FastAPI 8100 / 8101"] go["Gin 8200 / 8201"] end subgraph tpls ["模板"] skel["ddd-lite-strcut"] lite["ddd-lite"] end vue --> ja react --> ja uniA --> ja uniP --> ja vue --> py react --> py vue --> go react --> go lite -.-> ja skel -.-> lite

特性

端分离：Admin / Portal 各仓各端口
DDD 七层：types · api · domain · infrastructure · case/cases · trigger · app
依赖方向：Trigger → API → Case → Domain ← Infrastructure
Java：Maven 多模块 {project}-types … -app
FastAPI：仓库根扁平包，无 src/ 包装层
Gin：internal/{types,api,domain,infrastructure,cases,trigger} + cmd/app
Web / 移动：Vue 3、React 19、uni-app 双端
模板仓：骨架默认注释中间件；充实模板含账户竖切，S3 / Milvus / Spring AI / MCP 注释接入（原 voxel-ddd-ai-lite 已合并）

flowchart TB trigger["trigger"] api["api"] cases["case"] domain["domain"] infra["infrastructure"] types["types"] app["app"] trigger --> api --> cases --> domain infra --> domain app --> trigger app --> infra types -.-> trigger

技术栈

后端：JDK 21 · Python 3.11+ · Go 1.25+
前端：Vue 3 · React 19 · uni-app
协议：OpenAPI / Apifox（docs/api/openapi）

系列仓库

后端

Gin on 撷时录

Voxel

特性

技术栈

系列仓库