系统总览与代码地图
DGJ2.0 是一个围绕服务站经营的进销存系统:上游承接商品、订单、活动、支付、OA、调拨、TMS 等中心系统,下游给 PC 后台、App、小程序、渠道方和报表平台提供业务能力。
按业务模块梳理 DGJ2.0 代码入口、核心流程、状态流转、表模型、外部系统和排查路径。
这一组内容保留了你原来的沉淀结构,适合按顺序刷,也适合直接跳到最需要的那一篇。
DGJ2.0 是一个围绕服务站经营的进销存系统:上游承接商品、订单、活动、支付、OA、调拨、TMS 等中心系统,下游给 PC 后台、App、小程序、渠道方和报表平台提供业务能力。
基础资料是所有单据的前置口径,决定“谁买、买什么、从哪里出、按什么价格、走什么权限”。库存模块负责把各种入库、出库、调拨、盘点、关闭和撤销动作落成库存流水,并维护实时库存。
采购模块负责服务站向供应商、云仓、活动、订单中心等来源采购商品。它覆盖草稿、提交、审核、在线支付、待出库、配送、完成、关闭、退货、入库和补偿。
销售模块负责服务站向修理厂、E站、小程序、APP、机器人、渠道等客户销售商品。核心链路是销售开单、待出库、部分出库、全部出库、配送、送达、对账、核销和撤销。
活动模块负责 OPS 配置活动,服务站或 E站侧参与活动并生成业务单据。当前代码里活动类型较多,包含销售活动、客户活动、优惠券、赠品活动、预售、秒杀活动等。秒杀是近期最完整的一条链路,覆盖 OPS 管理、OA 审批、服务站商品列表、购物车、下单、采购单、支付和库存释放。
移动商城模块承接服务站和修理厂移动端场景,包括 E站商城、E站维修、E站活动、E站 APP、微仓补货、马上送、智能询价、AI 机器人报价和 IM 会话。
渠道模块用于承接外部平台或大客户订单,把外部订单转换为 DGJ 侧平台订单、销售出库或采购相关单据,并把审核、发货、签收、售后状态回传给渠道方。
这个模块负责资金单据、在线支付回调、账户流水、授信白条、报表查询、OA 审批回调、MQ 生产消费和跨系统同步。它不是一个单独业务,而是贯穿采购、销售、活动、渠道、移动商城的基础设施。
第一批文档已经回答了“项目有哪些业务模块、主流程怎么走、代码入口在哪里”。第二批建议继续补“能落地排查、能联调对接、能长期维护”的资料。下面按优先级列大纲,后续可以逐篇补成独立文档。
本文按业务域整理 DGJ2.0 的核心业务表。表名以 application/config/tables.php 为准,常量名是代码里最常见的检索入口,排查时优先用常量名 rg,再确认真实物理表。
本文把 application/KzData/Enums 中分散的状态、订单类型和交易类型整理成人能直接使用的字典。排查单据时,先确认“业务类型”,再看“状态是否允许当前操作”。
DGJ2.0 的入口不是单一 REST 风格,而是 PC 控制器、内部 API、App API code、老开放接口、任务消费者混在一起。本文按入口类型整理定位方法。
本文整理 DGJ2.0 与订单中心、支付中心、OA、商品中心、调拨中心、SAAS、APP、渠道平台之间的异步消息。排查线上问题时,先确认“消息有没有到”,再确认“消费方法有没有把业务表推进到正确状态”。
本文围绕一个采购单号,从创建、审核、支付、出库、配送、入库、关闭、退货一路排查。适用于“采购单状态不对”“支付成功但订单未推进”“采购入库数量异常”“关闭/退款没同步”等问题。
本文围绕销售单、出库单和退货单排查,适用于“销售单不能出库”“出库后库存不对”“配送/签收状态没同步”“APP/SAAS 没收到销售事件”等问题。
本文用于处理“列表有库存但下单失败”“库存流水和实时库存不一致”“报表库存和业务库存不一致”等问题。库存问题不要只看一个表,必须同时看商品、仓库、货位、流水、实时库存、缓存和报表口径。
本文覆盖 DGJ2.0 秒杀活动从 OPS 创建、OA 审批、启用,到服务站列表、加购、下单、支付、转采购、补偿的完整链路。适用于秒杀联调和线上排查。
本文围绕收付款单、在线支付、退款、白条还款、账户流水排查。适用于“支付成功业务单没变”“付款单重复/缺失”“退款不到账”“账户余额异常”等问题。
本文整理 DGJ2.0 后台菜单、资源权限、服务站白名单和 OPS 菜单控制。新增页面、按钮、接口或限制服务站能力时,先看这里。
本文整理 DGJ2.0 的导入、导出、模板下载和错误文件处理。重点关注秒杀、基础资料、采购、销售、库存、报表等场景。
本文整理 DGJ2.0 商品搜索、物料缓存、Redis、Mongo、ES 和缓存刷新任务。排查“搜索不到”“列表数据旧”“库存/价格展示不一致”时按本文定位。
本文整理 DGJ2.0 采购、销售、库存、利润、客户、往来账、对账单报表的入口和口径。报表问题通常不是单纯 SQL 问题,还要看业务状态、时间字段、同步延迟和历史表。
本文按外部系统整理 DGJ2.0 发送和接收的消息、入口文件、幂等关注点和补偿方向。联调或排查外部系统问题时,先按系统定位。
本文整理 DGJ2.0 本地开发和联调时的定位方法。不同机器环境可能有差异,具体配置以当前项目的 application/config、本地 Docker/Nginx/OpenResty 配置和实际环境变量为准。
本文是一份“改前必看”清单。DGJ2.0 有不少公共文件被采购、销售、库存、支付、活动、报表、外部同步共同复用,改动前必须明确影响面和回归范围。
本文整理 DGJ2.0 PDA、GPDA 相关的移动仓内作业,包括采购签收/入库、销售出库、盘点、货位调整、出库验货。它和 PC 端库存逻辑共用大量库存表,是库存一致性问题的重要入口。
本文整理服务站间调拨 STF、调拨申请、调出入库、调拨收付款。STF 是跨服务站库存和财务同时变化的链路,排查时必须同时看调出方、调入方、库存流水和账户流水。
本文整理 DGJ2.0 对账单 v2:策略配置、客户绑定、账单生成、审核、发送、发送结果、收款状态同步。该链路跨销售、出库、收款、客户微信绑定和 MQ 任务。
本文整理销售退货申请、审核、退货入库、异常退货和 APP/SAAS 同步。它和普通销售退货、出库撤销、采购售后不同,排查时要先确认退货来源和原始销售出库单。
本文整理客户开票资料、税票列表、提交、银行支行查询,以及 TMS/外部系统发票状态同步。发票链路通常和客户资料、销售、收款、对账单关联,但本项目中入口相对独立。
本文整理 DGJ2.0 的金融通道入口,包括 B2B 支付、桥接银行、工行、民生、拉卡拉、泰隆、小雨点、白条分期等。该链路和支付中心、白条授信、采购支付、退款强相关。
本文整理专属授信现金池、授信活动、服务站申请、额度调整、OA 审批、返利账户。该链路影响采购支付、白条、额度占用、还款和财务报表。
本文整理 DGJ2.0 帮助中心、问答、题库、知识库、ES 搜索和七鱼机器人知识库同步。它不是进销存主链路,但影响服务站自助查询、客服支持和机器人知识能力。
本文整理轮胎小程序相关业务:用户认证、轮胎登记、理赔申请、属性字典、OPS 审核和售后联动。轮胎业务有独立表,但理赔会和售后订单状态发生关联。
本文整理 DGJ2.0 PC、App、PDA 登录,短信验证码,密码重置,机器码绑定,PC 授权,账号安全配置和安全日志。账号链路是所有业务入口的前置条件。
本文整理总分店账号、总部视角报表、分店切换和数据权限。总店账号能跨多个服务站看采购、销售、财务数据,排查时重点确认当前账号、当前分店、菜单权限和报表口径。
本文整理 C 端营销活动、客户活动、优惠券、新人券、活动商品、活动报名、库存和限购。它和 E站活动、普通销售活动、秒杀活动都有关联,但表和入口相对独立。
本文整理 DGJ2.0 配送履约链路,包括骑手配送、轨迹上报、到达、签收、取消、自提、三方配送和调拨中心回调。配送状态会影响销售出库、采购配送和客户签收。
本文整理 AI 报价、智能询价、机器人会话、IM 群聊、Udesk 客户同步和 AI 控台配送能力。该链路横跨移动商城、机器人、客户、商品搜索、VIN、IM 和外部客服系统。
本文整理 DGJ2.0 中数据修复、迁移、临时脚本和工具入口的治理方式。此类代码风险极高,很多脚本绕过正常业务入口,执行前必须确认环境、数据范围、备份和幂等。
本文整理 DGJ2.0 报价、智能询价、报价范围、报价规则、机器人报价配置和迁移脚本。报价链路连接客户、商品、价格、库存、VIN、机器人和移动商城。
本文整理蓄电池服务站、可售分类品牌、可售 SKU 缓存和销售限制。该模块影响商品列表、销售出库、机器人查询和活动商品可售判断。
本文整理首配方案、预订单、预售活动、提货、售后和首批配货订单。它们属于采购主链路的特殊来源,排查时要关注 orderType、srcOrderType 和预订单表。
本文在“外部渠道、全车件与大客户订单”基础上继续细分大客户、临采、渠道订单、渠道售后、签收和自动发货/退款确认。
本文整理动态成本、出库成本、采购入库成本、成本调整和利润报表。成本口径影响销售毛利、库存金额、利润报表和经营报表。
本文整理省市区、服务站地址、仓库地址、退货地址、承运商时效、区域指导价和供货区域。地址和区域数据影响采购配送、销售配送、报价、价格、退货和报表。
本文整理 DGJ2.0 站内信、系统消息、APP 推送、活动通知、对账通知和任务消息。通知链路通常不改变主业务状态,但影响用户感知和后续操作。
本文整理 DGJ2.0 老开放接口、App code 映射、SAAS API、全车件显式路由和历史兼容策略。老接口通常被外部系统长期调用,改动风险高于普通页面接口。
本文档按真实代码入口梳理 /Users/zhoujiangbin/code/docker dev env/www/dgj2.0 项目,目标是让新人先理解业务,再顺着控制器、Service、模型、枚举和任务入口继续追代码。