Distributed PDF System (DPS)

A decentralized, peer-coordinated PDF sharing and storage system — inspired by Napster.

Innopolis University S25 System and Network administration

---

🚧 Tech Stack Overview

🖥️ Frontend

🛠️ Backend

---

⚙️ Deployment & Monitoring

---

🧭 Overview

The Distributed PDF System (DPS) is a full-stack project designed to provide scalable, distributed storage, sharing, and retrieval of PDF documents. It consists of:

• Backend — NestJS REST API with user and file management
• Frontend — Next.js web interface for users
• Sharding Node — Java-based service for file chunking/storage (Coming Soon)
• Reverse Proxy & Monitoring — NGINX, Prometheus, and Grafana

This system was developed as part of the System & Network Administration course at Innopolis University (S25).

---

🏗️ System Architecture

                   ┌────────────┐
                   │  Frontend  │  ← Next.js Web UI
                   └─────┬──────┘
                         │ HTTP
                         ▼
                   ┌────────────┐
                   │   NGINX    │  ← Reverse Proxy (routes requests to Backend, Frontend, Sharding)
                   └─────┬──────┘
                         │
         ┌───────────────┬───────────────┐
         ▼               ▼               ▼
  ┌────────────┐  ┌────────────┐  ┌──────────────┐
  │  Backend   │  │  Frontend  │  │ Sharding Node│  ← Java microservices (Coming Soon)
  └─────┬──────┘  └────────────┘  └──────────────┘
        │
        ▼
  File Storage
        │
        ▼
  ┌────────────┐
  │ Prometheus │  ← Metrics scraping
  └─────┬──────┘
        │
        ▼
  ┌────────────┐
  │  Grafana   │  ← Visualization Dashboard
  └────────────┘

---

📂 Project Structure

dps/
├── backend/            # NestJS backend server
├── frontend/           # Next.js frontend client
├── sharding/           # Java-based sharding node (Coming Soon)
├── watchproxy/         # NGINX config, Prometheus & Grafana
├── .github/            # CI/CD workflows
├── README.md           # ← you're here

---

⚙️ Backend (NestJS)

Located in: dps/backend

Features

• User authentication via JWT & local strategies
• File & chunk upload, update, delete
• Node registration (for storage nodes)
• Dockerized & container-ready

Getting Started

1. Copy .env.example to .env and fill in your environment variables before starting.

cd backend
pnpm install

# Start in dev mode
pnpm run start:dev

# Start in prod
pnpm run start:prod

API Docs

Visit: http://45.156.22.249/docs — auto-generated Swagger UI proxied via NGINX

---

🌐 Frontend (Next.js)

Located in: dps/frontend

Features

• Upload and manage PDF files
• Browse stored documents
• Modern interface using Next.js App Router

Getting Started

1. Copy .env.example to .env and configure environment variables.

cd frontend
pnpm install
pnpm dev

Open http://45.156.22.249 for production or http://localhost:3000 in development.

---

🧩 Sharding Node (Java)

Coming Soon...

---

🔒 Authentication

The backend implements:

• Local Strategy (username + password)
• JWT Token issuance
• Guards for authenticated routes

See /auth/ folder in backend for strategy and guards.

---

🧪 Testing

Backend:

# Unit tests
pnpm run test

# E2E tests
pnpm run test:e2e

# Coverage
pnpm run test:cov

Frontend:

# If test setup exists:
pnpm run test

---

🚀 Deployment

Backend, Sharding Node, and Proxy are containerized.

To deploy everything with Docker Compose:

# For backend
cd backend
docker-compose up --build

# For sharding
cd sharding
docker compose up

# For nginx/prometheus/grafana
cd watchproxy
docker-compose up --build

---

📊 Monitoring

• Prometheus: http://45.156.22.249/prometheus
• Grafana: http://45.156.22.249/grafana

---

🔄 CI/CD

GitHub Actions:

• .github/workflows/ci.yml: Build & test
• .github/workflows/cd.yml: Deployment pipeline

---

📜 License

• Backend/Frontend: MIT License — see LICENSE
• Sharding node: BSD — see LICENSE-BSD

---

📮 Maintainers

Developed at Innopolis University as part of the S25 System & Network Administration course.

---