使用指南 - Newsletter 管理系统

快速开始

打开主页

访问 index.html，系统会自动加载初始数据（首次使用时）

添加用户

进入「用户管理」标签，点击 ➕ 图标添加新用户

添加项目

进入「项目管理」标签，创建关联到用户的项目

导出数据

点击顶部「下载 JSON」按钮导出 newsletters.json 文件

用户管理

添加新用户

点击「用户管理」标签
点击右上角的 ➕ 图标展开表单
填写必填字段：
- 用户 ID：唯一标识符（如：sdu、ucl）
- 用户名称：显示名称或邮箱
- Logo URL：Logo 图片的网址
Logo 会自动预览显示
点击「保存用户」完成添加

编辑用户

在用户卡片上点击「编辑」按钮，修改信息后保存

删除用户

点击「删除」按钮，确认后删除（关联的项目不会被删除）

项目管理

添加新项目

点击「项目管理」标签
点击右上角的 ➕ 图标展开表单
填写项目信息：
- 项目标签：项目名称（必填）
- 关联用户：从下拉列表选择（必填）
- 状态 CSV URL：状态数据链接（必填）
- 点击 CSV URL：点击数据链接（必填）
- 联系数据 URL：可选
- 中文邮件内容 URL：可选
- 英文邮件内容 URL：可选
点击「保存项目」完成添加

提示：项目必须关联到已存在的用户。如果找不到需要的用户，请先在「用户管理」中添加。

数据导出与导入

查看 JSON

点击顶部的「查看 JSON」按钮，在弹窗中预览完整的 JSON 数据结构

可以直接复制到剪贴板或下载文件

编辑 JSON（高级功能）

点击顶部的「编辑 JSON」按钮，直接在文本编辑器中修改 JSON 数据

打开 JSON 编辑器，查看当前完整数据
直接编辑 JSON 文本（可以批量修改、添加、删除数据）
使用工具按钮：
- 格式化：自动美化 JSON 格式，便于阅读
- 验证：检查 JSON 语法和字段完整性
点击「保存并应用」
系统自动将 JSON 数据反向同步到用户和项目列表

注意：保存后会覆盖所有现有数据。建议在编辑前先备份数据。

下载 JSON

点击「下载 JSON」按钮，系统会生成 newsletters.json 文件并自动下载

文件内容包含所有用户和项目数据，格式化易读

导入数据

点击「导入数据」按钮
选择以下方式之一：
- 在文本框中粘贴 JSON 数据
- 点击「选择文件」上传 .json 文件
点击「导入」按钮
确认导入操作（会覆盖当前所有数据）

JSON 格式说明

标准格式

{
  "users": [
    {
      "id": "sdu",
      "name": "sduxk@sdu.edu.cn",
      "logoUrl": "https://example.com/logo.png",
      "createdAt": "2025-11-04T10:13:42.594Z"
    }
  ],
  "projects": [
    {
      "tag": "20251028-齐鲁青年论坛",
      "status_csv_url": "https://example.com/status.csv",
      "clicks_csv_url": "https://example.com/clicks.csv",
      "contact_data_url": "https://example.com/contact.csv",
      "user_id": "sdu",
      "email_content_zh": "https://example.com/email-zh.html",
      "email_content_en": "https://example.com/email-en.html"
    }
  ]
}

用户字段

字段	必填
`id`	✅
`name`	✅
`logoUrl`	✅
`createdAt`	自动

项目字段

字段	必填
`tag`	✅
`user_id`	✅
`status_csv_url`	✅
`clicks_csv_url`	✅
`contact_data_url`	可选
`email_content_zh`	可选
`email_content_en`	可选

常见问题

❓ 数据存储在哪里？

数据存储在浏览器的 LocalStorage 中，刷新页面不会丢失。但清除浏览器缓存会删除所有数据，建议定期备份。

❓ 如何备份数据？

点击顶部的「下载 JSON」按钮，将 newsletters.json 文件保存到本地。需要恢复时，使用「导入数据」功能。

❓ 用户 ID 可以重复吗？

不可以。系统会检查 ID 是否已存在，重复的 ID 会导致添加失败。

❓ 删除用户会影响项目吗？

不会。删除用户不会自动删除关联的项目，但项目的 user_id 字段仍会保留被删除的用户 ID。

❓ 外部系统如何访问 JSON 数据？

下载生成的 newsletters.json 文件后，上传到服务器的 api/ 目录。外部系统可以通过 /api/newsletters.json 访问数据。

❓ Logo 图片显示不出来？

检查 URL 是否正确，确保图片链接可以公开访问。某些图片可能因为跨域限制无法显示。

❓ JSON 编辑和导入数据有什么区别？

两者都可以修改数据，但使用场景不同：

JSON 编辑：适合高级用户，可以直接编辑当前数据，支持格式化和验证，保存后立即生效
导入数据：适合从外部文件或备份恢复数据，需要提供完整的 JSON 文件或文本

❓ 编辑 JSON 后数据会自动同步吗？

是的！点击「保存并应用」后，系统会自动将 JSON 数据解析并同步到用户和项目列表，所有界面都会实时更新。

重要注意事项

定期备份数据

浏览器缓存清理会导致数据丢失，务必定期使用「下载 JSON」功能备份。

验证 URL 格式

所有 URL 字段必须是有效的网址格式，以 http:// 或 https:// 开头。

手动同步 JSON 文件

这是静态网站，JSON 文件需要手动下载后上传到服务器才能被外部访问。