# naimlawani01/pharmacie-api architecture

> Architecture diagram of the GitHub repository naimlawani01/pharmacie-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naimlawani01/pharmacie-api
- Repository: https://github.com/naimlawani01/pharmacie-api

## Overview

This is a FastAPI pharmacy-management API. Clients reach the application’s registered routers for authentication, users, products, pharmacies and orders; those handlers operate on Beanie document models backed by MongoDB. Pharmacy inventory links products to pharmacies, and orders link users, pharmacies and inventory items. Startup initializes the database. The README is empty, so capabilities and relationships here are based on the provided source excerpts and index; unsampled behavior is not inferred.

Main entry points: [`main.py`](https://github.com/naimlawani01/pharmacie-api/blob/main/main.py) (FastAPI App), [`app/database.py`](https://github.com/naimlawani01/pharmacie-api/blob/main/app/database.py) (Database Setup), [`models/user.py`](https://github.com/naimlawani01/pharmacie-api/blob/main/models/user.py) (User Model), [`routers/auth.py`](https://github.com/naimlawani01/pharmacie-api/blob/main/routers/auth.py) (Auth Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["FastAPI App<br/>[main.py]"]
  node_database["Database Setup<br/>[database.py]"]
end

subgraph group_api["API Routes"]
  node_auth_routes["Auth Routes<br/>[auth.py]"]
  node_user_routes["User Routes<br/>[user.py]"]
  node_product_routes["Product Routes<br/>[product.py]"]
  node_pharmacy_routes["Pharmacy Routes<br/>[pharmacy.py]"]
  node_order_routes["Order Routes<br/>[order.py]"]
end

subgraph group_domain["Domain Models"]
  node_user_model["User Model<br/>[user.py]"]
  node_product_model["Product Model<br/>[product.py]"]
  node_pharmacy_model["Pharmacy Inventory<br/>[pharmacy.py]"]
  node_order_model["Order Models<br/>[order.py]"]
  node_token_model["Token Model<br/>[token.py]"]
end

subgraph group_security["Authentication"]
  node_auth_utils["Auth Utilities<br/>[auth.py]"]
end

node_client(("API Client"))
node_mongo[("MongoDB")]

node_client -->|"sends requests"| node_main
node_main -->|"initializes on startup"| node_database
node_main -->|"registers"| node_auth_routes
node_main -->|"registers"| node_user_routes
node_main -->|"registers"| node_product_routes
node_main -->|"registers"| node_pharmacy_routes
node_main -->|"registers"| node_order_routes
node_database -->|"connects to"| node_mongo
node_database -->|"registers model"| node_product_model
node_database -->|"registers model"| node_pharmacy_model
node_database -->|"registers model"| node_user_model
node_database -->|"registers models"| node_order_model
node_auth_routes -->|"looks up user"| node_user_model
node_auth_routes -->|"verifies and signs"| node_auth_utils
node_auth_routes -->|"returns token"| node_token_model
node_user_routes -->|"manages users"| node_user_model
node_user_routes -->|"hashes password"| node_auth_utils
node_product_routes -->|"manages products"| node_product_model
node_pharmacy_routes -->|"manages inventory"| node_pharmacy_model
node_pharmacy_routes -->|"checks product"| node_product_model
node_order_routes -->|"manages orders"| node_order_model
node_order_routes -->|"checks user"| node_user_model
node_pharmacy_model -->|"links products"| node_product_model
node_order_model -->|"links pharmacy"| node_pharmacy_model
node_order_model -->|"links user"| node_user_model

click node_main "https://github.com/naimlawani01/pharmacie-api/blob/main/main.py"
click node_database "https://github.com/naimlawani01/pharmacie-api/blob/main/app/database.py"
click node_auth_routes "https://github.com/naimlawani01/pharmacie-api/blob/main/routers/auth.py"
click node_user_routes "https://github.com/naimlawani01/pharmacie-api/blob/main/routers/user.py"
click node_product_routes "https://github.com/naimlawani01/pharmacie-api/blob/main/routers/product.py"
click node_pharmacy_routes "https://github.com/naimlawani01/pharmacie-api/blob/main/routers/pharmacy.py"
click node_order_routes "https://github.com/naimlawani01/pharmacie-api/blob/main/routers/order.py"
click node_user_model "https://github.com/naimlawani01/pharmacie-api/blob/main/models/user.py"
click node_product_model "https://github.com/naimlawani01/pharmacie-api/blob/main/models/product.py"
click node_pharmacy_model "https://github.com/naimlawani01/pharmacie-api/blob/main/models/pharmacy.py"
click node_order_model "https://github.com/naimlawani01/pharmacie-api/blob/main/models/order.py"
click node_token_model "https://github.com/naimlawani01/pharmacie-api/blob/main/models/token.py"
click node_auth_utils "https://github.com/naimlawani01/pharmacie-api/blob/main/utils/auth.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_main,node_database,node_client toneBlue
class node_auth_routes,node_user_routes,node_product_routes,node_pharmacy_routes,node_order_routes,node_mongo toneAmber
class node_user_model,node_product_model,node_pharmacy_model,node_order_model,node_token_model toneMint
class node_auth_utils toneRose
```

## Components

### Application

- [FastAPI App](https://github.com/naimlawani01/pharmacie-api/blob/main/main.py): `main.py`
- [Database Setup](https://github.com/naimlawani01/pharmacie-api/blob/main/app/database.py): `app/database.py`

### API Routes

- [Auth Routes](https://github.com/naimlawani01/pharmacie-api/blob/main/routers/auth.py): `routers/auth.py`
- [User Routes](https://github.com/naimlawani01/pharmacie-api/blob/main/routers/user.py): `routers/user.py`
- [Product Routes](https://github.com/naimlawani01/pharmacie-api/blob/main/routers/product.py): `routers/product.py`
- [Pharmacy Routes](https://github.com/naimlawani01/pharmacie-api/blob/main/routers/pharmacy.py): `routers/pharmacy.py`
- [Order Routes](https://github.com/naimlawani01/pharmacie-api/blob/main/routers/order.py): `routers/order.py`

### Domain Models

- [User Model](https://github.com/naimlawani01/pharmacie-api/blob/main/models/user.py): `models/user.py`
- [Product Model](https://github.com/naimlawani01/pharmacie-api/blob/main/models/product.py): `models/product.py`
- [Pharmacy Inventory](https://github.com/naimlawani01/pharmacie-api/blob/main/models/pharmacy.py): `models/pharmacy.py`
- [Order Models](https://github.com/naimlawani01/pharmacie-api/blob/main/models/order.py): `models/order.py`
- [Token Model](https://github.com/naimlawani01/pharmacie-api/blob/main/models/token.py): `models/token.py`

### Authentication

- [Auth Utilities](https://github.com/naimlawani01/pharmacie-api/blob/main/utils/auth.py): `utils/auth.py`

### Other components

- **API Client**
- **MongoDB**

## Connections

- API Client → FastAPI App: sends requests (evidence: `main.py`)
- FastAPI App → Database Setup: initializes on startup (evidence: `main.py`)
- FastAPI App → Auth Routes: registers (evidence: `main.py`)
- FastAPI App → User Routes: registers (evidence: `main.py`)
- FastAPI App → Product Routes: registers (evidence: `main.py`)
- FastAPI App → Pharmacy Routes: registers (evidence: `main.py`)
- FastAPI App → Order Routes: registers (evidence: `main.py`)
- Database Setup → MongoDB: connects to (evidence: `app/database.py`)
- Database Setup → Product Model: registers model (evidence: `app/database.py`)
- Database Setup → Pharmacy Inventory: registers model (evidence: `app/database.py`)
- Database Setup → User Model: registers model (evidence: `app/database.py`)
- Database Setup → Order Models: registers models (evidence: `app/database.py`)
- Auth Routes → User Model: looks up user (evidence: `routers/auth.py`)
- Auth Routes → Auth Utilities: verifies and signs (evidence: `routers/auth.py`)
- Auth Routes → Token Model: returns token (evidence: `routers/auth.py`)
- User Routes → User Model: manages users (evidence: `routers/user.py`)
- User Routes → Auth Utilities: hashes password (evidence: `routers/user.py`)
- Product Routes → Product Model: manages products (evidence: `routers/product.py`)
- Pharmacy Routes → Pharmacy Inventory: manages inventory (evidence: `routers/pharmacy.py`)
- Pharmacy Routes → Product Model: checks product (evidence: `routers/pharmacy.py`)
- Order Routes → Order Models: manages orders (evidence: `routers/order.py`)
- Order Routes → User Model: checks user (evidence: `routers/order.py`)
- Pharmacy Inventory → Product Model: links products (evidence: `models/pharmacy.py`)
- Order Models → Pharmacy Inventory: links pharmacy (evidence: `models/order.py`)
- Order Models → User Model: links user (evidence: `models/order.py`)
