PROJECTS / 13 — TOYNET

DELIVERED · 2026-04

TOYNET  

ToyNet 智能玩具 · 物联网智能玩具管理系统

100 COMMITS

3 CLIENTS

34 MINIPROGRAM PAGES

Swagger API DOCS

OVERVIEW ── 这是什么01

设备、小程序、后台三端一套打通的 IoT 管理系统。后端用 Koa 起服务,接口挂 Swagger,限流与鉴权在中间件层解决;管理端用 Vue 3 + ECharts 看设备状态与数据曲线;小程序侧共享一套类型定义。

ARCHITECTURE ── 架构分层02

01后端

Koa + koa-router · Mongoose · JWT 鉴权 · koa-ratelimit 限流 · Joi 参数校验 · koa2-swagger-ui 在线文档

02管理端

Vue 3 + Vite + Tailwind · Pinia · ECharts 数据看板 · GSAP 动效 · Zod 校验

03小程序

微信小程序原生 + TypeScript 类型层 · Jest 单测

04设计

独立 design-system 目录,三端共用一套视觉规范

05部署

PM2 进程守护 · nginx 站点配置随仓库交付

FEATURES ── 功能与取舍03

三端一致

后台、小程序、设备侧共用类型与接口契约,改一处不用三处对。

接口自带文档

swagger-jsdoc 从注释生成 OpenAPI,联调不靠口头约定。

设备数据看板

ECharts 呈现在线率与上报曲线,异常一眼能看出来。

测试用内存库

mongodb-memory-server 跑集成测试,不依赖外部实例。

MILESTONES ── 里程碑04

2026-04-09

后端服务、管理端与小程序同时开工

2026-04-13

三端打通并交付,含 Swagger 文档与 nginx 部署配置

RELATED LOGS ── 相关复盘05

01设备还没接上,后端先做什么?2026-04-0502设备明明在线,状态却一直跳2026-04-0803三端并行开发,谁先接谁?2026-04-12