Robot Tour Guide Platform MVP Maps Full Tour Workflow
A technical account describes a robot tour guide MVP that imports robot map packages, edits points and areas on the web, orchestrates tours, and compiles robot-executable task chains. It uses React, TypeScript, NestJS, PostgreSQL and Konva.js while separating map data, business workflows, and robot protocols. The platform also supports uploading tasks, starting robot execution, and displaying tour progress in real time.
The account presents a concrete end-to-end reference for connecting map editing, tour orchestration, robot task-chain generation, and live execution-state tracking.
这篇文章记录一个机器人导览平台 MVP 的技术设计与实现过程。
平台要解决的不是单一页面问题,而是一条完整链路:
导入机器人地图包
→ 在 Web 端编辑点位和区域
→ 编排导览流程
→ 生成机器人可执行的任务链
→ 上传并触发机器人执行
→ 实时展示导览进度
早期设计中混合过几种不同方案,例如由平台主动连接机器人、由机器人主动连接平台,以及不同的状态管理方式。最终实现时,我把地图数据、业务流程和机器人协议拆成了三个相对独立的层次,避免页面逻辑直接依赖机器人通信细节。
一、整体架构选型
前端
- 核心框架:React 19 + TypeScript 前后端都使用 TypeScript,便于统一接口模型和动作类型。
- UI 组件库:Ant Design 适合管理后台和复杂表单,可以快速搭建地图列表、流程编排、机器人档案等页面。
- 地图渲染:Konva.js / react-konva Canvas 2D 更适合地图编辑器。底图、路径、点位和区域可以分层渲染,并支持缩放、平移、框选与拖拽。
- 本地编辑状态:Redux Toolkit 用于保存地图编辑中的点位、区域、选择状态和交互模式。
- 服务端状态:TanStack Query 负责接口请求、缓存、刷新和 Mutation 状态,避免把服务端数据重复塞进本地 Store。
- 路由与构建:React Router + Vite
#React#TypeScript#Ant Design#Konva.js#Redux Toolkit#TanStack Query#NestJS#Prisma#PostgreSQL#React Router#Vite#Socket.IO