# 酒店公寓管理系统 产品需求文档 (PRD) ## 版本信息 | 版本 | 日期 | 描述 | 作者 | |------|------|------|------| | 1.0 | 2024-09-14 | 初始D8D Starter PRD版本 | John (PM) | | 1.1 | 2025-09-17 | 更新Epic结构和指标，与实际epic对齐 | Sarah (PO) | | 1.2 | 2025-09-19 | 在Epic 001中集成数据库备份功能 | Winston | | 2.0 | 2025-11-05 | 转向酒店公寓管理系统，重新定义功能需求 | John (PM) | ## 1. 项目介绍和分析 ### 1.1 项目概览 **分析来源**: 基于项目简介 `docs/brief.md` 和功能清单 `docs/hotel.md` **当前项目状态**: 酒店公寓管理系统是一个基于现代化技术栈的全栈管理系统，提供： - 🏨 **多端用户管理**: 租户端、公寓端、商家端、管理端统一平台 - 🏠 **房源管理**: 房源上架、房态更新、位置匹配、智能推荐 - 📋 **订单管理**: 预定、确认、入住、退宿全流程跟踪 - 💰 **支付结算**: 支付宝/微信/银行卡代扣、信用押金、线下支付 - 🎁 **积分商城**: 积分获取、兑换、商品管理、折扣活动 - 📊 **数据报表**: 自动报表生成、数据导出、统计分析 ### 1.2 项目背景 酒店公寓行业面临数字化管理挑战，包括多端管理复杂、支付结算繁琐、房源管理低效、订单跟踪困难等问题。本项目基于现代化技术栈构建完整的酒店公寓管理系统，提供多端协同、智能推荐、支付集成等差异化功能。 ### 1.3 项目目标 #### 业务目标 - 📈 **建立行业标准**: 成为酒店公寓行业首选的数字化管理平台 - 🎯 **提升运营效率**: 实现自动化运营、智能化管理和精准化营销 - 💰 **降低运营成本**: 减少人工操作，提高资源利用率 - 👥 **改善用户体验**: 提供便捷的房源搜索、安全的支付方式、积分奖励 #### 技术目标 - 🚀 **现代化架构**: 基于Hono + React + TypeORM的现代化全栈架构 - 🔐 **安全可靠**: JWT认证、RBAC权限控制、数据加密保护 - 📱 **多端支持**: Web应用 + 小程序，支持现代浏览器和移动端 - 🔧 **开发效率**: 类型安全、热重载、自动化文档生成 ## 2. 需求定义 ### 2.1 功能需求 基于酒店公寓管理系统的业务需求，定义以下功能需求： **FR1: 多端用户管理系统** - 支持租户端、公寓端、商家端、管理端四种用户角色 - 基于JWT的安全认证机制，支持多端无缝切换 - 用户信息持久化存储到PostgreSQL数据库 - 提供基于角色的权限控制(RBAC) **FR2: 房源管理功能** - 房源上架、编辑、下架功能（公寓端操作） - 房态实时更新和备注管理 - 基于高德地图的位置服务和房源推荐 - 房源分类与标签管理（按区域/价格/户型等） **FR3: 订单全流程管理** - 预定、确认、入住、退宿全流程状态跟踪 - 预定/预离时间管理 - 自动延期续租规则配置 - 逾期未缴催收管理 **FR4: 支付结算系统** - 支付宝/微信/银行卡代扣接口集成 - 信用押金管理（信用积分不足时强制收取） - 线下/部分付款记录登记与展示 - 扣款时间设置（按用户/群体差异化设置） **FR5: 积分与商城功能** - 积分获取机制（入住时长自动累加、任务完成领取） - 积分商城商品管理、库存管理、分类管理 - 积分兑换流程和兑换记录查看 - 后台积分调整和清零规则 **FR6: 推广与分销管理** - 邀请奖励规则（租户邀请公司/好友的奖励） - 分销渠道业绩统计和佣金计算 - 拉新渠道提现流程 - 分销结算对标花生日记模式 **FR7: 数据报表与导出** - 自动生成房态/订单/财务等报表 - 用户信息导出（支持筛选条件） - 订单导出（含明细/金额/状态等） - 数据统计和可视化展示 **FR8: 通知管理系统** - 到期前短信提醒（租赁到期/缴费到期） - 扣款成功/失败通知 - 订单状态变更通知 - 活动通知和系统公告 ### 详细 rationale (决策依据): 这些需求基于酒店公寓行业的实际业务场景： - **多端协同**: 不同用户角色需要不同的功能界面，但共享同一平台 - **支付集成**: 代扣管理是酒店公寓行业的核心需求，需要支持多种支付方式 - **智能推荐**: 基于位置的房源推荐提升用户体验和转化率 - **积分体系**: 激励机制提升用户粘性和复购率 - **数据驱动**: 报表和导出功能支持运营决策 **关键假设**: - 目标用户是酒店公寓运营商、长租公寓管理公司、民宿管理平台 - 主要使用场景是日常运营管理、租赁业务、预订管理 - 第三方服务（高德地图、支付接口）稳定可用 - 系统需要支持移动端和小程序访问 **需要验证的领域**: - 支付接口的合规性和资质要求 - 高德地图API的调用频率限制和成本控制 - 积分体系和分销推广的防作弊机制 - 多端用户权限的细粒度控制策略 ### 2.2 非功能性需求 **NFR1: 系统性能和响应时间** - API响应时间 < 200ms (p95)，复杂查询 < 1s - 页面加载时间 < 2秒，操作成功率 > 95% - 并发支持1000+用户同时在线 - 数据库查询优化，支持复杂关联查询 **NFR2: 系统可用性和稳定性** - 系统可用性99.9%，故障恢复时间 < 30分钟 - 支持高可用部署，自动故障转移 - 数据库备份和恢复机制完善 - 监控告警系统，实时监控系统状态 **NFR3: 安全性和数据保护** - 基于JWT的安全认证机制 - 提供基于角色的权限控制(RBAC) - 支付数据加密存储和传输 - 防止常见Web安全漏洞(XSS, CSRF, SQL注入等) - 用户隐私数据保护，符合数据安全法规 **NFR4: 可扩展性和维护性** - 模块化架构设计，支持功能扩展 - 清晰的代码结构和接口定义 - 自动化测试覆盖，单元测试覆盖率 > 70% - 文档完整且与代码同步 **NFR5: 多端兼容性和用户体验** - 支持现代浏览器和移动端访问 - 响应式设计，适配不同屏幕尺寸 - 小程序支持，提供原生应用体验 - 操作流程简洁，用户学习成本低 **NFR6: 第三方服务集成** - 高德地图API稳定集成，支持实时位置服务 - 支付接口安全可靠，支持多种支付方式 - 短信通知服务稳定，确保通知及时送达 - 第三方服务故障时的降级处理机制 ### 详细 rationale (决策依据): 这些非功能性需求基于酒店公寓管理系统的业务特点： - **性能要求**: 房源搜索、订单处理需要快速响应，影响用户体验 - **稳定性要求**: 支付结算、房态管理需要高可用性，避免业务中断 - **安全要求**: 支付数据和用户隐私需要严格保护 - **扩展性要求**: 业务增长需要系统能够平滑扩展 - **兼容性要求**: 多端用户需要一致的使用体验 **技术约束**: - 基于现有技术栈：Hono + React + TypeORM + PostgreSQL - 部署环境：多八多云端容器环境 - 第三方服务：高德地图API、支付接口、短信服务 - 安全标准：符合企业级安全要求 ### 3.2 集成策略 **数据库集成策略**: - 使用TypeORM实体定义数据模型，支持复杂关联关系 - 房源-订单-用户多对多关系映射 - 支持数据库迁移和版本控制 - 实现连接池管理优化性能 - 提供事务支持和数据一致性保证 **API集成策略**: - RESTful API设计遵循OpenAPI规范 - Hono RPC确保前后端类型安全 - 统一的错误处理和响应格式 - 支持API版本管理(v1前缀) - 多端用户权限验证和接口隔离 **前端集成策略**: - shadcn UI组件库提供一致的设计语言 - React Query管理服务端状态 - 基于Zod的表单验证和类型安全 - 响应式设计支持多种设备 - 多端用户界面切换和权限控制 **第三方服务集成策略**: - 高德地图API集成，支持位置服务和路线规划 - 支付宝/微信/银行卡支付接口集成 - 短信通知服务集成，支持模板消息 - 对象存储服务集成，支持图片和文件上传 ## 5. Epic和故事结构 ### 5.1 Epic方法 **Epic结构决策**: 业务功能导向的Epic划分 - 按照核心业务流程组织开发 **决策依据**: - 酒店公寓管理系统有明确的业务流程和功能模块 - 每个Epic应该交付完整的业务价值 - 按照用户角色和业务流程自然划分 - 支持并行开发和快速迭代 ### 5.2 Epic详情 **Epic 001: 基础主数据管理** **Epic目标**: 建立系统基础主数据模型，包括地区、城市、房型、设施等基础数据，为后续业务功能提供数据支撑。 **成功标准**: 基础主数据模型完整，数据管理功能正常，支持后续业务模块的数据关联 **Epic 002: 基础架构和多端用户系统** **Epic目标**: 建立系统基础架构，实现多端用户管理和认证系统，为后续功能开发奠定基础。 **成功标准**: 多端用户注册登录正常，权限控制完善，系统基础功能稳定运行 **Epic 003: 房源管理与位置服务** **Epic目标**: 实现房源全生命周期管理，集成高德地图位置服务，提供智能房源推荐。 **成功标准**: 房源上架流程顺畅，位置服务准确，房源推荐精准 **Epic 004: 订单全流程管理** **Epic目标**: 建立完整的订单管理流程，从预定到退宿全流程跟踪，支持自动延期续租。 **成功标准**: 订单流程完整，状态跟踪准确，延期续租功能正常 **Epic 005: 支付结算系统** **Epic目标**: 集成多种支付方式，实现代扣管理、信用押金、线下支付等结算功能。 **成功标准**: 支付接口稳定，代扣成功率>95%，结算准确率>99% **Epic 006: 积分与商城功能** **Epic目标**: 建立完整的积分体系和商城功能，支持积分获取、兑换、商品管理等。 **成功标准**: 积分获取和兑换流程顺畅，商城功能完整，用户体验良好 **Epic 007: 数据报表与系统管理** **Epic目标**: 提供数据报表、导出功能和系统管理工具，支持运营决策和系统维护。 **成功标准**: 报表生成准确，数据导出完整，系统管理功能完善 ### 5.3 各Epic用户故事概览 **Epic 001 - 基础主数据管理**: - 地区、城市、行政区划数据管理 - 房型分类和设施配置管理 - 支付方式、积分规则等基础配置 - 系统参数和字典数据管理 **Epic 002 - 基础架构和多端用户系统**: - 多端用户注册和登录 - 用户角色和权限管理 - 用户信息管理和个人中心 - 系统基础配置和设置 **Epic 003 - 房源管理与位置服务**: - 房源上架和编辑功能 - 房态管理和实时更新 - 高德地图集成和位置服务 - 房源推荐和搜索功能 **Epic 004 - 订单全流程管理**: - 订单创建和预定流程 - 订单状态跟踪和管理 - 自动延期续租功能 - 逾期催收和退租管理 **Epic 005 - 支付结算系统**: - 支付接口集成和配置 - 代扣管理和扣款设置 - 信用押金管理 - 线下支付记录和结算 **Epic 006 - 积分与商城功能**: - 积分获取和累计机制 - 积分商城商品管理 - 积分兑换流程 - 商城订单和库存管理 **Epic 007 - 数据报表与系统管理**: - 数据报表自动生成 - 用户和订单数据导出 - 系统监控和告警 - 管理员工具和配置 ## 6. 成功指标和验收标准 ### 6.1 关键绩效指标(KPI) **Epic 001 - 基础主数据管理指标**: - ✅ 基础数据模型完整性 100% - ✅ 数据字典配置准确率 > 99% - 🔄 数据关联关系正确率 100% - 📊 基础数据查询性能 < 100ms - 🔧 数据管理操作成功率 > 98% **Epic 002 - 基础架构和多端用户系统指标**: - ✅ 多端用户注册登录成功率 > 99% - ✅ 权限控制准确率 100% - ⏱️ 系统响应时间 < 200ms (p95) - 🔐 安全认证通过率 100% - 👥 用户满意度评分 > 4/5 **Epic 003 - 房源管理与位置服务指标**: - ✅ 房源上架成功率 > 98% - ✅ 房态准确率 > 98% - 🗺️ 位置服务准确率 > 95% - 🔍 房源推荐精准率 > 80% - 📱 移动端适配完成度 100% **Epic 004 - 订单全流程管理指标**: - ✅ 订单创建到确认时间 < 10分钟 - ✅ 订单状态跟踪准确率 > 99% - 🔄 自动延期续租成功率 > 95% - ⏰ 逾期催收响应时间 < 1小时 - 📊 订单处理效率提升 50% **Epic 005 - 支付结算系统指标**: - ✅ 支付接口成功率 > 95% - ✅ 代扣成功率 > 95% - 💰 结算准确率 > 99% - 🔒 支付数据安全合规 100% - 📈 支付处理效率提升 60% **Epic 006 - 积分与商城功能指标**: - ✅ 积分获取准确率 > 99% - ✅ 积分兑换成功率 > 95% - 🛒 商城订单转化率 > 15% - 📦 库存管理准确率 > 98% - 🎁 用户参与度提升 40% **Epic 007 - 数据报表与系统管理指标**: - ✅ 报表生成准确率 > 99% - ✅ 数据导出成功率 > 98% - 📊 系统监控覆盖率 100% - 🔧 管理员操作效率提升 50% - 📈 数据驱动决策支持度 > 80% **总体项目指标**: - 📚 文档完整性：PRD需求实现率100% - 🚀 系统可用性：99.9%正常运行时间 - 📈 业务价值：运营效率提升30%以上 - 👥 用户满意度：整体评分>4.5/5 - 💰 成本效益：人工成本降低40% ### 6.2 验收标准 **项目级验收**: - 所有功能需求和非功能需求实现 - 多端用户系统正常运行 - 支付结算系统稳定可靠 - 数据报表准确完整 - 系统性能和安全指标达标 **阶段性验收**: - 每个Epic完成后进行功能验收 - 每周演示进度和获取用户反馈 - 每月进行整体质量评估和性能测试 - 第三方服务集成测试通过 **用户验收测试**: - 租户端：房源搜索、预定、支付流程顺畅 - 公寓端：房源管理、订单处理功能完整 - 商家端：店铺宣传、订单派发功能正常 - 管理端：全局监控、数据管理功能完善 ## 7. 附录 ### 7.1 参考资料 - 项目简介文档: `docs/brief.md` - 功能清单文档: `docs/hotel.md` - Hono框架文档: https://hono.dev - TypeORM文档: https://typeorm.io - 高德地图开放平台: https://lbs.amap.com ### 7.2 相关文档 - API文档: 通过 `/ui` 端点访问 - 数据库设计文档: `docs/database-design.md` - 部署指南: `docs/deployment.md` - 用户手册: `docs/user-manual.md` ### 7.3 对标产品说明 - **美团跑单后台**: 租户端路线规划、订单跟踪；商家端派单逻辑 - **寓小二青旅版**: 公寓端房态管理、自动报表；管理端房态监控 - **花生日记分销模式**: 租户端邀请分销、佣金结算 - **拍小租/人人租**: 信用押金、多渠道代扣接口、租赁流程闭环 ### 7.4 联系方式 - 产品负责人: [待指定] - 技术负责人: [待指定] - 开发团队: [待指定] - 运营团队: [待指定] --- **文档状态**: 已更新 **最后更新**: 2025-11-05 **下次评审**: 2025-11-12