# gazala-rmida/micro-services-tp architecture

> Architecture diagram of the GitHub repository gazala-rmida/micro-services-tp, 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/gazala-rmida/micro-services-tp
- Repository: https://github.com/gazala-rmida/micro-services-tp

## Overview

This repository is a Spring-based microservices system for client and product data, invoice generation and lookup, and user authentication, with gateway, discovery, and configuration services. A principal workflow retrieves an invoice, loads its client and product details through Feign clients, and returns the enriched invoice; startup code also seeds invoices and lines from remote data. The graph includes authentication and platform services, but their runtime links are not evidenced by the available excerpts or README, which is empty.

Main entry points: [`micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java`](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java) (Invoice seeding), [`micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java`](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java) (Invoice API), [`authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java`](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java) (User service), [`micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ClientServiceClient.java`](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ClientServiceClient.java) (Client Feign client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_billing["Billing"]
  node_invoice_api["Invoice API"]
  node_invoice_seed["Invoice seeding"]
  node_invoice_store[("Invoice persistence")]
  node_invoice_records["Invoices and lines<br/>[Facture.java]"]
  node_client_client["Client Feign client"]
  node_product_client["Product Feign client"]
end

subgraph group_catalog["Client and Product"]
  node_client_service["Client API"]
  node_client_model["Client record<br/>[Client.java]"]
  node_client_store[("Client persistence")]
  node_product_service["Product API"]
  node_product_model["Product record<br/>[Produit.java]"]
  node_product_store[("Product persistence")]
end

subgraph group_identity["Authentication"]
  node_auth_api["User API"]
  node_auth_service["User service"]
  node_auth_users["Users and roles<br/>[AppUser.java]"]
  node_auth_user_store[("User repository")]
  node_auth_role_store[("Role repository")]
  node_jwt_auth["JWT authentication"]
  node_jwt_authorization["JWT authorization"]
  node_security_config["Security configuration"]
end

subgraph group_platform["Platform Services"]
  node_gateway["API gateway"]
  node_discovery["Service discovery"]
  node_config["Configuration service"]
end

node_caller(("API caller"))

node_caller -->|"requests invoice"| node_invoice_api
node_invoice_api -->|"loads invoice"| node_invoice_store
node_invoice_api -->|"loads client"| node_client_client
node_invoice_api -->|"loads products"| node_product_client
node_invoice_seed -->|"fetches client"| node_client_client
node_invoice_seed -->|"saves invoice"| node_invoice_store
node_invoice_seed -->|"fetches products"| node_product_client
node_invoice_seed -->|"saves lines"| node_invoice_store
node_client_client -.->|"calls remotely"| node_client_service
node_product_client -.->|"calls remotely"| node_product_service
node_client_service -->|"uses repository"| node_client_store
node_product_service -->|"uses repository"| node_product_store
node_auth_api -->|"delegates"| node_auth_service
node_auth_service -->|"uses repository"| node_auth_user_store
node_auth_service -->|"uses repository"| node_auth_role_store

click node_invoice_api "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java"
click node_invoice_seed "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java"
click node_invoice_store "https://github.com/gazala-rmida/micro-services-tp/tree/main/micro_services/factureservice/src/main/java/org/ms/factureservice/repository"
click node_invoice_records "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/entities/Facture.java"
click node_client_client "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ClientServiceClient.java"
click node_product_client "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ProduitServiceClient.java"
click node_client_service "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/clientservice/src/main/java/org/ms/clientservice/web/ClientRestController.java"
click node_client_model "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/clientservice/src/main/java/org/ms/clientservice/entities/Client.java"
click node_client_store "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/clientservice/src/main/java/org/ms/clientservice/repository/ClientRepository.java"
click node_product_service "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/produitservice/src/main/java/org/ms/produitservice/web/ProduitRestController.java"
click node_product_model "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/produitservice/src/main/java/org/ms/produitservice/entities/Produit.java"
click node_product_store "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/produitservice/src/main/java/org/ms/produitservice/repository/ProduitRepository.java"
click node_auth_api "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/web/UserServiceREST.java"
click node_auth_service "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java"
click node_auth_users "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/entities/AppUser.java"
click node_auth_user_store "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/repositories/AppUserRepository.java"
click node_auth_role_store "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/repositories/AppRoleRepository.java"
click node_jwt_auth "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/filtres/JwtAuthenticationFilter.java"
click node_jwt_authorization "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/filtres/JwtAuthorizationFilter.java"
click node_security_config "https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/securite/SecurityConfig.java"
click node_gateway "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/gateway_service/gateway_service/src/main/java/org/ms/gateway_service/GatewayServiceApplication.java"
click node_discovery "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/eureka-discoveryservice/src/main/java/org/ms/eurekadiscoveryservice/EurekaDiscoveryServiceApplication.java"
click node_config "https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/config-service/src/main/java/org/ms/config_service/ConfigServiceApplication.java"

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_invoice_api,node_invoice_seed,node_invoice_store,node_invoice_records,node_client_client,node_product_client toneBlue
class node_client_service,node_client_model,node_client_store,node_product_service,node_product_model,node_product_store toneAmber
class node_auth_api,node_auth_service,node_auth_users,node_auth_user_store,node_auth_role_store,node_jwt_auth,node_jwt_authorization,node_security_config,node_caller toneMint
class node_gateway,node_discovery,node_config toneRose
```

## Components

### Billing

- [Invoice API](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java): `micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java`
- [Invoice seeding](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java): `micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java`
- [Invoice persistence](https://github.com/gazala-rmida/micro-services-tp/tree/main/micro_services/factureservice/src/main/java/org/ms/factureservice/repository): `micro_services/factureservice/src/main/java/org/ms/factureservice/repository`
- [Invoices and lines](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/entities/Facture.java): `micro_services/factureservice/src/main/java/org/ms/factureservice/entities/Facture.java`
- [Client Feign client](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ClientServiceClient.java): `micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ClientServiceClient.java`
- [Product Feign client](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ProduitServiceClient.java): `micro_services/factureservice/src/main/java/org/ms/factureservice/feign/ProduitServiceClient.java`

### Client and Product

- [Client API](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/clientservice/src/main/java/org/ms/clientservice/web/ClientRestController.java): `micro_services/clientservice/src/main/java/org/ms/clientservice/web/ClientRestController.java`
- [Client record](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/clientservice/src/main/java/org/ms/clientservice/entities/Client.java): `micro_services/clientservice/src/main/java/org/ms/clientservice/entities/Client.java`
- [Client persistence](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/clientservice/src/main/java/org/ms/clientservice/repository/ClientRepository.java): `micro_services/clientservice/src/main/java/org/ms/clientservice/repository/ClientRepository.java`
- [Product API](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/produitservice/src/main/java/org/ms/produitservice/web/ProduitRestController.java): `micro_services/produitservice/src/main/java/org/ms/produitservice/web/ProduitRestController.java`
- [Product record](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/produitservice/src/main/java/org/ms/produitservice/entities/Produit.java): `micro_services/produitservice/src/main/java/org/ms/produitservice/entities/Produit.java`
- [Product persistence](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/produitservice/src/main/java/org/ms/produitservice/repository/ProduitRepository.java): `micro_services/produitservice/src/main/java/org/ms/produitservice/repository/ProduitRepository.java`

### Authentication

- [User API](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/web/UserServiceREST.java): `authentification-service/src/main/java/org/ms/authentificationservice/web/UserServiceREST.java`
- [User service](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java): `authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java`
- [Users and roles](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/entities/AppUser.java): `authentification-service/src/main/java/org/ms/authentificationservice/entities/AppUser.java`
- [User repository](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/repositories/AppUserRepository.java): `authentification-service/src/main/java/org/ms/authentificationservice/repositories/AppUserRepository.java`
- [Role repository](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/repositories/AppRoleRepository.java): `authentification-service/src/main/java/org/ms/authentificationservice/repositories/AppRoleRepository.java`
- [JWT authentication](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/filtres/JwtAuthenticationFilter.java): `authentification-service/src/main/java/org/ms/authentificationservice/filtres/JwtAuthenticationFilter.java`
- [JWT authorization](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/filtres/JwtAuthorizationFilter.java): `authentification-service/src/main/java/org/ms/authentificationservice/filtres/JwtAuthorizationFilter.java`
- [Security configuration](https://github.com/gazala-rmida/micro-services-tp/blob/main/authentification-service/src/main/java/org/ms/authentificationservice/securite/SecurityConfig.java): `authentification-service/src/main/java/org/ms/authentificationservice/securite/SecurityConfig.java`

### Platform Services

- [API gateway](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/gateway_service/gateway_service/src/main/java/org/ms/gateway_service/GatewayServiceApplication.java): `micro_services/gateway_service/gateway_service/src/main/java/org/ms/gateway_service/GatewayServiceApplication.java`
- [Service discovery](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/eureka-discoveryservice/src/main/java/org/ms/eurekadiscoveryservice/EurekaDiscoveryServiceApplication.java): `micro_services/eureka-discoveryservice/src/main/java/org/ms/eurekadiscoveryservice/EurekaDiscoveryServiceApplication.java`
- [Configuration service](https://github.com/gazala-rmida/micro-services-tp/blob/main/micro_services/config-service/src/main/java/org/ms/config_service/ConfigServiceApplication.java): `micro_services/config-service/src/main/java/org/ms/config_service/ConfigServiceApplication.java`

### Other components

- **API caller**

## Connections

- API caller → Invoice API: requests invoice (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java`)
- Invoice API → Invoice persistence: loads invoice (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java`)
- Invoice API → Client Feign client: loads client (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java`)
- Invoice API → Product Feign client: loads products (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/web/FactureRestController.java`)
- Invoice seeding → Client Feign client: fetches client (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java`)
- Invoice seeding → Invoice persistence: saves invoice (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java`)
- Invoice seeding → Product Feign client: fetches products (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java`)
- Invoice seeding → Invoice persistence: saves lines (evidence: `micro_services/factureservice/src/main/java/org/ms/factureservice/FactureserviceApplication.java`)
- Client Feign client → Client API: calls remotely
- Product Feign client → Product API: calls remotely
- Client API → Client persistence: uses repository (evidence: `micro_services/clientservice/src/main/java/org/ms/clientservice/web/ClientRestController.java`)
- Product API → Product persistence: uses repository
- User API → User service: delegates (evidence: `authentification-service/src/main/java/org/ms/authentificationservice/web/UserServiceREST.java`)
- User service → User repository: uses repository (evidence: `authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java`)
- User service → Role repository: uses repository (evidence: `authentification-service/src/main/java/org/ms/authentificationservice/services/UserServiceImpl.java`)
