交互原型 →
AI-powered Warehouse Operating System

AIvita WMS
项目文档中心

覆盖需求规格 · 开发实施 · 技术选型全套文档，基于项目计划书 / 产品需求 / 业务流程整理与补充。

📘 核心文档

7 篇

项目规划、产品需求、业务流程与交付物，从立项到上线的完整文档集。

📋 Project

项目计划书

项目背景、目标定义、里程碑规划、资源与风险评估。

打开 →
📐 Product

产品需求

功能模块、用户故事与产品原型说明，端到端覆盖 WMS 核心场景。

打开 →
🔄 Process

业务流程

入库、出库、盘点、退货等核心仓储业务流程图与说明。

打开 →
📗 Spec

需求规格说明书

系统目标、用户角色、4 端口架构，15 个核心模块 + 11 个补充模块；非功能需求、数据模型、集成清单与术语表。

打开 →
🛠 Tasks

开发任务文档

27 Epic · 约 140 Story · 约 520 Task，按 Phase 1 / 2 / 3 拆分；含估时、依赖、DoD 与风险。

打开 →
📗 Manual

用户使用手册

8 类角色 + 3 类客户端 + 5 个核心流程；含 AI Search Bar 用法、移动端 / 扫描枪与常见问题。

打开 →
⚙️ Tech

技术选型说明书

前端 / 后端 / 数据 / AI / 移动端 / DevOps 全栈；候选方案对比与推荐结论，Phase 1-3 引入路线。

打开 →

📐 开发实施细节

7 篇

将需求与任务拆解到「可动手编码」粒度：每篇含 Prisma 数据模型、目录结构、API 列表、核心算法、开发步骤与 DoD。

00 · Infra

项目结构搭建

pnpm + Turborepo monorepo 完整骨架；apps/packages/infra 目录；Flutter 排除 tsc；Docker Compose 与 CI。

打开 →
01 · Auth

账号权限与组织

5 种账号 × 4 端口；三层隔离 (tenant/customer/warehouse)；CASL + JWT + Refresh；tenantScope Prisma 扩展。

打开 →
02 · WH

仓库数字孪生与库位

6 层物理结构；库位编码与条码；Konva 2D 仓库地图；BinGenerator + ABC 分类 + 拣货路径。

打开 →
03 · Inv

库存 / 批次 / FIFO

三元组唯一 + 双数列 + 行锁事务；applyMutation 核心服务；FIFO/FEFO 分配 + 预占释放 + 循环盘点。

打开 →
04 · In

入库流程

ASN → 收货 → 上架全链路；4 种上架策略 + 评分公式；Flutter 扫描端 + 离线缓冲 + 幂等。

打开 →
05 · Out

出库流程

订单 → 波次 → 补货 → 拣货 → 打包 → 发货；波次驱动补货 ⭐；Rate Shopping；Tracking 归一化。

打开 →
06 · Bill

计费引擎与账单

13 类收费；基于 json-rules-engine 的 DSL；事件驱动 + 幂等；月度账单 PDF + 争议工作流。

打开 →

🛠 技术栈使用指南

10 篇

技术选型最终推荐栈的「上手使用手册」：每篇含「是什么 / 为什么选 / 安装 / 配置 / 用法 / 项目内场景 / 常见坑」，附可直接复制的代码片段。

00

工程化 & Monorepo

TypeScript 5 · pnpm 9 · Turborepo · Biome · Husky · Changesets · GitHub Actions · Caddy。

打开 →
01

前端基础

React 18 (useTransition/Suspense) · Vite 5 (SWC) · React Router v6 数据路由 · i18next。

打开 →
02

UI 与样式

Arco Design Pro · TailwindCSS 3 · @iconify/react · 暗色模式 · 主题变量统一。

打开 →
03

状态 / 请求 / 表单

TanStack Query v5 · Zustand · ky · React Hook Form · Zod schema · openapi-typescript。

打开 →
04

表格 / 图表 / 仓库 2D

Arco Table · TanStack Table + Virtual · ECharts 5 按需 · Konva 2D · dnd-kit 拖拽。

打开 →
05

后端 NestJS 全家桶

NestJS 10 · Swagger + nestjs-zod · JWT Refresh rotation · CASL · Socket.IO · XState · pino。

打开 →
06

数据存储

Postgres 16 + pgvector/pg_trgm/PostGIS · Prisma 5 行锁 · Redis 7 · BullMQ · MinIO 直传。

打开 →
07

AI / 规则 / 集成

Vercel AI SDK · pgvector RAG · json-rules-engine · 物流 / 电商 / 财务 SDK 抽象 · ZPL 打印。

打开 →
08

Flutter 移动端

Riverpod 2 + codegen · go_router · Dio 拦截器 · Drift 离线队列 · mobile_scanner + 扫描枪。

打开 →
09

测试与可观测性

Vitest + MSW · Playwright · Flutter 三层测试 · k6 压测 · OpenTelemetry · Sentry · Grafana。

打开 →