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>
98 lines
3.7 KiB
Python
98 lines
3.7 KiB
Python
"""
|
|
Payment-in-Chat — Moyasar payment-link drafts (NO live charge).
|
|
|
|
In production: link goes to a Moyasar hosted checkout. The user enters
|
|
their card on Moyasar's domain (PCI-safe), not inside WhatsApp.
|
|
|
|
This module produces a STRUCTURED draft only — the actual
|
|
`POST /v1/payments` call to Moyasar happens elsewhere with the
|
|
customer's secret key.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
from typing import Any
|
|
|
|
|
|
# ── Pricing (mirrors landing/pricing.html + business/pricing_strategy.py) ──
|
|
PLAN_CATALOG_SAR: dict[str, dict[str, Any]] = {
|
|
"founder_operator": {"label_ar": "مشغّل المؤسس", "amount_sar": 499.0},
|
|
"growth_os": {"label_ar": "نظام النمو (Growth OS)", "amount_sar": 2999.0},
|
|
"scale_os": {"label_ar": "نظام التوسّع (Scale OS)", "amount_sar": 7999.0},
|
|
"performance_pilot": {"label_ar": "Pay-per-Result pilot 30 يوم", "amount_sar": 1.0}, # placeholder
|
|
}
|
|
|
|
|
|
def sar_to_halalas(amount_sar: float) -> int:
|
|
"""Convert SAR to halalas (Moyasar's smallest unit). 1 SAR = 100 halalas."""
|
|
if amount_sar < 0:
|
|
raise ValueError("amount_sar must be non-negative")
|
|
return int(round(amount_sar * 100))
|
|
|
|
|
|
def build_moyasar_payment_link_draft(
|
|
*,
|
|
plan_key: str,
|
|
customer_id: str,
|
|
contact_email: str | None = None,
|
|
locale: str = "ar",
|
|
callback_url: str = "https://dealix.sa/payment-success.html",
|
|
cancel_url: str = "https://dealix.sa/payment-cancelled.html",
|
|
custom_amount_sar: float | None = None,
|
|
) -> dict[str, Any]:
|
|
"""
|
|
Build a Moyasar payment payload (NOT yet sent to Moyasar API).
|
|
|
|
Returns a dict the operator can review + approve. The actual
|
|
`POST /v1/payments` is fired elsewhere by the billing service.
|
|
"""
|
|
plan = PLAN_CATALOG_SAR.get(plan_key)
|
|
if plan is None and custom_amount_sar is None:
|
|
return {
|
|
"error": f"unknown_plan: {plan_key}",
|
|
"approval_required": True,
|
|
"approval_status": "pending_approval",
|
|
"live_charged": False,
|
|
}
|
|
amount_sar = custom_amount_sar if custom_amount_sar is not None else plan["amount_sar"]
|
|
label_ar = (plan["label_ar"] if plan else "خطة مخصصة")
|
|
|
|
description_ar = (
|
|
f"اشتراك Dealix — {label_ar}. "
|
|
f"المبلغ {amount_sar:,.2f} ريال شامل ضريبة القيمة المضافة 15%."
|
|
)
|
|
|
|
return {
|
|
"moyasar_request_draft": {
|
|
"amount": sar_to_halalas(amount_sar),
|
|
"currency": "SAR",
|
|
"description": description_ar,
|
|
"callback_url": callback_url,
|
|
"cancel_url": cancel_url,
|
|
"metadata": {
|
|
"customer_id": customer_id,
|
|
"plan_key": plan_key,
|
|
"locale": locale,
|
|
"draft_id": f"draft_pay_{uuid.uuid4().hex[:16]}",
|
|
},
|
|
},
|
|
"amount_sar": amount_sar,
|
|
"amount_halalas": sar_to_halalas(amount_sar),
|
|
"label_ar": label_ar,
|
|
"channel_recommendation": "whatsapp_with_link",
|
|
"in_chat_message_ar": (
|
|
f"الباقة المقترحة:\n{label_ar} — {amount_sar:,.0f} ريال\n\n"
|
|
"[ادفع الآن] [أرسل فاتورة] [كلم المبيعات]\n\n"
|
|
"ملاحظة: الدفع آمن عبر Moyasar (سعودي مرخّص). فاتورة ZATCA "
|
|
"تصلكم تلقائياً بعد التأكيد."
|
|
),
|
|
"approval_required": True,
|
|
"approval_status": "pending_approval",
|
|
"live_charged": False,
|
|
"compliance_note_ar": (
|
|
"draft فقط — لا يتم خصم أي مبلغ حتى يضغط العميل 'ادفع' "
|
|
"على Moyasar وتصلنا webhook 'paid'."
|
|
),
|
|
}
|