enagic/AGENTS.md

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

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