在县域农产品与特色商品上行、多端购物习惯并存的背景下,传统「单页面下单 + 线下结算」难以支撑商品管理、订单履约与运营数据沉淀。本项目旨在建设一套可运营的一体化商城平台:面向消费者提供流畅的浏览、搜索、下单与售后体验;面向运营/管理员提供商品、内容、订单与支付配置等后台能力;面向供应商提供独立的订单与数据视图。总体目标为:降低日常运营门槛、规范交易与对账流程、支撑多端(Web/H5/小程序等)同一套业务能力,并为后续扩展营销活动与内容化运营预留空间
本项目采用「单仓多前端 + 统一 BFF/API」思路:Next.js(App Router) 既承载 PC/全屏商城与管理后台页面,也通过 Route Handler 暴露 tRPC 与部分 REST(如认证、探活、小程序相关接口),形成清晰的服务端边界;业务数据与持久化 统一由 Prisma ORM 访问数据库,NextAuth 负责身份体系并与 Prisma Adapter 对接;客户端数据请求采用 tRPC + TanStack React Query,在端到端 TypeScript 下保持类型一致、减少重复 DTO 定义。校验与配置 使用 Zod、@t3-oss/env-nextjs 等,把环境变量与输入约束放在「编译与运行时可证明」的一层。UI 以 Chakra UI v3 与项目内封装组件为主,next-themes 支持明暗主题;构建与开发使用 pnpm 与 Next.js Turbopack(dev) 提升迭代效率。
在多端形态上:除主站内的 /full(全屏业务页)、/h5(移动 H5)、/admin(后台) 等路由分层外,mobile/ 独立为 Taro 3 + React + TypeScript + Sass + Webpack5 的微信小程序工程,通过 HTTP(如 tRPC 的 HTTP 入口或项目内封装的请求工具)与同一后端交互,实现「一套业务能力,多终端呈现」。整体设计强调:权限与敏感逻辑只在服务端执行;数据库与序列化边界清晰;按路由/目录划分展示层,核心领域能力集中在 server/api(含 tRPC routers) 与 Prisma schema 中复用,便于后续扩展订单、商品、内容与供应商等模块而不打散类型与安全模型。