Overall Architecture
Shiprocket Ads Core is a Spring Boot 3 microservice exposing web APIs for Shiprocket Ads. It validates seller/platform context, manages ad insights and operations through Meta Graph API and Google Ads API, supports CSV-driven workflows, and performs asynchronous processing via Kafka. It persists operational data in MySQL and MongoDB, uses Redis for caching/shared state, and integrates with AWS S3 (file storage) and AWS SES/SMTP (email). It also calls internal Shiprocket services (Aggregator, Communication, Edge/Checkout public-api S2S, Ads Python service) and optionally uses external AI/LLM providers (OpenAI, Google Vertex AI/Gemini, OpenRouter). Configuration is sourced from Spring Cloud Config Server. Observability is provided via Actuator and OpenTelemetry exporting to an OTLP collector (e.g., SigNoz). A secondary repo entry (shiprocket-ads-core@tmp) lacks code; its details are treated as non-authoritative and are not modeled beyond the primary service.
