system-prompts-and-models-o.../salesflow-saas/README.md
Claude 84762f08ab
Add complete launch infrastructure: models, APIs, agents, compliance, docs, knowledge base
Phase 1 - Repo Hardening:
- README.md, LICENSE, SECURITY.md, CONTRIBUTING.md
- GitHub Actions repo-hygiene workflow
- docs/: ARCHITECTURE, DATA-MODEL, API-MAP, AGENT-MAP, DEPLOYMENT-NOTES

Phase 2 - Database Models (7 new):
- Company, Contact, Call, Commission, Payout, Dispute, GuaranteeClaim
- Consent, Complaint, Policy, KnowledgeArticle, SectorAsset
- Updated models/__init__.py with all 32+ models

Phase 3 - API Surfaces (16 new route files):
- companies, contacts, calls, meetings, commissions, payouts
- disputes, guarantees, consents, complaints, knowledge
- sectors, presentations, supervisor, admin, health
- Updated router.py with all 24 route groups

Phase 4 - AI Prompt Registry (18 agent contracts):
- Lead Qualification, Affiliate Recruitment Evaluator, Onboarding Coach
- Outreach Writer, Arabic WhatsApp, English Conversation, Voice Call
- Meeting Booking, Sector Strategist, Objection Handler
- Proposal Drafter, QA Reviewer, Compliance Reviewer
- Knowledge Retrieval, Revenue Attribution, Fraud Reviewer
- Guarantee Claim Reviewer, Management Summary

Phase 5 - Communication Templates:
- 15 production templates (WhatsApp, email, voice, internal)
- Arabic + English variants with variable interpolation

Phase 6 - Compliance Center (7 legal docs):
- Privacy policy, Terms of service, Refund policy
- Commission policy, Affiliate rules, Consent policy, Data protection
- All PDPL-compliant, Arabic

Phase 7 - Celery Workers (fully implemented):
- follow_up_tasks: automated lead follow-ups with workflow execution
- message_tasks: WhatsApp/email/SMS with retry logic
- notification_tasks: daily reports, meeting reminders, in-app notifications
- affiliate_tasks: target checking, commission calculation, weekly reports, AI outreach

Phase 8 - Knowledge Base OS (8 files):
- Services overview, Pricing policy, Channel policy, Meeting policy
- Identity rules, Escalation rules, Hiring path, Internal SOPs

https://claude.ai/code/session_01KnJgK7RwyeCvRZTRThHtfU
2026-03-31 07:57:48 +00:00

3.1 KiB

Dealix - Saudi AI Revenue Operating System

AI-powered revenue operations platform built for the Saudi market. Dealix combines lead management, affiliate recruitment, sales automation, meeting scheduling, deal tracking, and commission processing into a single operating system driven by specialized AI agents.

Tech Stack

Layer Technology
Backend FastAPI (Python 3.11+)
Frontend Next.js 14 (React, TypeScript)
Database PostgreSQL 15
Cache / Broker Redis 7
Task Queue Celery 5
Reverse Proxy Nginx
Containerization Docker Compose

Quick Start

git clone https://github.com/VoXc2/dealix.git
cd dealix
cp .env.example .env        # fill in your secrets
docker-compose up --build

Backend: http://localhost:8000/docs Frontend: http://localhost:3000

Project Structure

salesflow-saas/
  backend/             # FastAPI application (routes, models, services, agents)
  frontend/            # Next.js dashboard and client portal
  ai-agents/           # AI agent definitions, prompts, and orchestration
  affiliate-system/    # Affiliate recruitment, tracking, commissions
  guarantee/           # Gold guarantee claim processing
  knowledge-base/      # RAG knowledge articles and sector data
  presentations/       # Proposal and pitch generation
  nginx/               # Reverse proxy configuration
  seeds/               # Database seed data
  docs/                # Architecture, API map, data model, deployment notes
  docker-compose.yml   # Full-stack orchestration
  Makefile             # Developer shortcuts

Key Features

  • Multi-Tenant - Isolated data per organization with role-based access
  • Arabic-First - UI, AI prompts, and WhatsApp flows in Arabic with full English support
  • WhatsApp Business API - Automated outreach, conversations, and booking via WhatsApp
  • 18 AI Agents - Lead qualification, outreach, objection handling, compliance, fraud review, and more
  • Affiliate System - Recruitment, onboarding, performance tracking, and tiered commissions
  • Gold Guarantee - Claim processing, dispute resolution, and automated refunds
  • Meeting Booking - AI-driven scheduling integrated with calendar providers
  • Deal Pipeline - Stage-based tracking with revenue attribution
  • Commission Engine - Automated calculation, payout scheduling, and dispute handling
  • Sector Intelligence - Industry-specific strategies, assets, and scoring

What Is Excluded from This Repository

This is a public repository for visibility and version tracking. The following are never committed:

  • .env files and environment secrets
  • Private keys, certificates, and SSL materials (.pem, .key, .crt)
  • Log files and runtime output
  • Docker volumes and persistent data
  • Third-party API credentials

See SECURITY.md for reporting vulnerabilities.

Safety Note

This repository is public. No secrets, credentials, or private customer data are stored here. All sensitive configuration is injected at deploy time via environment variables and secret managers.

Maintainer

Sami Assiri / VoXc2