# 沃尔核材智能电子秤

面向生产现场 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`