📝 docs(brief): 更新项目简介文档为酒店公寓管理系统

- 重命名项目名称从"shadcn全栈管理后台启动模板"为"酒店公寓管理系统"
- 调整产品概念为酒店公寓全栈管理系统，支持多端切换和完整业务功能
- 更新目标市场为酒店公寓运营商、长租公寓管理公司等行业客户
- 重新定义核心价值主张为提供完整的酒店公寓数字化管理解决方案
- 调整问题陈述以反映酒店公寓行业的数字化管理挑战
- 详细列出多端用户（租户/公寓/商家/管理员）的使用场景和需求
- 更新MVP核心功能为房源管理、订单管理、支付结算等业务功能
- 调整技术偏好和架构考虑以匹配酒店公寓业务需求
- 更新下一步行动计划，聚焦于业务需求分析和第三方服务集成

docs/brief.md

@@ -1,183 +1,198 @@
-# Project Brief: shadcn全栈管理后台启动模板
+# Project Brief: 酒店公寓管理系统
 
 ## Executive Summary
 
-**项目名称：** shadcn全栈管理后台启动模板
+**项目名称：** 酒店公寓管理系统
 
-**产品概念：** 一个基于shadcn/ui的全栈管理后台启动模板，提供预配置的用户管理系统、通用CRUD路由和服务，旨在显著减少新项目启动时的重复开发工作。
+**产品概念：** 一个基于现代化技术栈的酒店公寓全栈管理系统，支持多端切换（租户/公寓/商家/内部管理），提供完整的房源管理、订单管理、支付结算、积分商城等功能。
 
 **解决的主要问题：**
-- 新项目开发中重复的基础架构搭建工作
-- 缺乏标准化的管理后台起点
-- 开发团队在项目初期需要反复实现相同的核心功能
+- 酒店公寓行业缺乏标准化的数字化管理系统
+- 多端用户（租户、公寓、商家、管理员）需要统一平台管理
+- 复杂的支付结算、房源管理、订单跟踪需求
+- 积分体系和分销推广的自动化管理
 
 **目标市场：**
-- 中小型软件开发团队
-- 全栈开发者
-- 需要快速启动管理后台项目的创业公司
+- 酒店公寓运营商
+- 长租公寓管理公司
+- 民宿管理平台
+- 共享住宿服务提供商
 
-**核心价值主张：** 提供开箱即用的专业级管理后台基础架构，让开发团队能够专注于业务逻辑而非重复的基础设施建设。
+**核心价值主张：** 提供完整的酒店公寓数字化管理解决方案，实现多端协同、自动化运营和智能化管理。
 
 ## Problem Statement
 
 **当前状态和痛点：**
 
-在新项目开发中，特别是管理后台类项目，开发团队面临以下挑战：
+在酒店公寓管理行业中，运营者面临以下数字化管理挑战：
 
-1. **重复劳动严重** - 每个新项目都需要重新实现用户认证、权限管理、基础CRUD操作等通用功能
-2. **开发效率低下** - 项目初期大量时间花费在基础设施搭建而非业务逻辑开发上
-3. **代码质量不一致** - 不同开发者实现的相同功能存在质量差异，缺乏统一标准
-4. **维护成本高** - 分散的实现方式导致后续维护和升级困难
-5. **学习曲线陡峭** - 新成员需要时间熟悉项目特有的基础架构
+1. **多端管理复杂** - 租户、公寓、商家、管理员需要不同的功能界面，缺乏统一平台
+2. **支付结算繁琐** - 代扣管理、押金管理、线下支付记录等需要人工处理
+3. **房源管理低效** - 房态更新、房源推荐、位置匹配等缺乏自动化
+4. **订单跟踪困难** - 从预定到退宿的全流程状态跟踪不完善
+5. **营销推广不足** - 积分体系、分销渠道、邀请奖励等缺乏系统化管理
 
 **问题影响：**
-- 项目启动时间延长30-50%
-- 开发团队生产力受到基础工作的拖累
-- 技术债务从项目初期就开始积累
-- 团队难以专注于核心业务价值创造
+- 运营效率低下，人工成本高
+- 客户体验不一致，满意度下降
+- 数据统计不准确，决策缺乏依据
+- 营销效果难以量化，获客成本高
 
 **现有解决方案的不足：**
-- 通用后台框架过于臃肿，包含大量不需要的功能
-- 现有模板缺乏现代化技术栈整合（如shadcn/ui + 全栈架构）
-- 大多数模板只提供前端或后端，缺乏完整的全栈解决方案
-- 定制化程度不够，难以适应具体业务需求
+- 传统酒店管理系统功能单一，无法满足公寓管理需求
+- 通用物业管理软件缺乏酒店行业的专业功能
+- 定制化系统开发成本高，维护困难
+- 缺乏多端协同和移动端支持
 
 **紧迫性和重要性：**
-随着数字化转型加速，企业对内部管理系统的需求快速增长，开发团队需要更高效的工具来应对快速变化的市场需求。现在解决这个问题能够显著提升开发团队竞争力。
+随着共享经济和长租公寓市场的快速发展，数字化管理成为行业竞争的关键。现在解决这个问题能够帮助运营商提升效率、降低成本、改善客户体验。
 
 ## Proposed Solution
 
 **核心概念和方法：**
-提供一个精心设计的全栈管理后台启动模板，基于现代化的技术栈组合：shadcn/ui前端 + 类型安全的全栈框架。模板将包含预配置的用户管理系统、认证流程、权限控制和通用CRUD操作。
+提供一个完整的酒店公寓全栈管理系统，基于现代化技术栈（Hono + React + TypeORM），支持多端用户角色切换，提供房源管理、订单管理、支付结算、积分商城等核心功能。
 
 **关键差异化因素：**
-1. **技术栈优势** - 结合shadcn/ui的优秀设计系统和现代全栈框架
-2. **开箱即用** - 无需配置即可运行，包含开发环境所需的一切
-3. **模块化设计** - 易于扩展和定制，不强制特定的架构模式
-4. **类型安全** - 前后端完全类型安全，减少运行时错误
-5. **最佳实践** - 内置代码规范、测试配置和部署脚本
+1. **多端协同** - 租户端、公寓端、商家端、管理端统一平台，角色切换无缝
+2. **支付集成** - 支付宝/微信/银行卡代扣，信用押金，线下支付统一管理
+3. **智能推荐** - 基于高德地图的房源位置匹配和实时路线规划
+4. **积分体系** - 完整的积分获取、兑换、商城功能
+5. **分销推广** - 邀请奖励、分销渠道、佣金结算一体化
 
 **成功因素：**
-- 专注于解决具体的痛点（重复劳动）
-- 提供真实可用的代码而非概念验证
-- 保持轻量级，避免框架膨胀
-- 良好的文档和示例
+- 专注于解决酒店公寓行业的特定痛点
+- 提供完整的业务流程闭环
+- 支持移动端和小程序访问
+- 与第三方服务（高德地图、支付接口）深度集成
 
 **产品愿景：**
-成为全栈开发者首选的管理后台起点，显著降低项目启动门槛，让团队能够更快地交付业务价值。
+成为酒店公寓行业首选的数字化管理平台，帮助运营商实现自动化运营、智能化管理和精准化营销。
 
 ## Target Users
 
-**Primary User Segment: AI编码代理**
-- **技术背景：** 需要结构化、标准化的代码模板来生成一致性高的代码
-- **工作流程：** 基于模板快速生成业务系统代码，减少重复性工作
-- **核心需求：** 预配置的架构、清晰的代码规范、易于扩展的模式
-- **痛点：** 需要为每个项目重新定义基础架构，缺乏标准化起点
+**Primary User Segment: 租户**
+- **使用场景：** 寻找房源、预定入住、支付租金、使用积分、邀请好友
+- **核心需求：** 便捷的房源搜索、安全的支付方式、积分奖励、优质服务
+- **痛点：** 房源信息不准确、支付流程复杂、缺乏激励机制
 
-**Secondary User Segment: 非专业开发人员**
-- **技术背景：** 基础编程知识，需要低代码/模板化的解决方案
-- **工作流程：** 使用现成模板快速搭建业务系统，专注于业务逻辑配置
-- **核心需求：** 开箱即用、易于理解、最小化配置需求
-- **痛点：** 从零开始搭建系统的复杂性，技术细节的学习成本
+**Secondary User Segment: 公寓运营商**
+- **使用场景：** 房源管理、租户管理、订单处理、收益结算、数据统计
+- **核心需求：** 高效的房态管理、自动化结算、数据报表、客户维护
+- **痛点：** 人工操作繁琐、数据统计困难、客户流失率高
+
+**Tertiary User Segment: 商家**
+- **使用场景：** 店铺宣传、社群运营、订单派发、服务跟踪
+- **核心需求：** 精准营销、订单管理、客户关系维护
+- **痛点：** 获客成本高、订单管理混乱、客户粘性低
+
+**Quaternary User Segment: 内部管理员**
+- **使用场景：** 全局监控、数据管理、异常处理、系统配置
+- **核心需求：** 全面的数据视图、高效的异常处理、灵活的配置选项
+- **痛点：** 数据分散、异常响应慢、系统维护复杂
 
 **目标业务场景：**
-- 数据驱动的业务管理系统
-- 需要大量CRUD操作的企业应用
-- 内部管理工具和后台系统
-- 中小型企业的定制化业务系统
+- 酒店公寓日常运营管理
+- 长租公寓租赁业务
+- 民宿预订和管理
+- 共享住宿服务平台
 
 ## Goals & Success Metrics
 
 ### Business Objectives
-- 建立AI驱动的需求开发自动化流程
-- 通过BMAD方法论实现端到端的开发规范
-- 减少人工干预，提高需求到代码的转换效率
-- 为业务逻辑开发提供标准化框架
+- 建立完整的酒店公寓数字化管理平台
+- 实现多端用户协同运营
+- 提升运营效率和客户满意度
+- 降低人工成本和运营风险
 
 ### User Success Metrics
-- **上手时间：** 新用户30分钟内理解并使用开发流程
-- **任务完成率：** 用户能够成功完成95%的常见开发任务
-- **满意度：** 用户反馈评分4.5/5以上
+- **租户满意度：** 房源搜索成功率>90%，支付成功率>95%
+- **公寓运营效率：** 房态更新及时率>95%，订单处理时间<30分钟
+- **商家转化率：** 订单转化率提升30%以上
+- **管理员效率：** 异常处理响应时间<1小时
 
 ### Key Performance Indicators (KPIs)
-- **开发效率提升：** 需求到可运行代码的时间减少50%以上
-- **代码一致性：** AI生成代码与规范符合度达到90%+
-- **人工干预率：** 需要人工修正的代码比例低于10%
-- **需求覆盖度：** 能够处理80%以上的常见业务场景
-- **处理速度：** 单个需求处理时间<5分钟
-- **准确率：** 代码生成准确率>85%
-- **扩展性：** 支持至少10种常见业务模式
-- **稳定性：** 系统可用性99.9%
+- **房源管理：** 房源上架时间<5分钟，房态准确率>98%
+- **订单处理：** 订单创建到确认时间<10分钟，退宿处理时间<15分钟
+- **支付结算：** 代扣成功率>95%，结算准确率>99%
+- **积分体系：** 积分兑换率>20%，商城订单转化率>15%
+- **系统性能：** API响应时间<200ms (p95)，并发支持1000+用户
+- **数据准确性：** 报表数据准确率>99%，导出成功率>98%
+- **用户体验：** 页面加载时间<2秒，操作成功率>95%
+- **系统稳定性：** 系统可用性99.9%，故障恢复时间<30分钟
 
 ## MVP Scope
 
 ### Core Features (Must Have)
-- **用户管理系统**
-  - 用户注册、登录、认证
-  - 基本的用户信息管理
-  - 权限和角色管理基础框架
-
-- **通用CRUD路由及服务**
-  - 标准化的CRUD操作接口
-  - 统一的数据验证和错误处理
-  - 类型安全的API设计
-
-- **关联查询支持**
-  - 基础的表关联查询功能
-  - 标准化的关联数据处理模式
-  - 查询性能优化基础
-
-- **用户操作跟踪**
-  - 基本的操作日志记录
-  - 用户行为追踪框架
-  - 审计日志基础功能
+- **多端用户系统**
+  - 租户端：房源搜索、预定、支付、积分管理
+  - 公寓端：房源管理、租户管理、订单处理
+  - 商家端：店铺宣传、订单派发
+  - 管理端：全局监控、数据管理
+
+- **房源管理**
+  - 房源上架、编辑、下架
+  - 房态实时更新和备注
+  - 基于位置的房源推荐
+  - 高德地图集成
+
+- **订单管理**
+  - 预定、确认、入住、退宿全流程
+  - 订单状态跟踪
+  - 自动延期续租
+  - 逾期催收管理
+
+- **支付结算**
+  - 支付宝/微信/银行卡代扣
+  - 信用押金管理
+  - 线下支付记录
+  - 自动结算和提现
 
 ### Out of Scope for MVP
-- 高级权限管理系统
-- 复杂的数据分析功能
-- 第三方服务集成
-- 高级报表和仪表板
-- 移动端适配
-- 多语言支持
-- 高级缓存策略
+- 高级数据分析和大屏展示
+- 复杂的营销活动配置
+- 多语言国际化支持
+- 高级权限细分
+- 第三方服务商深度集成
+- 移动端原生应用
 
 ### MVP Success Criteria
-- 能够处理80%的基础业务CRUD需求
-- 开发新实体时间减少70%以上
-- 代码生成准确率达到85%
-- 系统稳定运行无重大故障
+- 支持100个房源、1000个用户的基本运营
+- 订单处理全流程自动化完成
+- 支付结算准确率>95%
+- 系统稳定运行，核心功能无重大故障
 
 ## Technical Considerations
 
 ### Platform Requirements
-- **Target Platforms:** Web应用，支持现代浏览器（Chrome, Firefox, Safari, Edge最新版本）
-- **Browser/OS Support:** Node.js 18+ 环境，支持Docker容器化部署
-- **Performance Requirements:** API响应时间<200ms (p95)，并发支持100+用户，复杂查询<1s
+- **Target Platforms:** Web应用 + 小程序，支持现代浏览器和移动端
+- **Browser/OS Support:** Node.js 20.19.2+ 环境，支持Docker容器化部署
+- **Performance Requirements:** API响应时间<200ms (p95)，并发支持1000+用户，复杂查询<1s
 
-### Technology Preferences
+### Technology Preferences (基于当前项目)
 - **Frontend:** React + TypeScript，shadcn/ui组件库，Vite构建工具
-- **Backend:** Node.js + TypeScript，Express/NestJS框架
-- **Database:** TypeORM/Prisma ORM，PostgreSQL，Redis缓存
-- **Hosting/Infrastructure:** Docker容器化，Kubernetes就绪，云原生架构
+- **Backend:** Hono + TypeScript，TypeORM ORM
+- **Database:** PostgreSQL 17，Redis 7缓存
+- **Storage:** MinIO对象存储
+- **Hosting/Infrastructure:** Docker容器化，多八多云端容器环境
 
 ### Architecture Considerations
 - **Repository Structure:** 单体仓库(monorepo)设计，前后端分离但统一管理
-- **Service Architecture:** 模块化设计，支持微服务扩展，插件架构支持自定义扩展
-- **Integration Requirements:** RESTful API设计，GraphQL就绪，WebSocket支持
+- **Service Architecture:** 模块化设计，支持多端用户角色
+- **Integration Requirements:** RESTful API设计，高德地图API集成，支付接口集成
 - **Security/Compliance:** JWT认证，RBAC权限控制，数据加密，审计日志
 
 ## Constraints & Assumptions
 
 ### Constraints
 - **Budget:** 基于现有云端开发环境，无额外基础设施成本
-- **Timeline:** 3个月实现核心MVP，6个月达到生产就绪
+- **Timeline:** 4个月实现核心MVP，8个月达到生产就绪
 - **Resources:** 现有开发团队，基于多八多云端容器环境
-- **Technical:** 必须兼容Node.js 20.18.3，PostgreSQL 15，Redis 7，MinIO存储
+- **Technical:** 必须兼容Node.js 20.19.2，PostgreSQL 17，Redis 7，MinIO存储
 
 ### Key Assumptions
 - 开发环境和生产环境配置一致性能够简化部署
-- 现有技术栈能够满足BMAD方法论的技术需求
-- AI驱动开发流程能够在该技术栈上有效实现
+- 现有技术栈能够满足酒店公寓管理系统的业务需求
+- 第三方服务（高德地图、支付接口）稳定可用
 - 团队具备足够的TypeScript和全栈开发经验
 - 云端容器环境稳定可用
 - 数据库和存储服务性能满足需求
@@ -188,33 +203,33 @@
 
 ### Key Risks
 - **技术栈复杂性风险：** Hono框架 + TypeORM + React组合相对较新，社区支持可能不如传统组合成熟
-- **AI集成风险：** BMAD方法论与现有技术栈的集成可能遇到兼容性问题
-- **性能风险：** TypeORM在复杂关联查询下的性能需要验证
-- **安全风险：** JWT认证和权限系统的实现需要严格的安全审计
+- **支付集成风险：** 支付宝/微信/银行卡代扣接口的稳定性和安全性
+- **性能风险：** TypeORM在复杂关联查询（房源-订单-用户）下的性能需要验证
+- **安全风险：** 支付数据、用户隐私数据的安全保护
 
 ### Open Questions
-- Hono框架与BMAD方法论的适配程度需要进一步验证
-- TypeORM在多数据库场景下的迁移策略
-- 前端状态管理（React Query）与后端缓存的一致性
-- 实时功能（WebSocket）与现有架构的集成方式
+- 高德地图API的调用频率限制和成本控制
+- 支付接口的合规性和资质要求
+- 多端用户权限的细粒度控制策略
+- 积分体系和分销推广的防作弊机制
 
 ### Areas Needing Further Research
-- Hono框架的最佳实践和性能优化
-- TypeORM高级特性（数据迁移、查询优化）
-- React Server Components与现有架构的兼容性
-- 微服务拆分策略和时机
+- 高德地图位置服务和路线规划API的深度集成
+- 支付接口的对接方案和技术实现
+- 积分商城的商品管理和库存同步
+- 分销渠道的佣金计算和结算流程
 
 ## Next Steps
 
 ### Immediate Actions
-1. 技术栈深度评估和验证
-2. 建立开发环境和工具链
-3. 制定详细的开发计划和时间表
-4. 组建核心开发团队并分配角色
-5. 建立代码规范和开发流程
+1. 详细需求分析和功能优先级排序
+2. 数据库设计和实体关系建模
+3. 第三方服务（高德地图、支付接口）技术调研
+4. 制定详细的开发计划和时间表
+5. 建立酒店公寓业务领域的代码规范和开发流程
 
 ### PM Handoff
 
-This Project Brief provides the full context for shadcn全栈管理后台启动模板. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
+This Project Brief provides the full context for 酒店公寓管理系统. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements.
 
 **项目已就绪，可以开始PRD生成流程。**