# nameplate

**Repository Path**: lyping/nameplate

## Basic Information

- **Project Name**: nameplate
- **Description**: 设备铭牌制作工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FRTS 铭牌工作室

> 四川法瑞检测设备有限公司燃烧测试设备铭牌的设计、记录与生产文件输出系统。

**关键词**：铭牌设计、铭牌生成、DXF 激光打标、PNG 高清印刷、Go 本地应用、设备铭牌、燃烧测试、FRTS、法瑞检测

---

## 项目简介

FRTS 铭牌工作室是一套面向生产现场的铭牌管理工具，以**本地 Web 服务**形式运行，用浏览器操作，不依赖互联网或数据库。它能够：

- 集中管理每台燃烧测试设备的铭牌档案（建档、修改、复制、检索）
- 以毫米为单位精准渲染 80 × 60 mm 铭牌版面
- 一键导出**高精度 PNG**（150 / 300 / 600 DPI）和**可激光打标 DXF**

程序是单个可执行文件（约 25 MB），内嵌网页前端与中文字体，双击即可启动，无需安装 Node.js、数据库或任何额外运行时。

---

## 主要功能

| 功能 | 说明 |
|------|------|
| 铭牌档案管理 | 新建、保存、修改、删除、复制；按名称 / 型号 / 编号全文检索 |
| 实时预览 | 编辑时右侧实时渲染，所见即所得 |
| PNG 导出 | 150 / 300 / 600 DPI 或自定义（72～600），写入 `pHYs` 物理分辨率块，置入排版软件无需手动换算尺寸 |
| DXF 导出（轮廓模式） | 将中文字形转为 `LWPOLYLINE` 封闭轮廓，接收端无需安装字体，直接导入激光打标机 |
| DXF 导出（文字实体模式） | 输出 DXF `TEXT` 实体，文件更小，便于在 CAD 中继续编辑 |
| 图层控制 | 外框 / 分隔线 / Logo / 公司信息 / 固定标签 / 设备参数 / 辅助线，可单独开关 |
| Logo 上传 | 支持 SVG（可转 DXF 矢量轮廓）和透明 PNG（仅印刷用） |
| JSON 持久化 | 原子写入 + 自动备份，支持手动导入恢复，数据不丢失 |
| 企业信息保护 | 公司名称 / 网址 / 电话默认锁定，需要管理员解锁才能修改 |

---

## 版本与环境

| 项目 | 信息 |
|------|------|
| 当前版本 | 1.0.0 |
| Go 最低版本 | 1.22 |
| 目标平台 | Windows AMD64（主力）/ Windows ARM64 / Linux |
| 运行依赖 | 无（纯 Go 标准库，无第三方模块） |
| 嵌入字体 | Noto Sans SC Regular（SIL OFL 1.1） |
| 铭牌尺寸 | 80 × 60 mm（宽高比 4:3） |
| 默认端口 | 8787（仅本机回环，`127.0.0.1`） |

---

## 快速开始

### Windows 日常使用（无需 Go 环境）

1. 从发布包取得 `FRTS-Nameplate-Studio.exe` 与 `Start-Nameplate-Studio.bat`
2. 双击运行 `Start-Nameplate-Studio.bat`
3. 浏览器自动打开 `http://127.0.0.1:8787`
4. 关闭服务：关闭弹出的控制台窗口，或在窗口内按 `Ctrl+C`

> 数据保存在程序旁的 `data/plates.json`，请定期备份该文件。

### 开发模式运行

需要 [Go 1.22+](https://go.dev/dl/)。

```bash
# 直接运行（默认监听 127.0.0.1:8787，数据写入 data/plates.json）
go run ./cmd/frts-nameplate-studio

# 自定义地址与数据路径
go run ./cmd/frts-nameplate-studio -addr 127.0.0.1:8787 -data D:/FRTS-Nameplate/plates.json
```

浏览器访问 `http://127.0.0.1:8787` 即可使用。

### 编译发布版

**Windows**

```bat
build-windows.bat
```

编译完成后，`dist/` 目录下生成：
- `FRTS-Nameplate-Studio.exe`（AMD64）
- `FRTS-Nameplate-Studio-arm64.exe`（ARM64，可选）
- `Start-Nameplate-Studio.bat`
- `README.md`、`docs/`、`samples/`

**Linux**

```bash
chmod +x build-linux.sh
./build-linux.sh
```

---

## 目录结构

```
nameplate/
├── cmd/
│   ├── frts-nameplate-studio/   # 主程序入口
│   └── gen-samples/             # 验收样例生成工具
├── internal/
│   ├── api/                     # HTTP API 路由与处理
│   ├── assets/                  # 嵌入资源（字体、Logo）
│   ├── dxf/                     # DXF 文件生成
│   ├── export/                  # 导出文件命名规则
│   ├── fontkit/                 # TrueType 字体解析与字形提取
│   ├── layout/                  # 毫米布局计算（预览/PNG/DXF 同源）
│   ├── model/                   # 数据模型（Plate、Settings）
│   ├── raster/                  # PNG 光栅化渲染
│   ├── store/                   # JSON 数据持久化
│   └── svgpath/                 # SVG 路径解析（Logo 轮廓提取）
├── web/                         # 前端（HTML + CSS + 原生 JS，go:embed 打包）
├── assets/                      # 源字体与 Logo（供开发使用）
├── docs/                        # 用户文档
├── samples/                     # 验收样例输出（PNG + DXF）
├── data/                        # 运行时铭牌数据（gitignore）
├── dist/                        # 编译发布输出（gitignore）
├── build-windows.bat            # Windows 一键编译脚本
├── build-linux.sh               # Linux 一键编译脚本
└── start-windows.bat            # Windows 启动脚本
```

---

## HTTP API 一览

服务启动后，以下端点可供程序内部或自动化脚本调用：

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/health` | GET | 健康检查，返回版本与启动时间 |
| `/api/settings` | GET / PUT | 企业通用信息（公司名、网址、电话、Logo 开关） |
| `/api/plates` | GET / POST | 铭牌列表查询 / 新建铭牌 |
| `/api/plates/{id}` | GET / PUT / DELETE | 单条铭牌读取 / 更新 / 删除 |
| `/api/preview.png` | GET | 铭牌实时预览图（低分辨率） |
| `/api/export/png` | GET | PNG 导出（参数：`id`、`dpi`） |
| `/api/export/dxf` | GET | DXF 导出（参数：`id`、`mode`、`layers` 等） |
| `/api/logo` | GET / PUT / DELETE | Logo 图片上传与管理 |
| `/api/backup` | GET / POST | 数据备份下载 / 导入恢复 |

---

## 铭牌字段说明

| 字段 | 最大长度 | 说明 |
|------|----------|------|
| 记录名称 | 100 字 | 内部检索用，不印在铭牌上 |
| 公司名称 | 100 字 | 默认锁定 |
| 公司网址 | 120 字 | 默认锁定 |
| 联系电话 | 40 字 | 默认锁定 |
| 设备名称 | 100 字 | 印在铭牌显著位置 |
| 设备型号 | 80 字 | |
| 出厂年月 | 40 字 | |
| 设备编号 | 80 字 | |
| 设备功率 | 80 字 | |
| 设备用气条件 | 160 字 | |
| 设备排烟条件 | 160 字 | |
| 执行标准 | 100 字 | |
| 备注 | 300 字 | |

---

## 导出规格

### PNG

- 物理尺寸固定 80 × 60 mm，DPI 决定像素数
- 300 DPI：945 × 709 px，约 2.6 MB RGBA 缓冲
- 600 DPI：1890 × 1417 px，约 10.2 MB RGBA 缓冲
- 写入 `pHYs` 块，排版软件（InDesign / CorelDRAW 等）自动识别物理尺寸

### DXF

- 单位：毫米（`$INSUNITS=4`，`$MEASUREMENT=1`）
- 坐标原点在铭牌左下角，Y 轴向上
- 范围：(0,0) ～ (80,60)
- 轮廓模式：贝塞尔曲线默认按弦高 0.05 mm 细分

---

## 印刷建议

- 常规面板印刷：**300 DPI**
- 精细小字 / 高精度印刷：**600 DPI**（内存占用更高）
- 激光打标：使用 DXF **文字转轮廓**模式
- 置入排版软件时，以 PNG 的 80 × 60 mm 物理尺寸导入，**不要二次拉伸**

---

## 文档

| 文档 | 内容 |
|------|------|
| [使用说明](docs/使用说明.md) | 界面操作、编辑、导出全流程 |
| [PVC 印刷配色规范](docs/PVC印刷配色规范.md) | 每个颜色的 CMYK 值与 Pantone 色号、工艺约束 |
| [数据备份与恢复](docs/数据备份与恢复.md) | plates.json 的备份策略与导入方法 |
| [DXF 字体与转轮廓说明](docs/DXF字体与转轮廓说明.md) | 两种 DXF 模式详解、图层说明 |
| [第三方依赖及许可证](docs/第三方依赖及许可证.md) | 字体许可证（OFL-1.1）声明 |
| [测试报告](docs/测试报告.md) | 单元测试与验收样例说明 |

---

## 生成验收样例

```bash
go run ./cmd/gen-samples ./samples
```

将在 `samples/` 目录下生成 PNG（300 DPI、600 DPI）和 DXF 文件，以及 `CHECK-REPORT.md` 质检报告。

---

## 企业信息

| 项目 | 信息 |
|------|------|
| 公司 | 四川法瑞检测设备有限公司 |
| 品牌 | FRTS |
| 网址 | [www.firets.com](http://www.firets.com) |
| 电话 | 18281912988 |

---

## 许可证与版权

- **程序源代码**：四川法瑞检测设备有限公司内部使用
- **嵌入字体 Noto Sans SC**：[SIL Open Font License 1.1](assets/fonts/OFL.txt)，允许嵌入与再分发，不得单独售卖字体文件
- **品牌 Logo**：四川法瑞检测设备有限公司版权所有，仅供本程序铭牌输出使用