# paixian **Repository Path**: lilw1/paixian ## Basic Information - **Project Name**: paixian - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-24 - **Last Updated**: 2026-11-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 瑞幸排线应用 替代 Excel VBA 排线模板的桌面 Web 应用:导入运单 → 自动排线(模板初排 + 确定性规则引擎)→ 人工拖拽微调 → 导出 TMS 计划。 - **架构**:Go 后端 + Vue3 前端(构建产物 go:embed 进单二进制)+ SQLite(纯 Go 驱动),单机运行、局域网可共享。 - **方案文档**:`排线应用-流程分析与方案调研.md`(算法、导出格式、坐标导入格式、地理编码 Key 申请指引)。 ## 快速开始(使用现成二进制) ```bash ./paixian # 桌面启动器:配置端口(默认 9100)→启动→点击地址开浏览器;关窗即停(Windows/macOS 同界面) ./paixian serve # 开发调试:直接启动 Web 服务(默认 127.0.0.1:8080,自动开浏览器) ./paixian -listen 0.0.0.0:8080 serve # 局域网共享(注意 flag 必须放在 serve 前面) ``` 数据库默认 `data/paixian.db`(`-data` 可改);桌面模式无 `-data` 时跟随可执行文件目录的 `data/paixian.db`(解压即用)。 ## 打包发布(Windows 64 位 zip) ```bash brew install mingw-w64 # 首次需要(Windows 交叉编译器) ./scripts/package.sh # 产出 排线应用-Windows64-日期.zip:exe(双击即用)+ data 数据包 + 使用说明 ``` 数据打包只走生产库快照副本并 checkpoint 成单文件,不触碰生产库;macOS 版二进制同时产出在 `dist/`。 ## 使用流程 1. **导入运单**:工作台页「① 导入运单」选择 TMS 运单 Excel(配送中心编码需与运单一致); 2. **地理编码**(首次):地理编码页按内置指引注册天地图/高德 Key → 一键批量补全;无 Key 也可走批量导入坐标或导出清单; 3. **新建计划**:工作台「新建计划」(配送中心 + 送达日期,发车日期 = 送达日 − 偏移天数); 4. **自动排线**:打开计划 → 「自动排线」(确定性规则引擎,同输入必同输出); 5. **微调**:拖拽门店在未分配池/线路间移动、线路内排序,右侧看板实时显示重量/体积/家数约束;固定线路(红色标记)禁止拖拽; 6. **导出 TMS**:「导出 TMS」下载 `{DC}ToTmsRountingPlan-{pn}.xlsx`(18 列,与 VBA 导出格式一致)。 主数据(门店/车型/承运商/路线模板/联运区域)在「主数据」页维护:每类都有导入模板下载(含表头说明)、Excel 导入、页面编辑。 ## 从源码构建 ```bash # 前端(产物输出到 internal/web/dist,由 Go 内嵌) cd web && npm install && npm run build && cd .. # 后端 + 单二进制 go build -o paixian . ``` 前端开发热更新:`cd web && npm run dev`(代理 /api 到 127.0.0.1:8080)。 ## 关键行为说明 - **约束可配置**(系统配置页 + 计划级参数):体积上限(默认 5 m³)、重量上限(默认 2500 kg)、家数上限(默认 25),全部为硬约束;体积下限(默认 3 m³,低于下限的线路拆散并入同区域/联运范围内其他线路,0=关闭);同区域距离阈值(默认 5000 m,计划级); - **区县不混线(硬约束)**:除联运区域中同一行内列出的区县外,其他区县不能混在一条线路; - **路线编号**:`RN` + 起运站点后 4 位 + 发车日期(远途线 +1 天)+ 3 位序号;直营/联营分块连续编号(线内门店多数定块,直营块 1..n、联营块 n+1..),块内同区域线路相邻; - **固定线路**:仅作人工微调保护(保留模板停靠顺序、禁止拖拽、TMS 导出填「固定线路名称」列),自动排线中照常参与拆分与合并; - **操作可撤销**:排线工作台「撤销」可回退最近 20 步内的移动/编辑/重编号; - **坐标**:统一 GCJ-02;无坐标门店降级按区县文本参与排线。