# 访客机自助登记管理平台前端

独立静态前端项目，当前实现登录页和首页数据看板。

## 配置

入口配置在 `js/config.js`：

```js
window.VISITOR_LOGIN_CONFIG = {
  frontendMode: "standalone",
  deploymentMode: "standalone",
  defaultServerIp: "",
  apiBaseUrl: "http://localhost:9098",
  deploymentConfigPath: "/api/deployment/config",
  defaultBackendPort: "9098",
  loginPath: "/api/login",
  captchaPath: "/captchaImage"
};
```

- `frontendMode: "standalone"`：前端单机版标识，显示 IP 输入框，登录时使用用户输入的后端 IP。
- `frontendMode: "cluster"`：前端集群版标识，隐藏 IP 输入框，登录时使用 `apiBaseUrl`。
- `deploymentMode`：兼容旧字段；未配置 `frontendMode` 时才读取。
- `requireServerIp`：可选强制覆盖项；配置后优先级高于 `frontendMode`。
- `apiBaseUrl`：集群版使用的后端地址；为空时使用当前前端域名。
- `deploymentConfigPath`：后端部署配置接口。页面会读取后端部署标识，但登录页展示由 `frontendMode` 决定。
- `defaultBackendPort`：用户只输入 IP 时自动补充的后端端口。
- `loginPath`：登录接口，默认对接后端 `POST /api/login`。
- `captchaPath`：验证码接口，默认对接后端 `GET /captchaImage`。

单机版示例：

```js
window.VISITOR_LOGIN_CONFIG = {
  frontendMode: "standalone",
  defaultBackendPort: "9098",
  loginPath: "/api/login",
  captchaPath: "/captchaImage"
};
```

集群版示例：

```js
window.VISITOR_LOGIN_CONFIG = {
  frontendMode: "cluster",
  apiBaseUrl: "http://localhost:9098",
  deploymentConfigPath: "/api/deployment/config",
  loginPath: "/api/login",
  captchaPath: "/captchaImage"
};
```

登录页会写入以下本地标识，供其它前端页面读取：

- `visitor_admin_frontend_mode`：`standalone` 或 `cluster`
- `visitor_admin_require_server_ip`：是否需要输入 IP
- `visitor_admin_backend_deployment_mode`：后端返回的部署模式
- `visitor_admin_middle_platform_enabled`：后端集群模式下是否对接中台

后端对应配置在 `ruoyi-admin/src/main/resources/application-*.yml`：

```yml
ruoyi:
  deploymentMode: standalone # standalone单机版 cluster集群版
  middlePlatformEnabled: false # 集群版是否对接中台
```

## 命令

```bash
npm run dev
npm run build
```

- `npm run dev`：启动本地静态服务。
- `npm run build`：复制静态资源到 `dist`。

## 页面

- `index.html`：登录页，登录成功后跳转 `pages/dashboard.html`。
- `pages/dashboard.html`：首页数据看板，当前使用 `js/dashboard.js` 内的静态数据，后续接口接入时替换数据加载逻辑。
- 首页右上角菜单：
  - 账号设置：`GET /system/user/profile`、`PUT /system/user/profile`
  - 重置密码：`PUT /system/user/profile/updatePwd`
  - 退出登录：`POST /logout`

## 目录结构

```text
visitor-admin-ui/
  index.html          # 登录入口
  pages/              # 业务页面 HTML
  css/                # 页面样式
  js/                 # 页面脚本和配置
  assets/             # 图片等静态资源
  scripts/            # 构建脚本
  logs/               # 本地服务日志
  dist/               # npm run build 输出
```

本地 `server.js` 会兼容旧业务页路径，例如 `/dashboard.html` 会回退读取 `pages/dashboard.html`。修改 `server.js` 后需要重启 dev server 才能让兼容逻辑生效。