本专题 Gmail 自动处理系统 基于一套集装箱/货代业务 Web 系统的实战经验整理，技术栈为 Next.js 14 App Router + TypeScript + Prisma + PostgreSQL + Gmail API + ExcelJS。
核心能力
- 货柜订单大表：23+ 业务字段（柜型、MBL、ETA、LFD、司机等）在线编辑
- Gmail 检索：按柜号搜索邮件，自动下载 Excel/CSV 派送附件
- 派送表解析：动态表头识别、FBA/仓库/箱数字段映射、仓库汇总
- 批次追踪：每次解析生成
batch_no，配套parse_logs审计日志
阅读建议
| 阶段 | 篇目 | 适合读者 |
|---|---|---|
| 1 | 01 系统架构 | 全员，建立全局图景 |
| 2 | 02 JWT 认证 | 后端 / 全栈 |
| 3 | 03 Gmail 检索 · 04 Excel 解析 | 集成工程师 |
| 4 | 05 解析流水线 | 架构 / 后端 |
| 5 | 06 可编辑大表 · 07 CRUD 模板 | 前端 / 全栈 |
| 6 | 08 部署导出 | 运维 / 上线 |
文章列表
| 篇 | 标题 | 阶段 |
|---|---|---|
| 01 | Next.js 14 Gmail 自动处理系统架构设计 | 架构入门 |
| 02 | JWT 双 Token 认证与 RBAC 权限控制 | 认证授权 |
| 03 | Gmail API 按柜号自动检索邮件 | 外部集成 |
| 04 | Excel 派送表动态解析引擎 | 解析核心 |
| 05 | 文档解析 ETL 流水线设计 | 编排与事务 |
| 06 | 可编辑大表与历史快照 | 前端表格 |
| 07 | CRUD 列表模板（Zod + Mapper） | 工程模板 |
| 08 | Vercel 部署与派送表导出 | 上线运维 |