Skip to content

theoria-lab/SecureVault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

32 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” SecureVault

A DRM & software-licensing platform β€” sell digital products protected by hardware-bound license keys, with a full marketplace, seller tooling, payments, and an administrative control plane.

FastAPI Next.js React PostgreSQL SQLAlchemy Razorpay Docker License

πŸ”— Live Demo Β Β·Β  hosted free-tier β€” the API may take ~30s to wake on first load

Proprietary & source-available. This repository is published for demonstration and evaluation only. It is not open source β€” see LICENSE. Please do not copy, reuse, or redistribute.


Overview

SecureVault lets creators distribute software and digital assets under license. Every product is issued as an encrypted artifact unlocked by a hardware-bound license key with enforced usage limits.

It ships with a buyer marketplace, a seller dashboard, a payments pipeline, fraud monitoring, and a full admin console. Developed as a collaborative project, it emphasizes security, auditability, and seller control.

πŸš€ Quick Start

  1. Clone the repo: git clone https://github.com/theoria-lab/SecureVault/
  2. Environment: Create a .env file using .env.example from backend.
  3. Backend: Navigate to /backend, install requirements, and run uvicorn main:app --reload.
  4. Frontend: Navigate to /frontend, install packages with npm install, and run npm run dev.
  5. Database: Ensure Docker is running for the PostgreSQL container.

Features

πŸ›’ Buyer marketplace

  • Browse, search, filter, and sort licensed products.
  • Purchase licenses through a secure Razorpay checkout.
  • Personal library of owned keys with remaining-use tracking.

πŸ“¦ Seller dashboard

  • Register products with metadata, integrity hashes, and a real file upload.
  • Prepaid key-credit packs in tiered bundles β€” Starter (5 keys) and Value (12 keys, 2 free).
  • Live sales, credit balance, and listing management.

πŸ›‘οΈ Admin control plane

  • User management with suspend / reactivate.
  • Live-editable commission brackets and a per-transaction commission ledger for auditing platform revenue.
  • License dispute lookup with a complete, time-ordered audit trail.
  • Full oversight of every listing and issued key, with seller attribution.

πŸ‘₯ Development Team

  • [Tushar Aggarwal] β€” Backend Infrastructure & Encryption Logic Architect
  • [Devyanshu Rathore] β€” Frontend Architecture & UI/UX Development
  • [Tushar Sharma] β€” Backend API Development & Database Integration

πŸ”‘ Licensing & security

  • Hardware-bound license keys with per-key decrypt limits.
  • JWT access/refresh authentication (refresh tokens as httpOnly cookies).
  • Admin 2FA (TOTP), shorter admin sessions, and stricter admin rate limiting.
  • Login rate limiting and a shared, typed error contract.

πŸ’³ Payments

  • Razorpay order creation plus HMAC-verified webhooks with idempotent, row-locked fulfillment.

πŸ€– Fraud monitoring

  • Anomaly detection on license-verification behavior (IsolationForest) with a threshold fallback.

🀝 Collaboration & Contributions

This is a collaborative project. Please follow these guidelines:

  • Branching: Use feature/ or fix/ prefixes for all new work.
  • Pull Requests: All PRs require review from at least one other team member before merging.
  • Commits: Follow semantic commit messages (e.g., feat: add TOTP 2FA or fix: resolve payment webhook bug).

Tech stack

Layer Technologies
Backend Python, FastAPI, SQLAlchemy, Alembic, Pydantic
Database PostgreSQL
Frontend Next.js, React
Auth JWT, TOTP (2FA), bcrypt
Payments Razorpay
ML scikit-learn
Infra & Deploy Docker Β· Render (API) Β· Neon (Postgres) Β· Vercel (web)

Architecture

A FastAPI service exposes a typed, versioned API (auth, seller, buyer, licensing, payments, admin) backed by PostgreSQL with Alembic-managed migrations. A Next.js frontend delivers the buyer, seller, and admin experiences. Payments run through Razorpay with webhook-driven fulfillment, and a storage abstraction keeps the encrypted artifacts behind a clean seam. It runs locally with a single Docker Compose command and is deployed on a free-tier cloud stack (Render + Neon + Vercel).

Status

Live in production. The web platform β€” marketplace, seller and admin consoles, payments, license issuance + verification, and fraud monitoring β€” is deployed and functional.

Roadmap

  • Production-grade AES-GCM encryption.
  • Desktop decryptor client for license unlocking.
  • Advanced analytics for seller dashboards.

Β© 2026 Theoria Labs β€” All rights reserved.

About

DRM & software-licensing platform: marketplace, seller tooling, Razorpay payments, hardware-bound license keys, and an admin control plane. FastAPI + Next.js.

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors