# ishaq-5012/attain-x architecture

> Architecture diagram of the GitHub repository ishaq-5012/attain-x, 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/ishaq-5012/attain-x
- Repository: https://github.com/ishaq-5012/attain-x

## Overview

AttainX is a Flask academic-results workflow: staff provide course and student data plus exam, attendance, survey, and end-sem inputs; the system parses and stores them, calculates attainment metrics, and generates a downloadable Excel report. The graph preserves the documented CO/PO mapping, attendance, CES, and end-sem stages. The README and excerpts support the main paths; unsampled implementation details are represented only where documented.

Main entry points: [`app.py`](https://github.com/ishaq-5012/attain-x/blob/main/app.py) (Flask application), [`attainx.db`](https://github.com/ishaq-5012/attain-x/blob/main/attainx.db) (SQLite academic data), [`generate_download.py`](https://github.com/ishaq-5012/attain-x/blob/main/generate_download.py) (Excel report generator), [`templates/index.html`](https://github.com/ishaq-5012/attain-x/blob/main/templates/index.html) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflow"]
  node_ui["Web interface<br/>[index.html]"]
  node_app["Flask application<br/>[app.py]"]
end

subgraph group_course["Course data"]
  node_inputparse["Course and student parser<br/>[parse_input1.py]"]
  node_coursemap["Course and CO/PO data<br/>[app.py]"]
end

subgraph group_assessment["Assessment processing"]
  node_examparse["Exam and CO attainment"]
  node_attendanceparse["Attendance processing"]
  node_endsem["End-sem results<br/>[app.py]"]
  node_ces["CES processing"]
end

subgraph group_persistence["Persistence"]
  node_db[("SQLite academic data<br/>[attainx.db]")]
end

subgraph group_reporting["Report generation"]
  node_report["Excel report generator"]
  node_workbook["Downloadable report"]
end

node_staff(("Academic staff"))

node_staff -->|"uses"| node_ui
node_ui -.->|"submits inputs"| node_app
node_app -->|"invokes parser"| node_inputparse
node_inputparse -->|"extracts course data"| node_coursemap
node_app -->|"invokes parser"| node_examparse
node_app -->|"invokes parser"| node_attendanceparse
node_app -->|"parses results"| node_endsem
node_app -.->|"processes survey"| node_ces
node_app -->|"reads and writes"| node_db
node_examparse -->|"stores exam metrics"| node_db
node_attendanceparse -->|"stores summaries"| node_db
node_endsem -->|"stores grades"| node_db
node_ces -->|"stores survey scores"| node_db
node_app -->|"requests generation"| node_report
node_report -->|"reads report data"| node_db
node_report -->|"generates workbook"| node_workbook
node_app -->|"serves download"| node_workbook

click node_ui "https://github.com/ishaq-5012/attain-x/blob/main/templates/index.html"
click node_app "https://github.com/ishaq-5012/attain-x/blob/main/app.py"
click node_inputparse "https://github.com/ishaq-5012/attain-x/blob/main/parse_input1.py"
click node_coursemap "https://github.com/ishaq-5012/attain-x/blob/main/app.py"
click node_examparse "https://github.com/ishaq-5012/attain-x/blob/main/parse_exam_marks.py"
click node_attendanceparse "https://github.com/ishaq-5012/attain-x/blob/main/parse_attendance.py"
click node_endsem "https://github.com/ishaq-5012/attain-x/blob/main/app.py"
click node_ces "https://github.com/ishaq-5012/attain-x/blob/main/parse_exam_marks.py"
click node_db "https://github.com/ishaq-5012/attain-x/blob/main/attainx.db"
click node_report "https://github.com/ishaq-5012/attain-x/blob/main/generate_download.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_ui,node_app toneBlue
class node_inputparse,node_coursemap toneAmber
class node_examparse,node_attendanceparse,node_endsem,node_ces toneMint
class node_db toneRose
class node_report,node_workbook,node_staff toneIndigo
```

## Components

### Web workflow

- [Web interface](https://github.com/ishaq-5012/attain-x/blob/main/templates/index.html): `templates/index.html`
- [Flask application](https://github.com/ishaq-5012/attain-x/blob/main/app.py): `app.py`

### Course data

- [Course and student parser](https://github.com/ishaq-5012/attain-x/blob/main/parse_input1.py): `parse_input1.py`
- [Course and CO/PO data](https://github.com/ishaq-5012/attain-x/blob/main/app.py): `app.py`

### Assessment processing

- [Exam and CO attainment](https://github.com/ishaq-5012/attain-x/blob/main/parse_exam_marks.py): `parse_exam_marks.py`
- [Attendance processing](https://github.com/ishaq-5012/attain-x/blob/main/parse_attendance.py): `parse_attendance.py`
- [End-sem results](https://github.com/ishaq-5012/attain-x/blob/main/app.py): `app.py`
- [CES processing](https://github.com/ishaq-5012/attain-x/blob/main/parse_exam_marks.py): `parse_exam_marks.py`

### Persistence

- [SQLite academic data](https://github.com/ishaq-5012/attain-x/blob/main/attainx.db): `attainx.db`

### Report generation

- [Excel report generator](https://github.com/ishaq-5012/attain-x/blob/main/generate_download.py): `generate_download.py`
- **Downloadable report**

### Other components

- **Academic staff**

## Connections

- Academic staff → Web interface: uses (evidence: `README.md`)
- Web interface → Flask application: submits inputs
- Flask application → Course and student parser: invokes parser (evidence: `app.py`)
- Course and student parser → Course and CO/PO data: extracts course data (evidence: `README.md`)
- Flask application → Exam and CO attainment: invokes parser (evidence: `app.py`)
- Flask application → Attendance processing: invokes parser (evidence: `app.py`)
- Flask application → End-sem results: parses results (evidence: `app.py`)
- Flask application → CES processing: processes survey (evidence: `README.md`)
- Flask application → SQLite academic data: reads and writes (evidence: `README.md`)
- Exam and CO attainment → SQLite academic data: stores exam metrics (evidence: `README.md`)
- Attendance processing → SQLite academic data: stores summaries (evidence: `README.md`)
- End-sem results → SQLite academic data: stores grades (evidence: `app.py`)
- CES processing → SQLite academic data: stores survey scores (evidence: `README.md`)
- Flask application → Excel report generator: requests generation (evidence: `README.md`)
- Excel report generator → SQLite academic data: reads report data (evidence: `README.md`)
- Excel report generator → Downloadable report: generates workbook (evidence: `README.md`)
- Flask application → Downloadable report: serves download (evidence: `README.md`)
