DOC: API_GATEWAYS_SUMMARY.md

API GATEWAYS SUMMARY

Core backend API for IPELLIO. Handles trademark data storage and search, user authentication, subscription management, billing, and orchestrates calls to external services.

Python 3.13
Runtime Environment
FastAPI
Async HTTP Framework
PostgreSQL 16
Primary Database
SQLAlchemy 2.x
Async ORM
Alembic
Schema Migrations
Authlib & JWT
Google OAuth & Sessions
OpenAI SDK
GPT-4o Integration
Stripe SDK
Payment Processing

Component Architecture (DDD)

app/
core/ (Config, security, middleware)
api/v1/endpoints/ (FastAPI routers — 14 endpoints)
domain/ (11 domains: models, repos, services, schemas)
ai_engines/ (scoring, social_handles, prompt)
infrastructure/ (DB, Redis, S3, PDF, Celery)
shared/ (LLM client, utilities, logging)
cronjobs/ (IP Australia sync, metrics refresh)