DOC: ARCHITECTURE.md

ARCHITECTURE

IPELLIO is built as a unified backend service with integrated deterministic scoring engines, delivering trademark insights for the Australian IP market.

System Topology Model

USER BROWSER
Ipellio.com (Next.js SSR)
Trademark Search · Reports · Charts · Dashboard
HTTP/REST (Axios)
BACKEND API
API Gateways
FastAPI @ :8000
Routers Layer
Services Layer
Repositories Layer
Scoring Engines
Deterministic Engines (availability, conflict, distinctiveness, valuation)
Social Handles Detection
Rule-Based Industry Classification
PERSISTENCE
PostgreSQL 16
Dockerized · 18 Tables
EXTERNAL APIs
Third-Party Services
  • OpenAI / Azure OpenAI
  • IP Australia API
  • Google Cloud APIs
  • Resend (Email)
  • SerpAPI & DuckDuckGo

Architectural Patterns

Ipellio.com: Next.js SSR · App Router · Server Components
API Gateways: Clean/Layered (Router → Service → Repo)
Scoring: Integrated deterministic scoring modules inside api-gateways