mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-18 07:19:35 +00:00
8c3d91c070
- Align httpx, litellm, langchain, openai, mem0ai, crewai, numpy, requests, pydantic - Rename SequenceEvent ORM attribute to event_metadata (DB column stays metadata) - Use PyJWT instead of python-jose in security and auth service - Mem0: MemoryConfig + graceful fallback when init fails (CI without keys) - Frontend: I18nProvider in root layout, fix dashboard LeadScoreCard props, Section id, kpi-card useRef, en.json nameAr parity, e2e assertion for premium landing - README: troubleshooting for connection refused and local E2E Playwright install Co-authored-by: VoXc2 <VoXc2@users.noreply.github.com>
93 lines
4.7 KiB
Markdown
93 lines
4.7 KiB
Markdown
# 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 15 (React, TypeScript) |
|
|
| Database | PostgreSQL 15 |
|
|
| Cache / Broker | Redis 7 |
|
|
| Task Queue | Celery 5 |
|
|
| Reverse Proxy | Nginx |
|
|
| Containerization | Docker Compose |
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
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`
|
|
|
|
**If the browser shows connection refused on `:3000` or `:8000`:** nothing is listening on that port yet. Start the stack (`docker compose up` from this folder) or run `uvicorn` / `npm run dev` manually. Confirm with `curl -sSf http://127.0.0.1:8000/api/v1/health` and ensure the browser is on the same machine as the server (not WSL/remote without port forwarding).
|
|
|
|
**Without Docker:** install Python 3.12+ and Node 22+, copy `.env` and `frontend/.env.local`, run Postgres/Redis (or point `DATABASE_URL` / `REDIS_URL` at existing instances), then `cd backend && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000` and `cd frontend && npm run dev`.
|
|
|
|
**E2E locally:** after `npm ci`, run `npx playwright install chromium` once, then `npm run test:e2e` (matches CI).
|
|
|
|
**Customer onboarding (B2B):** `GET /api/v1/customer-onboarding/journey` and `docs/CUSTOMER_OS_ONBOARDING_AR.md`. Dashboard tab: **مسار التشغيل مع العميل**.
|
|
|
|
**Launch verification:** see `docs/LAUNCH_CHECKLIST.md`. From `salesflow-saas`: copy `frontend/.env.example` to `frontend/.env.local` and set `NEXT_PUBLIC_API_URL`. Run `.\verify-launch.ps1 -HttpCheck -SoftReady` (use `-BaseUrl` if the API is not on port 8000).
|
|
|
|
**CI:** GitHub Actions workflow `.github/workflows/dealix-ci.yml` (repo root) runs backend `pytest` and frontend `lint` + `build` when `salesflow-saas/**` changes.
|
|
|
|
**DB migrations:** from `backend`, set `PYTHONPATH` to the backend folder (e.g. `set PYTHONPATH=%CD%` on Windows), then `alembic upgrade head`. For Postgres schema evolution, prefer `alembic revision --autogenerate` against a dev database after the baseline revision.
|
|
|
|
## 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](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](https://github.com/VoXc2)
|