enagic/代码

Enagic 本希甄选小程序项目

项目路径： /mnt/e/workspace/enagic/代码/enagic-lilishop 和 /mnt/e/workspace/enagic/代码/enagic-uniapp

项目组成

代码/
├── SPEC.md                          # 技术方案文档（完整需求、设计、API、数据库）
│
├── enagic-lilishop/                # 基于 Lilishop 的后台项目
│   ├── enagic-plugin/               # Enagic 插件模块（Maven）
│   │   ├── pom.xml                   # 聚合 POM
│   │   │
│   │   ├── enagic-entity/            # 实体层（14 张新表）
│   │   │   └── src/main/java/com/enagic/modules/enagic/entity/dos/
│   │   │       ├── HealthAdvisor.java       # 健康布施者
│   │   │       ├── AdvisorMedal.java        # 荣誉勋章
│   │   │       ├── EnagicVipConfig.java      # VIP 配置
│   │   │       ├── MemberVip.java           # 会员 VIP
│   │   │       ├── MemberDeduction.java     # 抵扣金账户
│   │   │       ├── DeductionLog.java        # 抵扣金流水
│   │   │       ├── OperationFlow.java      # 运维流程模板
│   │   │       ├── OperationPlan.java      # 运维计划
│   │   │       ├── OperationRecord.java     # 运维记录
│   │   │       ├── MemberTransfer.java       # 客户移交
│   │   │       ├── ArticleQr.java           # 素材二维码
│   │   │       ├── BehaviorLog.java         # 行为日志
│   │   │       ├── AiConversation.java     # AI 对话记录
│   │   │       └── AiKnowledge.java         # AI 知识库
│   │   │
│   │   ├── enagic-api/               # 业务 API（核心扩展）
│   │   │   └── src/main/java/com/enagic/modules/enagic/
│   │   │       ├── config/
│   │   │       │   └── EnagicApiAutoConfiguration.java  # Spring 自动配置
│   │   │       ├── controller/
│   │   │       │   ├── buyer/
│   │   │       │   │   ├── AiChatController.java         # AI 数字人
│   │   │       │   │   └── HealthAdvisorBuyerController.java  # 健康布施者
│   │   │       │   └── manager/
│   │   │       │       └── HealthAdvisorManagerController.java  # 后台管理
│   │   │       ├── service/
│   │   │       │   ├── AiChatService.java         # AI 业务逻辑
│   │   │       │   ├── HealthAdvisorService.java  # 健康布施者业务
│   │   │       │   ├── VipService.java            # VIP 业务
│   │   │       │   └── OperationPlanService.java # 运维计划业务
│   │   │       └── mapper/
│   │   │           └── *Mapper.java (MyBatis-Plus)
│   │   │
│   │   ├── enagic-admin/             # PC 后台管理 Vue 页面
│   │   │   ├── pom.xml
│   │   │   └── src/main/vue/
│   │   │       ├── views/enagic/     # 页面组件
│   │   │       └── api/enagic.js     # API 调用
│   │   │
│   │   └── enagic-consumer/          # 事件消费者（定时任务）
│   │       └── src/main/java/com/enagic/modules/enagic/consumer/
│   │           ├── OrderEventConsumer.java    # RocketMQ 订单事件监听
│   │           └── OperationRemindJob.java    # 运维提醒定时任务
│   │
│   └── README.md
│
└── enagic-uniapp/                    # 小程序（forked from lilishop-uniapp）
    ├── api/
    │   └── enagic.js                # Enagic API 调用层
    ├── pages/
    │   └── enagic/
    │       └── ai-chat/
    │           └── index.vue         # AI 数字人对话页
    └── README.md

技术架构

后端扩展方式

1. 新增 Maven 模块 (enagic-plugin) 作为 Lilishop 的扩展
2. 通过 Spring @ComponentScan 自动注册到 Lilishop 应用上下文
3. 独立 API 命名空间 (/enagic/buyer/*, /enagic/manager/*) 不干扰原有 API
4. 事件驱动：RocketMQ 监听 Lilishop 订单事件，触发运维流程
5. 定时任务：XXL-Job 定时扫描运维计划、VIP 感恩提醒

数据库

• 14 张新表，前缀 li_enagic_*，与 Lilishop 原有表共存
• 扩展原有表：li_member（health_advisor_id、advisor_credits）、li_distribution（medal_level、permanent_bind）

小程序改造

• fork /mnt/e/workspace/uniapp/lilishop 为 enagic-uniapp
• 新增 pages/enagic/ 目录（分包），包含 AI聊天、健康布施者中心、VIP、抵扣金、运维等页面
• 新增 api/enagic.js 统一封装 Enagic 扩展 API

快速开始

1. 初始化数据库

-- 在 Lilishop 数据库中执行以下 DDL
--（详见 SPEC.md 第四章数据库设计）
CREATE TABLE li_enagic_health_advisor (...);
CREATE TABLE li_enagic_advisor_medal (...);
CREATE TABLE li_enagic_vip_config (...);
CREATE TABLE li_enagic_member_vip (...);
CREATE TABLE li_enagic_deduction (...);
CREATE TABLE li_enagic_deduction_log (...);
CREATE TABLE li_enagic_operation_flow (...);
CREATE TABLE li_enagic_operation_plan (...);
CREATE TABLE li_enagic_operation_record (...);
CREATE TABLE li_enagic_member_transfer (...);
CREATE TABLE li_enagic_behavior_log (...);
CREATE TABLE li_enagic_article_qr (...);
CREATE TABLE li_enagic_ai_conversation (...);
CREATE TABLE li_enagic_ai_knowledge (...);

2. 部署 enagic-plugin

cd enagic-lilishop/enagic-plugin
mvn clean install -DskipTests

# 将生成的 JAR 加入 Lilishop 部署
cp enagic-*/target/enagic-*.jar /path/to/lilishop/lib/

3. 启动 Lilishop

# Lilishop 重启后，Enagic 的 Controller、Service 会自动注册
cd /path/to/lilishop
java -jar lilishop.jar

4. 运行小程序

cd enagic-uniapp
# 在 HBuilderX 中打开
# 运行 → 运行到小程序模拟器 → 微信开发者工具

主要功能一览

功能	模块	说明
AI 数字人对话	enagic-api + enagic-uniapp	对接硅基流动，实时对话
健康布施者中心	enagic-api + enagic-uniapp	邀请客户、查看业绩、勋章
VIP 开通	enagic-api + enagic-uniapp	无到期时间，分享激励
抵扣金账户	enagic-api + enagic-uniapp	独立账户，订单抵扣
运维流程	enagic-consumer	订单发货后自动生成运维计划
PC 后台管理	enagic-admin	健康布施者、VIP、运维、AI知识库管理

配置项

# application.yml
enagic:
  ai:
    provider: siliconflow          # 或 aliyun
    api-key: ${AI_API_KEY}          # 从环境变量读取
    model: Qwen/Qwen2.5-7B-Instruct
    base-url: https://api.siliconflow.cn/v1