# snmiitb-bit/core-traits-self-assessment architecture

> Architecture diagram of the GitHub repository snmiitb-bit/core-traits-self-assessment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snmiitb-bit/core-traits-self-assessment
- Repository: https://github.com/snmiitb-bit/core-traits-self-assessment

## Overview

This Streamlit application guides candidates through a bilingual Big Five self-assessment, then generates and offers a downloadable PDF certificate. The main flow collects candidate details and facet ratings, using assessment rows loaded from the workbook, before the submission handler validates the name and invokes PDF generation. The README also documents organization branding and signature blocks, implemented in the certificate. The single source file contains these responsibilities; the graph keeps them distinct while showing only evidenced calls. The logo is referenced by the source, but is absent from the provided file tree.

Main entry points: [`app.py`](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py) (Streamlit interface), [`Core Traits Self Assesment_2026.xlsx`](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/Core%20Traits%20Self%20Assesment_2026.xlsx) (Assessment workbook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assessment["Assessment experience"]
  node_streamlit_ui["Streamlit interface<br/>[app.py]"]
  node_candidate_details["Candidate details<br/>[app.py]"]
  node_workbook["Assessment workbook"]
  node_questionnaire["Bilingual questionnaire<br/>[app.py]"]
  node_response_collection["Ratings and comments<br/>[app.py]"]
end

subgraph group_certificate["Certificate generation"]
  node_submission["Submission handler<br/>[app.py]"]
  node_pdf_generation["PDF certificate<br/>[app.py]"]
  node_download["PDF download<br/>[app.py]"]
  node_branding["Organization branding<br/>[app.py]"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_streamlit_ui
node_streamlit_ui -->|"collects"| node_candidate_details
node_streamlit_ui -->|"loads"| node_workbook
node_streamlit_ui -->|"renders"| node_questionnaire
node_questionnaire -->|"collects"| node_response_collection
node_candidate -->|"rates facets"| node_response_collection
node_streamlit_ui -->|"handles submit"| node_submission
node_submission -->|"calls"| node_pdf_generation
node_submission -->|"passes details"| node_candidate_details
node_submission -->|"passes responses"| node_response_collection
node_pdf_generation -->|"includes"| node_branding
node_submission -->|"offers PDF"| node_download
node_candidate -->|"downloads"| node_download

click node_streamlit_ui "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_candidate_details "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_workbook "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/Core%20Traits%20Self%20Assesment_2026.xlsx"
click node_questionnaire "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_response_collection "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_submission "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_pdf_generation "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_download "https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py"
click node_branding "https://github.com/snmiitb-bit/core-traits-self-assessment/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_ui,node_candidate_details,node_workbook,node_questionnaire,node_response_collection toneBlue
class node_submission,node_pdf_generation,node_download,node_branding toneAmber
class node_candidate toneIndigo
```

## Components

### Assessment experience

- [Streamlit interface](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`
- [Candidate details](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`
- [Assessment workbook](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/Core%20Traits%20Self%20Assesment_2026.xlsx): `Core Traits Self Assesment_2026.xlsx`
- [Bilingual questionnaire](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`
- [Ratings and comments](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`

### Certificate generation

- [Submission handler](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`
- [PDF certificate](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`
- [PDF download](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`
- [Organization branding](https://github.com/snmiitb-bit/core-traits-self-assessment/blob/main/app.py): `app.py`

### Other components

- **Candidate**

## Connections

- Candidate → Streamlit interface: uses (evidence: `README.md`)
- Streamlit interface → Candidate details: collects (evidence: `app.py`)
- Streamlit interface → Assessment workbook: loads (evidence: `app.py`)
- Streamlit interface → Bilingual questionnaire: renders (evidence: `app.py`)
- Bilingual questionnaire → Ratings and comments: collects (evidence: `app.py`)
- Candidate → Ratings and comments: rates facets (evidence: `README.md`)
- Streamlit interface → Submission handler: handles submit (evidence: `app.py`)
- Submission handler → PDF certificate: calls (evidence: `app.py`)
- Submission handler → Candidate details: passes details (evidence: `app.py`)
- Submission handler → Ratings and comments: passes responses (evidence: `app.py`)
- PDF certificate → Organization branding: includes (evidence: `app.py`)
- Submission handler → PDF download: offers PDF (evidence: `app.py`)
- Candidate → PDF download: downloads (evidence: `README.md`)
