# harshalw19/bidauc-backend-mircoservices architecture

> Architecture diagram of the GitHub repository harshalw19/bidauc-backend-mircoservices, 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/harshalw19/bidauc-backend-mircoservices
- Repository: https://github.com/harshalw19/bidauc-backend-mircoservices

## Overview

Blue Collar Marketplace is a six-service marketplace: users verify by OTP and register, then use profiles, jobs, bids, and payments; notifications deliver event-driven SMS. The README documents Nginx, RabbitMQ, MongoDB-per-service, Redis, and Razorpay, but the tree contains no gateway or Redis implementation. Sampled source confirms OTP/user registration, job-to-user HTTP clients, bid-to-job/user clients, and notification consumption; several payment and inter-service details are documented but not verified in source excerpts.

Main entry points: [`services/bid-service/src/routes/bids.js`](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/routes/bids.js) (Bidding), [`services/payment-service/src/routes/payments.js`](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/payment-service/src/routes/payments.js) (Payment processing), [`services/job-service/src/routes/jobs.js`](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/routes/jobs.js) (Job listings), [`services/auth-service/src/routes/auth.js`](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/routes/auth.js) (OTP and sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Profiles"]
  node_auth["OTP and sessions<br/>[auth.js]"]
  node_authuser[("Auth user records<br/>[User.js]")]
  node_otp[("OTP records<br/>[Otp.js]")]
  node_profiles["User profiles<br/>[users.js]"]
  node_profiledb[("Profile records<br/>[User.js]")]
  node_userhandler["Profile event sync<br/>[userHandler.js]"]
end

subgraph group_marketplace["Marketplace"]
  node_jobs["Job listings<br/>[jobs.js]"]
  node_categories["Job categories<br/>[categories.js]"]
  node_jobdb[("Job records<br/>[Job.js]")]
  node_jobuserclient["Job user client"]
  node_bids["Bidding<br/>[bids.js]"]
  node_biddb[("Bid records<br/>[Bid.js]")]
  node_bidjobclient["Bid job client"]
  node_biduserclient["Bid user client"]
end

subgraph group_transactions["Payments"]
  node_payments["Payment processing<br/>[payments.js]"]
  node_paymentdb[("Payment records<br/>[Payment.js]")]
  node_paymentclients["Payment service clients"]
end

subgraph group_messaging["Notifications"]
  node_consumer["Event consumer<br/>[consumer.js]"]
  node_sms["SMS handlers<br/>[smsHandler.js]"]
end

subgraph group_platform["Shared Platform"]
  node_gateway["Nginx gateway"]
  node_queue["RabbitMQ events"]
  node_mongodb[("MongoDB")]
  node_redis[("Redis cache")]
end

node_customer(("Marketplace users"))
node_twilio["Twilio SMS"]
node_razorpay["Razorpay"]

node_customer -->|"requests"| node_gateway
node_gateway -.->|"routes to"| node_auth
node_gateway -.->|"routes to"| node_profiles
node_gateway -.->|"routes to"| node_jobs
node_gateway -.->|"routes to"| node_bids
node_gateway -.->|"routes to"| node_payments
node_auth -->|"reads and writes"| node_authuser
node_auth -->|"stores and verifies"| node_otp
node_auth -->|"publishes registration"| node_queue
node_profiles -->|"reads and writes"| node_profiledb
node_consumer -->|"consumes events"| node_queue
node_consumer -->|"dispatches user events"| node_userhandler
node_userhandler -->|"upserts profiles"| node_profiledb
node_jobs -->|"manages listings"| node_jobdb
node_jobs -->|"fetches users"| node_jobuserclient
node_jobuserclient -->|"requests user data"| node_profiles
node_categories -.->|"uses categories"| node_jobdb
node_bids -->|"manages bids"| node_biddb
node_bids -->|"fetches and updates jobs"| node_bidjobclient
node_bids -->|"fetches users"| node_biduserclient
node_bidjobclient -->|"requests job data"| node_jobs
node_biduserclient -->|"requests user data"| node_profiles
node_bids -.->|"publishes events"| node_queue
node_payments -.->|"records payments"| node_paymentdb
node_payments -.->|"calls service clients"| node_paymentclients
node_paymentclients -.->|"requests bid data"| node_bids
node_paymentclients -.->|"requests job data"| node_jobs
node_payments -.->|"processes payment"| node_razorpay
node_payments -.->|"publishes events"| node_queue
node_consumer -->|"dispatches notifications"| node_sms
node_sms -->|"sends SMS"| node_twilio
node_auth -.->|"persists identity data"| node_mongodb
node_profiles -.->|"persists profiles"| node_mongodb
node_jobs -.->|"persists listings"| node_mongodb
node_bids -.->|"persists bids"| node_mongodb
node_payments -.->|"persists payments"| node_mongodb
node_gateway -.->|"uses cache"| node_redis

click node_auth "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/routes/auth.js"
click node_authuser "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/models/User.js"
click node_otp "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/models/Otp.js"
click node_profiles "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/user-service/src/routes/users.js"
click node_profiledb "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/user-service/src/models/User.js"
click node_userhandler "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/user-service/src/handlers/userHandler.js"
click node_jobs "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/routes/jobs.js"
click node_categories "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/routes/categories.js"
click node_jobdb "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/models/Job.js"
click node_jobuserclient "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/clients/userServiceClient.js"
click node_bids "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/routes/bids.js"
click node_biddb "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/models/Bid.js"
click node_bidjobclient "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/clients/jobServiceClient.js"
click node_biduserclient "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/clients/userServiceClient.js"
click node_payments "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/payment-service/src/routes/payments.js"
click node_paymentdb "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/payment-service/src/models/Payment.js"
click node_paymentclients "https://github.com/harshalw19/bidauc-backend-mircoservices/tree/dev/services/payment-service/src/clients"
click node_consumer "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/notification-service/src/consumer.js"
click node_sms "https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/notification-service/src/handlers/smsHandler.js"

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_auth,node_authuser,node_otp,node_profiles,node_profiledb,node_userhandler,node_customer toneBlue
class node_jobs,node_categories,node_jobdb,node_jobuserclient,node_bids,node_biddb,node_bidjobclient,node_biduserclient toneAmber
class node_payments,node_paymentdb,node_paymentclients toneMint
class node_consumer,node_sms toneRose
class node_gateway,node_queue,node_mongodb,node_redis,node_twilio,node_razorpay toneIndigo
```

## Components

### Identity & Profiles

- [OTP and sessions](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/routes/auth.js): `services/auth-service/src/routes/auth.js`
- [Auth user records](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/models/User.js): `services/auth-service/src/models/User.js`
- [OTP records](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/auth-service/src/models/Otp.js): `services/auth-service/src/models/Otp.js`
- [User profiles](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/user-service/src/routes/users.js): `services/user-service/src/routes/users.js`
- [Profile records](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/user-service/src/models/User.js): `services/user-service/src/models/User.js`
- [Profile event sync](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/user-service/src/handlers/userHandler.js): `services/user-service/src/handlers/userHandler.js`

### Marketplace

- [Job listings](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/routes/jobs.js): `services/job-service/src/routes/jobs.js`
- [Job categories](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/routes/categories.js): `services/job-service/src/routes/categories.js`
- [Job records](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/models/Job.js): `services/job-service/src/models/Job.js`
- [Job user client](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/job-service/src/clients/userServiceClient.js): `services/job-service/src/clients/userServiceClient.js`
- [Bidding](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/routes/bids.js): `services/bid-service/src/routes/bids.js`
- [Bid records](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/models/Bid.js): `services/bid-service/src/models/Bid.js`
- [Bid job client](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/clients/jobServiceClient.js): `services/bid-service/src/clients/jobServiceClient.js`
- [Bid user client](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/bid-service/src/clients/userServiceClient.js): `services/bid-service/src/clients/userServiceClient.js`

### Payments

- [Payment processing](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/payment-service/src/routes/payments.js): `services/payment-service/src/routes/payments.js`
- [Payment records](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/payment-service/src/models/Payment.js): `services/payment-service/src/models/Payment.js`
- [Payment service clients](https://github.com/harshalw19/bidauc-backend-mircoservices/tree/dev/services/payment-service/src/clients): `services/payment-service/src/clients`

### Notifications

- [Event consumer](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/notification-service/src/consumer.js): `services/notification-service/src/consumer.js`
- [SMS handlers](https://github.com/harshalw19/bidauc-backend-mircoservices/blob/dev/services/notification-service/src/handlers/smsHandler.js): `services/notification-service/src/handlers/smsHandler.js`

### Shared Platform

- **Nginx gateway**
- **RabbitMQ events**
- **MongoDB**
- **Redis cache**

### Other components

- **Marketplace users**
- **Twilio SMS**
- **Razorpay**

## Connections

- Marketplace users → Nginx gateway: requests
- Nginx gateway → OTP and sessions: routes to
- Nginx gateway → User profiles: routes to
- Nginx gateway → Job listings: routes to
- Nginx gateway → Bidding: routes to
- Nginx gateway → Payment processing: routes to
- OTP and sessions → Auth user records: reads and writes (evidence: `services/auth-service/src/routes/auth.js`)
- OTP and sessions → OTP records: stores and verifies (evidence: `services/auth-service/src/routes/auth.js`)
- OTP and sessions → RabbitMQ events: publishes registration (evidence: `services/auth-service/src/routes/auth.js`)
- User profiles → Profile records: reads and writes (evidence: `services/user-service/src/routes/users.js`)
- Event consumer → RabbitMQ events: consumes events (evidence: `services/notification-service/src/consumer.js`)
- Event consumer → Profile event sync: dispatches user events (evidence: `services/notification-service/src/consumer.js`)
- Profile event sync → Profile records: upserts profiles (evidence: `services/user-service/src/handlers/userHandler.js`)
- Job listings → Job records: manages listings (evidence: `services/job-service/src/routes/jobs.js`)
- Job listings → Job user client: fetches users (evidence: `services/job-service/src/routes/jobs.js`)
- Job user client → User profiles: requests user data (evidence: `services/job-service/src/clients/userServiceClient.js`)
- Job categories → Job records: uses categories
- Bidding → Bid records: manages bids (evidence: `services/bid-service/src/routes/bids.js`)
- Bidding → Bid job client: fetches and updates jobs (evidence: `services/bid-service/src/routes/bids.js`)
- Bidding → Bid user client: fetches users (evidence: `services/bid-service/src/routes/bids.js`)
- Bid job client → Job listings: requests job data (evidence: `services/bid-service/src/clients/jobServiceClient.js`)
- Bid user client → User profiles: requests user data (evidence: `services/bid-service/src/clients/userServiceClient.js`)
- Bidding → RabbitMQ events: publishes events
- Payment processing → Payment records: records payments
- Payment processing → Payment service clients: calls service clients
- Payment service clients → Bidding: requests bid data
- Payment service clients → Job listings: requests job data
- Payment processing → Razorpay: processes payment
- Payment processing → RabbitMQ events: publishes events
- Event consumer → SMS handlers: dispatches notifications (evidence: `services/notification-service/src/consumer.js`)
- SMS handlers → Twilio SMS: sends SMS (evidence: `services/notification-service/src/handlers/smsHandler.js`)
- OTP and sessions → MongoDB: persists identity data
- User profiles → MongoDB: persists profiles
- Job listings → MongoDB: persists listings
- Bidding → MongoDB: persists bids
- Payment processing → MongoDB: persists payments
- Nginx gateway → Redis cache: uses cache
