AGENTS.md 3.3 KB

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