肆季花坊
花店全业务经营管理平台

是什么

肆季花坊管理系统是一套面向花店行业的全渠道经营管理平台（Web 应用），采用管理后台 + 客户 H5 商城双端架构。管理端供花店经营者/花艺师员工使用，客户端 H5 供终端消费者自助选品下单。覆盖从花材采购、库存批次管理、花束 BOM 配方、订单制作与配送、到 VIP 会员营销的完整业务闭环。

面向谁

主要功能

灵感来源

花店是典型的小微零售业态，日常经营面临多重痛点：花材是易腐品，库存管理容不得半点马虎；花束定价需要精确计算物料成本，但大多数花店仍在用 Excel 甚至纸笔记录；多门店经营时，价格、库存、配送范围都需要独立管理。市面上的通用电商系统无法满足花材 BOM 配方、批次保质期、花束订阅等行业特色需求，而专业花店软件又价格不菲且功能僵化。

在调研重庆璧山区和西藏拉萨的两家实体花店后，我发现这些痛点真实而普遍。于是决定用 TRAE 从零打造一套懂花店业务的经营管理系统。

想解决的问题

为什么做这个方向

客户端 H5 入口：登录后访问 /m/selection 进入选品商城，或在管理员/员工后台点击右上角"客户端预览"。

体验路径推荐

1. 管理员视角：登录后查看仪表盘 → 商品中心（BOM 配方）→ 库存批次 → 采购管理 → 数据报表（成本分析/月度净利）
2. 员工视角：登录后处理订单 → 库存入库 → 配送管理 → 客户服务
3. 客户视角：H5 商城选品 → 加入购物车 → 结算下单 → 查看订单 → VIP 中心

开发环境与工具

系统架构

flowchart TB
    subgraph Frontend["前端层 (Next.js App Router)"]
        direction LR
        AUTH["认证页面
/login, /register"]
        ADMIN["管理后台
/(dashboard)"]
        H5["客户端 H5
/(customer)/m/*"]
    end

    subgraph API["API 层 (Next.js API Routes)"]
        direction LR
        AUTH_API["认证 & 权限"]
        BIZ_API["业务 API
商品/订单/库存/客户"]
        PAY_API["支付 & 配送
支付宝/微信/顺丰"]
    end

    subgraph Service["服务层 (src/lib/)"]
        direction LR
        BOM_SVC["BOM 配方引擎"]
        FIFO_SVC["库存 FIFO 扣减"]
        COST_SVC["成本核算"]
        CRON_SVC["定时任务
超时订单取消"]
    end

    subgraph Data["数据层"]
        DB[("SQLite
(Prisma ORM)")]
    end

    subgraph External["第三方集成"]
        direction LR
        AMAP["高德地图"]
        SF["顺丰同城"]
        PAY["支付宝/微信
云闪付/抖音"]
        FEISHU["飞书通知"]
    end

    Frontend --> API
    API --> Service
    Service --> DB
    API --> External
    Service --> External
        

开发流程时间线

关键技术实现

1. 花束 BOM 配方引擎

每个花束商品关联一组 BOM 配方项（BomItem），每项指定花材 SKU、数量和单位。下单时系统自动按配方扣减库存，并按"物料成本 + 人工成本 + 辅材成本"计算花束成本。订单项留存成本快照（costSnapshot），确保历史订单利润分析不受后续价格变动影响。

// 订单创建时计算成本快照
const bomItems = await getBomItems(product.id);
const materialCost = bomItems.reduce((sum, item) =>
  sum + item.sku.costPrice * item.quantity, 0
);
const totalCost = materialCost + product.laborCost + product.auxiliaryCost;
orderItem.costSnapshot = { materialCost, laborCost, totalCost };

2. 库存批次 FIFO 扣减

花材按批次入库（InventoryBatch），每批记录数量、采购价、保质期。出库时按 FIFO 规则从最早批次开始扣减。库存不足时抛出异常，防止超卖。退货/取消订单时按原批次逆向回退库存。

3. 配送距离分级校验

集成高德地图 API 计算客户地址到门店的直线距离。10km 内正常下单；10-25km 标记 deliveryOverridden=true 进入管理员审批队列；25km 以上系统拦截。管理员和客户 API 双重校验。

4. 30 分钟未支付订单自动取消

通过 node-cron 注册每分钟扫描任务（runPaymentTimeoutScan），查找 status=pending, payStatus=unpaid, createdAt < now-30min 的订单，自动取消并执行回退库存、回退消费券、写 OrderStatusLog、发 SSE 通知。

5. 三层角色权限矩阵

TRAE 开发心得

Session ID 汇总

肆季花坊管理系统是一个从真实行业痛点出发、用 TRAE IDE 全程开发的花店经营管理平台。它不是通用电商系统的简单改版，而是深入花店业务场景，实现了花材 BOM 配方、库存批次 FIFO、多门店差异化定价、花店特色营销等行业专属功能。

在 TRAE 的辅助下，从需求分析到 40+ 数据模型定义、从 API 开发到前端页面、从测试用例到部署上线，整个开发过程高效而连贯。TRAE 不仅加速了代码生成，更在跨模块一致性、测试覆盖、代码规范等方面提供了持续的保障。