# maithilis2403/system-analysis architecture

> Architecture diagram of the GitHub repository maithilis2403/system-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maithilis2403/system-analysis
- Repository: https://github.com/maithilis2403/system-analysis

## Overview

##### Project type and purpose
- From the README and deliverables, SOCHS is a full-stack, brokerage-free housing platform tailored to Syracuse students.
- Its primary goals are to let students list/find housing, match roommates, offer legal aid resources, and support multiple languages.

##### File structure
- The repository consists of design deliverables (PDFs and a PowerPoint), suggesting this is the requirements & architecture phase rather than code.

##### README for additional insights
- Features called out: multilingual support, legal aid integration, roommate matching.
- Architecture must accommodate data storage, business logic, third-party APIs, and a responsive UI.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        WebUI["Web UI"]:::frontend
        MobileUI["Mobile UI"]:::frontend
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        APIGateway["API Gateway"]:::backend
    end

    %% Backend Services
    subgraph "Backend Services"
        direction TB
        AuthService["Authentication Service"]:::backend
        UserProfile["User Profile Service"]:::backend
        ListingService["Listing Service"]:::backend
        MatchingService["Matching Service"]:::backend
        LegalAidService["Legal Aid Service"]:::backend
        TranslationService["Translation Service"]:::backend
        NotificationService["Notification Service"]:::backend
    end

    MessageQueue["Message Queue"]:::backend

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        UserDB["User DB (Postgres)"]:::datastore
        ListingDB["Listing DB (Postgres)"]:::datastore
        Cache["Cache (Redis)"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        TranslateAPI["Google Translate API"]:::external
        LegalAPI["Legal Aid Info API"]:::external
        Twilio["Twilio SMS/Email"]:::external
    end

    %% Documentation
    subgraph "Documentation"
        direction TB
        README["Project Overview & Requirements"]:::docs
        PPT["Architectural Slides & Diagram Details"]:::docs
        Deliverables["Design Deliverables (PDF)"]:::docs
        Charter["Project Charter and Scope"]:::docs
        Week11["Weekly Progress & Deliverables Summary"]:::docs
    end

    %% Connections
    WebUI -->|HTTPS| APIGateway
    MobileUI -->|HTTPS| APIGateway

    APIGateway -->|REST/gRPC| AuthService
    APIGateway -->|REST/gRPC| UserProfile
    APIGateway -->|REST/gRPC| ListingService
    APIGateway -->|REST/gRPC| MatchingService
    APIGateway -->|REST/gRPC| LegalAidService
    APIGateway -->|REST/gRPC| TranslationService

    AuthService -->|SQL| UserDB
    UserProfile -->|SQL| UserDB
    ListingService -->|SQL| ListingDB

    AuthService -->|Cache| Cache
    UserProfile -->|Cache| Cache
    ListingService -->|Cache| Cache

    MatchingService -->|AMQP| MessageQueue
    MessageQueue -->|Event| NotificationService
    NotificationService -->|SMTP/SMS| Twilio

    LegalAidService -->|HTTPS| LegalAPI
    TranslationService -->|HTTPS| TranslateAPI

    %% Click Events for documentation
    click README "https://github.com/maithilis2403/system-analysis/blob/main/README.md"
    click PPT "https://github.com/maithilis2403/system-analysis/blob/main/ISA_Ppt-SOCHS.pptx"
    click Deliverables "https://github.com/maithilis2403/system-analysis/blob/main/Group2_SOCHS-Deliverables.pdf"
    click Charter "https://github.com/maithilis2403/system-analysis/blob/main/Group2_SOCHS-Project Charter.pdf"
    click Week11 "https://github.com/maithilis2403/system-analysis/blob/main/Group2_SOCHS-Week11-Project Deliverables.pdf"

    %% Styles
    classDef frontend fill:#D0E7FF,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#D5F5E3,stroke:#28a745,color:#155724;
    classDef datastore fill:#FDEBD0,stroke:#d35400,color:#7d6608;
    classDef external fill:#E5E7E9,stroke:#6c757d,color:#343a40;
    classDef docs fill:#F4ECF7,stroke:#8e44ad,color:#4a235a
```
