Xichen Full Stack

Appearance

熙辰 Full Stack全栈 Monorepo 开发文档

pnpm workspace + Turbo · Java 单体/微服务 + Python 后端 · Web / Desktop / Mobile 多端 · RBAC 权限底座 · 仪器设备可选插件

快速开始
Web 演示
架构概览

契约优先

contracts/openapi 与 schema.sql 作为双后端与前端对齐的唯一真相源，避免接口漂移。

共享层复用

types、api-client、auth、admin 等 workspace 包在三端之间共享，前端只关心 VITE_API_BASE_URL。

RBAC 闭环

登录 → Token → 动态菜单 → 按钮权限 → 接口级鉴权；server-java、micro-java 与 Python 行为对齐。

Java 双实现

server-java 单体上手快；micro-java 拆分为 Gateway + auth/system/monitor 微服务，与单体功能对齐，仍对外 :8080。

多端一致

Web 与 Desktop 共用 NC 企业壳（layout enterprise）与 RBAC；Mobile 按权限控制业务入口。

仪器设备（可选）

Desktop 可选接入 C# device-agent（:19721）与 @xichen-full-stack/instrument，用于串口/SDK 本地控制；默认构建不依赖。

脚手架在线体验 ​

端说明地址
Web 管理后台在线演示（默认账号 admin / admin123）https://web.tsanyang.top/
Desktop 桌面端Windows 安装包下载xichen-desktop.exe
Mobile 移动端Android APK 下载xichen_mobile.apk

TIP

Desktop / Mobile 安装包需配合可访问的 RBAC 后端（生产环境请在各自 .env.production 中配置 VITE_API_BASE_URL）。Web 演示已指向线上后端。

推荐阅读顺序 ​

  1. 快速开始 — 环境、安装、首次启动
  2. 整体架构 — 理解 Monorepo 分层
  3. RBAC 请求链路 — 登录到权限控制的完整流程
  4. admin 共享包 — Web / Desktop 管理后台核心
  5. Desktop 桌面端 — 桌面业务宿主；仪器设备插件 可选
  6. Java 安全与鉴权 或 micro-java 微服务 或 Python 权限

技术栈一览 ​

层级技术
编排pnpm workspace、Turbo
契约OpenAPI 3、MySQL schema
后端Spring Boot 3 + JWT + MyBatis-Plus / Spring Cloud Alibaba micro-java / FastAPI + SQLAlchemy
前端Vue 3 + Vite + Element Plus + Pinia
桌面Electron + vite-plugin-electron（业务宿主）
移动uni-app
仪器（可选）ASP.NET Core 8 device-agent + @xichen-full-stack/instrument

Xichen Full Stack 内部文档

Copyright © 2026