Lux CRM Agent (Lux Design Edition)

Smart CRM tailored for a design agency workflow:

• lead intake and pipeline stages
• client profiles
• projects and delivery stages
• proposals / estimates
• contracts and status tracking
• tasks, notes, and follow-ups
• dashboard metrics for agency operations

Architecture

• API: FastAPI (apps/api)
• UI: Next.js (apps/ui)
• Infra: Docker Compose (API, worker, Redis, Neo4j, n8n, UI)

Docker quickstart

1. Copy environment file:

   cp .env.example .env
   

2. Start stack:

   docker compose up --build
   

3. Open:
   • UI: http://localhost:3000
   • API: http://localhost:8000/v1
   • Agency dashboard API: http://localhost:8000/v1/agency/dashboard

Local dev (without Docker)

API

cd apps/api
pip install -e .[dev]
uvicorn app.main:app --reload --port 8000

UI

cd apps/ui
npm install
npm run dev

Design-agency CRM endpoints

• POST /v1/agency/leads
• POST /v1/agency/clients
• POST /v1/agency/projects
• POST /v1/agency/proposals
• POST /v1/agency/tasks
• GET /v1/agency/dashboard

The dashboard response includes stage distribution, pipeline value, proposal/contract/task counts, and recent records.

OpenClaw integration (Phase 2/3)