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).

---

⚙️ Backend (NestJS)

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

Access by default: http://localhost:8000

---

🌐 Frontend (Next.js)

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

Access by default: http://localhost:3001

---

🧩 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.

---

🚀 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://localhost:9090
• Grafana: http://localhost:3000

---

🔄 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.

---