File Management System

A comprehensive Laravel-based collaborative file management system that enables users to organize files into groups, manage permissions, and track activities with detailed reporting.

🚀 Features

Core Functionality

• User Authentication & Authorization - Secure login/registration with Laravel Breeze
• Group-Based Organization - Create and manage file groups with multiple users
• File Upload & Management - Upload, download, edit, and delete files
• Permission Control - File-level permissions and ownership management
• Activity Reporting - Comprehensive audit trail of all file operations
• File Size Limits - Configurable file size restrictions per group
• File Count Limits - Set maximum number of files per group

Advanced Features

• Bulk Operations - Select and update multiple files simultaneously
• File Status Tracking - Track file processing status (active/completed)
• User Management - Add/remove users from groups
• Responsive Design - Modern UI built with Tailwind CSS
• PDF Generation - Generate reports using Laravel DomPDF

🛠️ Technology Stack

• Laravel 10 - PHP web framework
• PHP 8.1+ - Server-side programming language
• MySQL - Database management system
• Tailwind CSS - Utility-first CSS framework
• Laravel Breeze - Authentication scaffolding
• Laravel Sanctum - API authentication
• Laravel DomPDF - PDF generation
• Vite - Frontend build tool

📋 Prerequisites

• PHP 8.1 or higher
• Composer
• Node.js & NPM
• MySQL Database
• Web server (Apache/Nginx) or Laravel Valet

🚀 Installation

1. Clone the Repository

git clone <repository-url>
cd FileManagment

2. Install Dependencies

# Install PHP dependencies
composer install

# Install Node.js dependencies
npm install

3. Environment Setup

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

4. Database Configuration

Update your .env file with database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=file_management
DB_USERNAME=your_username
DB_PASSWORD=your_password

5. Run Migrations

php artisan migrate

6. Build Assets

npm run build

7. Start Development Server

php artisan serve

Visit http://localhost:8000 to access the application.

📁 Project Structure

FileManagment/
├── app/
│   ├── Http/Controllers/     # Application controllers
│   │   ├── Auth/            # Authentication controllers
│   │   ├── FileController.php
│   │   ├── GroupController.php
│   │   ├── ProfileController.php
│   │   └── ReportController.php
│   ├── Models/              # Eloquent models
│   │   ├── File.php
│   │   ├── Group.php
│   │   ├── Report.php
│   │   └── User.php
│   └── Policies/            # Authorization policies
├── database/
│   ├── migrations/          # Database migrations
│   ├── factories/          # Model factories
│   └── seeders/            # Database seeders
├── resources/
│   ├── views/              # Blade templates
│   │   ├── auth/          # Authentication views
│   │   ├── files/         # File management views
│   │   ├── groups/        # Group management views
│   │   └── layouts/       # Layout templates
│   ├── css/               # Stylesheets
│   └── js/                # JavaScript files
└── public/
    └── uploads/           # File storage directory

🔧 Usage

Creating Groups

1. Register/Login to your account
2. Navigate to Groups section
3. Click "Create Group"
4. Set group name, file count limit, and file size limit
5. Add users to the group by email

Managing Files

1. Select a group from the Groups list
2. Upload files using the "Add File" button
3. Edit file details (only files you own)
4. Mark files as completed when done
5. Delete files when no longer needed

Viewing Reports

1. Access the Reports section
2. View activity logs for each group
3. Track file operations and user activities

🧪 Testing

Run the test suite:

php artisan test

📊 Database Schema

Users Table

• id, name, email, email_verified_at, password, remember_token, created_at, updated_at

Groups Table

• id, name, user_id_creater, files_count, file_size, created_at, updated_at

Files Table

• id, name, status, path, group_id, created_at, updated_at

Reports Table

• id, group_id, message, created_at, updated_at

Group-User Pivot Table

• group_id, user_id

🔒 Security Features

• CSRF Protection - All forms protected against CSRF attacks
• File Validation - Uploaded files are validated for type and size
• Permission Checks - Users can only modify files they own
• SQL Injection Prevention - Using Eloquent ORM and prepared statements
• XSS Protection - Output escaping in Blade templates

📝 API Endpoints

The application provides RESTful API endpoints for:

• Authentication: /api/login, /api/register, /api/logout
• Groups: /api/groups (GET, POST, PUT, DELETE)
• Files: /api/files (GET, POST, PUT, DELETE)
• Reports: /api/reports (GET)

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎯 Roadmap

• File versioning system
• Advanced search functionality
• File sharing via public links
• Real-time notifications
• Mobile application
• Cloud storage integration
• Advanced reporting dashboard