safety-eval-service-frontend/docs/startup.md

# 证照管理子应用 — 快速启动

## 环境要求

- Node.js >= 18
- pnpm >= 8

## 启动

```bash
# 安装依赖（首次或重命名项目目录后）
pnpm install

# 启动开发服务器
pnpm run serve:development
```

## 访问

| 地址 | 说明 |
|------|------|
| `http://localhost:8081/certificate/container/` | 应用首页 |
| `http://localhost:8081/certificate/container/Test` | 测试页面（无 API 依赖，纯前端调试可用） |

## 常用命令

| 命令 | 说明 |
|------|------|
| `pnpm run serve:development` | 开发环境启动（推荐） |
| `pnpm run serve:production` | 生产环境配置启动 |
| `pnpm run build:development` | 开发环境构建 |
| `pnpm run build:production` | 生产环境构建 |

## 技术栈

- React 18 + Ant Design 5.x
- @cqsjjb/jjb-dva-runtime（GBS 底座 DVA 运行时）
- rspack 构建 / pnpm 包管理
- qiankun 微前端子应用

## 重要提示

- 本项目为 GBS 底座微前端子应用，独立启动时有内置模拟布局
- 本地独立运行时 API 调用会返回 401（缺少底座注入的认证 Token）
- 仅 Test 页面可在本地无底座环境下正常访问
- 重命名项目目录后需 `pnpm install` 重建 node_modules 符号链接
- 完整开发指南请参考 [dev-guide.md](./dev-guide.md)