uEngage Engineering Knowledge Base¶
A single, searchable home for product-by-product engineering knowledge across the uEngage platform. Each product has its own deep-dive knowledge base โ architecture, modules, database, APIs, runbooks, and a full learning path โ grounded in the actual code, not generic descriptions.
๐ Products¶
| Product | What it is | Status | Enter |
|---|---|---|---|
| Prism | F&B customer-engagement / CRM platform (dashboards, RFM, campaigns, loyalty, membership, feedback) | ๐ข Complete | Open Prism KB โ |
| WLA | White-Label App | โช Planned | coming soon |
| Edge | uEngage Edge โ online ordering platform | โช Planned | coming soon |
Adding a product later is just a new folder under
docs/(e.g.docs/wla/) plus a nav section โ see Adding a new product.
๐ How to use this KB¶
- Reading on GitHub? Just browse the folders โ everything renders as Markdown with diagrams.
- Reading as a website? Run the MkDocs portal (full-text search, rendered diagrams, dark mode): from the repo root,
pip install -r requirements-docs.txtthenmkdocs serveโ http://127.0.0.1:8000. Full instructions are in the repository README. - New joiner? Pick your product and start with its Getting Started section and New Joiner Learning Path.
- AI / RAG? Every page carries YAML front-matter (
tags,keywords,related,difficulty,reading_time) for retrieval.
๐งญ Conventions (shared across all products)¶
Every product KB follows the same shape so knowledge is predictable wherever you land:
docs/<product>/
โโโ README.md # product master index
โโโ 00-Getting-Started/ # system overview, setup, project structure
โโโ 01-Business/ # product + business flows, glossary, roadmap
โโโ 02-Architecture/ # high-level, request lifecycle, module map
โโโ 03-Modules/ # per-module 15-section deep-dives
โโโ 04..13/ # Database, API, Queues, Caching, Security,
โ # Third-Party, Deployment, Debugging,
โ # Best-Practices, Common-Issues
โโโ 14..15/ # Interview questions, learning path, assessments
Validation legend (used in every product KB): โ verified in code ยท ๐ spec-only ยท ๐ป code-only ยท โป๏ธ duplicate impl ยท โฐ๏ธ dead/legacy ยท โ ๏ธ tech debt / risk.
โ Adding a new product¶
- Create
docs/<product>/following the folder shape above (copy Prism's skeleton as a template). - Add a nav section for it in
mkdocs.yml(a new top-level entry becomes a tab). - Add a row to the Products table above.
- Build with
mkdocs build --strictto verify links.
Start here โ Prism Knowledge Base