# 风影随行通讯 · 手机端交接（Windows）

手机端以后只在你这台 Windows 上改、测、打包。Linux 主机只跑现网 OA/IM，不再当手机开发机。

工程已在桌面时，用文末 **CMD 增量拉取** 覆盖服务器上的新文件即可，本地多出来的文件（例如 `unpackage/`、自己改过但服务器没有的）不会被删。

---

## 1. 分工

| 在哪 | 干什么 |
|---|---|
| **Windows + HBuilderX** | 改页面、联调、真机、打 APK |
| **Linux / 现网** | `oa.fysxkj.com` 后端、权限、IM。手机只调接口 |

现网地址（`utils/config.js`）：

- OA：`https://oa.fysxkj.com`
- IM HTTP：`https://oa.fysxkj.com/im`
- IM WS：`wss://oa.fysxkj.com/im/websocket`

本地不用起后端、不用 npm、没有 `node_modules`。

---

## 2. 权限（不要写死）

工作台入口只认 `/auth/my-perms`，和 Web 权限中心同一套。

- 判断：`utils/perms.js` 的 `canMenu`
- 目录（只描述「有这个权限才显示」）：`utils/catalog.js`
- 登录后拉权：`utils/store.js` → `refreshPerms()` → `personalApps()` / `erpModules()`

谁看见打卡、审批、投标、人事，只由 Web 给这个人开的格子决定。不要按人名、岗位写死。

---

## 3. 工程结构

```
fysx-hbuilder/
  pages.json          路由 / 底栏
  manifest.json       HBuilder 打包配置
  App.vue / main.js
  pages/              页面（登录、消息、通讯录、打卡、工作台、我、聊天、审批、协同、ERP…）
  utils/              接口、权限、IM、申请单
  components/         顶栏
  static/tab/         底栏图标
  交接.md             本文件
```

常改：

| 文件 | 作用 |
|---|---|
| `pages/tabs/workbench.vue` | 工作台（权限过滤后的格子） |
| `pages/login/login.vue` | 登录 |
| `utils/store.js` | 会话、IM、打卡、审批 |
| `utils/api.js` | HTTP |
| `utils/im.js` | WebSocket |
| `utils/catalog.js` | 工作台/ERP 入口元数据 |
| `utils/perms.js` | 权限判断 |
| `utils/config.js` | 现网地址 |

---

## 4. HBuilderX 打开

1. 安装 [HBuilderX](https://www.dcloud.io/hbuilderx.html)（正式版）
2. 登录 DCloud 账号（云打包要用）
3. **文件 → 导入 → 从本地目录导入** → 选桌面上的 `fysx-hbuilder`
4. 若提示重新获取 `appid`，确定即可；应用名保持「风影随行通讯」

已导入过的，增量拉取后在 HBuilderX 里重新打开该目录即可，不必再导入一遍。

---

## 5. 开发 / 测试

**H5 快测：** 运行 → 运行到浏览器 → Chrome。现网账号登录。看登录、消息、工作台格子是否随权限变。H5 定位不准，打卡以真机为准。

**真机：** USB 开开发者选项 + 调试 → 运行到手机 → Android。打卡必须允许定位。

**换两个权限不同的人登录**，工作台格子应不一样。没「投标管理」的人不应看到投标入口。

---

## 6. 打包 APK

1. 发行 → 原生 App-云打包
2. Android，CPU 勾 `armeabi-v7a` + `arm64-v8a`
3. 证书：内测可用 DCloud 公共测试证书；上架再换自己的 keystore
4. 下载 APK 装到手机

打包产物在本机 `unpackage/`，增量拉取不会删它。

---

## 7. 什么时候才再碰 Linux

手机 UI / 打包：不用。

只有改后端接口、权限、IM 协议，或要把 APK 挂到现网下载页时才上服务器。

可选（Windows CMD，把打好的包挂现网）：

```bat
scp D:\你的包.apk root@47.96.23.244:/data/nexus-oa-erp/dist/downloads/android.apk
```

---

## 8. 验收清单

1. 登录（短信码仅服务端开启时出现）
2. 消息列表：工作通知 / 群 / 单聊，能发文字
3. 换账号后工作台入口不同
4. 无模块权限时 ERP 页提示无权限
5. 真机打卡能提交
6. 待办、请假/报销能走现网审批

---

## 9. 桌面增量拉取（CMD）

在 **Windows CMD** 执行。会下载最新包并解压覆盖桌面上的 `fysx-hbuilder`（只覆盖包里有的文件）。

```bat
cd /d %USERPROFILE%\Desktop && curl -L -o fysx-hbuilder.zip https://oa.fysxkj.com/downloads/fysx-hbuilder.zip && tar -xf fysx-hbuilder.zip
```

拉完打开：`%USERPROFILE%\Desktop\fysx-hbuilder`