医疗旅游报告生成器 — 整改细则

当前状态

仓库:qzw-alt/chinahospitalsguide 入口脚本:scripts/generate-report.js

用法

# 基础版 ¥49
node scripts/generate-report.js --name "Carlos Mendoza" --case "knee replacement" --city Beijing --basic

# 升级版 ¥399
node scripts/generate-report.js --name "Carlos Mendoza" --case "knee replacement" --city Beijing --premium

已实现功能

参考模板(既定格式)


一、数据源扩展

当前 CSV 字段不足以支持模板中的所有内容,需要扩展:

1.1 扩展 CSV 增加字段

文件: data/hospital-directory-51.csv

需要增加的字段:

Email,          # 国际部邮箱(如 tangdu_foreign@fmmu.edu.cn)
Intl_Phone,     # 国际部专线(如 029-84777502)
Intl_LeadTime,  # 国际部预约提前量(如 "7-15天")
Intl_Services,  # 国际部服务内容(如 "外国患者接待、中英双语翻译、VIP病房")
Price_Range,    # 该院参考价格范围(如 "$6,300 - $8,500")
Price_Note,     # 价格说明(如 "不含住院费")
Has_Email,      # 是否有邮箱(True/False)

如果暂时无法收集全部,至少补充:

1.2 医院个性化描述数据

模板中每家医院有一段"一句话性格"描述,如:

💬 "军队医院出身能打硬仗——胸外科全军第一,胡桃夹综合征3D支架全国独家"

当前脚本的 generateOneLiner() 函数只根据排名返回通用描述(如 "Top-tier specialized hospital in China"),太敷衍。

建议方案: 在脚本中创建一个 HOSPITAL_DESCRIPTIONS 对象,包含每家医院的中文一句话描述和详细推荐理由:

const HOSPITAL_DESCRIPTIONS = {
  "jishuitan-hospital": {
    oneLiner: "中国骨科"国家队"——关节置换手术年量全球领先,膝髋关节置换是王牌",
    whyRecommend: [
      "全中国骨科排名第一,专门做关节置换已有60年历史",
      "每年膝关节置换手术超过5,000例——每天约15台",
      "该院拥有国际化的关节置换中心"
    ]
  },
  // ... 每家医院
};

二、基础版(¥49)缺失内容

2.1 医院卡片增加"为什么推荐"板块

位置: 每张医院卡片的信息表下方

模板参考:

#### 为什么推荐这家医院:
- 胸外科全国第6、全军第1,神经外科和骨科也是顶级水准
- 胡桃夹综合征 3D 打印支架手术——全国独家技术之一
- 费用参考:3D支架植入术 ¥45,000-60,000
- 国际部已接待多位国际患者,服务流程成熟

当前实现: 只有信息表和费用参考,没有"为什么推荐"板块。

实现方案:HOSPITAL_DESCRIPTIONS 中加入 whyRecommend 数组,渲染到医院卡片中。

2.2 医院卡片增加国际部联系信息

模板参考:

| **国际部** | ✅ 有(双语协调员)|

当前实现: 只显示 "🌐 国际部" 标记。

改进: 增加国际部详情行(如果有数据),显示邮箱/专线电话。

2.3 升级服务增加"费用抵扣"说明

模板参考:

### Q: 我可以先买 $49,后续再升级吗?
可以。$49 的费用可以抵扣升级费用,你只需补差价即可。

当前实现: FAQ 中没有这个问题。

改进: FAQ 中增加此问题。


三、升级版(¥399)缺失内容

3.1 客户情况概要表格

模板参考:

| 项目 | 内容 |
|------|------|
| **姓名** | [客户姓名] |
| **国籍** | [国家] |
| **诊断** | [病情诊断] |
| **主要需求** | [治疗目标] |
| **偏好城市** | [城市偏好,如有] |
| **预算范围** | [预算] |
| **就诊时间** | [预计时间] |

当前实现: 完全没有。

实现方案:

3.2 升级版医院深度信息

模板中每家医院包含以下额外信息(基础版没有):

3.2.1 国际部联系详情表格

| 方式 | 信息 |
|------|------|
| 📞 **电话** | 029-84777502 |
| 📧 **邮箱** | tangdu_foreign@fmmu.edu.cn |
| ⏰ **预约提前量** | 建议提前7-15天 |
| 🌐 **服务内容** | 外国患者接待、中英双语翻译 |

需要数据支持(Email/Intl_Phone/Intl_LeadTime)

3.2.2 费用明细表格

| 项目 | 参考价格 | 折合美元 |
|------|---------|---------|
| **手术费** | ¥45,000-60,000 | $6,300-$8,500 |
| **住院费(5-7天)** | ¥10,000-15,000 | $1,400-$2,100 |
| **术前检查** | ¥5,000-8,000 | $700-$1,100 |
| **合计参考** | ¥60,000-83,000 | $8,400-$11,600 |
| 对比:美国同类手术 | | $40,000-80,000 |

当前只有一行"中国约 $8,000-$12,000",太粗。

实现方案: 创建 PRICE_BREAKDOWN 数据对象按病种和城市给出明细。

3.2.3 周边生活指南

| 项目 | 说明 |
|------|------|
| **附近住宿** | 步行5-15分钟有快捷酒店和短租公寓 |
| **饮食** | 周边有清真餐厅、西北风味 |
| **陪护家属** | 月租公寓约¥2,000-3,000/月 |
| **通信** | 医院和酒店WiFi可访问海外网站 |
| **旅游** | 术后可游览景点建议 |

实现方案: 创建 CITY_LIFESTYLE_GUIDES 对象,按城市给出标准内容。

3.2.4 "需要留意的地方"板块

我们不说假话——这家医院不是适合所有人:
- 国际部接待能力有限,不适合紧急情况
- 西安的国际航班比北京/上海少
- 如果病情复杂需要多科室会诊,北京可能更合适

实现方案:HOSPITAL_DESCRIPTIONS 中加入 watchOut 数组。

3.3 三家医院对比一览表

模板参考:

| 对比项 | 🥇 首选 | 🥈 备选 | 🥉 第三选择 |
|--------|---------|---------|-----------|
| **城市** | 西安 | 北京 | 成都 |
| **定位** | 专科精专 | 心血管国家队 | 综合全能 |
| **费用水平** | 中等 | 较高 | 中等 |
| **国际部** | ✅ 有 | ✅ 有 | ✅ 有 |
| **适合人群** | 追求性价比 | 追求权威 | 需多科室会诊 |

当前实现: 完全没有。

实现方案: 动态生成对比表,数据来自各家医院的描述信息。

3.4 "为什么选择我们"对比表

模板参考:

| 场景 | 自己联系医院 | 通过我们 |
|------|------------|---------|
| **语言沟通** | 自己发英文邮件 | 我们帮你翻译、跟进 |
| **选哪家医院** | 自己网上查 | 我们从51家里筛 |
| **遇到问题** | 自己想办法 | 有人帮你协调 |
| **回国后** | 医生可能不记得你 | 完整档案和随访通道 |

当前实现: 完全没有。

实现方案: 纯静态内容,创建 generateWhyUs() 函数。

3.5 关于我们板块

模板参考:

| 项目 | 内容 |
|------|------|
| **网站** | chinahospitalsguide.com |
| **覆盖范围** | 10个城市、51家医院 |
| **服务内容** | 医院推荐、就诊协调、行前指导、远程随访 |

当前实现: 只有页脚。

改进: 升级版在 FAQ 后增加"关于我们"卡片。


四、页面优化

4.1 页头中文化

当前页头标签还是英文:

PATIENT | CONDITION | CITY | MATCHED | REPORT DATE

改为中文:

患者 | 病症 | 城市 | 匹配数 | 报告日期

4.2 按钮文字统一

顶部工具栏按钮仍为英文:

🖨️ Print / PDF
📥 Download Full Report

改为中文:

🖨️ 打印 / PDF
📥 下载完整报告

五、修复已知 Bug

5.1 未使用的 CSS 类清理

当前 CSS 中仍有旧版价格区域的类:

.price-row{...}
.price-box{...}
.price-save-wrap{...}
.save-badge{...}

这些不再被 HTML 使用,可删除。


六、文件结构

本次改动集中在:

文件说明
scripts/generate-report.js主生成器,全部内容修改
data/hospital-directory-51.csv如需扩展字段
report-*.html重新生成的样本报告

注意: 生成报告后,复制到网站根目录的旧文件名覆盖(report-carlos-mendoza-1782619281101.htmlreport-carlos-mendoza-1782619281172.html),然后 git push


七、参考数据

城市数据(已存在于脚本中)

TRANSPORT_GUIDES 对象覆盖以下城市: Beijing, Shanghai, Guangzhou, Shenzhen, Chengdu, Xi'an, Hangzhou, Tianjin, Nanjing, Jinan

需要扩展为 CITY_LIFESTYLE_GUIDES,包含住宿、饮食、陪护、通信、旅游信息。

医院分类描述

需要创建的 HOSPITAL_DESCRIPTIONS 至少覆盖当前 CSV 中的 51 家医院。 最低要求:前 20 家常用医院有完整描述。


优先级排序

优先级任务预计工时
P0下载按钮修复(已修复)-
P0价格区域 CSS 修复(已修复)-
P1页头/按钮中文化15min
P1医院卡片增加"一句话性格"真实描述1-2h
P1升级版增加客户情况概要表格30min
P1升级版增加三家医院对比表30min
P2升级版增加"为什么选择我们"对比表20min
P2升级版增加"关于我们"板块10min
P2医院卡片增加"为什么推荐"板块1h
P3升级版医院深度信息(国际部联系、费用明细、生活指南、注意项)2-3h
P3费用明细表格1h
P3扩展 CSV 数据1-2h
P4CSS 无用类清理10min

以上就是完整的整改细则。核心思路:让生成器输出的 HTML 页面内容,跟 hospital-directory-basic-49.mdhospital-directory-premium-399.md 两个模板的结构完全一致。