[PHP] 基于Docker容器在NAS部署电子礼簿GiftBook：私有化礼金管理方案

GiftBook 是一款开源、免费、完全本地运行的单页 Web 应用，专为婚庆、寿宴、白事等场合设计，旨在提供现代化、安全且高效的礼金（份子钱）管理解决方案。它彻底告别了传统的手写礼簿，通过数字化方式整合了记录、统计、查询和存档的全流程，并以数据安全和用户隐私为核心设计原则。

核心优势

🥇 完全本地化与数据安全

• 离线运行：无需网络，打开即可使用，杜绝数据上传风险。
• 加密存储：所有记录均通过管理密码进行 AES 加密，存储于浏览器 IndexedDB 中。无密码无法窥探数据。
• 隐私至上：所有数据，从事项名称到每一笔礼金，都只属于用户自己。

📚 现代化的事件管理

• 多事项支持：可同时创建和管理多个不同事项，并通过密码安全切换。
• 个性化主题：内置“喜庆红”与“肃穆灰”两套界面风格，一键适应不同场合氛围。
• 封面定制：支持为每个事项上传专属横向封面图。在打印或导出 PDF 时，该封面将作为精美的首页。

✒️ 高效的礼金录入

• 智能防重：录入时自动检测同名或同名同金额记录，发出醒目提示，避免重复录入。
• 大写转换：金额输入后，自动生成符合财务规范的中文大写金额。
• 语音播报：开启后，每成功录入一笔，系统会自动语音播报“xxx 贺礼/奠仪 xxx 元”，方便现场核对。
• 超时补录：即使超出设定的事项时间，也可通过管理密码进行补录，确保数据完整。

📊 强大的数据处理功能

• 即时统计：主界面实时显示总金额、总人数及当前页小计。
• 多维度查询：支持按姓名快速检索礼金记录。
• 专业报表导出：一键将所有礼金明细导出为标准 Excel (.xlsx) 文件，方便二次处理或长期存档。
• 精美电子礼薄PDF生成与打印：自动生成适合A4纸横向打印的精美礼簿页面。若设置了封面，将自动添加为首页。带备注的记录会自动整理成附录，附加在礼簿末尾。
• 深度统计视图：提供包含所有礼金详情的交互式数据表格，支持即时搜索、排序和筛选。

💻 优良的用户体验

• 响应式设计：无论是电脑还是平板，都能获得良好的视觉和操作体验，这得益于其优秀的前端框架/工程化实践。
• 直观界面：模拟传统竖版礼簿的书写习惯，符合用户直觉。
• 弹窗优化：弹窗操作时，背景页面将锁定滚动，避免误操作。
• 快捷键支持：支持 Ctrl + P 快速打印、Enter 键快速提交等快捷操作。

适用场景
本系统适用于所有需要记录礼金或馈赠的场合，包括但不限于：婚嫁喜宴、新生儿满月酒、寿辰庆典、乔迁之喜、升学宴、白事吊唁、开业庆典等。

安装部署

原版应用采用浏览器 IndexedDB 存储数据，仅限当前浏览器访问。为满足将数据持久化保存在 NAS 的需求，社区提供了一个修改版本，通过 PHP 实现数据本地文件存储。用户可根据自身需求选择部署对应的版本。

1. Docker Compose 部署（原版，IndexedDB 数据库）
此版本数据存储在浏览器内。

services:
  gift-book:
    image: heizicao/gift-book:latest
    container_name: gift-book
    ports:
      - 8080:3000
    restart: always

2. Docker Compose 部署（修改版，PHP 数据存储）
此版本数据通过 PHP 写入宿主机文件，实现持久化，是典型的云原生/IaaS轻量应用部署方式。

services:
  gift-book:
    image: heizicao/gift-book:beta
    container_name: gift-book
    ports:
      - 8080:80
    volumes:
      - ./data:/var/www/html/data # 挂载数据目录，确保数据持久化
    restart: always

使用指南

1. 在浏览器中输入 http://你的NAS_IP地址:8080 即可访问应用界面。
   

2. 按要求填写事项名称、管理密码，时间也可根据实际情况调整。
   

3. 在“更多设置”中，可以切换“喜庆红”或“肃穆灰”的界面风格。
   

4. 创建事项后进入主界面，布局直观清晰。
   

5. 在左侧输入宾客姓名和礼金金额即可完成录入（信息录入错误也可后续修改）。
   

6. 右侧区域实时显示礼簿效果。
   

7. 功能菜单支持一键打印礼簿或导出 Excel 表格。
   

8. 进入“查看统计”页面，所有数据支持按需排序与筛选。
   

方案总结

GiftBook 提供了一个颇为新颖的数字化解决方案，将传统的礼金管理流程变得私密、高效且体面。尽管其使用频率可能不如日常应用，但在特定场景下却能发挥不可替代的作用。通过 Docker 容器化部署，在 NAS 上搭建过程极为简便，为注重数据隐私和希望实现业务数字化的用户提供了一个可靠的后端 & 架构工具选择。

综合推荐：⭐⭐⭐（场景特定，但解决痛点）
使用体验：⭐⭐⭐（界面直观，功能专注）
部署难易：⭐（Docker一键部署，非常简单）