快速开始

相关代码: package.json, .env.example

环境要求

• Node.js 18+
• npm 9+
• 可访问的 Leopard/Ghippo API

1. 克隆项目

git clone <repo-url>
cd drun-pitstop
npm install

2. 配置环境变量

创建 .env 文件：

# 必需
VITE_API_BASE_URL=https://your-leopard-api.example.com
VITE_API_TOKEN=your-admin-access-token
VITE_ADMIN_USERNAME=admin
VITE_ADMIN_PASSWORD=your-password

# 可选
USER_TOKEN_TTL_HOURS=1        # 用户 Token 缓存时长（默认 1 小时）
SESSION_TTL_HOURS=24          # 管理员会话有效期（默认 24 小时）
COOKIE_SECURE=false           # 生产环境 HTTPS 时设为 true

关于 Token

VITE_API_TOKEN 是管理员 AccessToken，需要有以下权限：

• Leopard: SKU 管理、产品查询
• Ghippo: 用户列表查询、创建用户 AccessToken

3. 启动开发服务器

npm run dev

这会同时启动：

• Vite (:5173) - React 开发服务器
• Express (:3001) - Node 代理服务器

访问 http://localhost:5173 ，使用配置的用户名密码登录。

4. 验证运行

登录后应该能看到：

• 左侧导航：SKU 管理、用户管理、代金券
• SKU 列表页面正常加载数据

常用命令

# 仅启动 Vite（不需要代理时）
npm run dev:vite

# 仅启动 Node 代理
npm run server

# 代码检查
npm run lint

# 生产构建
npm run build

目录结构

drun-pitstop/
├── server/             # Express 代理层
├── src/                # React 前端
├── data/               # 运行时数据（Token 缓存）
├── leopardapi/         # API Swagger 参考
└── codewiki/           # 本文档

常见问题

登录失败

检查 .env 中的 VITE_ADMIN_USERNAME 和 VITE_ADMIN_PASSWORD

API 请求 401

1. 检查 VITE_API_TOKEN 是否有效
2. 确认 Token 有所需权限

用户数据加载失败

1. 检查 Ghippo API 是否可访问
2. 确认管理员 Token 有创建用户 AccessToken 的权限

下一步

• 架构概览 - 理解系统设计
• 开发指南 - 添加新功能