88 lines
2.2 KiB
Markdown
88 lines
2.2 KiB
Markdown
# 沃尔核材智能电子秤
|
||
|
||
面向生产现场 Android 终端的横屏智能称重应用。应用完成废料选择、人员与机台确认、连续稳定采样、称重记录上传、本地备份和异常补传。
|
||
|
||
## 主要功能
|
||
|
||
- 首页选择废铜、废电线、废铝或废锡，Type ID 默认为 3、4、5、6。
|
||
- 从本地服务器读取门禁人员和生产机台数据。
|
||
- 通过 WebSocket 连续读取电子秤重量，支持 kg、g、lb 单位切换。
|
||
- 支持清零、去皮、累计和取消上一次累计。
|
||
- 重量稳定后提交记录；网络异常时写入本地备份和补传队列。
|
||
- 管理员可维护废料字典、设备信息、接口地址、语言和密码。
|
||
- 预留 USB 摄像头拍照与打印机触发点。
|
||
- 支持开机自启动、系统设置、文件管理、实时日志和日志导出。
|
||
|
||
## 正式数据接口
|
||
|
||
应用不包含人员、机台或重量模拟数据。接口未配置或不可用时，界面会显示错误并保留在安全等待状态。
|
||
|
||
### 人员接口
|
||
|
||
返回 JSON：
|
||
|
||
```json
|
||
{
|
||
"name": "员工姓名",
|
||
"employeeId": "员工工号"
|
||
}
|
||
```
|
||
|
||
### 机台接口
|
||
|
||
可返回字符串数组，或包含 `machines` 的对象：
|
||
|
||
```json
|
||
{
|
||
"machines": [
|
||
{ "id": "机台号", "name": "机台名称" }
|
||
]
|
||
}
|
||
```
|
||
|
||
### 电子秤接口
|
||
|
||
使用 WebSocket。支持纯数字或 JSON 消息：
|
||
|
||
```json
|
||
{ "weight": 2490, "unit": "g" }
|
||
```
|
||
|
||
内部统一换算为 kg。支持 `weightKg`、`weight`、`value` 字段和 `kg`、`g`、`lb` 单位。
|
||
|
||
### 上传接口
|
||
|
||
使用 HTTP POST，内容类型为 `application/json`，字段包括员工、机台、废料、重量和称重时间。
|
||
|
||
## 本地目录
|
||
|
||
- 图片：`/sdcard/smart/image/`
|
||
- 称重备份：`/sdcard/smart/cache/`
|
||
- 运行及导出日志：`/sdcard/smart/logs/`
|
||
|
||
## 开发与测试
|
||
|
||
要求 Node.js 22 或更高版本、pnpm、Android SDK 和 JDK 21。
|
||
|
||
```bash
|
||
pnpm install
|
||
pnpm test
|
||
pnpm run lint
|
||
```
|
||
|
||
Android Web 资源检查与打包：
|
||
|
||
```bash
|
||
cd android-app
|
||
pnpm install
|
||
pnpm exec tsc --noEmit
|
||
pnpm run build:web
|
||
pnpm exec cap copy android
|
||
cd android
|
||
./gradlew test assembleDebug
|
||
```
|
||
|
||
调试 APK 输出位置：
|
||
|
||
`android-app/android/app/build/outputs/apk/debug/app-debug.apk`
|