# ali-repos/deadline-tracker-ai architecture

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

- Interactive diagram: https://gitdiagram.com/ali-repos/deadline-tracker-ai
- Repository: https://github.com/ali-repos/deadline-tracker-ai

## Overview

Deadline Tracker AI is a Streamlit academic-deadline assistant. Students upload schedule images or ask questions; the app sends content to Gemini for extraction and conversation, then can request a concise digest and deliver it through Telegram. Prompts define extraction and digest behavior. The main runtime is concentrated in app.py; edges reflect its shown calls and the README’s documented workflow. No separate persistent deadline store is shown, and get_chat_id.py is a setup utility rather than part of the student-facing runtime.

Main entry points: [`app.py`](https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py) (Streamlit App), [`prompts.py`](https://github.com/ali-repos/deadline-tracker-ai/blob/main/prompts.py) (Assistant Prompts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Student App"]
  node_streamlit["Streamlit App<br/>[app.py]"]
  node_chat_state["Chat Session<br/>[app.py]"]
  node_content["Image and Text Input<br/>[app.py]"]
end

subgraph group_ai["AI Assistance"]
  node_prompts["Assistant Prompts<br/>[prompts.py]"]
  node_gemini["Gemini"]
end

subgraph group_delivery["Digest Delivery"]
  node_telegram_client["Telegram Sender<br/>[app.py]"]
  node_telegram["Telegram"]
end

node_student(("Student"))

node_student -->|"uses"| node_streamlit
node_student -->|"uploads or asks"| node_content
node_streamlit -->|"manages"| node_chat_state
node_content -->|"submits"| node_streamlit
node_streamlit -->|"imports"| node_prompts
node_streamlit -->|"sends chat content"| node_gemini
node_prompts -->|"guides responses"| node_gemini
node_streamlit -->|"requests digest"| node_telegram_client
node_telegram_client -->|"requests summary"| node_gemini
node_telegram_client -->|"sends digest"| node_telegram

click node_streamlit "https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py"
click node_chat_state "https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py"
click node_content "https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py"
click node_prompts "https://github.com/ali-repos/deadline-tracker-ai/blob/main/prompts.py"
click node_telegram_client "https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.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_streamlit,node_chat_state,node_content toneBlue
class node_prompts,node_gemini toneAmber
class node_telegram_client,node_telegram toneMint
class node_student toneIndigo
```

## Components

### Student App

- [Streamlit App](https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py): `app.py`
- [Chat Session](https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py): `app.py`
- [Image and Text Input](https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py): `app.py`

### AI Assistance

- [Assistant Prompts](https://github.com/ali-repos/deadline-tracker-ai/blob/main/prompts.py): `prompts.py`
- **Gemini**

### Digest Delivery

- [Telegram Sender](https://github.com/ali-repos/deadline-tracker-ai/blob/main/app.py): `app.py`
- **Telegram**

### Other components

- **Student**

## Connections

- Student → Streamlit App: uses (evidence: `README.md`)
- Student → Image and Text Input: uploads or asks (evidence: `README.md`)
- Streamlit App → Chat Session: manages (evidence: `app.py`)
- Image and Text Input → Streamlit App: submits (evidence: `app.py`)
- Streamlit App → Assistant Prompts: imports (evidence: `app.py`)
- Streamlit App → Gemini: sends chat content (evidence: `app.py`)
- Assistant Prompts → Gemini: guides responses
- Streamlit App → Telegram Sender: requests digest (evidence: `app.py`)
- Telegram Sender → Gemini: requests summary (evidence: `app.py`)
- Telegram Sender → Telegram: sends digest (evidence: `app.py`)
