system-prompts-and-models-o.../salesflow-saas/backend/app/api/v1/companies.py
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

158 lines
5.1 KiB
Python

from fastapi import APIRouter, Depends, HTTPException, Query
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy import select, func
from uuid import UUID
from datetime import datetime
from typing import Optional
from pydantic import BaseModel as Schema
from app.database import get_db
from app.api.deps import get_current_user
from app.models.user import User
from app.models.company import Company
router = APIRouter()
class CompanyCreate(Schema):
name: str
name_ar: Optional[str] = None
website: Optional[str] = None
phone: Optional[str] = None
email: Optional[str] = None
industry: Optional[str] = None
size: Optional[str] = None
city: Optional[str] = None
address: Optional[str] = None
source: Optional[str] = None
affiliate_id: Optional[UUID] = None
notes: Optional[str] = None
metadata: Optional[dict] = None
class CompanyUpdate(Schema):
name: Optional[str] = None
name_ar: Optional[str] = None
website: Optional[str] = None
phone: Optional[str] = None
email: Optional[str] = None
industry: Optional[str] = None
size: Optional[str] = None
city: Optional[str] = None
address: Optional[str] = None
source: Optional[str] = None
notes: Optional[str] = None
is_active: Optional[bool] = None
class CompanyResponse(Schema):
id: UUID
tenant_id: UUID
name: str
name_ar: Optional[str] = None
website: Optional[str] = None
phone: Optional[str] = None
email: Optional[str] = None
industry: Optional[str] = None
size: Optional[str] = None
city: Optional[str] = None
address: Optional[str] = None
source: Optional[str] = None
is_active: bool
created_at: datetime
model_config = {"from_attributes": True}
class CompanyListResponse(Schema):
items: list[CompanyResponse]
total: int
page: int
per_page: int
@router.get("", response_model=CompanyListResponse)
async def list_companies(
search: str = Query(None),
industry: str = Query(None),
city: str = Query(None),
is_active: bool = Query(None),
page: int = Query(1, ge=1),
per_page: int = Query(20, ge=1, le=100),
current_user: User = Depends(get_current_user),
db: AsyncSession = Depends(get_db),
):
query = select(Company).where(Company.tenant_id == current_user.tenant_id)
if search:
query = query.where(Company.name.ilike(f"%{search}%") | Company.email.ilike(f"%{search}%"))
if industry:
query = query.where(Company.industry == industry)
if city:
query = query.where(Company.city == city)
if is_active is not None:
query = query.where(Company.is_active == is_active)
total = (await db.execute(select(func.count()).select_from(query.subquery()))).scalar()
query = query.order_by(Company.created_at.desc()).offset((page - 1) * per_page).limit(per_page)
result = await db.execute(query)
items = [CompanyResponse.model_validate(c) for c in result.scalars().all()]
return CompanyListResponse(items=items, total=total, page=page, per_page=per_page)
@router.get("/{company_id}", response_model=CompanyResponse)
async def get_company(
company_id: UUID,
current_user: User = Depends(get_current_user),
db: AsyncSession = Depends(get_db),
):
result = await db.execute(select(Company).where(Company.id == company_id, Company.tenant_id == current_user.tenant_id))
company = result.scalar_one_or_none()
if not company:
raise HTTPException(status_code=404, detail="Company not found")
return CompanyResponse.model_validate(company)
@router.post("", response_model=CompanyResponse, status_code=201)
async def create_company(
data: CompanyCreate,
current_user: User = Depends(get_current_user),
db: AsyncSession = Depends(get_db),
):
company = Company(tenant_id=current_user.tenant_id, **data.model_dump(exclude_none=True))
db.add(company)
await db.flush()
await db.refresh(company)
return CompanyResponse.model_validate(company)
@router.put("/{company_id}", response_model=CompanyResponse)
async def update_company(
company_id: UUID,
data: CompanyUpdate,
current_user: User = Depends(get_current_user),
db: AsyncSession = Depends(get_db),
):
result = await db.execute(select(Company).where(Company.id == company_id, Company.tenant_id == current_user.tenant_id))
company = result.scalar_one_or_none()
if not company:
raise HTTPException(status_code=404, detail="Company not found")
for field, value in data.model_dump(exclude_none=True).items():
setattr(company, field, value)
await db.flush()
await db.refresh(company)
return CompanyResponse.model_validate(company)
@router.delete("/{company_id}", status_code=204)
async def delete_company(
company_id: UUID,
current_user: User = Depends(get_current_user),
db: AsyncSession = Depends(get_db),
):
result = await db.execute(select(Company).where(Company.id == company_id, Company.tenant_id == current_user.tenant_id))
company = result.scalar_one_or_none()
if not company:
raise HTTPException(status_code=404, detail="Company not found")
company.is_active = False
await db.flush()