Repository navigation
v0.1.0 — EngageIQ initial release
Pre-releaseOverview
EngageIQ is a full‑stack reference implementation of a community platform that demonstrates robust client/server synchronization, idempotent reward/karma mechanics, moderation tooling, and optional AI-assisted content helpers (rewrite + autotag).
This first release packages the frontend UI, the admin backend, seeding and admin scripts, developer tooling and example data for local demos.
Highlights / key features
Production‑style frontend: React 19 + TypeScript app bootstrapped with Vite and Tailwind.
See: frontend
TypeScript admin backend with Express, Cosmos persistence patterns and developer scripts.
See: backend
Deterministic, idempotent karma awards and anti‑gaming measures (deterministic audit keys + session dedupe).
Client award logic: useKarmaSystem.ts
Server audit/upsert helpers: db.ts
Resilient client/server synchronization with an unsynced queue and retry semantics for offline or failed requests.
Unsynced queue: unsynced.ts
AI‑assisted helpers for improving post quality and discovery:
Server AI adapter (AOAI / Foundry): ai.ts — provides callRewriteProvider and autotag provider functions.
Admin rewrite endpoint wired to AI helper: admin.ts (POST /admin/rewrite now calls callRewriteProvider).
Demo script for rewrite + autotag: demo-rewrite-and-autotag.mjs
Developer tooling & seed data for reproducible demos:
Seeding scripts and helpers under: scripts
Seeding entry: node ./backend/scripts/fresh-seed-all.mjs
What’s included (short checklist)
Frontend app: code, components, hooks and test suite — frontend
Backend server: TypeScript source, API routes and admin scripts — backend
AI helpers: ai.ts (AOAI + Foundry support; uses env to select provider)