帝可得智能售货机系统实战Day1：从环境搭建到区域管理功能落地 (1)

帝可得智能售货机系统实战Day1：从环境搭建到区域管理功能落地

在物联网技术与新零售深度融合的背景下，智能售货机系统正成为线下零售数字化转型的重要载体。本文作为帝可得智能售货机运营管理系统实战系列的开篇，将记录从项目初始化到核心功能实现的完整过程，重点分享若依框架的工程化实践、AIGC辅助开发技巧以及区域管理模块的技术选型思考。

为了更直观地呈现首日实战的核心内容框架，以下是整理的mermaid思维导图，可作为后续阅读的导航指引：
帝可得实战Day1 项目全景五端五角色环境搭建工程初始化 AIGC与提示工程区域管理功能总结与次日规划

一、项目全景：五端五角色架构解析

帝可得系统作为物联网概念下的智能售货机运营管理平台，其核心特征是通过"五端五角色"实现全链路业务覆盖。各角色职责与系统模块的对应关系如下：

角色	核心职责	对应系统模块
管理员	基础数据管理（区域/点位/设备）、工单指派、报表查看	系统管理、数据字典、统计分析
运维人员	设备投放/撤除/维修、故障处理	运维工单、设备监控
运营人员	商品补货、销售数据跟踪	运营工单、货道管理
合作商	点位提供、收益查看	合作商管理、收益报表
消费者	扫码购物、订单查询	小程序端、支付集成
系统设计亮点：通过角色权限的细粒度划分，实现了业务流程的权责分离，为后续功能扩展奠定了清晰的架构基础。

二、环境搭建与工程初始化

2.1 项目克隆与环境配置

首先从Gitee仓库克隆前后端工程，确保本地环境满足JDK1.8+、MySQL8.0+、Node.js14+的基础要求：

bash 复制代码

# 克隆前端工程
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生成的字典枚举类示例：

java 复制代码

/**
 * 商户圈类型枚举
 */
public enum MerchantCircleTypeEnum {
    COMMUNITY("0", "社区"),
    SCHOOL("1", "学校"),
    HOSPITAL("2", "医院"),
    OFFICE("3", "写字楼");

    private final String code;
    private final String name;

    // 构造器、getter方法省略
}

通过这种方式，不仅快速完成了数据字典设计，还确保了代码风格与项目规范的一致性。

四、区域管理功能实现：多表联查策略解析

为直观展示区域管理模块的技术选型与实现逻辑，以下是该模块的专项思维导图：
区域管理功能需求分析查区域点位数量技术选型多表联查方案核心实现VO封装+联查+前端展示

4.1 需求分析与技术选型

区域管理模块需实现"查询区域下点位数量"的功能，面临两种技术方案选择：

方案A：在区域表（sys_region）中添加node_count字段，通过触发器或定时任务更新
方案B：采用多表联查（区域表与点位表sys_point）实时统计

最终选择方案B，主要基于以下考量：

当前项目数据量较小（初期预计区域数≤1000），多表联查性能开销可忽略
避免数据冗余，确保区域与点位数据的实时一致性
简化系统设计，无需维护额外的更新逻辑

4.2 核心代码实现

后端通过MyBatis-Plus实现多表联查，封装RegionVo返回给前端：

java 复制代码

/**
 * 区域VO
 */
@Data
public class RegionVo extends SysRegion {
    // 区域下点位数量
    private Integer pointCount;
}

/**
 * Mapper接口
 */
public interface SysRegionMapper extends BaseMapper

前端通过标签直接展示node_count

五、实战总结与次日规划

首日实战完成了项目环境搭建、若依框架代码生成流程梳理、AIGC辅助开发实践以及区域管理功能的核心实现。通过本次实践，提炼出若依框架二次开发的通用流程：

数据表设计（含基础字段与注释）
代码生成与结构整合
VO封装与多表联查实现
前端页面适配与交互完善

次日将重点推进合作商和点位管理的代码优化,敬请期待!