# anuragkej/team-12 architecture

> Architecture diagram of the GitHub repository anuragkej/team-12, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anuragkej/team-12
- Repository: https://github.com/anuragkej/team-12

## Overview

##### Project type and purpose
- This is a full-stack alumni and events management web application (“LMCC”) built as a hackathon project.
- The “lmcc-ui” folder is a Next.js/React front-end; “lmcc-server” is a Python Flask back-end.
- The front-end uses Firebase for authentication; the back-end exposes REST APIs that persist data to a database (e.g., PostgreSQL/MySQL/SQLite) and is hosted on an AWS EC2 instance.

##### File-structure highlights
- Top-level:
- lmcc-ui/… — Next.js app (React components under src/app, src/components, Tailwind CSS config).
- lmcc-server/… — Flask app (app.py), requirements.txt for Python, package.json/package-lock.json (possibly for tooling).
- Team-12_Server_Details.txt, .pem keys, Accessing_server.pdf — indicate AWS EC2 deployment and SSH access.
- Front-end uses Firebase modules under src/app/firebase.
- No explicit database code in the front-end; server likely holds ORM or SQL logic in app.py (CRUD endpoints).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Tier
    subgraph "Client Tier"
        direction TB
        Browser["User Browser"]:::admin
    end

    %% Front-end Tier
    subgraph "Front-end Tier"
        direction TB
        NextApp["Next.js Front-end Application"]:::owned
        NextConfig["Next.js Configuration"]:::owned
        ReactPages["React Pages (Client Tier)"]:::owned
        UIComponents["React UI Components"]:::owned
        FirebaseModule["Firebase Authentication Module"]:::third
        TailwindConfig["Tailwind CSS Configuration"]:::owned
    end

    %% Third-party
    FirebaseAuth["Firebase Auth Service"]:::third

    %% AWS VPC
    subgraph "AWS VPC"
        direction TB
        subgraph "EC2 Instance"
            direction TB
            FlaskAPI["Flask Back-end API Server"]:::owned
            Requirements["Python Dependencies (requirements.txt)"]:::owned
            NodeTooling["Node Tooling (package.json)"]:::owned
        end
        DB["Database"]:::db
        SSHDocs["SSH Keys & Docs"]:::owned
    end

    %% Connections
    Browser -->|"HTTPS"| NextApp
    NextApp -->|"Uses SDK"| FirebaseModule
    NextApp -->|"HTTPS (Bearer Token)"| FlaskAPI
    NextApp -->|"Reads Config"| NextConfig
    NextApp -->|"Loads Pages"| ReactPages
    NextApp -->|"Uses Components"| UIComponents
    NextApp -->|"Loads CSS Config"| TailwindConfig
    FirebaseModule -->|"Authenticates"| FirebaseAuth
    FlaskAPI -->|"SQL/TCP (port 5432/3306)"| DB
    Admin["Admin Workstation"]:::admin -->|"SSH"| SSHDocs
    Admin -->|"SSH"| FlaskAPI

    %% Click Events
    click NextApp "https://github.com/anuragkej/team-12/tree/main/lmcc-ui/"
    click NextConfig "https://github.com/anuragkej/team-12/blob/main/lmcc-ui/next.config.mjs"
    click ReactPages "https://github.com/anuragkej/team-12/tree/main/lmcc-ui/src/app/"
    click UIComponents "https://github.com/anuragkej/team-12/tree/main/lmcc-ui/src/components/"
    click FirebaseModule "https://github.com/anuragkej/team-12/blob/main/lmcc-ui/src/app/firebase/firebase.js"
    click TailwindConfig "https://github.com/anuragkej/team-12/blob/main/lmcc-ui/tailwind.config.js"
    click FlaskAPI "https://github.com/anuragkej/team-12/blob/main/lmcc-server/app.py"
    click Requirements "https://github.com/anuragkej/team-12/blob/main/lmcc-server/requirements.txt"
    click NodeTooling "https://github.com/anuragkej/team-12/blob/main/lmcc-server/package.json"
    click SSHDocs "https://github.com/anuragkej/team-12/blob/main/Team-12_Server_Details.txt"

    %% Styles
    classDef owned fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef third fill:#90EE90,stroke:#000,stroke-width:1px
    classDef db fill:#FAA540,stroke:#000,stroke-width:1px,shape:cylinder
    classDef admin fill:#FFD700,stroke:#000,stroke-width:1px
```
