快速开始

生成项目

在脚手架目录运行：
终端窗口
```
npm run dev
```
按提示依次选择前端框架、后端框架，并输入项目名称（只能包含小写字母、数字和连字符，默认 my-fullstack-app）。
```
? 请选择前端框架: React / Vue
? 请选择后端框架: Python (FastAPI) / Java (Spring Boot)
? 请输入项目名称: my-project
```
生成的项目会出现在当前目录下，并自动完成 git init 与初始提交。

启动开发环境

cd my-project
./dev.sh start

dev.sh 会先安装前端与后端依赖，然后同时启动两个服务，并自动打开日志：

前端页面:  http://localhost:5173
后端 API:  http://localhost:8088
API 文档:  http://localhost:8088/docs

登录系统

打开 http://localhost:5173，使用默认管理员账号登录：

用户名密码角色

admin 123456 管理员

默认密码 123456 仅用于开发调试。部署到生产后请立即登录并修改管理员密码。

默认账号

除管理员外，模板还预置了四个普通用户，密码同为 123456：

用户名	姓名	角色
`admin`	管理员	`admin`（全部权限）
`zhangsan`	张三	`user`
`lisi`	李四	`user`
`wangwu`	王五	`user`
`zhaoliu`	赵六	`user`

详见默认账号。

端口

环境	前端	后端
开发	5173	8088
Docker	5173	8088（容器内，经 Nginx 反代）

下一步

项目结构 —— 生成的目录里都有什么。
认证与账号 —— 登录、注册、维护模式与人工审核。
Docker 部署 —— 打包成单个镜像上线。