Gmail 自动处理系统上线指南：Vercel 部署与派送表导出
本篇定位Gmail 自动处理系统 上线运维：Vercel + Neon、环境变量、Gmail OAuth 生产配置、派送明细导出。 A. 环境变量| 变量 | 说明 || C. 启动命令1234npm installnp...
阅读全文 →分类
基于 Next.js 的 Gmail 自动处理系统
Next.js CRUD 列表模板：Zod 校验与 Prisma Mapper 最佳实践
目标：掌握 Gmail 自动处理系统 90% 日常开发模式 —— 六件套 CRUD 模板。 六件套架构1234567flowchart LR V[xxx-validators.ts] --> M[xxx-mapper.ts] M --> Q[xxx-list-query.ts] Q -->...
阅读全文 →Next.js 可编辑大表实战：货柜订单 23 字段管理与历史快照
业务字段概览货柜大表（表名 cargo_sheet）覆盖运营全流程字段： 类别 字段示例 柜信息 柜型、柜号、MBL、DO、重量 时间 订单日、ETA、LFD、提柜日、还柜日 地点 Terminal、送仓地址 人员 提柜司机、还柜司机、预约同事 其它 预报窗口、仓库账号、备注 共 23+...
阅读全文 →文档解析 ETL 流水线：Prisma 事务边界、幂等锁与审计日志
编排入口order-parse-service.ts 负责：加锁 → 建批次 → Gmail → 解析 → 事务写入 → 写日志。 一、Parse 库是什么？Parse 库不是单独的 npm 包，而是项目里负责「派送表自动解析」的一组模块，核心职责： 职责 说明 搜邮件 按柜号在 Gmail 中检索 下...
阅读全文 →Excel 派送表动态解析：FBA 字段映射与仓库汇总
痛点同一货代不同客户送的 Excel 列名不统一：「FBA ID」「fba」「Reference PO」混用；表头可能不在第 1 行。硬编码列号会在换模板时全线崩溃。 一、项目里两种 Excel，不要混 类型 用途 核心文件 入库表 派送明细表 Gmail 附件里的 FBA/仓库/箱数明细...
阅读全文 →Gmail API 实战：按柜号自动检索邮件并下载 Excel 附件
本篇定位：Gmail 自动处理系统的 外部集成核心 —— OAuth、双业务线、搜索 fallback、附件下载。 一、这套能力解决什么问题业务场景：货代/物流收到带 柜号 的邮件，附件里是 派送明细表（xlsx 或 csv）。系统需要： 按柜号在 Gmail 里 搜到对应邮件 下载 Excel...
阅读全文 →Next.js JWT 双 Token 认证与 RBAC 权限控制实战
设计目标 Token 不进 localStorage，降低 XSS 窃取风险 双 Token：access 短效（约 15 分钟）+ refresh 长效（约 7 天） 三角色：admin / operator / viewer，写操作后端二次校验 演示账号（仅本地/测试）：ops@de...
阅读全文 →Next.js 14 Gmail 自动处理系统架构设计：Prisma 与 PostgreSQL 实战
业务背景货代日常需管理 柜号、MBL、ETA、LFD、DO、司机 等字段，并从邮件附件中的 Excel/CSV 派送表 提取 FBA ID、仓库代码、箱数等明细。人工复制粘贴易错、难追溯。 本系统（Gmail 自动处理系统）目标：在线管订单 + 一键 Gmail 检索 + 自动解析入库 + 按批次审计。 系统...
阅读全文 →