# PROJECT KNOWLEDGE BASE

**Generated:** 2026-05-07
**Branch:** master

## OVERVIEW
Enagic (元気) 本希甄选 — WeChat mini-program platform for Kangen water business. Spring Boot + Vue 2 + UniApp, extending Lilishop B2B2C.

## STRUCTURE
```
enagic/
├── 课件/          # Courseware materials
├── 资料文档/       # Reference documentation
├── 资料/          # Misc materials (PDFs, XLSX)
├── 需求文档/       # Requirement docs (PDF, XLSX, MD)
├── 测试文档/       # Test docs (reserved)
├── 代码/          # Source code
│   ├── SPEC.md                    # Tech spec (requirements, design, API, DB)
│   ├── enagic-lilishop/           # Backend: Maven multi-module plugin
│   │   ├── enagic-entity/         # Entity layer (14 new tables)
│   │   ├── enagic-api/            # Business API (core extension)
│   │   ├── enagic-admin/          # Admin panel (Vue 2 + ViewUI)
│   │   └── enagic-consumer/       # Event consumer / scheduled tasks
│   └── enagic-uniapp/             # Mini-program (forked from lilishop-uniapp)
└── AGENTS.md
```

## WHERE TO LOOK
| Task | Location |
|------|----------|
| Tech spec & API docs | `代码/SPEC.md` |
| Backend (Spring Boot + Maven) | `代码/enagic-lilishop/enagic-plugin/` |
| Admin frontend (Vue 2) | `代码/enagic-lilishop/enagic-plugin/enagic-admin/` |
| Mini-program (UniApp) | `代码/enagic-uniapp/` |
| Database schema | `代码/enagic-lilishop/enagic-plugin/DB/enagic_init.sql` |
| Deployment guide | `代码/enagic-lilishop/enagic-plugin/docs/` |
| Requirements docs | `需求文档/` |
| Courseware | `课件/` |

## KEY MODULES
| Module | Tech | Description |
|--------|------|-------------|
| AI Digital Human | Java + SiliconFlow API | Real-time AI chat with knowledge base |
| Health Advisor | Java + UniApp | Referral system, achievements, medals |
| VIP System | Java + UniApp | No-expiry membership, gratitude reminders |
| Deduction Account | Java + UniApp | Independent balance for order payments |
| Operation Flow | Java + RocketMQ | Auto-generate maintenance plans after order |
| QR Code Sharing | Java + UniApp | Track referral relationships |

## ARCHITECTURE
- **Plugin pattern**: Maven module `enagic-plugin` injected via Spring `@Component`
- **API isolation**: `/enagic/**` namespace, no conflict with Lilishop originals
- **Event-driven**: RocketMQ listens to Lilishop order events
- **Scheduled tasks**: XXL-Job for maintenance plan scans, VIP reminders

## DATABASE
14 new tables with prefix `li_enagic_` (see `SPEC.md` §4 for full schema).

## CONVENTIONS
- Java: Spring Boot 2.4 + MyBatis-Plus, standard Maven layout
- Vue: Vue 2 + ViewUI (iView), single-file components
- UniApp: uView UI framework
- API: RESTful under `/enagic/buyer/` (customer) and `/enagic/manager/` (admin)

## COMMANDS
```bash
git pull origin master           # Sync repo
mvn clean package -DskipTests    # Build (requires Lilishop v4.3 source)
```

## NOTES
- Depends on Lilishop B2B2C v4.3 source code for compilation
- Do NOT modify Lilishop core code — all extensions in `enagic-plugin/`
- Chinese filenames common. Use `chcp 65001` for Unicode in PowerShell
- Remote: `http://git.iwintrue.com/liaoxg/enagic.git`
- Full tech spec: `代码/SPEC.md`