帝可得智能售货机系统实战Day1：从环境搭建到区域管理功能落地 (1)
帝可得智能售货机系统实战Day1：从环境搭建到区域管理功能落地
在物联网技术与新零售深度融合的背景下，智能售货机系统正成为线下零售数字化转型的重要载体。本文作为帝可得智能售货机运营管理系统实战系列的开篇，将记录从项目初始化到核心功能实现的完整过程，重点分享若依框架的工程化实践、AIGC辅助开发技巧以及区域管理模块的技术选型思考。
为了更直观地呈现首日实战的核心内容框架，以下是整理的mermaid思维导图，可作为后续阅读的导航指引：
一、项目全景：五端五角色架构解析
帝可得系统作为物联网概念下的智能售货机运营管理平台，其核心特征是通过"五端五角色"实现全链路业务覆盖。各角色职责与系统模块的对应关系如下：
| 角色 | 核心职责 | 对应系统模块 |
|---|---|---|
| 管理员 | 基础数据管理（区域/点位/设备）、工单指派、报表查看 | 系统管理、数据字典、统计分析 |
| 运维人员 | 设备投放/撤除/维修、故障处理 | 运维工单、设备监控 |
| 运营人员 | 商品补货、销售数据跟踪 | 运营工单、货道管理 |
| 合作商 | 点位提供、收益查看 | 合作商管理、收益报表 |
| 消费者 | 扫码购物、订单查询 | 小程序端、支付集成 |
| 系统设计亮点：通过角色权限的细粒度划分，实现了业务流程的权责分离，为后续功能扩展奠定了清晰的架构基础。 |
二、环境搭建与工程初始化
2.1 项目克隆与环境配置
首先从Gitee仓库克隆前后端工程，确保本地环境满足JDK1.8+、MySQL8.0+、Node.js14+的基础要求：
# 克隆前端工程
git clone https://gitee.com/code-craftsmen/dkd-vue.git# 克隆后端工程
git clone https://gitee.com/code-craftsmen/dkd-parent.git
后端工程采用多模块架构，核心模块包括dkd-common（公共组件）、dkd-system（系统管理）、dkd-business（业务逻辑）。前端基于Vue3+Element Plus构建，需执行npm install安装依赖后启动开发服务。
2.2 若依框架代码生成实践
基于若依框架的代码生成功能，可快速构建基础CRUD接口。关键步骤如下：
-
在MySQL中创建项目数据库，执行初始化SQL脚本
-
登录若依后台 → 系统工具 → 代码生成 → 导入数据表（需包含create_by、create_time等基础字段）
-
配置生成参数（模块名、作者、生成方式），点击"生成代码"下载压缩包
-
后端代码：将java文件复制到对应模块的src/main/java目录，资源文件放入resources
-
前端代码：将vue文件放入src/views目录，路由配置添加到router/index.js
注意事项：生成代码前需确保数据表有完整注释，字段注释将直接作为前端表单的label提示，表注释将作为模块名称。
三、AIGC与提示工程在开发中的应用
在项目初始化阶段，通过提示工程引导AI辅助完成代码优化和文档生成，大幅提升开发效率。以商户圈数据字典设计为例，采用"角色+需求+输出格式"的三段式提示模板：
提示词：你是资深Java开发工程师，需为智能售货机系统设计商户圈数据字典。要求包含字典类型（dict_type）、字典标签（dict_label）、字典值（dict_value），请生成符合若依框架规范的SQL脚本和Java枚举类。
AI生成的字典枚举类示例：
/*** 商户圈类型枚举*/
public enum MerchantCircleTypeEnum {COMMUNITY("0", "社区"),SCHOOL("1", "学校"),HOSPITAL("2", "医院"),OFFICE("3", "写字楼");private final String code;private final String name;// 构造器、getter方法省略
}
通过这种方式，不仅快速完成了数据字典设计，还确保了代码风格与项目规范的一致性。
四、区域管理功能实现：多表联查策略解析
为直观展示区域管理模块的技术选型与实现逻辑，以下是该模块的专项思维导图：
4.1 需求分析与技术选型
区域管理模块需实现"查询区域下点位数量"的功能，面临两种技术方案选择：
-
方案A：在区域表（sys_region）中添加node_count字段，通过触发器或定时任务更新
-
方案B：采用多表联查（区域表与点位表sys_point）实时统计
最终选择方案B，主要基于以下考量：
-
当前项目数据量较小（初期预计区域数≤1000），多表联查性能开销可忽略
-
避免数据冗余，确保区域与点位数据的实时一致性
-
简化系统设计，无需维护额外的更新逻辑
4.2 核心代码实现
后端通过MyBatis-Plus实现多表联查，封装RegionVo返回给前端：
/*** 区域VO*/
@Data
public class RegionVo extends SysRegion {// 区域下点位数量private Integer pointCount;
}/*** Mapper接口*/
public interface SysRegionMapper extends BaseMapper
前端通过标签直接展示node_count
五、实战总结与次日规划
首日实战完成了项目环境搭建、若依框架代码生成流程梳理、AIGC辅助开发实践以及区域管理功能的核心实现。通过本次实践，提炼出若依框架二次开发的通用流程：
-
数据表设计（含基础字段与注释）
-
代码生成与结构整合
-
VO封装与多表联查实现
-
前端页面适配与交互完善
次日将重点推进合作商和点位管理的代码优化,敬请期待!