← 返回项目库

MicroRealEstate 中文租务管理台（本地演示）

MicroRealEstate 是面向房东和小型租务团队的房源、租客、合同与租金收款管理台。

本地化交付保留 Next.js 房东端与租客端网页界面，并提供可复现的本地演示适配器：房源、租客、合同、租金、收款和租务动态均使用中文演示数据；外部认证、邮件、PDF、MongoDB 与 Redis 服务未连接，界面已明确标注演示模式。

真实界面

项目截图

共 6 张

工作台
房源
租客
租金
新入住租客
合同

Capabilities

核心功能

✓中文房源列表、房源状态与租金信息
✓租客档案、租约期限与入住状态管理
✓月度租金应收、已收、部分收款与欠款统计
✓收款记录写入、状态更新与关联回读
✓合同模板、续约提醒与租务动态
✓房东端核心路由与本地演示数据适配器

适用场景

在本地评估少量房源的租务管理和收款工作流
为自托管部署准备房源、租客、合同和租金数据模型
基于上游开源项目进行中文界面和业务适配开发

适合谁

需要在自有环境中管理少量房源、租客、租约和月度收款记录的个人房东与小型租务团队。

商业化思路

上游源码按 Sustainable Use License（SUL）v2.0 交付；允许范围内的个人、非商业自托管使用请遵守许可证，商业使用、托管服务或超过五套房源需另行取得权利人许可。

你会拿到什么

  • ✓MicroRealEstate 上游源码、房东端与租客端网页应用
  • ✓中文核心界面、本地演示适配器、API 路由和功能验证证据
  • ✓原始 LICENSE.md、源码 README、本地构建与完整部署说明

部署流程

  1. 1安装 Node.js、Yarn 与 Docker Compose，按 README 配置 MongoDB、Redis、认证、PDF 和邮件服务
  2. 2先在本地完成真实认证、租金写入、文件生成和权限测试，再切换生产环境变量并部署
  3. 3生产使用前核对 SUL 的非商业限制、五套房源阈值、商标和所有依赖许可证要求

真实验证结果

已通过 6 个真实运行的中文功能页、HTTP 200、演示房源/租客/租金/合同数据、租金收款 PATCH 写入与 GET 回读、控制台无错误、无坏图和无横向溢出验收。

部署前须知

本次截图与功能验证使用 DEMO_MODE 和内存演示数据，收款写入仅在当前进程内生效；外部认证、邮件、PDF、MongoDB、Redis、文件存储和生产权限策略未在本地预览中接入。完整生产部署前必须补齐服务配置并重新做安全与权限验收。

部署难度

较高

最低配置

Node.js 20+；完整生产部署还需要 Docker Compose、MongoDB、Redis、认证器、PDF/邮件服务及相应环境变量。当前本地预览使用 Node.js、Next.js 和内存演示适配器，不连接这些外部服务。

开源许可证

Sustainable Use License (SUL) v2.0; historical MIT scope disclosed upstream

最后验证

2026-09-02

授权说明

交付包保留上游 LICENSE.md。LICENSE.md 说明 master 分支至 479d0ad 的提交为 MIT，main 分支自 a95d44e 起为 Sustainable Use License（SUL）；本次来源提交 0bc53f4 属于后者。中文界面和本地演示适配属于本地化修改，禁止把本交付宣传为可自由商业托管或商业再分发。

Release notes

版本记录

1 个已发布版本

vcn-0bc53f4c8be1 当前推荐

将 MicroRealEstate 房源、租客、合同、租金和租务动态核心界面本地化为简体中文，补充可复现的本地演示适配器、外部服务未接入声明和收款写入回读验证。

部署要求：Node.js 20+；完整生产部署需要 Docker Compose、MongoDB、Redis、认证、PDF、邮件和文件存储配置；当前截图使用本地 DEMO_MODE。

已知问题：演示环境不接入外部服务，收款修改仅在当前进程内生效；请按 LICENSE.md 核对 SUL v2.0 的个人非商业使用、五套房源阈值和商业许可限制。

登录后领取