Web 快速开始

Web 是面向 C 端的 Vue 3 + Vite SPA，与 Admin 共用 Service，走 app 侧 EPS（service.user.* 等），没有 Admin 的 vm-crud 体系。

前置条件

依赖	说明
Service	后端先启动（开发代理默认 http://127.0.0.1:3000）
vome-core	EPS 客户端、configureClient / createEps
Bun	推荐用 Bun 安装与运行

启动

cd web
bun install
bun run dev

独立仓库 Clone / ZIP 见 源码下载。

开发端口 9900：

http://localhost:9900

API 前缀 /dev → Vite 代理到 Service（见 配置）。

启动顺序（main.ts）

1. bootEps() → createEps({ side: 'app' })
2. createApp + Pinia + Router → mount
3. 有 token 时 connectWs()（Socket）
4. 壳层：bootTheme、按需拉用户信息（见 App.vue）

首屏与 Tab

/ → /pages/home/index。TAB_LIST：首页 / 发现 / 消息 / 我的。登录：/pages/login/index。

详见 路由与页面。

常用脚本

命令	说明
bun run dev	开发
bun run build	生产构建（vite build）

端口对照

端	端口
Admin	9000
Web	9900
UniApp H5	6600
Service	3000

文档目录

文档	内容
目录结构	树、别名
配置说明	host / baseUrl / 免登录
路由与页面	glob、Tab、新增页
技术栈与 shadcn	栈与自动导入
API 与 EPS	request、service
Better Auth	登录会话
Socket.IO	实时连接
Stores	Pinia
主题	亮暗与变量
构建自有组件库	ui + vm-*
调试	排错
部署	Nginx / 生产