How mayurh2007/zittet-ai-lead-recovery-engine-backend- works
Zizzet is a multi-tenant backend API for lead recovery, not a CRM UI. A tenant submits a lead and conversation for analysis; the service invokes an LLM, validates structured output, applies opt-out and scoring rules, and persists the result. Follow-up retrieval and idempotent webhook intake are separate product paths, with webhooks processed in the background. The graph follows the README’s architecture and capabilities; most implementation files are not present in the supplied tree or excerpts, so their paths are left null and edges rely on documented relationships.
Main entry points: main.py FastAPI App
Components 17
HTTP API
- FastAPI App
main.py - Lead Routes
- Webhook Route
- Health Route
Lead Services
- Lead Service
- Follow-up Service
Analysis Engine
- Analysis Service
- LLM Provider
- Output Validation
- Business Rules
Persistence
- Lead Repository
- Analysis Repository
- Webhook Repository
- PostgreSQL
Webhook Processing
- Webhook Service
- Background Worker
Other components
- Tenant Client
Connections 22
- Tenant Client → FastAPI App: sends requests
README.md - FastAPI App → Lead Routes: registers routes
main.py - FastAPI App → Webhook Route: registers routes
main.py - FastAPI App → Health Route: registers route
main.py - Lead Routes → Lead Service: delegates analysis
README.md - Lead Routes → Follow-up Service: requests follow-up
README.md - Lead Service → Lead Repository: accesses lead data
README.md - Lead Service → Analysis Service: orchestrates analysis
README.md - Analysis Service → Lead Repository: loads lead context
- Analysis Service → LLM Provider: requests analysis
README.md - LLM Provider → Analysis Service: returns structured output
README.md - Analysis Service → Output Validation: validates output
README.md - Analysis Service → Business Rules: applies rules
README.md - Analysis Service → Analysis Repository: persists analysis
README.md - Follow-up Service → Analysis Repository: reads stored analysis
README.md - Webhook Route → Webhook Service: delegates intake
README.md - Webhook Service → Webhook Repository: records events
README.md - Webhook Service → Background Worker: schedules processing
README.md - Background Worker → Lead Service: processes lead
- Lead Repository → PostgreSQL: reads and writes
README.md - Analysis Repository → PostgreSQL: reads and writes
README.md - Webhook Repository → PostgreSQL: reads and writes
README.md