# gift-book

**Repository Path**: echobean/gift-book

## Basic Information

- **Project Name**: gift-book
- **Description**: 一款开源、免费、完全本地运行的单页 Web 应用，旨在为各类红白喜事（如婚庆、寿宴、白事等）提供一个现代化、安全、高效的礼金（份子钱）管理解决方案。它告别了传统的手写礼簿，通过数字化的方式解决了记录、统计、查询和存档的全部流程，同时以**数据安全**和**用户隐私**为最高设计原则。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-12-05
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电子礼簿系统(参考来源：https://github.com/jingguanzhang/gift-book/)

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

**本系统无需任何网络连接，所有数据均加密存储在您自己的浏览器中，确保信息永不泄露。**


## 核心优势

* **🥇 完全本地化与数据安全**
  * ​**离线运行**：无需网络，打开 HTML 文件即可使用，杜绝任何数据被上传到服务器的风险。
  * ​**加密存储**：所有礼金记录均通过您为事项设定的管理密码进行 AES 加密，存储于浏览器的 IndexedDB 数据库中。即使他人能接触到您的电脑，没有密码也无法窥探数据。
  * ​**隐私至上**：您的所有数据，从事项名称到每一笔礼金，都只属于您自己。

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

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

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


## 适用场景
**本系统适用于所有需要记录礼金或馈赠的场合，包括但不限于：**

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

## 快速上手指南
* ​**下载文件**：获取 **index.html** **及** **static** **文件夹，并将它们放在同一个目录下。**
* ​**打开应用**：使用现代浏览器（如 Chrome, Firefox, Edge）打开 **index.html** **文件。**
* ​**创建新事项**：
  * ​**填写事项名称、设定一个您能牢记的**管理密码**。**
  * ​**在“更多设置”中，根据需要选择界面风格，并**上传一张横向的图片作为封面**（可选）。**
  * **点击“创建并进入”按钮。**
* ​**开始录入**：在主界面左侧的表单中，依次填写来宾姓名、金额、收款方式和备注，然后点击“确认录入”。
* ​**管理与导出**：使用右侧的功能按钮进行查找、打印、导出 Excel 或查看详细统计。  ​
* ​**切换或返回**：点击主界面左上角的标题，可以方便地切换到其他事项或返回创建页面。
  
  ​

## 技术栈
* ​**前端**：HTML5, JavaScript (ES6+)
* ​**样式**：Tailwind CSS
* ​**本地存储**：IndexedDB
* ​**核心库**：
  * ​**CryptoJS**: 用于数据的 AES 加密。
  * **SheetJS (xlsx)**: 用于生成和导出 Excel 文件。
  * **Grid.js**: 用于构建功能强大的统计数据表格。