快速开始
前置环境
- Python 3.11+、Node.js 20+、npm 9+。
- 可选 Redis 6+，用于登录限流和会话缓存。
- 需要 Git 和 Docker，若使用 Compose 还要保证镜像可拉取、依赖可安装。
克隆与环境变量
bash
git clone https://github.com/hzb666/LabStorageManager.git
cd LabStorageManager
cp .env.example .env至少确认这些配置项：
DEFAULT_ADMIN_PASSWORDENVCORS_ORIGINSREDIS_PASSWORDREDIS_HOSTALGORITHMPRIVATE_KEY_PATHPUBLIC_KEY_PATH
启动后端
bash
poetry install
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000- 启动后可访问
http://localhost:8000/docs、/redoc和/health。
启动前端
bash
cd frontend
npm install
npm run dev- 开发模式默认监听 5173。
- 前端 API 基址通常由
VITE_API_URL指向http://localhost:8000/api。 - 生产构建使用
npm run build。
Docker Compose 运行整套服务
bash
APP_PORT=80 docker compose up -d --buildbackend、frontend和redis会一起启动。app_data需要可写，尤其是static、keys和数据库文件。- 可用
docker compose logs backend和docker compose logs frontend查看日志。
首次启动的自动初始化
- 后端
lifespan会调用init_db()，完成建表、索引、FTS 和默认管理员初始化。 - SQLite 连接会强制使用 WAL 和外键约束。
- 开发模式下若缺少 RSA key，配置层会尝试生成临时密钥；生产模式仍应显式提供 key 文件。
- 前端首次加载会恢复登录态，并初始化路由守卫和全局 UI 容器。
核心验证
curl http://localhost:${APP_PORT:-80}/health- 浏览器访问
http://localhost:${APP_PORT:-80}，确认前端能正常加载。 - 登录后检查
/api/users/me。 - 打开
/docs和/redoc，确认文档入口可用。 - 检查
/cart-import?import=true是否能被扩展桥接。 redis-cli -a <REDIS_PASSWORD> ping
常见排障命令
bash
docker compose ps
docker compose logs --tail 200 backend
docker compose logs --tail 200 frontend
docker compose exec redis redis-cli -a "$REDIS_PASSWORD" ping
curl -i http://localhost:8000/health文档站
wiki/ 是 VitePress 文档站源码，启动方式如下：
bash
cd wiki
npm install
npm run dev浏览器访问 http://localhost:5174 即可查看文档站。