mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-17 14:59:35 +00:00
e1c629bacf
Add cards schema (max 3 buttons, forbidden automation patterns), deterministic card_factory per CEO/Sales/Growth/Agency/Support/Delivery, FastAPI routes GET /api/v1/cards/feed, GET whatsapp daily-brief (no auto-send), POST decision (draft_only). Wire router in main, extend smoke_inprocess, enrich command-center.html with role switcher + live feed. Tests: test_role_based_cards.py. Co-authored-by: Cursor <cursoragent@cursor.com>
110 lines
3.1 KiB
Python
110 lines
3.1 KiB
Python
"""Role-Based Revenue Command Cards — schema, validation, safety constants.
|
|
|
|
No live send, no scraping, no cold WhatsApp. Cards are decision units (max 3 buttons).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import Enum
|
|
from typing import Any, Literal, TypedDict
|
|
|
|
MAX_CARD_BUTTONS = 3
|
|
MAX_CARDS_VISIBLE = 7
|
|
|
|
RiskLevel = Literal["low", "medium", "high"]
|
|
ActionMode = Literal["approval_required", "draft_only", "suggest_only", "blocked"]
|
|
|
|
|
|
class UserRole(str, Enum):
|
|
"""Operational personas (one interface, role-scoped feeds)."""
|
|
|
|
CEO = "ceo"
|
|
SALES_MANAGER = "sales_manager"
|
|
GROWTH_MANAGER = "growth_manager"
|
|
AGENCY_PARTNER = "agency_partner"
|
|
SUPPORT = "support"
|
|
SERVICE_DELIVERY = "service_delivery"
|
|
|
|
|
|
class CardType(str, Enum):
|
|
OPPORTUNITY = "opportunity"
|
|
PARTNER = "partner"
|
|
DEAL_FOLLOWUP = "deal_followup"
|
|
NEGOTIATION = "negotiation"
|
|
CLOSE = "close"
|
|
PROOF = "proof"
|
|
SUPPORT = "support"
|
|
CEO_BRIEF = "ceo_brief"
|
|
GROWTH_PLAN = "growth_plan"
|
|
RISK = "risk"
|
|
DELIVERY = "delivery"
|
|
|
|
|
|
class ForbiddenPattern(str, Enum):
|
|
"""Substrings that must not appear in actions or button machine keys."""
|
|
|
|
LINKEDIN_SCRAPE = "linkedin_scrape"
|
|
COLD_WHATSAPP = "cold_whatsapp"
|
|
WHATSAPP_BLAST = "whatsapp_blast"
|
|
LIVE_GMAIL_SEND = "live_gmail_send"
|
|
MOYASAR_CHARGE = "moyasar_charge"
|
|
|
|
|
|
FORBIDDEN_SUBSTRINGS: tuple[str, ...] = tuple(p.value for p in ForbiddenPattern)
|
|
|
|
|
|
class CardButton(TypedDict, total=False):
|
|
label_ar: str
|
|
action: str
|
|
|
|
|
|
def _buttons_payload(buttons: list[CardButton]) -> list[CardButton]:
|
|
if len(buttons) > MAX_CARD_BUTTONS:
|
|
return buttons[:MAX_CARD_BUTTONS]
|
|
return buttons
|
|
|
|
|
|
def assert_safe_card_copy(card: dict[str, Any]) -> None:
|
|
"""Raise ValueError if copy suggests blocked automation (tests + CI guard)."""
|
|
blob = " ".join(
|
|
str(x).lower()
|
|
for x in (
|
|
card.get("recommended_action_ar"),
|
|
card.get("why_now_ar"),
|
|
card.get("title_ar"),
|
|
" ".join(b.get("action", "") + " " + b.get("label_ar", "") for b in card.get("buttons") or []),
|
|
)
|
|
if x
|
|
)
|
|
for bad in FORBIDDEN_SUBSTRINGS:
|
|
if bad in blob:
|
|
raise ValueError(f"unsafe card copy references forbidden pattern: {bad}")
|
|
|
|
|
|
def normalize_card(card: dict[str, Any]) -> dict[str, Any]:
|
|
"""Clamp buttons, ensure lists for proof_impact, run safety assert."""
|
|
out = dict(card)
|
|
buttons = list(out.get("buttons") or [])
|
|
out["buttons"] = _buttons_payload(buttons) # type: ignore[arg-type]
|
|
pi = out.get("proof_impact")
|
|
if pi is None:
|
|
out["proof_impact"] = []
|
|
elif isinstance(pi, str):
|
|
out["proof_impact"] = [pi]
|
|
elif isinstance(pi, list):
|
|
out["proof_impact"] = [str(x) for x in pi]
|
|
else:
|
|
out["proof_impact"] = []
|
|
assert_safe_card_copy(out)
|
|
return out
|
|
|
|
|
|
def normalize_role_param(role: str | None) -> str:
|
|
r = (role or "").strip().lower().replace("-", "_")
|
|
aliases = {"agency": "agency_partner", "delivery": "service_delivery", "cs": "support"}
|
|
return aliases.get(r, r)
|
|
|
|
|
|
def is_known_role(role: str) -> bool:
|
|
return role in {e.value for e in UserRole}
|