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）

系列仓库

后端

ACOJ

Mon, 31 Aug 2026 00:00:00 +0800

ACOJ 是在线评测（OJ）monorepo：在 HEI 脚手架上扩展题库、提交判题与多执行机调度，提供 Admin（Vue 3）、Portal（React 19）与统一 Spring Boot API。判题执行依赖 SparkSandbox：沙箱只编译与限资源运行，AC / WA 在 ACOJ 裁决。Apache License 2.0。

相对「沙箱内直接出最终结果」的一体化 OJ，隔离执行与题目语义拆开：执行机加权调度、熔断、排水、租约换机；平台保留测例版本、标签、发布校验与做题统计。modules/oj 叠在脚手架之上，而不是从零拼一套账号与存储。

flowchart LR portal["Portal"] admin["Admin"] api["Spring Boot API"] mq["RabbitMQ"] sched["调度 / 熔断 / 换机"] spark["SparkSandbox"] portal --> api admin --> api api --> mq --> sched --> spark spark -->|"stdout / 状态"| api api -->|"AC / WA"| portal

特性

双端账号：ADMIN / PORTAL 独立会话（Sa-Token）；密码 RSA、验证码、失败锁定与限流；JustAuth（可配置）
RBAC：账号 / 角色 / 部门 / 用户组 / 岗位；菜单、按钮与 API 授权；会话踢出
系统管理：字典、动态配置（敏感项加密）、Banner、公告、反馈、弱口令库
对象存储：S3 兼容（MinIO / RustFS / OSS），直链或预签名
运维：审计与告警、登录日志、运营工作台、sys_job / Lock4j
题库：CRUD、测例 INLINE / OBJECT、标签、参考答案、试跑与发布校验
提交与判题：多语言入队；RabbitMQ；加权调度、熔断 / 排水 / 租约换机；业务侧裁决
判题节点：oj_judge_node 登记沙箱；心跳探活；oj_judge_dispatch 派发审计
个人中心：公开资料、安全设置、实名认证；做题统计

API 前缀 /api/v1/admin/* 与 /api/v1/portal/*。子工程：admin · portal · server。

Spring Boot on 撷时录

Voxel

特性

技术栈

系列仓库

ACOJ

特性