BuildSphere - Full-Stack System Architecture

A highly modular architecture demonstrating clean frontend, backend, and database separation for institutional telemetry and reporting.

🏗 System Architecture

The application enforces strict separation of concerns, communicating exclusively over HTTP REST APIs.

graph TD
    subgraph Frontend [FRONTEND LAYER - Client Browser]
        A[index.html<br/>Authentication] -->|Redirect on Success| B(dashboard.html<br/>Main SPA)
        B -->|Fetch /api/*| C{Express Router}
        
        style A fill:#4c1d95,stroke:#a78bfa,color:#fff
        style B fill:#312e81,stroke:#818cf8,color:#fff
    end

    subgraph Backend [BACKEND LAYER - Node.js Express Server]
        C -->|POST / DELETE| D(server.js<br/>API Logic & Multer)
        C -->|GET| D
        D -->|Static Serve| Frontend
        
        style C fill:#065f46,stroke:#34d399,color:#fff
        style D fill:#064e3b,stroke:#10b981,color:#fff
    end

    subgraph Database [DATA PERSISTENCE LAYER]
        D -->|Read/Write JSON| E[(data.json<br/>Persistent Store)]
        D -->|Save Evidence| F[uploads/<br/>Physical Files]
        
        style E fill:#7c2d12,stroke:#f87171,color:#fff
        style F fill:#9a3412,stroke:#fb923c,color:#fff
    end

Loading

🛠 Tech Stack

• Frontend: Vanilla HTML/JS, Tailwind CSS (via CDN), GSAP 3 (Animations), SweetAlert2.
• Backend: Node.js, Express.js, Multer (for file uploads), CORS.
• Database: Local JSON Store (data.json) providing zero-dependency disk persistence.

🚀 Live Deployment

• Render Web Service: https://buildsphere-1.onrender.com

Note

Demo Access Credentials If you are reviewing this repository, you can log in to the authentication portal using the following test credentials:

• Username: faculty1
• Password: pass123

---

💻 Local Setup

Follow these 3 steps to boot the application locally. Since the backend serves the frontend statically, only one terminal is required.

1. Clone the Repository

   git clone https://github.com/CodeWithRJ006/buildsphere.git
   cd buildsphere/BACKEND

2. Install Dependencies

   npm install

3. Start the Server

   npm start

   The app will be available at http://localhost:3000.

---