?

項目介紹?

東方仙盟開源酒店押金管理系統是一款面向中小型酒店、民宿、客棧的輕量級前臺管理工具，專注于簡化房態管理、訂單處理和押金跟蹤流程。作為完全開源的解決方案，它無需依賴任何第三方服務，所有數據存儲在本地瀏覽器中，確保數據安全性與訪問便捷性。?

核心功能?

• 房態實時管理：通過直觀的卡片式界面展示房間狀態（空房 / 在住），支持快速查看與操作?

• 訂單全流程處理：從入住登記、押金收取到退房結算的完整流程管理?

• 基礎資料維護：靈活管理房型、樓層、房間等核心數據，支持增刪改查操作?

• 押金自動跟蹤：精準記錄押金金額、支付方式及退還狀態，避免財務糾紛?

• 本地化數據存儲：所有數據存儲在瀏覽器本地，無需服務器支持，即開即用?

設計理念?

本系統采用 "極簡實用" 的設計理念，摒棄復雜的功能堆砌，專注解決中小型住宿業態的核心管理需求。通過原生 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 與二次開發。