mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-17 23:09:35 +00:00
Builds the full Saudi Autonomous Revenue OS surface as 10 deterministic
modules + a 16-endpoint router under /api/v1/growth-operator/.
Approval-first: every outbound is draft. No live send / charge / calendar
insert from this layer.
MODULES (auto_client_acquisition/growth_operator/)
1. client_profile.py — ClientGrowthProfile + Saudi-default approval
+ compliance rules (no cold WhatsApp, blocked keywords, weekly cap,
quiet_hours_riyadh)
2. contact_importer.py — normalize_phone (Saudi E.164),
dedupe_contacts (richer-record-wins), classify_contact_source
(existing/inbound/event/referral/old_lead/cold/unknown), detect_opt_out
(Arabic + English markers), summarize_import (dashboard report)
3. contactability.py — score_contactability returns
safe/needs_review/blocked with Arabic reasons; default policy:
no cold WhatsApp without lawful basis (PDPL Art.5)
4. targeting.py — segment_contacts, rank_targets (filters unsafe),
recommend_top_10, why_now_stub (deterministic, sector-aware)
5. message_planner.py — draft_arabic_message (Saudi tone, 4-sector
opener bank, no overhyped phrases, always pending_approval),
draft_followup (4 outcome modes), draft_objection_response
(6 indexed Saudi B2B objections with score_delta + next_action)
6. partnership_planner.py — 6 partner types catalog
(agency / consultant / integrator / crm / community / influencer)
+ suggest_partner_types (size/sector aware) + draft_partner_outreach
+ partner_scorecard (platinum/gold/silver/bronze)
7. meeting_planner.py — build_meeting_agenda (15/20-30/45+ min slot
plans), build_calendar_draft (Google Calendar shape, live_inserted=False,
conferenceData for Meet, Asia/Riyadh timezone), build_post_meeting_followup
8. payment_offer.py — sar_to_halalas, build_moyasar_payment_link_draft
(full payload + in-chat message + 4-plan catalog, live_charged=False)
9. proof_pack.py — build_weekly_proof_pack with grade A+/A/B/C/D,
activity/money/quality/best-of sections, dynamic next_week_plan_ar,
markdown export
10. mission_planner.py — 6 GROWTH_MISSIONS (first_10_opportunities ⭐
kill feature, recover_stalled_deals, partnership_sprint,
safe_whatsapp_campaign, meeting_booking_sprint, list_cleanup);
list_missions() + run_mission()
ROUTER (api/routers/growth_operator.py) — 16 endpoints
POST /contacts/import-preview · POST /contactability/score
POST /targets/top-10 · POST /messages/draft · POST /messages/followup
POST /messages/objection-response · POST /partners/suggest
POST /partners/outreach · POST /partners/scorecard
POST /meetings/draft · POST /meetings/post-followup
POST /payment-offer/draft · GET /missions · POST /missions/{id}/run
GET /proof-pack/demo · POST /profile
WIRING: api/main.py adds growth_operator import + router include
(positioned after personal_operator, before public).
DOCS
- docs/ARABIC_GROWTH_OPERATOR_FULL_SPEC.md (NEW): 20-section vision +
customer-type table + upload flow + contactability rules +
WhatsApp/Gmail/Calendar/Moyasar drafts + 6 missions + 16-endpoint
catalog + competitive comparison + beta readiness checklist
TESTS — 50 passing on Python 3.10 venv
tests/unit/test_growth_operator.py covers:
- Phone normalization across 5 input formats including invalid
- Dedupe richer-record invariant
- Source classification (existing/inbound/event/cold/unknown)
- Opt-out detection (Arabic + English notes + status)
- Import summary aggregation
- Contactability: opt-out blocked, cold WhatsApp blocked,
unknown→needs_review, existing→safe, inbound→safe
- Bulk contactability summary
- Top-10 filtering (unsafe excluded), max-cap enforcement
- Segment buckets
- Arabic message: pending_approval invariant + Arabic content
+ no overhyped phrases (banned list)
- Followup approval invariant
- Objection response: known + unknown→diagnostic
- Partner suggestions size-aware (SMB→agency/consultant/community)
- Partner outreach approval invariant
- Partner unknown type returns error
- Partner scorecard tier ordering
- Meeting agenda + calendar draft (live_inserted=False) +
Asia/Riyadh timezone + post-followup pending
- Payment: halalas conversion (1 SAR=100), negative raises,
draft NEVER charges (live_charged=False), unknown plan→error
- Proof pack: grade range + structure + markdown export
- Missions: first_10_opportunities present + kill feature ID
+ run mission known/unknown
- Profile: demo specialized + partial not specialized
+ default compliance blocks 'ضمان 100' + no_cold_whatsapp_without_lawful_basis
VERIFICATION
- 527 unit tests pass (was 477; +50 growth_operator)
- 2 skipped (provider smoke needs API keys)
- AST green on all 13 new files
- Approval invariant holds across every drafting function
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
186 lines
5.5 KiB
Python
186 lines
5.5 KiB
Python
"""
|
|
FastAPI application entry point.
|
|
نقطة دخول تطبيق FastAPI.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import AsyncIterator
|
|
from contextlib import asynccontextmanager
|
|
|
|
from fastapi import FastAPI, Request
|
|
from fastapi.middleware.cors import CORSMiddleware
|
|
from fastapi.responses import JSONResponse
|
|
|
|
from api.middleware import RequestIDMiddleware
|
|
from api.routers import (
|
|
admin,
|
|
agents,
|
|
automation,
|
|
autonomous,
|
|
business,
|
|
command_center,
|
|
customer_success,
|
|
data,
|
|
dominance,
|
|
drafts,
|
|
ecosystem,
|
|
email_send,
|
|
full_os,
|
|
growth_operator,
|
|
health,
|
|
innovation,
|
|
leads,
|
|
outreach,
|
|
personal_operator,
|
|
pricing,
|
|
prospect,
|
|
public,
|
|
revenue,
|
|
revenue_os,
|
|
sales,
|
|
sectors,
|
|
v3,
|
|
webhooks,
|
|
)
|
|
from api.security import APIKeyMiddleware, setup_rate_limit
|
|
from core.config.settings import get_settings
|
|
from core.errors import AICompanyError
|
|
from core.logging import configure_logging, get_logger
|
|
|
|
|
|
@asynccontextmanager
|
|
async def lifespan(_app: FastAPI) -> AsyncIterator[None]:
|
|
"""App startup/shutdown hook."""
|
|
configure_logging()
|
|
log = get_logger(__name__)
|
|
settings = get_settings()
|
|
log.info(
|
|
"app_startup",
|
|
app=settings.app_name,
|
|
version=settings.app_version,
|
|
env=settings.app_env,
|
|
)
|
|
# Auto-create tables on boot (additive — safe with SQLAlchemy create_all)
|
|
try:
|
|
from db.session import init_db
|
|
await init_db()
|
|
log.info("db_init_complete")
|
|
except Exception as exc:
|
|
log.warning("db_init_skipped", error=str(exc))
|
|
yield
|
|
log.info("app_shutdown")
|
|
|
|
|
|
def create_app() -> FastAPI:
|
|
"""FastAPI factory."""
|
|
settings = get_settings()
|
|
|
|
app = FastAPI(
|
|
title=settings.app_name,
|
|
version=settings.app_version,
|
|
description=(
|
|
"Multi-agent AI platform for the Saudi Arabian market.\n\n"
|
|
"**Phase 8**: Auto Client Acquisition — intake, ICP match, "
|
|
"pain extraction, qualification, CRM sync, booking, proposals.\n\n"
|
|
"**Phase 9**: Autonomous Growth — sector intel, content, distribution, "
|
|
"enrichment, competitor analysis, market research.\n\n"
|
|
"**Phase 10 / v3**: Autonomous Saudi Revenue OS — revenue memory, "
|
|
"safe agent runtime, market radar, compliance OS, revenue science, "
|
|
"and Sami Personal Strategic Operator."
|
|
),
|
|
docs_url="/docs",
|
|
redoc_url="/redoc",
|
|
openapi_url="/openapi.json",
|
|
lifespan=lifespan,
|
|
)
|
|
|
|
app.add_middleware(
|
|
CORSMiddleware,
|
|
allow_origins=settings.cors_origin_list,
|
|
allow_credentials=True,
|
|
allow_methods=["*"],
|
|
allow_headers=["*"],
|
|
)
|
|
app.add_middleware(RequestIDMiddleware)
|
|
app.add_middleware(APIKeyMiddleware)
|
|
setup_rate_limit(app)
|
|
|
|
try:
|
|
from dealix.observability import instrument_fastapi, setup_sentry, setup_tracing
|
|
|
|
setup_sentry()
|
|
setup_tracing(service_name=settings.app_name, version=settings.app_version)
|
|
instrument_fastapi(app)
|
|
except Exception: # pragma: no cover
|
|
pass
|
|
|
|
@app.exception_handler(AICompanyError)
|
|
async def ai_company_error_handler(_: Request, exc: AICompanyError) -> JSONResponse:
|
|
return JSONResponse(
|
|
status_code=400,
|
|
content={"error": exc.__class__.__name__, "detail": str(exc)},
|
|
)
|
|
|
|
app.include_router(health.router)
|
|
app.include_router(leads.router)
|
|
app.include_router(sales.router)
|
|
app.include_router(sectors.router)
|
|
app.include_router(agents.router)
|
|
app.include_router(webhooks.router)
|
|
app.include_router(pricing.router)
|
|
app.include_router(prospect.router)
|
|
app.include_router(autonomous.router)
|
|
app.include_router(data.router)
|
|
app.include_router(outreach.router)
|
|
app.include_router(revenue.router)
|
|
app.include_router(automation.router)
|
|
app.include_router(email_send.router)
|
|
app.include_router(drafts.router)
|
|
app.include_router(dominance.router)
|
|
app.include_router(full_os.router)
|
|
app.include_router(customer_success.router)
|
|
app.include_router(ecosystem.router)
|
|
app.include_router(command_center.router)
|
|
app.include_router(revenue_os.router)
|
|
app.include_router(v3.router)
|
|
app.include_router(innovation.router)
|
|
app.include_router(business.router)
|
|
app.include_router(personal_operator.router)
|
|
app.include_router(growth_operator.router)
|
|
app.include_router(public.router)
|
|
app.include_router(admin.router)
|
|
|
|
@app.get("/", tags=["root"])
|
|
async def root() -> dict[str, object]:
|
|
return {
|
|
"name": settings.app_name,
|
|
"version": settings.app_version,
|
|
"status": "operational",
|
|
"env": settings.app_env,
|
|
"docs": "/docs",
|
|
"health": "/health",
|
|
"v3_command_center": "/api/v1/v3/command-center/snapshot",
|
|
"personal_operator_daily_brief": "/api/v1/personal-operator/daily-brief",
|
|
"personal_operator_launch_report": "/api/v1/personal-operator/launch-report",
|
|
"business_pricing": "/api/v1/business/pricing",
|
|
"innovation_command_feed_demo": "/api/v1/innovation/command-feed/demo",
|
|
}
|
|
|
|
return app
|
|
|
|
|
|
app = create_app()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
import uvicorn
|
|
|
|
settings = get_settings()
|
|
uvicorn.run(
|
|
"api.main:app",
|
|
host=settings.app_host,
|
|
port=settings.app_port,
|
|
reload=settings.is_development,
|
|
)
|