V1.0: Class 1 fax — real-world 4-page send to external number confirmed

Core features:
- Class 1 T.30 protocol: full send/receive implementation
- HDLC: DLE-stuffing, FCS strip, USR5637 bit-reversal handling
- T.4 MH encoder/decoder (1728px A4 standard)
- Document pipeline: PDF (Ghostscript), PNG, TIFF input
- Width clamping: US Letter 1734px → 1728px fax standard
- Cover page: CJK rasterization (TW/CN/JP/EN), TIFF + HTML output
- OCR verification: Tesseract 5 with eng+chi_tra, CJK space-tolerant
- API server (axum): health, send, jobs, cover, retry, cancel
- Background worker: auto-poll queue, speed fallback, retry policy
- Modem detection, pool management

Real-world test results (2026-07-23):
- V90 → 25153038: 4 pages, V.17 12000 bps, 2:33 ✅
- USR5637 → 25153038: 4 pages, V.17 12000 bps, 2:26 ✅
- Both faxes confirmed received on remote machine

Tested: loopback (100% pixel match), multi-page, all input formats,
cover pages, OCR verify, API endpoints, worker processing.
13 unit tests pass, 0 new clippy warnings.
This commit is contained in:
Warren
2026-07-24 18:47:15 +08:00
parent d1e92b32fb
commit 55bca92691
155 changed files with 25024 additions and 916 deletions
+174
View File
@@ -0,0 +1,174 @@
# Phase 3 进度报告
## 已完成:通讯录功能(Address Book)
### 1. 数据库设计 ✅
**通讯录表结构:**
```sql
CREATE TABLE contacts (
id TEXT PRIMARY KEY,
name TEXT NOT NULL,
fax_number TEXT NOT NULL,
company TEXT,
email TEXT,
phone TEXT,
category TEXT,
notes TEXT,
is_favorite INTEGER DEFAULT 0,
created_at TEXT NOT NULL,
updated_at TEXT NOT NULL
)
```
**群组表结构:**
```sql
CREATE TABLE groups (
id TEXT PRIMARY KEY,
name TEXT NOT NULL,
description TEXT,
color TEXT,
created_at TEXT NOT NULL,
updated_at TEXT NOT NULL
)
```
**联系人-群组关联表:**
```sql
CREATE TABLE contact_groups (
contact_id TEXT NOT NULL,
group_id TEXT NOT NULL,
PRIMARY KEY (contact_id, group_id),
FOREIGN KEY (contact_id) REFERENCES contacts(id) ON DELETE CASCADE,
FOREIGN KEY (group_id) REFERENCES groups(id) ON DELETE CASCADE
)
```
---
### 2. API 端点 ✅
**联系人管理:**
- `POST /api/v1/contacts` - 创建联系人
- `GET /api/v1/contacts` - 列出联系人(支持搜索和分类)
- `GET /api/v1/contacts/:id` - 获取联系人详情
- `PUT /api/v1/contacts/:id` - 更新联系人
- `DELETE /api/v1/contacts/:id` - 删除联系人
**群组管理:**
- `POST /api/v1/groups` - 创建群组
- `GET /api/v1/groups` - 列出群组
- `GET /api/v1/groups/:id` - 获取群组详情
- `PUT /api/v1/groups/:id` - 更新群组
- `DELETE /api/v1/groups/:id` - 删除群组
- `GET /api/v1/groups/:id/contacts` - 获取群组内的联系人
**群组关系管理:**
- `POST /api/v1/contacts/:contact_id/groups/:group_id` - 添加联系人到群组
- `DELETE /api/v1/contacts/:contact_id/groups/:group_id` - 从群组移除联系人
---
### 3. 核心功能 ✅
**联系人属性:**
- ID(UUID)
- 姓名
- 传真号码
- 公司
- 电子邮件
- 电话
- 分类
- 备注
- 收藏标记
- 创建时间
- 更新时间
**群组属性:**
- ID(UUID)
- 名称
- 描述
- 颜色标记
- 创建时间
- 更新时间
**高级功能:**
- 搜索联系人(姓名、传真号码、公司、电子邮件)
- 分类管理
- 群组批量发送
- 收藏标记
---
## 下一步:Web UI 实现
### 待实现页面
1. **通讯录页面(AddressBook.vue)**
- 联系人列表视图
- 搜索和筛选
- 分类管理
- 收藏标记
2. **联系人详情页(ContactDetail.vue)**
- 查看和编辑联系人
- 群组归属
- 发送传真快捷方式
3. **群组管理页(Groups.vue)**
- 群组列表
- 群组详情和成员
- 批量发送传真
---
## 技术栈
**后端:**
- Rust + Rusqlite
- Axum REST API
- UUID + Chrono
**前端(计划):**
- Vue 3 + TypeScript
- Tailwind CSS
- Axios API 客户端
---
## 编译状态
✅ **编译成功**
```
Finished `dev` profile [unoptimized + debuginfo] target(s) in 3.98s
```
---
## 文件清单
**后端代码:**
- `src/address_book/mod.rs` - 模块导出
- `src/address_book/contact.rs` - 联系人数据结构
- `src/address_book/group.rs` - 群组数据结构
- `src/address_book/store.rs` - SQLite 存储实现
- `src/api/address_book_routes.rs` - REST API 端点
**配置:**
- 已集成到 `src/lib.rs`
- 已导出到 `src/api/mod.rs`
---
## 评分改进预测
**当前评分:93/150**
- 遠端操作:36/40 ✅
- 轉檔預覽:28/30 ✅
- 存檔日誌:24/30 ✅
- **通訊錄:4/20 → 预计提升至 12/20** ⚠️ 进行中
- Email連結:5/30 ⚠️ 待实现
**通讯录完成后预计评分:101/150**
**Email整合后预计评分:111/150(第二名)**