@@ -1,140 +1,63 @@
-
 # Secure File System (SFS)
 
-This repository contains a Django + DRF backend for a Secure File System and a minimal frontend using Bootstrap and Axios.
+A Django + Django REST Framework backend for encrypted file storage, with a
+small template-based frontend (Bootstrap + Axios) served by Django. Users
+register, log in with JWT, and upload files that are encrypted at rest;
+each operation is recorded in an activity log. The repository also contains
+an experimental React/Vite client prototype at the root (`App.tsx`,
+`services/`), which is separate from the Django app.
 
 ## Features
 
-- User registration + JWT authentication (djangorestframework-simplejwt)
-- AES-256 encrypted files, RSA-2048 per-user key pairs, HMAC-SHA256 integrity
-- Upload / download / delete files
-- Local, Firebase and S3 storage options (local implemented)
-- Activity logs
+- User registration and JWT authentication (djangorestframework-simplejwt)
+- AES-256 file encryption, RSA-2048 per-user key pairs, HMAC-SHA256 integrity checks
+- Upload, download, and delete endpoints (`/api/files/`)
+- Local storage implemented; Firebase and S3 hooks included but not wired up
+- Activity logging of file and auth operations
 
-## Quick setup (development)
+## Setup
 
-1. Create virtual environment and activate
+Requires Python 3. From the repository root:
 
-```powershell
+```bash
 python -m venv venv
-.\venv\Scripts\Activate.ps1
-```
-
-2. Install backend dependencies
-
-```powershell
+source venv/bin/activate        # Windows: .\venv\Scripts\Activate.ps1
 pip install -r backend/requirements.txt
 ```
 
-3. Setup env
+Configuration is read from environment variables (optionally via a `.env`
+file next to `manage.py`): `DJANGO_SECRET_KEY`, `DJANGO_DEBUG`,
+`DJANGO_ALLOWED_HOSTS`, and `POSTGRES_*` for PostgreSQL. Defaults use
+SQLite with debug on, so no configuration is needed for development.
 
-```powershell
-copy backend/sfs_backend/.env.example backend/sfs_backend/.env
-# edit .env if needed
-```
-
-4. Apply migrations and create superuser
-
-```powershell
-cd backend/sfs_backend
+```bash
+cd backend/backend/sfs_backend
 python manage.py migrate
 python manage.py createsuperuser
-```
-
-5. Run server
-
-```powershell
 python manage.py runserver
 ```
 
-Access:
+Then open:
 
 - API root: http://127.0.0.1:8000/api/
 - Frontend: http://127.0.0.1:8000/login.html
 - Admin: http://127.0.0.1:8000/admin/
 
-## Production notes
-
-- Set `DJANGO_DEBUG=False` and configure `POSTGRES_*` env vars for PostgreSQL
-- Use a secure `DJANGO_SECRET_KEY` and handle FILE master key
-- Configure proper CORS origins
-- Serve static files with WhiteNoise or from a CDN
-
-## Project layout
-
-(see project description in your IDE)
-
 ## Tests
 
-Run tests with
-
-```powershell
-cd backend/sfs_backend
+```bash
+cd backend/backend/sfs_backend
 python manage.py test
 ```
 
+## Production notes
 
-### Information Security Project – 3rd Semester  
-**Under the supervision of Sir Khalid Mehmood**
-
----
-
-## 👥 Project Team
-- **Moavia Amir**
-- **Mirza Muhammad Dawood**
-- **Arslan Nasir**
-- **Ali Raza**
-
----
-
-## 📌 Project Overview
-
-**SFS (Secure File System)** is a professional-grade, zero-knowledge encrypted file storage and sharing platform developed as part of the **Information Security course (3rd Semester)**.
-
-The system utilizes the browser’s native **WebCrypto API** to perform **client-side encryption**, ensuring that all data is encrypted before being transmitted or stored. At no point are plaintext files or private cryptographic keys exposed to the server.
-
----
-
-## 🚀 Deployment Guide
-
-### 1. Prepare GitHub Repository
-- Initialize the repository:
-  ```bash
-  git init
-  ```
-
-### 2. Vercel Deployment (Recommended)
-- Connect the GitHub repository to **Vercel**
-- Set the environment variable `API_KEY` with your **Google AI Studio API key**
-- The project auto-configures using the included `vercel.json`
-
-### 3. Netlify Deployment
-- Connect the GitHub repository to **Netlify**
-- Set the `API_KEY` in **Site Settings → Environment Variables**
-- Routing and security headers are managed using `netlify.toml` and `_redirects`
-
----
-
-## 🛡️ Security Specifications
-- **Symmetric Encryption**: AES-256-GCM (file content encryption)
-- **Asymmetric Encryption**: RSA-2048-OAEP (secure key wrapping)
-- **Hash Algorithm**: SHA-256 (data integrity verification)
-- **Zero-Knowledge Architecture**:
-  - No plaintext files stored
-  - No private keys transmitted
-  - No sensitive data exposed on the server
-
----
-
-## 🛠️ Key Features
-- **Identity Provisioning**: Automatic RSA key-pair generation during user registration
-- **Secure File Sharing**: RSA-based key re-encryption for authorized recipients
-- **Neural Security Logic**: Gemini-3-Flash integration for cryptographic analysis
-- **Immutable Audit Logging**: Real-time logging of security-sensitive operations
-
----
-
+- Set `DJANGO_DEBUG=False` and the `POSTGRES_*` variables for PostgreSQL
+- Use a strong `DJANGO_SECRET_KEY` and protect the file master key
+- Restrict CORS origins and serve static files with WhiteNoise or a CDN
 
-© 2025 **Coding Moves – Engineering Branch**  
-Developed for academic purposes under the **Information Security curriculum**.
+## Credits
 
+Information Security course project, 3rd semester, under the supervision of
+Sir Khalid Mehmood. Team: Moavia Amir, Mirza Muhammad Dawood, Arslan Nasir,
+Ali Raza. Coding Moves, Engineering Branch, 2025.