# 市民请集合智能助手

这是给 `smqjh-cloud` 管理端准备的 Windows 桌面智能助手初始框架。当前阶段先把 exe 项目的外壳、对话界面、配置、登录、任务注册表、运行日志和预演模式搭好，管理员操作需求确定后再逐个接真实接口。

## 技术选型

- Electron + React + TypeScript
- 对话优先界面，接近 Codex 的“对话 + 工具确认 + 日志上下文”形态
- 应用名称和 exe 产品名：`市民请集合智能助手`
- 应用图标来自 `src/renderer/assets/logo.png`，Windows 打包图标为 `build/icon.ico`
- 后端对接 `smqjh-cloud` 测试环境网关，默认 `http://192.168.1.242:8080`
- OAuth 后台客户端默认 `mall-admin / 123456`
- 打包工具 `electron-builder`

## 目录

```text
src/main      Electron 主进程、配置、OAuth、任务执行器
src/renderer  管理员工作台 UI
src/shared    主进程与页面共享类型
docs          架构和需求收集文档
scripts       本地构建脚本
```

## 本地启动

```powershell
npm install
npm run dev
```

## 构建 exe

便携版 exe：

```powershell
npm run dist
```

安装包：

```powershell
npm run dist:installer
```

产物会输出到 `release/`。

## 当前已接入的接口线索

- `POST /smqjh-auth/oauth2/token`
- `GET /smqjh-auth/api/v1/auth/captcha`
- `GET /smqjh-system/api/v1/users/me`
- `POST /smqjh-system/api/v1/member/export/task/start`
- `GET /smqjh-system/api/v1/pointsRecharge/exportTemplate`
- `GET /smqjh-system/api/v1/members/enterprise/getByMobile`

## 测试环境

- 网关：`http://192.168.1.242:8080`
- Nacos：`http://192.168.1.242:8848/nacos`
- 命名空间：`public`
- 网关路由：`/smqjh-auth/**`、`/smqjh-system/**`、`/smqjh-pms/**`、`/smqjh-oms/**`

## 下一步

1. 补齐管理员常用操作清单。
2. 给每个操作标注接口、权限、参数、是否需要审批。
3. 把危险操作继续保持预演模式，确认回滚策略后再开放真实执行。