# mataminus-capstone/jagamata_flask architecture

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

- Interactive diagram: https://gitdiagram.com/mataminus-capstone/jagamata_flask
- Repository: https://github.com/mataminus-capstone/jagamata_flask

## Overview

Jagamata is a Flask eye-health application with web pages and a mobile-facing API. Users can authenticate, ask eye-health questions, submit images for detection, and review related health content; the app also supports clinics, medicines, drowsiness checks, and feedback. The application factory registers the route modules, which dispatch to controllers or service logic. Models persist user and feature data. The excerpts show several service implementations, but not all controller or route behavior, so uncertain links are omitted.

Main entry points: [`models.py`](https://github.com/mataminus-capstone/jagamata_flask/blob/main/models.py) (Application data), [`routes`](https://github.com/mataminus-capstone/jagamata_flask/tree/main/routes) (API routes), [`routes/web_routes.py`](https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/web_routes.py) (Web routes), [`services/auth_service.py`](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/auth_service.py) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application entry"]
  node_flask["Flask app<br/>[app.py]"]
  node_api_routes["API routes"]
  node_web_routes["Web routes<br/>[web_routes.py]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Auth routes<br/>[auth_routes.py]"]
  node_auth_controller["Auth controller<br/>[auth_controller.py]"]
  node_auth_service["Auth service<br/>[auth_service.py]"]
  node_jwt["JWT service<br/>[jwt_service.py]"]
end

subgraph group_eye["Eye-health services"]
  node_chat_routes["Chat routes<br/>[chatbot_routes.py]"]
  node_chat_controller["Chat controller"]
  node_chat_service["Chatbot service<br/>[chatbot_service.py]"]
  node_detection_routes["Detection routes"]
  node_detection_controller["Detection controller"]
  node_detection_service["Detection service"]
  node_drowsy_routes["Drowsiness routes"]
  node_drowsy_controller["Drowsiness controller"]
  node_drowsy_service["Drowsiness service"]
end

subgraph group_content["Content and community"]
  node_article_controller["Article controller"]
  node_feedback_controller["Feedback controller"]
  node_user_controller["User controller<br/>[user_controller.py]"]
  node_clinic_controller["Clinic controller"]
end

subgraph group_data["Persistence and integrations"]
  node_database[("Application data<br/>[models.py]")]
  node_cloudinary(("Cloudinary"))
  node_google(("Google OAuth"))
  node_gemini(("Gemini"))
  node_sentiment["Sentiment analysis"]
end

node_user(("User"))

node_user -->|"uses"| node_flask
node_flask -->|"registers"| node_api_routes
node_flask -->|"registers"| node_web_routes
node_api_routes -.->|"includes"| node_auth_routes
node_api_routes -.->|"includes"| node_chat_routes
node_api_routes -.->|"includes"| node_detection_routes
node_api_routes -.->|"includes"| node_drowsy_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"uses"| node_auth_service
node_auth_controller -->|"uses"| node_jwt
node_auth_service -->|"queries"| node_database
node_auth_service -->|"verifies tokens"| node_google
node_auth_service -->|"requests user info"| node_google
node_chat_routes -->|"dispatches"| node_chat_controller
node_chat_controller -->|"uses"| node_chat_service
node_chat_service -.->|"generates replies"| node_gemini
node_detection_routes -->|"dispatches"| node_detection_controller
node_detection_controller -->|"uses"| node_detection_service
node_detection_controller -->|"stores history"| node_database
node_detection_controller -->|"uploads images"| node_cloudinary
node_drowsy_routes -->|"dispatches"| node_drowsy_controller
node_drowsy_controller -->|"uses"| node_drowsy_service
node_web_routes -->|"queries"| node_database
node_web_routes -->|"uploads images"| node_cloudinary
node_web_routes -->|"uses"| node_chat_service
node_article_controller -->|"reads and writes"| node_database
node_article_controller -->|"uploads images"| node_cloudinary
node_feedback_controller -->|"analyzes text"| node_sentiment
node_feedback_controller -->|"stores feedback"| node_database
node_user_controller -->|"manages users"| node_database
node_clinic_controller -->|"manages clinics"| node_database
node_clinic_controller -->|"uploads images"| node_cloudinary

click node_flask "https://github.com/mataminus-capstone/jagamata_flask/blob/main/app.py"
click node_api_routes "https://github.com/mataminus-capstone/jagamata_flask/tree/main/routes"
click node_web_routes "https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/web_routes.py"
click node_auth_routes "https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/auth_routes.py"
click node_auth_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/auth_controller.py"
click node_auth_service "https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/auth_service.py"
click node_jwt "https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/jwt_service.py"
click node_chat_routes "https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/chatbot_routes.py"
click node_chat_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/chatbot_controller.py"
click node_chat_service "https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/chatbot_service.py"
click node_detection_routes "https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/detection_routes.py"
click node_detection_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/detection_controller.py"
click node_detection_service "https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/detection_service.py"
click node_drowsy_routes "https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/drowsiness_routes.py"
click node_drowsy_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/drowsiness_controller.py"
click node_drowsy_service "https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/drowsiness_service.py"
click node_article_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/article_controller.py"
click node_feedback_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/feedback_controller.py"
click node_user_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/user_controller.py"
click node_clinic_controller "https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/clinic_controller.py"
click node_database "https://github.com/mataminus-capstone/jagamata_flask/blob/main/models.py"
click node_sentiment "https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/sentiment_service.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_flask,node_api_routes,node_web_routes,node_user toneBlue
class node_auth_routes,node_auth_controller,node_auth_service,node_jwt toneAmber
class node_chat_routes,node_chat_controller,node_chat_service,node_detection_routes,node_detection_controller,node_detection_service,node_drowsy_routes,node_drowsy_controller,node_drowsy_service toneMint
class node_article_controller,node_feedback_controller,node_user_controller,node_clinic_controller toneRose
class node_database,node_cloudinary,node_google,node_gemini,node_sentiment toneIndigo
```

## Components

### Application entry

- [Flask app](https://github.com/mataminus-capstone/jagamata_flask/blob/main/app.py): `app.py`
- [API routes](https://github.com/mataminus-capstone/jagamata_flask/tree/main/routes): `routes`
- [Web routes](https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/web_routes.py): `routes/web_routes.py`

### Identity and access

- [Auth routes](https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/auth_routes.py): `routes/auth_routes.py`
- [Auth controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/auth_controller.py): `controllers/auth_controller.py`
- [Auth service](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/auth_service.py): `services/auth_service.py`
- [JWT service](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/jwt_service.py): `services/jwt_service.py`

### Eye-health services

- [Chat routes](https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/chatbot_routes.py): `routes/chatbot_routes.py`
- [Chat controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/chatbot_controller.py): `controllers/chatbot_controller.py`
- [Chatbot service](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/chatbot_service.py): `services/chatbot_service.py`
- [Detection routes](https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/detection_routes.py): `routes/detection_routes.py`
- [Detection controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/detection_controller.py): `controllers/detection_controller.py`
- [Detection service](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/detection_service.py): `services/detection_service.py`
- [Drowsiness routes](https://github.com/mataminus-capstone/jagamata_flask/blob/main/routes/drowsiness_routes.py): `routes/drowsiness_routes.py`
- [Drowsiness controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/drowsiness_controller.py): `controllers/drowsiness_controller.py`
- [Drowsiness service](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/drowsiness_service.py): `services/drowsiness_service.py`

### Content and community

- [Article controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/article_controller.py): `controllers/article_controller.py`
- [Feedback controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/feedback_controller.py): `controllers/feedback_controller.py`
- [User controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/user_controller.py): `controllers/user_controller.py`
- [Clinic controller](https://github.com/mataminus-capstone/jagamata_flask/blob/main/controllers/clinic_controller.py): `controllers/clinic_controller.py`

### Persistence and integrations

- [Application data](https://github.com/mataminus-capstone/jagamata_flask/blob/main/models.py): `models.py`
- **Cloudinary**
- **Google OAuth**
- **Gemini**
- [Sentiment analysis](https://github.com/mataminus-capstone/jagamata_flask/blob/main/services/sentiment_service.py): `services/sentiment_service.py`

### Other components

- **User**

## Connections

- User → Flask app: uses (evidence: `app.py`)
- Flask app → API routes: registers (evidence: `app.py`)
- Flask app → Web routes: registers (evidence: `app.py`)
- API routes → Auth routes: includes
- API routes → Chat routes: includes
- API routes → Detection routes: includes
- API routes → Drowsiness routes: includes
- Auth routes → Auth controller: dispatches (evidence: `routes/auth_routes.py`)
- Auth controller → Auth service: uses (evidence: `controllers/auth_controller.py`)
- Auth controller → JWT service: uses (evidence: `controllers/auth_controller.py`)
- Auth service → Application data: queries (evidence: `services/auth_service.py`)
- Auth service → Google OAuth: verifies tokens (evidence: `services/auth_service.py`)
- Auth service → Google OAuth: requests user info (evidence: `services/auth_service.py`)
- Chat routes → Chat controller: dispatches (evidence: `routes/chatbot_routes.py`)
- Chat controller → Chatbot service: uses (evidence: `controllers/chatbot_controller.py`)
- Chatbot service → Gemini: generates replies
- Detection routes → Detection controller: dispatches (evidence: `routes/detection_routes.py`)
- Detection controller → Detection service: uses (evidence: `controllers/detection_controller.py`)
- Detection controller → Application data: stores history (evidence: `controllers/detection_controller.py`)
- Detection controller → Cloudinary: uploads images (evidence: `controllers/detection_controller.py`)
- Drowsiness routes → Drowsiness controller: dispatches (evidence: `routes/drowsiness_routes.py`)
- Drowsiness controller → Drowsiness service: uses (evidence: `controllers/drowsiness_controller.py`)
- Web routes → Application data: queries (evidence: `routes/web_routes.py`)
- Web routes → Cloudinary: uploads images (evidence: `routes/web_routes.py`)
- Web routes → Chatbot service: uses (evidence: `routes/web_routes.py`)
- Article controller → Application data: reads and writes (evidence: `controllers/article_controller.py`)
- Article controller → Cloudinary: uploads images (evidence: `controllers/article_controller.py`)
- Feedback controller → Sentiment analysis: analyzes text (evidence: `controllers/feedback_controller.py`)
- Feedback controller → Application data: stores feedback (evidence: `controllers/feedback_controller.py`)
- User controller → Application data: manages users (evidence: `controllers/user_controller.py`)
- Clinic controller → Application data: manages clinics (evidence: `controllers/clinic_controller.py`)
- Clinic controller → Cloudinary: uploads images (evidence: `controllers/clinic_controller.py`)
