{"id":29618948,"url":"https://github.com/iffaith/memberlite","last_synced_at":"2026-04-10T15:10:56.223Z","repository":{"id":305075353,"uuid":"1010883570","full_name":"IfFaith/MemberLite","owner":"IfFaith","description":"会员消费管理系统是一个基于Electron-Vite开发的桌面应用程序，专为小门店设计，用于管理会员信息、会员余额和消费记录。系统采用单机运行模式，所有数据本地存储，确保数据安全和隐私保护。","archived":false,"fork":false,"pushed_at":"2025-07-18T03:55:30.000Z","size":478,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T07:34:11.743Z","etag":null,"topics":["boilerplate","electron","javascript","react","sqlite","template","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IfFaith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-30T01:33:36.000Z","updated_at":"2025-07-18T03:55:33.000Z","dependencies_parsed_at":"2025-07-18T07:37:20.507Z","dependency_job_id":"0db7f6b1-1cd8-4c64-b2d2-e1fca2796b33","html_url":"https://github.com/IfFaith/MemberLite","commit_stats":null,"previous_names":["iffaith/memberlite"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/IfFaith/MemberLite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IfFaith%2FMemberLite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IfFaith%2FMemberLite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IfFaith%2FMemberLite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IfFaith%2FMemberLite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IfFaith","download_url":"https://codeload.github.com/IfFaith/MemberLite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IfFaith%2FMemberLite/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266231762,"owners_count":23896472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate","electron","javascript","react","sqlite","template","typescript"],"created_at":"2025-07-21T03:00:47.730Z","updated_at":"2025-12-30T22:07:01.742Z","avatar_url":"https://github.com/IfFaith.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 理发店会员消费管理系统\n\n## 项目概述\n会员消费管理系统是一个基于Electron-Vite开发的桌面应用程序，专为小门店设计，用于管理会员信息、会员余额和消费记录。系统采用单机运行模式，所有数据本地存储，确保数据安全和隐私保护。\n\n## 快速上手\n\n### 环境要求\n- Node.js 16.0 或更高版本\n- npm 或 yarn 包管理器\n\n### 安装和运行\n\n1. **克隆项目**\n   ```bash\n   git clone [项目地址]\n   cd electron\n   ```\n\n2. **安装依赖**\n   ```bash\n   npm install\n   ```\n\n3. **开发模式运行**\n   ```bash\n   npm run dev\n   ```\n\n4. **打包应用**\n   ```bash\n   npm run build\n   npm run dist\n   ```\n\n### 首次使用\n\n1. **登录系统**\n   - 默认账号：`admin`\n   - 默认密码：`123456`\n   - 可在系统设置中修改密码\n\n2. **基础配置**\n   - 进入\"系统设置\"页面\n   - 配置店铺信息\n   - 添加服务项目（如：剪发、染发、护理等）\n\n3. **开始使用**\n   - 添加会员信息\n   - 为会员充值\n   - 记录消费扣费\n\n## 功能模块\n\n### 1. 会员管理 ✅\n- 会员信息录入（姓名、手机号、等级等）\n- 会员信息查询和筛选\n- 会员状态管理（正常、暂停、注销）\n- 会员信息导出\n\n### 2. 余额管理 ✅\n- 会员充值功能\n- 余额查询和变动记录\n- 消费自动扣费\n- 余额不足提醒\n\n### 3. 服务项目管理 ✅\n- 服务项目配置（名称、价格、分类）\n- 不同会员等级的价格设置\n- 服务状态管理（启用/禁用）\n\n### 4. 消费记录 ✅\n- 消费记录查询和统计\n- 消费报表生成\n- 消费记录导出\n- 消费趋势分析\n\n### 5. 系统管理 ✅\n- 店铺信息设置\n- 数据备份恢复\n- 登录密码修改\n- 系统参数配置\n\n## 技术架构\n\n### 技术栈\n- **前端框架**: Electron + Vite\n- **UI框架**: React + Ant Design\n- **数据库**: SQLite（本地存储）\n- **开发语言**: TypeScript\n\n### 项目结构\n```\nsrc/\n├── main/                 # 主进程\n│   ├── index.ts         # 主进程入口\n│   ├── database.ts      # 数据库管理\n│   └── handles.ts       # IPC处理器\n├── preload/             # 预加载脚本\n│   └── index.ts         # API暴露\n└── renderer/            # 渲染进程\n    ├── src/\n    │   ├── components/  # 组件\n    │   ├── pages/       # 页面\n    │   ├── types/       # 类型定义\n    │   ├── App.tsx      # 主应用\n    │   └── App.scss     # 样式文件\n    └── index.html       # HTML模板\n```\n\n## 使用说明\n\n### 主要操作流程\n\n1. **会员注册**\n   - 进入\"会员管理\"页面\n   - 点击\"新增会员\"\n   - 填写会员信息（姓名、手机号必填）\n   - 保存会员信息\n\n2. **会员充值**\n   - 进入\"会员充值\"页面\n   - 选择会员（可通过姓名或手机号搜索）\n   - 输入充值金额\n   - 选择支付方式\n   - 确认充值\n\n3. **消费扣费**\n   - 进入\"消费扣费\"页面\n   - 选择会员\n   - 选择服务项目\n   - 系统自动计算价格（根据会员等级）\n   - 确认扣费\n\n4. **查询统计**\n   - 进入\"统计报表\"页面\n   - 选择时间范围\n   - 查看消费统计、会员分析等数据\n\n### 功能特点\n\n- **会员管理**: 支持会员信息的增删改查，支持按姓名、手机号、等级、状态筛选\n- **服务管理**: 支持不同会员等级的价格设置，支持服务项目的启用/禁用\n- **消费扣费**: 自动根据会员等级计算价格，支持余额不足提醒\n- **会员充值**: 支持多种支付方式，自动更新会员余额\n- **统计报表**: 支持按时间范围查询统计数据，包含消费记录和充值记录\n- **系统设置**: 支持店铺信息配置、数据管理和密码修改\n\n## 技术特点\n\n- **单机运行**: 无需网络连接，数据本地存储\n- **数据安全**: SQLite数据库，数据加密存储\n- **界面友好**: 现代化UI设计，操作简单直观\n- **功能完整**: 覆盖理发店会员管理的所有需求\n- **扩展性强**: 模块化设计，便于功能扩展\n\n## 注意事项\n\n1. **数据备份**: 定期备份数据库文件，防止数据丢失\n2. **系统更新**: 及时更新系统版本，获得最新功能\n3. **数据安全**: 注意数据安全和隐私保护\n4. **数据清理**: 建议定期清理历史数据，保持系统性能\n\n## 常见问题\n\n### Q: 如何备份数据？\nA: 在系统设置页面，点击\"数据备份\"功能，选择备份位置即可。\n\n### Q: 如何修改窗口图标？\nA: 替换 `resources/icon.png` 文件，重新打包应用即可。\n\n### Q: 如何修改安装包图标？\nA: 将图标转换为 `.ico` 格式，放在 `resources/icon.ico`，在 `electron-builder.yml` 中配置 `win.icon: resources/icon.ico`。\n\n## 开发团队\n\nlixp\n\nhttps://github.com/IfFaith\n\n## 联系方式\n\nhttps://github.com/IfFaith\n\n13283029823@163.com","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiffaith%2Fmemberlite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiffaith%2Fmemberlite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiffaith%2Fmemberlite/lists"}