泰国定位手环程序

# 泰国定位手环程序

## 目的

本文档仅列出在运行 smartband-controlcenter 可执行文件之前，Windows 目标机器上**必须存在/已配置**的项目。

## 应用运行时所依赖的密钥与配置摘要

- 应用从可执行文件所在目录（或向上两层父目录）的 `.env` 文件中读取 API 服务器地址（`API_ENDPOINT`）。`.env` 仅用于配置 API 地址。
- 应用从 **Windows Credential Manager**（凭据管理器）读取 API 密钥（用于对 API 请求签名），凭据类型为 **Generic Credential**，目标名称为：`smbcc`
- 应用从 **Windows Credential Manager** 读取 MySQL 凭据（用户名和密码），凭据类型为 **Generic Credential**，目标名称为：`smbcc-mysql`
- 数据库主机/端口/库名（`db_ip`、`db_port`、`db_name`）不存储在本地，而是在启动时由 API（控制中心设置）返回。应用会先向 API 请求这些值，然后使用凭据管理器中的 MySQL 用户名/密码进行连接。

## 目标 PC 所需的软件

1. **Windows 10 / 11**（自带 Credential Manager）
2. **Microsoft .NET Framework 4.8**（桌面运行时）已安装并启用
   - 如未安装，请从 Microsoft 下载：https://dotnet.microsoft.com/zh-cn/download/dotnet-framework/net48
3. PC 与 `.env` 中配置的 API 端点之间的**网络连通性**
4. PC 需能访问 API 返回的 MySQL 服务器（网络/防火墙规则）——应用将尝试通过 API 返回的 `db_ip` 和 `db_port` 进行连接。

## 需放置在可执行文件旁边的文件

- `.env`（纯文本）——必须至少包含 `API_ENDPOINT`

## `.env` 放置位置

- 将名为 `.env` 的文件放在与应用程序可执行文件（`.exe`）相同的目录下。如果在可执行文件目录中未找到，应用也会向上查找父目录及父目录的父目录。

## 最小 `.env` 示例

```
API_ENDPOINT=https://th.melands.cn/api
```

## 需要添加的 Windows Credential Manager 条目

需添加两条 **Generic Credential**（通用凭据）（路径："Windows Credentials" → "Add a generic credential"），目标名称必须严格如下。代码中会精确匹配这些目标名称。

### 1) API 密钥凭据

- **目标名称（Internet or network address）**：`smbcc`
- **用户名**：可选（不会使用）。可留空或设置一个描述性的用户名。
- **密码**：`<API 密钥字符串>`

### 2) MySQL 凭据

- **目标名称（Internet or network address）**：`smbcc-mysql`
- **用户名**：`<MySQL 用户名>`（泰国当前用户名 `ldwh`）
- **密码**：`<MySQL 密码>`

## 收银系统后台参数

泰国数据库IP (db_ip) `10.103.100.2`
```
{
  "control-center":{
    "db_ip":"xxx.xxx.xxx.xxx",
    "db_port":3306,
    "db_name":"ldwh",
    "id":1678
  }
}