民宿住宿登记系统源码，客人扫码自助登记，房东后台确...

zhang*** · 昨天 11:30

民宿住宿登记系统源码，客人扫码自助登记，房东后台确认入住与退房

复制代码

一、这套系统做什么
给一家民宿替代纸质登记本用。客人在房间门口或前台扫一张登记码，自己把同住人的证件信息填进来；房东在自己电脑上看到单子，确认、办理入住、续住、换房、退房、算押金，最后按日期区间导出一张能拿去线下报送的住宿登记表。系统只有一个民宿、一套账号体系，不做多店多房东。
二、客人端（扫码后看到的页面）
入口是一个 32 位登记码地址，一个房间一张码。打开后先校验这张码：码不存在提示"登记码已失效，请联系房东获取新码"；房间被停用提示"该房间暂不可登记，请联系房东"；地址写错或从首页直接进，都落到同一个兜底页，兜底页会带上民宿名称并给出"拨打民宿电话"按钮。
落地页显示民宿名、房号大字、房型与可住人数、今日日期，一段"自助登记约 1 分钟"的提示，下面是隐私协议摘要，点开是全文底部弹层。必须勾选"我已阅读并同意隐私协议"，"开始登记"按钮才可点。
登记表单分两步。第一步填住客，默认一位主住客，可点"添加同住人"逐条增加，人数达到该房可住上限时按钮禁用并提示上限。每位住客要填：姓名（2 到 50 字）、证件类型、证件号码、手机号、证件有效期、现住址。主住客固定用居民身份证、手机号必填且必须是 1 开头的 11 位号码；同住人证件可选居民身份证、户口簿、出生医学证明、护照、其他，选非居民身份证时证件号码可留空；每位住客可标成人或儿童。身份证号做 18 位加权校验位核验，15 位旧证放行但提示建议换证。校验在填完离开输入框时即时提示，点"下一步"时统一拦截并弹一条提示。
第二步确认入住信息：房号、房型、入住日期、离店日期、入住天数、房费、押金。房费等于该房默认房价乘以间夜数，押金取该房默认押金，页面标注"线下支付由房东收取"。日期只能选今天及以后，最早可选今天，最晚 2099 年底；离店必须晚于入住。这里还有一段"填写须知"折叠说明。
第三步是核对页，把住客、入住信息、费用三段列出来，任何一项不合格会在页顶列出问题清单并可点回表单。再勾一次"我确认以上信息真实有效"才能提交。如果这份草稿从开始填写到此刻超过两小时，第一次点提交不会真提交，而是先拉一次最新的房价房态并提示"填写时间较长，请再点一次提交"，避免按旧房价成交。
提交时服务端按顺序复核：码是否有效、房间是否停用、是否同意协议、日期格式与范围、间夜数、人数是否超该房上限、同一证件在同一房间同一入住日是否已登记过、该房间该日期区间是否已有别的单据占位。全过才生成登记单，状态为"待确认"，来源记"扫码"，并把当时那份隐私协议正文整段快照存进这张单，之后房东改协议也不影响历史单据。
成功后进回执页，显示登记编号、当前状态"待房东确认"、房号、入住离店与间夜、住客（姓名与证件号都是脱敏的）、房费、押金、提交时间，提示截图保存。
填写过程的内容存在手机本地，按登记码分开存，边打字边延迟保存，中途退出再扫同一张码可以接着填；提交成功后这份草稿清掉。
三、房东管理后台
登录：账号密码登录，密码加密存储。连续输错 5 次锁 10 分钟，锁定期内按钮变成倒计时且不可点，刷新页面倒计时继续；每次失败都记一条登录失败日志。登录令牌有效期 7 天。改密码后所有设备上的旧令牌立即作废，必须重新登录。
工作台：四张数字卡是今日待入住、今日待退房、当前在住人数、本月住宿人次；下面四张待办清单是待确认登记单、今日入住、今日退房、逾期未办理。待确认单里从提交起算超过 24 小时的整行标红并打"超 24 小时"标签；今日退房在过了"超时退房判定时点"之后仍未退房的标红；入住日期已过但还停在待确认或待入住的单进"逾期未办理"。顶部有一条汇总提醒"待确认几单、逾期未办理几单"。清单里点任意一行进登记单详情。
房态总览：按房间出卡片，显示房号、房态、房型、可住人数、当前住客或空置、剩余天数（今日无单、剩几天退房、今日退房、已超时几天、今日入住、离店日期）和房价，上方是空房、在住、已预订、维修中四类计数。点卡片弹出这个房间能办的事：办理入住（跳代填并带房号）、查看当前单、置为维修中并锁定或解除维修锁定、查看登记码。登记码弹窗里是二维码和地址，可直接下载图片。只有空房、启用、未锁定的房间才给办入住，其余情况给出说明文字。
入住登记代填：给不上网或需要补录过往日期的客人用。默认入住今天、离店明天，房间下拉按所选日期区间实时标注每个房间是"该区间可住""该区间已占""维修中"还是"已停用"，不可选的直接置灰。住客区与客人端同一套字段和校验，另有房东备注（仅后台可见，500 字内）。费用区可以改房费、收取方式（现金、微信、支付宝、其他）、房费状态（未收、已收）、押金、押金方式与押金状态，有一键"按默认价重算"。保存后直接生成状态为"待入住"的单据并跳到详情页，来源记"代填"。
订单管理：按状态分页签，全部、待确认、待入住、在住、已退房、已取消，每个页签带计数；可按入住日期区间和关键字（登记编号、姓名、证件号、手机号）检索，可重置，分页每页 10/20/50/100 条。列表列登记编号、房号、主住客、入住与离店日期、天数、人数、房费与状态、押金与状态、来源、状态、行内操作。行内操作按状态出现：待确认有确认、退回、取消；待入住有办理入住、续住改期、换房、取消；在住有续住改期、换房、退房；已退房与已取消没有操作。
状态流转的具体规则：
确认只对待确认单有效，确认前再查一次日期冲突，通过后转待入住。
退回只对待确认单有效，必须填退回原因，退回后转已取消，客人重新扫码会生成新编号。
取消对待确认与待入住有效，原因选填，转已取消并立即释放日期占位。
办理入住只对待入住有效，房间处于维修锁定时拒绝，通过后转在住。
续住改期对在住与待入住有效，选新离店日期，按该房默认房价重算房费且允许手工覆盖，改期前查日期冲突。
换房对在住与待入住有效，目标房间排除停用、锁定、人数装不下、目标区间已被占的，换房后房费按新房默认价重算，原房间立即释放，两个房间的房态都刷新。
退房只对在住有效，要填应收房费、房费状态、实退金额、扣除金额与扣除原因，硬校验"实退加扣除必须等于押金"，有扣除就必须填原因，否则不给提交；退房后写实际退房时间，押金状态按实退与否自动定。
费用修改在已退房与已取消之外都可做，改前改后都进日志。
同住人可在待确认、待入住、在住期间增删，删除不允许动主住客，也不能把人数删到零，增删都受该房可住人数上限约束。
查看完整证件信息需要二次确认，并单独记一条查看日志；不点就是脱敏视图。
打印登记单是 A5 版式，点一次记一条打印日志。
登记单详情：顶部是编号与状态，副行是房号房型、区间与间夜、人数、来源、创建时间。分四块：登记信息（含实际退房时间、客人同意协议时间、房东备注、取消或退回原因）、住客明细（身份、姓名、证件类型、证件号码、手机号、证件有效期、现住址，可显示完整、可编辑住客与日期、可添加同住人、可删同住人）、费用明细（房费及其方式与状态、押金及其方式与状态、实退、扣除、扣除原因，可编辑）、操作日志（时间线，倒序最多 100 条，同时包含这张单和这个房间的记录）。右侧是可用操作面板与当前状态、房费、押金、住客数摘要。编辑住客与日期需要先看完整证件，这一步有二次确认并记日志；改完写一条变更日志，日志里是"由 A 改为 B"的形式，日期、人数、房费哪几项变了就写哪几项。
报备导出：选起止日期（默认本月，另有本月、上月、近 7 天、近 30 天快捷），先出预览：导出区间、登记单张数、住客明细行数、将生成的文件名。导出的是每个住客占一行的表格，共 22 列：序号、登记编号、房号、房型、姓名、证件类型、证件号码、联系电话、证件有效期、现住址、成人儿童、入住日期、离店日期、实际退房时间、房费、房费状态、押金、押金状态、实退押金、扣除押金、登记来源、登记时间。表前三行是民宿名称、地址、联系电话，第四行才是表头；一张单多位住客时主住客那一行加粗；证件号、电话、日期这些列强制按文本写，避免被识别成科学计数法。文件名带民宿名与区间，导出动作本身记一条日志。
房间管理：列表显示房号、房型、可住人数、默认房价、默认押金、当前房态、启用状态、在店与待入住情况（主住客、编号、离店日期），可搜索房号房型、可切换显示已停用。新增与编辑弹窗里房号唯一（重复直接报"房号 X 已存在"）、房型可从大床房、双床房、家庭房、套房里选也可以自填、可住人数 1 到 20、默认房价必须大于 0、默认押金不为负，另有维修锁定与启用两个开关。停用有约束：该房还有有效单据时拒绝停用并提示还有几张。登记码可单独查看下载，也可批量打印 A4 标签（每行两枚，带裁切虚线）。重置登记码有二次确认，重置后旧码立刻不可用。
统计：可按日、按周、按月三档，区间最长 366 天。口径由服务端算：入住率等于已占用房晚除以可售房晚（可售房晚是启用房间数乘区间天数），住宿人次按入住日期归属统计。出两张图（入住率趋势、住宿人次柱状）和四张卡（区间平均入住率、区间住宿人次含儿童数、今日在住人数、本月住宿人次），下面一张房费与押金汇总表：房费已收、房费未收、押金收取中、押金已退、押金已扣除、可售房晚、已占用房晚，每行都带口径说明。
设置：民宿名称、地址、联系电话（这三项进导出表头和顶部栏，电话也出现在客人端兜底页），超时退房判定时点（默认 12:00，影响工作台与订单列表的退房超时标红），隐私协议正文（纯文本分段，最长 4000 字，保存后影响后续扫码客人看到的协议，历史单据保留各自快照），登录密码修改。保存前可放弃修改，保存会写一条设置变更日志，日志里带改前的名称、电话与判定时点。
四、贯穿全流程的规则
登记编号形如 DJ 加 8 位日期加 4 位当日流水，按日取号且有唯一约束，并发撞号会明确报错让重试。
日期占位只看三种"占位状态"（待确认、待入住、在住），已退房与已取消不占位，所以退房后同一区间可以重新登记。
房间房态由单据推导：有在住单即在住；有今天入住的待确认或待入住单即已预订；否则空房；手动锁定维修时固定为维修中。这个推导在每次涉及单据或房间状态变动时重算。
敏感信息默认脱敏：姓名保留首尾字、证件号保留前四后二、手机号保留前三后四。列表、工作台、回执页都是脱敏值。
留痕覆盖 21 类动作：创建、确认、退回、办理入住、信息修改、续住改期、换房、办理退房、取消作废、费用变更、住客变更、房态变更、重置登记码、查看完整信息、打印登记单、导出报备表、登录失败、新增房间、修改房间、修改密码、系统设置。
客人端接口按"登记码加来源地址"维度限流，每分钟 10 次，超了返回明确提示。
后台所有管理接口都要带登录令牌，未登录或过期一律 401 并被前端拦回登录页。
跨端一致：房态、费用、押金、住客数、超时标记都由服务端算，前端只展示。
五、明确不做的功能
不对接公安或任何第三方报送接口，导出表格由人拿去线下报；不做线上支付，房费押金只记录线下收取状态；不做门锁、短信、微信授权登录与微信支付；不做证件识别录入；不做图片上传；不做地图导航；不做多店多房东与角色权限；不做会员营销。
六、读代码看到的限制与问题，如实列出
1 隐私协议正文里向客人承诺"信息自退房之日起保存 90 天后自动清除"，但整个服务端没有任何定时任务、清理逻辑或过期判断，这条承诺目前没有实现。这是文案与实现不一致，建议要么补一个定期清理，要么改协议措辞为人工按周期处理。
2 房态是"被动刷新"：只有发生单据或房间操作时才重算。跨天后（比如在住单已过离店日期）房间状态不会自己变，需要有人打开页面或点刷新才会更新，长期没人操作时房态可能与实际不符。
3 客人提交后系统不主动通知房东，没有短信、推送或角标提醒，房东必须自己看工作台；待确认单停留超 24 小时只是标红，不会升级提醒。
4 换房时房费默认按新房默认价重算，会覆盖原单上手工调过的价格；续住改期同理，虽然都允许再手工改回，但操作者容易忽略。
5 编辑住客与日期是"整单住客先全部删掉再重建"，住客记录标识会变，历史日志里提到的住客无法精确回溯到同一条记录。
6 导出与列表都是整表读取，没有分页或流式写出；登记单积累到很大量时，导出会一次性占用较多内存、耗时变长。
7 日期与时间全部按字符串存取，跨天与超时判定依赖服务器时区设置，换到别的时区部署会出现判定偏移。
8 限流计数在进程内存里，服务重启即清零，不能防住反复重启绕过。
9 退房、取消都是终态，没有撤销或恢复入口，误操作只能新增单据修正。
10 只有一个管理员账号的概念：账号表可以存多行，但界面与流程都按单账号使用，没有角色、权限与操作人区分，日志里的"操作人"只有房东、客人、系统三种。
11 代填单的押金状态下拉里不给选"已退"，只能走退房流程产生，逻辑自洽但界面上没有解释，容易让人以为缺项。
12 房间停用后登记码仍在库里，重新启用时旧码恢复可用，与"重置登记码才失效"的行为并存，使用者需要区分这两种操作。
13 统计里"住宿人次"按入住日期归属，跨月的单子整笔算进入住那个月；按日入住率用间夜分摊后再四舍五入，周和月是日值取平均，与"总间夜除以总可售间夜"的算法会有小幅差异。
一、主关键词标题（覆盖"民宿住宿登记系统 / 入住登记源码"这类核心搜索）
民宿住宿登记系统源码，客人扫码自助登记，房东后台确认入住与退房
民宿入住登记系统可部署源码，扫码填证件、房东审核、房态总览一条龙
客栈住宿登记管理系统源码，房间独立登记码，住客信息自动脱敏
民宿旅客登记系统源码，一房一码自助登记，续住换房加收房费全流程可操作
单店民宿住宿登记软件源码，含房东管理后台与客人扫码填写页
民宿开房登记系统源码，入住到退房全程留痕，房费押金分账管理
小型民宿住宿登记系统源码，不用装 App，客人扫二维码就能登记
二、长尾标题（贴合具体搜索意图，竞争小、命中率高）
民宿客人自助登记怎么写？扫码填姓名身份证手机号，房东后台确认入住的源码参考
一个房间最多住几个人能自己设？民宿登记系统源码里房间容量、参考价、押金都是可改配置
民宿退房押金算不清？这套源码要求实退加扣除必须等于原押金才能提交
民宿身份证号码校验怎么做才严谨？源码含十七位加权校验位算法与十五位老证兼容处理
前台不用登记本：民宿扫码登记系统源码，住客信息按房间归组成一张登记单
民宿登记单编号怎么生成？源码按"前缀加日期加当日流水"自动排号
客人改了离店日期算不算冲突？源码在确认入住前按日期区间查重叠，同一时间只允许一张有效单
民宿房态总是对不上？这套源码的房态由登记单状态实时推导，不单独维护
退房超时自动标红：民宿登记系统源码按每日判定时点标记超时退房与超时未入住
民宿要交纸质登记表？源码按入住日期区间导出二十二字段的表格文件，现场可直接打印
住客手机号和证件号怎么打码？源码后台列表默认脱敏，完整信息只在详情和导出中出现
谁改了登记单？源码内置二十一类操作留痕，管理员后台可查记录
民宿登记页被反复刷怎么办？源码对扫码提交做了按登记码加来源地址的频率限制
房东账号怕被爆破？源码含连续失败锁定与口令改版后立即失效旧登录态的机制
客人填一半就走了？扫码登记源码把草稿存在本机，两小时内回来能接着填
三、场景与人群标题（用于社交和论坛投放）
给只有一两栋房的民宿做的住宿登记源码，不接支付、不上报接口，本地就能跑
夫妻店开民宿的登记台账源码，手机扫码登记，电脑后台看房态
农家乐、短租公寓、客栈都能改的住宿登记系统源码，房间、房型、企业名都可配
自己住也想留个客档：民宿登记源码单店版，一人后台多房扫码
不想买 SaaS 年费的民宿老板，可以看看这套能自己部署的住宿登记源码
四、技术内容向标题（面向找参考实现的人）
带状态机的住宿登记源码：待确认、待入住、在住、已退房、已取消五态流转怎么写
前端两步表单加校验提示的民宿登记页源码，错误信息精确到第几位住客哪一项
管理后台按房间维度看今日入住、今日退房、在住房源的源码实现
把民宿登记拆成客人端与后台端两套页面的源码结构说明
登记码配二维码标签批量打印的源码做法，后台可按房间生成图片

复制代码

wutuoba*** · 昨天 11:30

非常好！！

tht*** · 昨天 12:05

沙发！！

xna*** · 昨天 12:06

顶一下！！

hbc*** · 昨天 12:07

你好棒！！

niuxian*** · 1 小时前

支持！！！

17668*** · 1 分钟前

已加客服

		自动登录	找回密码
密码			立即注册

民宿住宿登记系统源码，客人扫码自助登记，房东后台确...

民宿住宿登记系统源码，客人扫码自助登记，房东后台确...

本帖子中包含更多资源