# siamsell/icar-microservice architecture

> Architecture diagram of the GitHub repository siamsell/icar-microservice, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siamsell/icar-microservice
- Repository: https://github.com/siamsell/icar-microservice

## Overview

iCar Algeria is a Django microservices marketplace with Auth, Catalog, and Notification services. Clients use Auth for account and JWT operations, then access catalog listings with stateless token validation; catalog changes and user events are exchanged asynchronously through RabbitMQ. Notification APIs manage follows and notification state, while a worker consumes events and persists notification/fan-out data. The README documents Traefik/Consul routing and isolated databases, but their implementation files are outside this tree; edges involving them are documented rather than source-verified.

Main entry points: [`microservices/services/car/catalog_service/catalog/views.py`](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/views.py) (Catalog API), [`microservices/services/auth/icar_auth/users/views.py`](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/views.py) (Auth API), [`microservices/services/notification/notification_service/notifications/views.py`](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/views.py) (Notification API), [`microservices/services/car/catalog_service/catalog/rabbitmq_consumer.py`](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/rabbitmq_consumer.py) (User Event Consumer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Auth Service"]
  node_authapi["Auth API<br/>[views.py]"]
  node_authdata[("User Records<br/>[models.py]")]
  node_authserial["User Serializers<br/>[serializers.py]"]
  node_authevents["User Event Publisher<br/>[rabbitmq.py]"]
end

subgraph group_catalog["Catalog Service"]
  node_catalogapi["Catalog API<br/>[views.py]"]
  node_catalogauth["Stateless JWT Auth<br/>[authentication.py]"]
  node_catalogdata[("Listings and Categories<br/>[models.py]")]
  node_catalogserial["Catalog Serializers<br/>[serializer.py]"]
  node_catalogpub["Content Event Publisher<br/>[rabbitmq.py]"]
  node_catalogworker["User Event Consumer"]
  node_catalogcommand["Consumer Command"]
  node_catalogdb[("Catalog Database<br/>[models.py]")]
end

subgraph group_notify["Notification Service"]
  node_notifyapi["Notification API<br/>[views.py]"]
  node_notifyauth["Stateless JWT Auth<br/>[authentication.py]"]
  node_notifyserial["Notification Serializers<br/>[serializers.py]"]
  node_notifydata[("Follow and Notice Data<br/>[models.py]")]
  node_notifyworker["Event Worker<br/>[rabbit.py]"]
  node_notifycommand["Worker Command<br/>[start_worker.py]"]
  node_notifydb[("Notification Database<br/>[models.py]")]
end

subgraph group_infra["Platform Infrastructure"]
  node_gateway["Traefik Gateway"]
  node_discovery["Consul Discovery"]
  node_broker["RabbitMQ"]
end

node_client(("API Client"))

node_client -.->|"sends requests"| node_gateway
node_gateway -.->|"routes healthy instances"| node_discovery
node_gateway -.->|"routes requests"| node_authapi
node_gateway -.->|"routes requests"| node_catalogapi
node_gateway -.->|"routes requests"| node_notifyapi
node_authapi -->|"validates data"| node_authserial
node_authapi -->|"reads and writes"| node_authdata
node_authapi -->|"publishes user events"| node_authevents
node_authevents -.->|"publishes events"| node_broker
node_broker -.->|"delivers user events"| node_catalogworker
node_catalogcommand -->|"starts consumer"| node_catalogworker
node_catalogworker -->|"syncs user records"| node_catalogdata
node_catalogapi -->|"authenticates requests"| node_catalogauth
node_catalogapi -->|"serializes responses"| node_catalogserial
node_catalogapi -->|"queries listings"| node_catalogdata
node_catalogapi -->|"publishes content events"| node_catalogpub
node_catalogpub -.->|"publishes events"| node_broker
node_broker -.->|"delivers events"| node_notifyworker
node_notifycommand -->|"starts consumer"| node_notifyworker
node_notifyworker -->|"creates notices"| node_notifydata
node_notifyapi -->|"authenticates requests"| node_notifyauth
node_notifyapi -->|"serializes responses"| node_notifyserial
node_notifyapi -->|"manages follows and notices"| node_notifydata

click node_authapi "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/views.py"
click node_authdata "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/models.py"
click node_authserial "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/serializers.py"
click node_authevents "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/rabbitmq.py"
click node_catalogapi "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/views.py"
click node_catalogauth "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog_service/authentication.py"
click node_catalogdata "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/models.py"
click node_catalogserial "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/serializer.py"
click node_catalogpub "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/rabbitmq.py"
click node_catalogworker "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/rabbitmq_consumer.py"
click node_catalogcommand "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/management/commands/consume_user_events.py"
click node_catalogdb "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/models.py"
click node_notifyapi "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/views.py"
click node_notifyauth "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notification_service/authentication.py"
click node_notifyserial "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/serializers.py"
click node_notifydata "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/models.py"
click node_notifyworker "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/rabbit.py"
click node_notifycommand "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/management/commands/start_worker.py"
click node_notifydb "https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_authapi,node_authdata,node_authserial,node_authevents,node_client toneBlue
class node_catalogapi,node_catalogauth,node_catalogdata,node_catalogserial,node_catalogpub,node_catalogworker,node_catalogcommand,node_catalogdb toneAmber
class node_notifyapi,node_notifyauth,node_notifyserial,node_notifydata,node_notifyworker,node_notifycommand,node_notifydb toneMint
class node_gateway,node_discovery,node_broker toneRose
```

## Components

### Auth Service

- [Auth API](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/views.py): `microservices/services/auth/icar_auth/users/views.py`
- [User Records](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/models.py): `microservices/services/auth/icar_auth/users/models.py`
- [User Serializers](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/serializers.py): `microservices/services/auth/icar_auth/users/serializers.py`
- [User Event Publisher](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/auth/icar_auth/users/rabbitmq.py): `microservices/services/auth/icar_auth/users/rabbitmq.py`

### Catalog Service

- [Catalog API](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/views.py): `microservices/services/car/catalog_service/catalog/views.py`
- [Stateless JWT Auth](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog_service/authentication.py): `microservices/services/car/catalog_service/catalog_service/authentication.py`
- [Listings and Categories](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/models.py): `microservices/services/car/catalog_service/catalog/models.py`
- [Catalog Serializers](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/serializer.py): `microservices/services/car/catalog_service/catalog/serializer.py`
- [Content Event Publisher](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/rabbitmq.py): `microservices/services/car/catalog_service/catalog/rabbitmq.py`
- [User Event Consumer](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/rabbitmq_consumer.py): `microservices/services/car/catalog_service/catalog/rabbitmq_consumer.py`
- [Consumer Command](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/management/commands/consume_user_events.py): `microservices/services/car/catalog_service/catalog/management/commands/consume_user_events.py`
- [Catalog Database](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/car/catalog_service/catalog/models.py): `microservices/services/car/catalog_service/catalog/models.py`

### Notification Service

- [Notification API](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/views.py): `microservices/services/notification/notification_service/notifications/views.py`
- [Stateless JWT Auth](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notification_service/authentication.py): `microservices/services/notification/notification_service/notification_service/authentication.py`
- [Notification Serializers](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/serializers.py): `microservices/services/notification/notification_service/notifications/serializers.py`
- [Follow and Notice Data](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/models.py): `microservices/services/notification/notification_service/notifications/models.py`
- [Event Worker](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/rabbit.py): `microservices/services/notification/notification_service/notifications/rabbit.py`
- [Worker Command](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/management/commands/start_worker.py): `microservices/services/notification/notification_service/notifications/management/commands/start_worker.py`
- [Notification Database](https://github.com/siamsell/icar-microservice/blob/main/microservices/services/notification/notification_service/notifications/models.py): `microservices/services/notification/notification_service/notifications/models.py`

### Platform Infrastructure

- **Traefik Gateway**
- **Consul Discovery**
- **RabbitMQ**

### Other components

- **API Client**

## Connections

- API Client → Traefik Gateway: sends requests
- Traefik Gateway → Consul Discovery: routes healthy instances
- Traefik Gateway → Auth API: routes requests
- Traefik Gateway → Catalog API: routes requests
- Traefik Gateway → Notification API: routes requests
- Auth API → User Serializers: validates data (evidence: `microservices/services/auth/icar_auth/users/views.py`)
- Auth API → User Records: reads and writes (evidence: `microservices/services/auth/icar_auth/users/views.py`)
- Auth API → User Event Publisher: publishes user events (evidence: `microservices/services/auth/icar_auth/users/views.py`)
- User Event Publisher → RabbitMQ: publishes events
- RabbitMQ → User Event Consumer: delivers user events
- Consumer Command → User Event Consumer: starts consumer (evidence: `microservices/services/car/catalog_service/catalog/management/commands/consume_user_events.py`)
- User Event Consumer → Listings and Categories: syncs user records (evidence: `microservices/services/car/catalog_service/catalog/rabbitmq_consumer.py`)
- Catalog API → Stateless JWT Auth: authenticates requests (evidence: `microservices/services/car/catalog_service/catalog/views.py`)
- Catalog API → Catalog Serializers: serializes responses (evidence: `microservices/services/car/catalog_service/catalog/views.py`)
- Catalog API → Listings and Categories: queries listings (evidence: `microservices/services/car/catalog_service/catalog/views.py`)
- Catalog API → Content Event Publisher: publishes content events (evidence: `microservices/services/car/catalog_service/catalog/views.py`)
- Content Event Publisher → RabbitMQ: publishes events
- RabbitMQ → Event Worker: delivers events
- Worker Command → Event Worker: starts consumer (evidence: `microservices/services/notification/notification_service/notifications/management/commands/start_worker.py`)
- Event Worker → Follow and Notice Data: creates notices (evidence: `microservices/services/notification/notification_service/notifications/rabbit.py`)
- Notification API → Stateless JWT Auth: authenticates requests (evidence: `microservices/services/notification/notification_service/notifications/views.py`)
- Notification API → Notification Serializers: serializes responses (evidence: `microservices/services/notification/notification_service/notifications/views.py`)
- Notification API → Follow and Notice Data: manages follows and notices (evidence: `microservices/services/notification/notification_service/notifications/views.py`)
