项目介绍​

东方仙盟开源酒店押金管理系统是一款面向中小型酒店、民宿、客栈的轻量级前台管理工具，专注于简化房态管理、订单处理和押金跟踪流程。作为完全开源的解决方案，它无需依赖任何第三方服务，所有数据存储在本地浏览器中，确保数据安全性与访问便捷性。​

核心功能​

• 房态实时管理：通过直观的卡片式界面展示房间状态（空房 / 在住），支持快速查看与操作​

• 订单全流程处理：从入住登记、押金收取到退房结算的完整流程管理​

• 基础资料维护：灵活管理房型、楼层、房间等核心数据，支持增删改查操作​

• 押金自动跟踪：精准记录押金金额、支付方式及退还状态，避免财务纠纷​

• 本地化数据存储：所有数据存储在浏览器本地，无需服务器支持，即开即用​

设计理念​

本系统采用 "极简实用" 的设计理念，摒弃复杂的功能堆砌，专注解决中小型住宿业态的核心管理需求。通过原生 JavaScript 开发，确保系统轻量化与兼容性，同时保持代码的可扩展性，方便开发者根据实际需求进行二次开发。​

安装与使用​

环境要求​

• 现代浏览器（Chrome、Firefox、Edge、Safari 等）​

• 无需数据库、服务器或额外依赖​

安装步骤​

1. 获取源码​

​

​

​

或直接下载 ZIP 压缩包并解压。​

1. 启动系统​

无需安装任何依赖，直接在浏览器中打开项目根目录下的index.html文件即可使用：​

​

# 示例：使用Chrome浏览器打开​

​

1. 初始化设置​

首次使用需完成基础资料配置：​

• 进入 "基础资料" 页面​

• 依次添加房型（含默认房价与押金）​

• 添加楼层信息​

• 关联房型与楼层创建具体房间​

• 完成配置后即可开始使用收银台功能​

系统架构​

技术栈​

• 前端框架：原生 HTML5 + CSS3 + JavaScript（无任何第三方依赖）​

• 数据存储：localStorage（带项目前缀 "东方仙盟开源酒店系统"）​

• 界面组件：纯原生实现的表格、表单与交互组件​

数据结构设计​

所有数据通过localStorage进行持久化存储，核心数据结构如下：​

1. 房型数据（roomTypes）​

​

{​

id: "唯一标识",​

name: "房型名称",​

price: "默认房价",​

deposit: "默认押金"​

}​

​

1. 楼层数据（floors）​

​

{​

id: "唯一标识",​

name: "楼层名称",​

sort: "显示序号"​

}​

​

1. 房间数据（rooms）​

​

{​

id: "唯一标识",​

roomTypeId: "关联房型ID",​

floorId: "关联楼层ID",​

name: "房间号",​

sort: "显示序号"​

}​

​

1. 订单数据（depositOrders）​

​

{​

cyber_id: "自增ID",​

cyber_sn: "32位随机订单号",​

room_name: "房间号",​

total_price: "总金额",​

deposit_price: "押金金额",​

userid: "身份证号",​

username: "客人姓名",​

create_time: "创建时间戳",​

status: "状态（2=在住，1=已退房）",​

// 更多字段请参考源码定义​

}​

​

界面架构​

1. 布局结构​

• 顶部导航栏：显示系统名称与核心操作区​

• 左侧可收缩菜单：包含收银台、押金管理、基础资料等功能入口​

• 主内容区：根据选择的功能动态加载对应页面​

• 底部版权区：显示开源信息与版权声明​

1. 核心页面​

• 收银台（房态页面）：卡片式房态展示，支持快速创建订单​

• 押金管理：订单列表与状态跟踪，支持退房结算操作​

• 基础资料：表格形式展示并管理房型、楼层、房间数据​

开发与扩展​

由于系统采用原生 JavaScript 开发且无第三方依赖，二次开发非常便捷：​

1. 如需添加新功能，可在script.js中扩展对应方法​

1. 界面样式修改可通过调整style.css实现​

1. 数据结构扩展需同步更新 localStorage 操作方法​

1. 所有核心逻辑均有清晰注释，便于理解与修改​

许可证​

本项目采用 MIT 许可证开源，允许个人与商业用途，欢迎 Fork 与二次开发。