包职责对照

应用包

包	路径	技术	说明
web	packages/web	Vue 3 + Vite	薄入口，bootstrap admin
desktop	packages/desktop	Electron + Vue	同上，hash 路由
mobile	packages/mobile	uni-app	业务端，登录 + 权限入口
server-java	packages/server-java	Spring Boot 3	RBAC API 参考实现
server-python	packages/server-python	FastAPI	RBAC API 对照实现

共享包

包	npm 名	说明
types	@xichen-full-stack/types	API DTO、LoginResponse 等 TS 类型
api-client	@xichen-full-stack/api-client	axios 封装、Token、401 刷新
auth	@xichen-full-stack/auth	hasPermission、menusToRoutes（纯 TS）
admin	@xichen-full-stack/admin	管理后台 UI + 路由 + Pinia
components	@xichen-full-stack/components	通用 Vue 组件库
utils	@xichen-full-stack/utils	通用工具函数

依赖关系（简化）

web / desktop
  └── admin
        ├── api-client → types
        ├── auth → types
        └── element-plus, pinia, vue-router

mobile
  ├── api-client
  ├── auth
  └── utils

契约与基础设施

路径	说明
contracts/openapi/rbac-api.yaml	REST API 契约
contracts/sql/schema.sql	MySQL 表结构
docker-compose.yml	MySQL 8 容器
docs/	本文档站（packages/docs，VitePress）

默认端口

服务	端口
MySQL	3306
server-java	8080
server-python	8000（可改 8080）
web	5173
desktop dev	5174
VitePress docs	5173（与 web 冲突时需改端口）

相关文档

• 整体架构
• 共享层概览