# harmony-doc

**Repository Path**: unnoc/harmony-doc

## Basic Information

- **Project Name**: harmony-doc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 医生工作站 · 开发文档索引

本目录收录医生工作站（iOS 端 `scaffold-doc`）的功能、设计与 IM 规格，用于跨端（Android / 鸿蒙）开发交接。

## 鸿蒙 1:1 开发（当前重点）

| 文档 | 内容 |
| --- | --- |
| `harmonyos-dev.md` | 功能与架构：技术栈对照、工程结构、启动/导航、环境配置、网络层兼容（多命名 JSON + 401 并发刷新）、核心接口清单、DTO 字段多命名容错、页面状态机、分页、鸿蒙映射 |
| `harmonyos-ui.md` | UI 设计规格：精确色值（AppColor）、字体/圆角/间距、深色模式、公共组件与 ArkUI 等价实现、各页面 UI 规格、视觉禁用项、文案规范 |
| `harmonyos-im.md` | IM 与通话：聊天 REST API、消息 action 映射、历史分页、时间分隔、CIM 长连接、通话信令、TRTC 等价方案、去重/已读/撤回 |

> IM 文档的消息 action 映射以 `cim-message-action.md` 为权威来源。

## IM 权威参考

| 文档 | 内容 |
| --- | --- |
| `cim-message-action.md` | **IM 消息类型主文档**（action 分段、各类型字段、REST/RTC 接口、离线推送），消息类型以本文档为准 |
| `cim-message-action-simple.md` | 上述文档的精简版速查 |

## 其他

| 文档 | 内容 |
| --- | --- |
| `project-code-optimization-report.md` | 代码优化分析报告 |

## 一致性原则

跨端开发不是重新设计，而是按 iOS 当前代码的功能、接口、状态、分页、IM 行为 1:1 还原：

- 接口路径、参数、双 baseURL、响应/分页多命名兼容一致
- 图片短路径拼接 `resourceBaseURL + path` 一致
- 首页/工作台/我的三 Tab 一致；候诊筛选、未接诊不可发送一致
- 列表下拉刷新、上拉加载和分页一致
- 消息 action 映射和通话信令一致（以 `cim-message-action.md` 权威）
- 删除等危险操作使用自定义确认弹窗（确认按钮固定 danger 红）一致

### 与旧版 / 局部结论的重大差异（已在新文档中修正）

1. **环境地址**：`messageBaseURL = https://yuytech.top/prod-api`（非旧文档写的 `47.94.225.170:10000`）；主 `apiBaseURL = https://imdc.hbgdfy.com/api`；IM 走裸 TCP `47.94.225.170:9876`，**无 webSocketURL 字段**。
2. **IM action 映射**：以 `cim-message-action.md` 为准（1-12 / 20-31 / 100-115 / 200-206 / 901-998 / 999）；其中 `100`=通话记录、`101/102`=音视频邀请、`106`=已连接、`109`=挂断。iOS 曾把 `100` 硬编码成"语音通话"，鸿蒙需按 `extra.mediaType` 区分。
3. **按钮样式**：`AppButton` 实为 4 种（primary/secondary/**outline**/danger）。
4. **`AppUnderlineSelector` 实为胶囊分段控件**，非下划线。
5. **`ConfirmDialog` 确认按钮一律 danger 红**，与操作类型无关。
6. **`/api/device/bind` 等接口已声明但无业务调用点**（已声明未使用）。
7. **视觉禁用项**：无毛玻璃、默认无渐变、仅弱阴影。