🏨 酒店管理与渠道聚合系统
完整的酒店管理解决方案，专为 Odoo 18 设计开发
📋 系统概述
这是一套完整的酒店管理与渠道聚合解决方案，专为 Odoo 18 社区版 设计开发。 系统支持酒店、房型、房间的全面管理，提供线上线下订单处理，集成多渠道API接口， 实现酒店与第三方OTA平台（携程、美团、飞猪等）的无缝对接。
图1: 系统主界面概览
✨ 核心功能
🏢 酒店基础管理
- 多酒店、多公司支持
- 酒店信息管理（地址、联系方式、星级）
- 房型定义（床型、价格、设施、取消规则）
- 房间管理（房态、价格、售卖类型）
- 实时房态更新（空闲、预订、入住、维修）
📝 订单全流程管理
- 线上线下订单统一管理
- 订单流程：草稿 → 确认 → 入住 → 退房
- 支持订单取消与退款
- 一键复刻功能：快速复制订单重新下单
- 订单日历与看板视图
- 订单确认单打印（含二维码）
🌐 渠道聚合与API
- 多渠道接入（携程、美团、飞猪等）
- 企业唯一标识 + Token 认证机制
- Token自动生成与轮换
- RESTful JSON API接口
- 渠道映射与定价策略
- 接口调用日志与审计
📊 库存与价格管理
- 按日期管理房间库存
- 总库存、已售、可售自动计算
- 批量更新价格与库存
- 库存预警机制
- 开放售卖状态控制
📈 数据看板与报表
- 实时在住统计
- 近7天/30天订单与收入分析
- 按酒店/渠道/房型的多维度统计
- 订单图表与透视表
- 消息面板与告警通知
🔐 权限与安全
- 四级权限：酒店经理、渠道经理、前台用户、API客户端
- 多公司数据隔离
- 记录级权限控制
- 价格修改权限保护
- 操作日志与审计追踪
📊 数据看板
实时监控酒店运营数据，包括酒店数、房间数、入住率、在住房间、订单数等关键指标。 支持按时间范围、酒店、统计口径进行筛选，提供多维度数据分析和可视化图表。
图2: 数据看板界面 - 实时运营数据监控
主要功能
- • 关键指标卡片：酒店数、房间数、入住率、在住房间、订单数
- • 房间状态分布：按酒店展示房间状态（在住、可售、已预订、停用）
- • 渠道销售分析：按房型分组展示各渠道销售情况
- • 趋势图表：入住率趋势、平均价格（ADR）分析
📝 订单管理
统一的订单管理平台，支持线上线下订单的统一处理。提供看板视图，按订单状态分组展示， 支持订单的创建、确认、入住、退房全流程管理，以及一键复刻功能快速复制订单。
图3: 订单管理看板视图 - 按状态分组展示
🔄 订单流程
- 草稿 → 已确认 → 已入住 → 已退房
- 支持订单取消与库存释放
- 订单状态不可逆转
⚡ 一键复刻
- 快速复制现有订单
- 自动创建新草稿单
- 大幅提升下单效率
📋 多视图支持
- 看板视图（按状态分组）
- 列表视图（详细数据）
- 日历视图（时间轴展示）
- 表单视图（完整信息）
🏢 酒店管理
酒店信息管理，支持多酒店、多公司运营。提供看板视图展示酒店卡片，包含酒店图片、星级、 基本信息、统计数据等。支持酒店的新增、编辑、启用/停用等操作。
图4: 酒店管理看板视图 - 酒店卡片展示
🛏️ 房型管理
房型定义与管理，包括床型、价格、设施、取消规则等。每个房型卡片展示详细信息， 支持按酒店筛选，查看房型的房间数量、基础价格、设施配置等。
图5: 房型管理界面 - 房型卡片展示
🚪 房间管理
房间信息管理，实时显示房间状态（空闲、已预订、已入住、维修中）。每个房间卡片 展示房间号、楼层、房型、价格、售卖类型等信息，支持按状态筛选和搜索。
图6: 房间管理界面 - 房间状态卡片展示
🌐 渠道管理
多渠道接入管理，支持携程、美团、飞猪、Booking.com、去哪儿、艺龙等主流OTA平台。 每个渠道卡片展示渠道信息、订单数、同步日志、运行状态等，支持Token管理和API配置。
图7: 渠道管理界面 - 渠道卡片展示
渠道功能特性
- • 企业唯一标识：每个渠道分配独立的 enterprise_key
- • Token认证：自动生成Token，支持手动轮换，有效期1年
- • 渠道映射：支持灵活的定价策略（基础价、加价、减价、固定价）
- • 同步日志：完整记录API调用情况，便于审计和排查问题
🔌 API接口说明
提供完整的RESTful JSON API接口，支持第三方系统集成。所有接口采用JSON-RPC格式， 使用Enterprise Key + Token双重认证，确保接口安全。
接口格式: JSON-RPC | 认证方式: Enterprise Key + Token | 响应格式: 统一JSON格式
接口列表
🔑 获取Token
POST /api/channel/token
根据企业唯一标识获取访问Token，Token有效期1年，支持手动轮换。
🏨 查询房间
POST /api/hotel/rooms
获取酒店房间列表，支持分页查询，返回房间详细信息、价格、库存等。
📝 创建订单
POST /api/order/create
创建新订单，自动验证房间可用性，扣减库存，生成订单号。
💰 更新价格库存
POST /api/room/update
批量更新房间价格与库存，支持按日期范围批量操作。
🔄 更新订单
POST /api/order/update
更新订单信息，支持订单取消、改期等操作，自动处理库存。
📋 订单详情
POST /api/order/detail
查询订单详细信息，包括订单状态、客人信息、房间信息等。
统一响应格式
{
"code": 0, // 0=成功, -1=失败
"msg": "成功", // 消息说明
"data": {...}, // 返回数据
"timestamp": 1699430400 // 时间戳
}🚀 安装与部署
📋 环境要求
- Odoo 18 Community Edition
- Python 3.11+
- PostgreSQL 14+
- 推荐内存: 4GB+
⚙️ 安装步骤
- 将模块复制到 addons 目录
- 重启 Odoo 服务
- 更新应用列表
- 搜索"酒店管理"并安装
🎁 演示数据
- 2家酒店
- 3种房型
- 5个房间
- 2个渠道
- 5个订单样例
Docker 快速部署
使用 Docker Compose 一键部署：
cd hotel_channel_hub
docker-compose up -d访问 http://localhost:8069 开始使用
🌟 核心亮点
⭐ 一键复刻功能
订单详情页点击"一键复刻"按钮，快速复制订单并创建新草稿单， 大幅提升下单效率，特别适合重复预订场景。
🔌 完整的API生态
6个RESTful接口，支持获取Token、查询房间、创建订单、更新价格库存、 订单管理等全流程操作，满足第三方系统集成需求。
📊 多视图支持
每个模型都提供列表、表单、搜索视图，订单额外提供日历和看板视图， 提升用户体验，满足不同场景的使用需求。
🌐 渠道聚合架构
支持多渠道接入，每个渠道独立的Token认证，渠道映射支持灵活的定价策略， 实现与主流OTA平台的无缝对接。
🎁 完整的演示数据
安装即可体验完整功能，无需手动创建数据。包含酒店、房型、房间、 渠道、订单等完整演示数据，快速上手使用。
🔐 企业级权限控制
四级权限组，多公司支持，记录级访问控制，确保数据安全。 支持酒店经理、渠道经理、前台用户、API客户端等不同角色。
酒店管理与渠道聚合系统
版本 18.0.1.0.0 | 许可证 LGPL-3
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3302 |
| Technical Name |
hotel_channel_hub |
| License | LGPL-3 |
| Website | https://www.zjdtcloud.com/ |
Please log in to comment on this module