告别手写礼簿！私密安全的电子礼簿GiftBook部署与使用指南

GiftBook是一款开源、免费且完全在本地运行的单页Web应用，专为婚庆、寿宴、白事等各种红白喜事设计，提供了一个现代化、安全且高效的礼金（份子钱）管理解决方案。它彻底取代了传统的手写记录方式，通过数字化技术涵盖了从记录、统计、查询到存档的完整流程，并将数据安全与用户隐私置于设计的核心地位。

🚀 核心功能与优势

🥇 完全本地化与数据安全

• 离线运行：无需连接互联网，直接打开HTML文件即可使用，从根本上杜绝了数据被上传至任何服务器的可能性。
• 加密存储：所有礼金记录都会使用您为事项设置的管理密码进行AES加密，并安全地存储在浏览器的IndexedDB数据库中。即使他人物理接触到您的设备，没有正确的密码也无法查看任何敏感信息。
• 隐私至上：所有数据，包括事项名称和每一笔礼金详情，都完全归属用户个人，不会离开您的本地环境。

📚 现代化的事件管理

• 多事项支持：允许同时创建和管理多个独立的事项，并可以通过密码进行安全、快速的切换。
• 个性化主题：内置了“喜庆红”与“肃穆灰”两套界面主题，可一键切换以适应不同场合（如婚礼与葬礼）的视觉氛围需求。
• 封面定制：支持为每个事项上传定制的横向封面图片。在后续打印或导出PDF时，此封面将作为精美的首页呈现，极大地提升了整个礼簿的正式感和仪式感。

✒️ 高效的礼金录入

• 智能防重：在录入过程中，系统会自动检测是否存在姓名相同或姓名及金额均相同的记录，并以醒目的方式提示用户，有效避免了重复登记的常见错误。
• 大写转换：输入数字金额后，系统会自动生成符合财务规范的中文大写金额，方便核对与存档。
• 语音播报：启用此功能后，每成功录入一笔礼金，系统会以语音形式播报“XXX 贺礼/奠仪 XXX元”，便于现场即时核对，也能为现场增添一份恰当的互动气氛。
• 超时补录：即使在预设的事项时间结束后，仍可通过输入管理密码进行礼金补录，确保了所有往来人情数据的完整性，不留遗漏。

📊 强大的数据处理功能

• 即时统计：主界面实时动态显示当前事项的总金额、总人数以及当前页面的金额小计，让账目状态一目了然。
• 多维度查询：提供按姓名进行快速检索的功能，方便在海量记录中迅速定位。
• 专业报表导出：只需一键操作，即可将所有礼金明细导出为标准格式的Excel (.xlsx)文件，便于进行更深度的数据分析、打印或长期归档保存。
• 精美电子礼薄PDF生成与打印：能够自动生成适配A4纸张横向打印的精美礼簿页面。如果已设置封面，它将自动成为打印文档的首页。所有带有备注的记录会被智能整理成附录，附加在礼簿正文之后，从而保持主账簿页面的清晰与整洁。
• 深度统计视图：提供一个包含所有礼金详细信息的交互式数据表格视图，支持即时搜索、多列排序和条件筛选，使得数据回顾与分析变得前所未有的直观和高效。

💻 优良的用户体验

• 响应式设计：无论是桌面电脑还是平板设备，都能获得良好的视觉布局与流畅的操作体验。
• 直观界面：界面设计模拟了传统竖版礼簿的书写与阅读习惯，符合用户长期形成的操作直觉，降低学习成本。
• 弹窗优化：在进行弹窗操作（如新增或修改记录）时，背景页面会被锁定，防止因滚动造成的误操作，提升操作准确性。
• 快捷键支持：支持如 Ctrl + P 快速打印、Enter 键快速提交表单等常用快捷键，显著提升了数据录入与管理的整体效率。

适用场景

本系统适用于所有需要正式记录礼金或馈赠物品的社交场合，典型场景包括但不限于：

• 婚嫁喜宴
• 新生儿满月酒、百日宴
• 寿星大寿庆典
• 乔迁新居之喜
• 升学宴、谢师宴
• 白事吊唁
• 开业庆典、宗族聚会等

🔧 两种部署方式详解

原版应用依赖浏览器的IndexedDB进行数据存储，其局限性在于数据仅存在于当前使用的浏览器中。考虑到许多用户有将数据集中保存至NAS（网络附加存储）的需求，这里也提供了基于AI工具辅助修改的新版本，该版本通过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数据存储版） 此版本数据存储在容器外，便于备份和管理。

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，部署过程极为简单）