# colmali-7/ratemydc architecture

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

- Interactive diagram: https://gitdiagram.com/colmali-7/ratemydc
- Repository: https://github.com/colmali-7/ratemydc

## Overview

RateMyDC is a Flask-based student review platform. Students browse subjects and submit teacher ratings and written feedback; administrators sign in to manage subjects, teachers, and reviews, filter reviews, and inspect per-teacher rating analytics. The routes, SQLAlchemy models, and persistence setup are all in app.py. README documents teacher pages, search, and subject filtering, but the supplied source excerpt does not show their implementation, so those links are omitted. Templates are represented by the views they render; no external database service is assumed because the configured backend may be SQLite or PostgreSQL.

Main entry points: [`app.py`](https://github.com/colmali-7/ratemydc/blob/main/app.py) (Flask app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student reviews"]
  node_catalog["Subject catalog<br/>[app.py]"]
  node_review_submit["Review submission<br/>[app.py]"]
end

subgraph group_admin["Admin tools"]
  node_admin_auth["Admin login<br/>[app.py]"]
  node_review_admin["Review management<br/>[app.py]"]
  node_catalog_admin["Subject management<br/>[app.py]"]
  node_teacher_admin["Teacher management<br/>[app.py]"]
  node_review_detail["Review detail<br/>[app.py]"]
  node_teacher_analytics["Teacher analytics<br/>[app.py]"]
end

subgraph group_runtime["Application runtime"]
  node_web_app["Flask app<br/>[app.py]"]
  node_review_store[("Review data<br/>[app.py]")]
  node_rate_limit["Login rate limit<br/>[app.py]"]
end

node_student(("Student"))
node_admin_user(("Administrator"))

node_student -->|"requests pages"| node_web_app
node_web_app -->|"routes browsing"| node_catalog
node_catalog -->|"reads subjects"| node_review_store
node_web_app -->|"routes submissions"| node_review_submit
node_review_submit -->|"writes reviews"| node_review_store
node_admin_user -->|"requests admin"| node_web_app
node_web_app -->|"routes login"| node_admin_auth
node_admin_auth -->|"limits attempts"| node_rate_limit
node_web_app -->|"routes review list"| node_review_admin
node_review_admin -->|"filters reviews"| node_review_store
node_web_app -->|"routes subject changes"| node_catalog_admin
node_catalog_admin -->|"manages subjects"| node_review_store
node_web_app -->|"routes teacher changes"| node_teacher_admin
node_teacher_admin -->|"manages teachers"| node_review_store
node_web_app -->|"routes detail view"| node_review_detail
node_review_detail -->|"loads review"| node_review_store
node_web_app -->|"routes analytics"| node_teacher_analytics
node_teacher_analytics -->|"loads reviews"| node_review_store

click node_web_app "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_catalog "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_review_submit "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_review_store "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_admin_auth "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_review_admin "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_catalog_admin "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_teacher_admin "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_review_detail "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_teacher_analytics "https://github.com/colmali-7/ratemydc/blob/main/app.py"
click node_rate_limit "https://github.com/colmali-7/ratemydc/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_catalog,node_review_submit toneBlue
class node_admin_auth,node_review_admin,node_catalog_admin,node_teacher_admin,node_review_detail,node_teacher_analytics toneAmber
class node_web_app,node_review_store,node_rate_limit toneMint
class node_student,node_admin_user toneIndigo
```

## Components

### Student reviews

- [Subject catalog](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Review submission](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`

### Admin tools

- [Admin login](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Review management](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Subject management](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Teacher management](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Review detail](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Teacher analytics](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`

### Application runtime

- [Flask app](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Review data](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`
- [Login rate limit](https://github.com/colmali-7/ratemydc/blob/main/app.py): `app.py`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Flask app: requests pages (evidence: `app.py`)
- Flask app → Subject catalog: routes browsing (evidence: `app.py`)
- Subject catalog → Review data: reads subjects (evidence: `app.py`)
- Flask app → Review submission: routes submissions (evidence: `app.py`)
- Review submission → Review data: writes reviews (evidence: `app.py`)
- Administrator → Flask app: requests admin (evidence: `app.py`)
- Flask app → Admin login: routes login (evidence: `app.py`)
- Admin login → Login rate limit: limits attempts (evidence: `app.py`)
- Flask app → Review management: routes review list (evidence: `app.py`)
- Review management → Review data: filters reviews (evidence: `app.py`)
- Flask app → Subject management: routes subject changes (evidence: `app.py`)
- Subject management → Review data: manages subjects (evidence: `app.py`)
- Flask app → Teacher management: routes teacher changes (evidence: `app.py`)
- Teacher management → Review data: manages teachers (evidence: `app.py`)
- Flask app → Review detail: routes detail view (evidence: `app.py`)
- Review detail → Review data: loads review (evidence: `app.py`)
- Flask app → Teacher analytics: routes analytics (evidence: `app.py`)
- Teacher analytics → Review data: loads reviews (evidence: `app.py`)
