内容
<p align="center">
<img src="branding/png/kamra-mark-512.png" width="96" alt="Kamra" />
</p>
<h1 align="center">Kamra PMS</h1>
<p align="center"><b>开源、AI原生的酒店管理系统。</b><br/>
使用您可控的AI代理管理酒店 — 基于您拥有的基础设施。</p>
<p align="center">
<a href="https://demo.kamrapms.com"><b>▶ 在线演示</b></a> ·
<a href="https://github.com/Kamra-PMS/kamra-pms/tree/main/docs"><b>文档</b></a> ·
<a href="https://github.com/Kamra-PMS/kamra-pms"><b>源码</b></a> ·
<a href="mailto:hello@kamrapms.com"><b>联系</b></a>
</p>
> ### 🏨 立即试用 → **[demo.kamrapms.com](https://demo.kamrapms.com)**
> 一个预加载了示例酒店的在线沙盒。 **点击任意角色登录 — 演示用户名和密码直接在页面上列出。** 客房预订引擎位于 [/book](https://demo.kamrapms.com/book) 而客房服务电话应用位于 [/kamra/hk](https://demo.kamrapms.com/kamra/hk)。
---
## 为什么我们要开发这个
大多数酒店管理系统软件都是二十年前开发的，从那时起几乎没有变化。 有数十个选项，但几乎没有创新：相同的点击式屏幕，相同的夜间例行程序，相同的数据壁垒。
酒店理应拥有比以下更好的系统：
- **按房间、按模块付费。** 您的软件账单随着酒店的扩张而增长。 夜间审计是一个附加功能。 报告是一个附加功能。 预订引擎是一个附加功能。
- **您的数据被劫持。** 客人历史、费率历史、您的账簿 — 锁定在供应商的云中，如果您尝试离开，需要支付导出费用。
- **等待永远不会到来的AI。** 传统供应商将聊天机器人附加到2005年的软件上，并称之为创新。 真正的代理操作需要一个专门为代理设计的系统。
- **集成炼狱。** 每个连接都是一个付费接口、一个认证队列、一个季度等待。
- **只有受过培训的员工才能使用的软件。** 如果新员工需要一周的培训才能为客人办理入住手续，那么软件就失败了 — 而不是员工。
**Kamra是我们希望存在的答案：** 一个完整的物业管理系统，其中每个操作 — 预订、入住、账单、夜间审计、定价 — 都是一个受控的操作，可以由AI代理执行，拥有者的防护措施由系统强制执行，而不是由希望执行。
## Kamra的不同之处
- **AI和代理原生，MCP优先。** Kamra附带一个 [MCP服务器](mcp/kamra_mcp.py)，包含17+工具。 连接Claude（或任何MCP客户端）并说 *"为周末预订Rao先生一个带早餐的豪华房"* — 代理报价、预订并记录。 代理只是用户：角色范围、权限检查、完全审计。
- **自带密钥。** 没有捆绑的AI标记，没有模型锁定。 将您自己的LLM指向Kamra的工具表面。
- **确定性货币。** 价格、税费、可用性来自定价引擎 — 而不是来自语言模型。 GST板块、多费率发票和不超订保证是代码，通过CI中的评估套件验证。
- **自主权有约束。** 拥有者设置费率下限/上限和批准阈值；代理实际上不能在它们之外定价。 每个自动操作记录它节省的分钟数 — ROI是一个仪表板，而不是承诺。
- **真正免费。** AGPL许可。 没有按房间计价，没有按用户座位计价，没有许可审计。 在本地或任何云上自行托管。
- **构建在Frappe上。** ERPNext背后的框架 — 世界上最大的开源ERP之一 — 拥有成熟的生态系统：RBAC、审计跟踪、多租户、frappe/payments网关应用和庞大的开发者社区。
## 看看
*以下屏幕截图均来自 [在线演示](https://demo.kamrapms.com) — 打开它并点击周围。*
| | |
|---|---|
|  |  |
| **今日** — 到达、离开、房内付费/应付、房间板、节省时间账本 | **预订360** — 一个面板显示实时计费、内联日期修改、客人旅程和正确的入住/离开/取消操作 |
|  |  |
| **磁带图表** — 房间×日期、预订条、房间移动和停留修改 | **报告** — 入住率/ADR/RevPAR、MTD、收款、14天趋势、可打印快报 |
|  |  |
| **新预订** — 返回客人类型搜索、实时报价、销售信息、多房间、附加项、取消政策（ plain text） | **客人资料** — 停留记录、终身统计数据、即将到来的停留、合并和匿名 |
|  |  |
| **账单和GST发票** — 每行GST、分割/转账、付款链接、多费率分解 | **公共预订页面** — SEO友好、实时费率、酒店付款、零佣金 |
## 当前内容
| 区域 | 已包含 |
|---|---|
| 前台 | 今日仪表盘，显示已付/应付、 一键入住/出住、磁带图表、预订、客人 **资料中心** （停留记录、合并重复项、匿名/DPDP）、黑名单 |
| 预订 | 公共SEO友好预订引擎、 **一次预订多个房间**、团队和公司预订、代他人预订（预订者vs客人）、返回客人类型搜索、 **预订时添加附加项**、销售信息、旅行社佣金、日间 |
| 收益 | 基于入住率的定价、季节、费率计划、代金券、餐计划、 **费率防护栏**、取消/不出现/押金 **在代码中强制执行**、业主简报API |
| 计费 | 账单每行GST（₹7,500板块自动切换）、 **公司计费规则** （费用路由、酒精始终计入客人）、 **团体主账单**、%/₹ **费用分割**，精确保留、批量转账、自动夜间审计也对未出现者收费、GST发票附B2B GSTIN、GSTR-1导出、收银员对账、通过frappe/payments的付款链接 |
| 运营 | 服务票证附SLA、客房服务 **移动应用**（`/hk`）、遗失和发现、班次交接、POS-lite（出口/菜单/订单→账单、酒精感知）、场地和活动 |
| 客人 | 自助入住链接、可打印 **GRC附合法占用者登记册**、ID保留模式（存储/验证和丢弃）、体验展示 |
| 平台 | 多属性附用户范围、六角色RBAC、设置中心、 **暗黑模式**、入职向导+ **AI迁移工具**、节省账本、 **CI中18检查评估套件** |
## 文档
完整文档位于 [`docs/`](docs/)：
- [前台用户指南](docs/user-guide.md) — 一天到结束
- [AI和API设置](docs/ai-and-api.md) — 自带密钥、MCP、API密钥、REST
- [自托管指南和先决条件](docs/self-hosting.md)
- [电子邮件设置](docs/email-setup.md)
- [开发者笔记](docs-dev.md) · [品牌资产](branding/README.md)
## 安装
```bash
bench get-app payments
bench get-app kamra https://github.com/Kamra-PMS/kamra-pms
bench --site your-site install-app kamra
```
Kamra附带其内置的前端，因此安装后产品UI在 **`/kamra`** （预订引擎重定向到 `/book`，客房服务到 `/hk`） — 生产环境中无需Node服务器。 Frappe Desk作为管理员逃生舱口保留在 `/app`。
## 快速入门（开发）
```bash
bench init --frappe-branch v16.25.0 frappe-bench && cd frappe-bench
bench get-app payments
bench get-app kamra https://github.com/Kamra-PMS/kamra-pms
bench new-site kamra.localhost --admin-password admin
bench --site kamra.localhost install-app kamra
bench serve --port 8000
cd apps/kamra/frontend && npm install && npm run dev # 在:5173上热重载UI
```
在前端更改后，使用 `npm run build` 重建生产UI（输出到 `kamra/public/frontend`，在 `/kamra` 提供服务）。 通过 `bench --site … execute kamra.scripts.seed_demo.execute` 使用演示属性、角色和用户进行种子（这也会在登录屏幕上启用演示账户按钮）。 完整的开发说明： [docs-dev.md](docs-dev.md).
连接AI代理：
```bash
claude mcp add kamra -e KAMRA_URL=... -e KAMRA_API_KEY=... \
-e KAMRA_API_SECRET=... -- python mcp/kamra_mcp.py
```
## 针对酒店业主
您拥有软件、服务器和每字节的数据。 成本不随房间数量而增加。 您的AI前台从第一天起就开始工作 — 如果您需要托管或AI员工（语音、WhatsApp）作为附加服务，这些是选择，而不是赎金。
## 针对IT团队
标准Python（Frappe）+ React。 真实的RBAC，真实的审计跟踪，记录的REST + MCP接口，CI中的评估套件，无黑盒。 分叉它，扩展它，发布您自己的模块 — 这就是目的。
## 许可
AGPL-3.0 — 永久免费。 任何提供Kamra作为托管服务的人必须分享他们的修改，这使得生态系统诚实。
## 链接和联系
- **在线演示：** [demo.kamrapms.com](https://demo.kamrapms.com) — 凭证在页面上
- **文档：** [`docs/`](docs/)
- **源码和问题：** [github.com/Kamra-PMS/kamra-pms](https://github.com/Kamra-PMS/kamra-pms)
- **电子邮件：** [hello@kamrapms.com](mailto:hello@kamrapms.com)
由 [HeyKoala](https://heykoala.ai) 构建。
*Kamra的意思是“房间”。 我们的标志中的门是故意打开的。*
