架构 · 接口 · 安全

采购之前
先把技术底牌摊开

物业软件最怕两件事:上线后发现跑不动,以及三年后被锁死换不掉。这一页把三套系统的技术栈、部署形态、开放接口、硬件兼容清单和数据隔离机制全部公开——包括我们不做什么。

技术栈

三套系统各自的技术底座

三套系统语言与框架不同,通过 HTTP 接口与共享数据契约协作,不依赖同一进程,可独立扩容。

AI AI智慧物业(对话层)

语言/框架Python · FastAPI · OpenAI Agents SDK
对话引擎ChatKit + 6 个 Agent + 17 个业务工具
主模型小米 MiMo(mimo-v2.5),支持 10 家厂商热切换
可切换厂商通义 / 混元 / 豆包 / DeepSeek / OpenAI / GLM / Kimi / 千帆 / 自定义 / Token计划
语音MiMo ASR(mimo-v2.5-asr)+ TTS(mimo-v2.5-tts)
向量检索paraphrase-multilingual-MiniLM-L12-v2
安全护栏相关性护栏 + 越狱护栏(独立模型)
存储SQLite 分库:租户 / 物业 / 知识库 / 工单桥 / 会话日志
服务形态uvicorn 常驻服务

物业 智慧物业(底座层)

语言/框架Java 8 · Spring Boot 2.0.4 · Spring Cloud(Eureka)
持久层MyBatis 3.5.6 · MySQL(570+ 张业务表)
缓存/调度Redis · 内嵌 Quartz 定时任务
前端Vue 2.6 · vue-router 3 · Element-UI 2.15
图表/编辑器ECharts 5 · TinyMCE / wangEditor
国际化vue-i18n 多语言
移动端uni-app 业主端「智慧家园」+ 物业端「物业版」
服务形态单体包 / 微服务集群(详见下方)

商圈 智慧社区(经营层)

语言/框架Java 8 · Spring Boot 2.0.4 · Spring Cloud Finchley
持久层MyBatis · MySQL 8
中间件Redis · ActiveMQ · Activiti 工作流
鉴权JWT
接口文档Swagger
对象存储阿里云 OSS / 腾讯云 COS
接口规模1,178 个业务 Cmd 类,统一入口 POST /mall/api/{serviceCode}
移动端uni-app 业主商城端 + 商家员工端

前端 智慧物业前端(wuye_PE)

构建vue-cli 4.5,开发端口 3000
后端代理/app 与 /callComponent 两个前缀指向 8008
部署形态构建产物 dist 由 Nginx 静态托管
门户分发按租户类型加载 index-dev / index-admin / index-property 三套门户
部署形态

一套代码,两种启动方式

中小物业不必为了上系统先买服务器集群;规模上来之后也不用重写。这是这套系统 2017 年至今能持续维护的关键设计。

形态 A

单体包部署

以 MicroCommunityBoot.jar 单包启动,2 核 4G(2G 内存可跑)即可承载一个普通小区的全部业务。适合单个物业公司、单个项目先跑起来。

  • 运维简单,一个 jar 包 + MySQL + Redis
  • 硬件成本低,可部署在现有办公服务器或云主机
  • 通过脚本与微服务形态互相切换
形态 B

微服务集群

按业务域拆分为独立服务(收费、订单、工单、门禁、用户等),注册到 Eureka,可横向扩展。适合连锁物业、多项目并发量大的场景。

  • 热点模块独立扩容(如缴费高峰期只扩收费服务)
  • 单服务故障不影响全局
  • 与形态 A 共用同一套代码,切换靠环境脚本
交付到谁手上:可部署在您自有的服务器 / 云主机(数据留在您手里),也可由我们托管。两种方式的运维责任边界在合同里写清楚。
集成能力

能接什么,接不了什么

下面是已经在生产环境跑通的对接清单。没写的不代表做不了,但需要我们评估后再答复。

类别已支持的对接说明
业主触达 微信公众号(OAuth 授权 + JS-SDK)、企业微信、H5 移动页、App / 小程序嵌入 AI 客服以 120 秒一次性票据嵌入业主端,支持 postMessage 与小程序消息互通
支付收单 随行付(微信 JSAPI / NATIVE 收款码 / 支付宝) 支持进件、预分账与开票;物业收款与商圈收款共用通道但独立清分
门禁与通行 门禁:海康、大华;道闸:臻识、华夏;另支持充电桩、梯控、智能水电表、视频监控、蓝牙开门 硬件按项目选配,不是使用软件的前提
物业↔商圈 房屋欠费查询、积分转本户余额(prestoreIntegralBalance)、业主绑定双向同步 物业侧以 fee_channel 区分 COMMUNITY / MALL / KEFU / PROPERTY 四种收费来源
物业↔AI SSO 桥接(HMAC 签名 + 一次性 ticket 防重放) AI 侧的报修投诉直接落成物业工单,主任不用两边录
同城配送 UU跑腿、达达、顺丰、快跑者、开始送、哪都达 + 快递电子面单 商家可自选运力,也支持自送
CPS 联盟 好单库(淘宝 / 京东 / 拼多多 / 唯品会 / 抖音 / 快手 / 美团 / 闪购) 导购分佣,本站不收款,订单按渠道码归因后记入运营商广告费账户
开放接口 商圈 mall-openapi、统一入口 POST /mall/api/{serviceCode}、Swagger 文档 1,178 个业务 Cmd 类可按权限开放给第三方
数据安全

多租户隔离与风控机制

多家物业公司共用一套平台时,最怕数据串盘。以下是系统里实际的隔离与防护措施。

租户与小区隔离

  • 三级租户体系:开发者 / 平台管理员 / 物业公司
  • AI 侧:账户↔物业多对多,每租户唯一 slug,会话线程强制前缀隔离
  • 知识库按 community_id 分库,不同小区互不读取
  • 每物业独立配置:品牌、欢迎语、支付、企微凭证

接口与身份防护

  • JWT 鉴权,接口按角色与权限组授权
  • 物业↔AI 桥接使用 HMAC 签名 + 一次性 ticket 防重放
  • 业主端嵌入使用 120 秒一次性票据
  • 数据权限、角色权限、组织信息三级可配

AI 侧风控

  • 双护栏:相关性护栏 + 越狱防护(独立模型)
  • 小区规定只检索物业自己的知识库,检索不到就回答不知道,不临场编制度
  • 缴费、报修等写操作需业主口语二次确认
  • 未认证房屋只能咨询,不能动账单与工单

操作留痕

报修与投诉全流程留工单号,可追溯处理人、时间与评价;AI 侧保留会话日志与每日 Token 用量;商圈扣积分流水挂小区积分账户并记录折算金额,运营商后台可逐笔查询。

数据归属与可迁出

房屋、业主、账单、工单等主数据归物业所有。我们不做数据绑架:合作终止时可按要求导出,具体格式与范围写入合同。

可用性与降级

AI Token 余额不足时暂停 AI 而非产生欠费;AI 无法处理时引导转人工,不会硬答。物业系统单体形态与微服务形态可互相切换,降低单点依赖。

我们不做的承诺:不承诺 100% 无故障、不承诺防住一切攻击、不承诺 AI 永不答错。我们承诺的是出问题时有工单、有日志、有人跟进,以及把能力边界提前说清楚。

技术侧常见疑问

我们能拿到源码自己维护吗?

可以谈。二次开发与源码交付属于定制合作范畴,按项目单独签。标准合作下我们负责运维与升级,您方保留数据所有权与导出权。

想接我们已有的硬件/系统,能做吗?

已验证的清单见上方表格。清单外的设备需要评估——部分厂商提供标准 SDK 或 HTTP 接口可直接接入,封闭协议的设备可能需要额外开发。我们会先做技术评估再答复,不先答应。

AI 用的模型能换成我们指定的吗?

可以。系统支持 10 家厂商在线热切换,也支持自定义接入与 Token 计划。切换后 Token 单价按厂商定价调整,我们会提前告知。这也是我们不锁定单一模型厂商的设计意图。

数据能放在我们自己的服务器吗?

可以。支持部署在您自有的服务器或云主机,数据不出您的机房。托管方式则由我们负责运维。两种方式的服务范围与响应时效不同,会在方案里写明。

系统上线后怎么升级?会不会影响我们正在用?

升级流程与窗口期安排见实施交付页。标准做法是先在测试环境验证,再安排低峰窗口上线,涉及数据结构的升级会提前通知并备份。

需要更细的技术资料?

接口文档、部署手册、硬件兼容清单可以索取。我们也可以安排与您方技术负责人直接对一次架构。

索取技术资料 看实施交付