# 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. 初始化数据库

```sql
-- 在 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

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

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

### 3. 启动 Lilishop

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

### 4. 运行小程序

```bash
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知识库管理 |

## 配置项

```yaml
# 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
```