lawprosystem - GitLite

KO | EN

gitlite — search

#animation #pdf #web #gpt #database #postgresql #react-native #anthropic #vue #c

lawprosystem

(★ 21)

A bilingual Laravel-based law firm management system for organizing cases, clients, schedules, and legal operations efficiently.

File Explorer

ZIP Download

Showing a partial file list — download the zip above to see everything.

- - Kernel.php
- - Handler.php
- - Helpers.php
  - LogActivity.php
  - MyFuncs.php
- - Kernel.php
- - AdvocateClient.php
  - AllTax.php
  - Appointment.php
  - Blog.php
  - CaseLog.php
  - CaseMember.php
  - CasePartiesInvolves.php
  - CaseStatus.php
  - CaseTransfer.php
  - CaseType.php
  - City.php
  - ClientPartiesInvoive.php
  - Country.php
  - Court.php
  - CourtCase.php
  - CourtType.php
  - Dump.php
  - Email.php
  - EmailTemplate.php
  - Expense.php
  - ExpenseCats.php
  - ExpensesItem.php
  - Faq.php
  - GeneralSettings.php
  - Invoice.php
  - InvoiceItem.php
  - InvoiceSetting.php
  - Judge.php
  - Mailsetup.php
  - Newsletter.php
  - Offer.php
  - OtpBlock.php
  - Package.php
  - Payment.php
  - PaymentMade.php
  - PaymentReceived.php
  - Permission.php
  - Role.php
  - Service.php
  - Setting.php
  - sqlBackup.php
  - State.php
  - Task.php
  - TaskMember.php
  - UserPasswordReset.php
  - Vendor.php
  - VerifyUser.php
- - AdminResetPassword.php
- - AppServiceProvider.php
  - AuthServiceProvider.php
  - BroadcastServiceProvider.php
  - EventServiceProvider.php
  - PermissionsServiceProvider.php
  - RouteServiceProvider.php
- - DatatablTrait.php
  - HasPermissionsTrait.php
- Admin.php
- User.php
- - bootstrap-iconpicker.min.css
.env.example
.gitignore
.htaccess
artisan
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Showing a partial file list.

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> A Web-Based Solution for Organizing and Managing Legal Practices
> **Developed by:** Ammar Al-Najjar — Full-Stack Software Engineer
>
> This system was designed and built end-to-end (architecture, backend, database, and UI) as an early freelance software engineering project. All code and technical decisions in this repository are my own work.

---

## 📘 Overview

**Law Pro** is a web-based legal management system tailored for law firms and independent lawyers. Designed to modernize traditional legal workflows, the platform provides an integrated solution for managing cases, clients, appointments, financial transactions, and administrative roles — all in one centralized dashboard.

This system enhances productivity, reduces errors, improves client service, and ensures secure and efficient handling of legal operations.

---

## 🎯 Key Features

### ✅ Case & Client Management
- Add, update, and track legal cases
- Secure client information storage and management
- Case filtering, searching, and status updates

### 🌐 Multilingual Support
- Full support for **Arabic 🇸🇦** and **English 🇺🇸**
- Dynamic language switching and RTL layout for Arabic

### 📅 Appointments & Scheduling
- Book and manage meetings, hearings, and consultations
- Calendar view with upcoming appointments

### 💼 Task & Workflow Automation
- Assign and monitor legal tasks
- Receive alerts for pending and urgent actions

### 💳 Financial Management
- Invoice generation and payment tracking
- Expense categorization and tax management
- Financial reporting module

### 🔐 Role-Based Access Control (RBAC)
- Distinct roles: Admin, Lawyer, Employee
- Custom permissions per role
- Secure login, session, and password management

### 📊 Reporting & Notifications
- Real-time dashboard with KPIs
- Alerts for upcoming hearings, deadlines, and urgent cases

---

## Screenshots

> *🔐 Login Interface:
The login interface provides users with secure access to the system through a clean and intuitive Arabic user interface. It includes fields for entering an email address and password, a password visibility toggle, and a “Forgot Password?” option for easy recovery. The interface supports multilingual access (Arabic and English) and aligns with modern UI principles to ensure usability across devices.*
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/735ff32a-15f5-4a9d-a29a-14dab2a8f8ee" />

> *📊 Dashboard Interface:
The dashboard provides a comprehensive overview of the system’s key metrics and real-time activity. Users are welcomed with interactive status cards summarizing archived, urgent, and total case counts, as well as client statistics. Below, users can view upcoming hearings, case statuses, and appointment details. A fully integrated calendar allows for visual tracking of schedules, making it easier to manage legal deadlines and meetings. The sidebar offers quick access to core modules, including clients, cases, tasks, members, roles, and settings — all within a clean, responsive layout that supports Arabic and English.*
><img width="1920" height="2683" alt="image" src="https://github.com/user-attachments/assets/972d9053-d15b-416a-9ce9-98ffb779ff8f" />
> <img width="1920" height="2578" alt="image" src="https://github.com/user-attachments/assets/c7f8d3db-bdb0-4b60-a6eb-b4ca2e7a12d2" />

> *👥 Client Management Interface:
This interface offers a centralized view of all clients within the system, allowing users to manage client records efficiently. Key client details such as name, contact number, case count, and status are displayed in a searchable and paginated table. Each entry includes quick actions — view, edit, or delete — via a dropdown menu, and a toggle switch for activating or deactivating client status. The layout supports intuitive navigation and bulk management, streamlining the onboarding and monitoring of client data for legal teams.*
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/70c44d7e-ab6e-4e06-8f35-bbc8b6183d0f" />

> *✅ Task Management Interface:
The Task Management module allows users to create, monitor, and control legal tasks associated with specific cases or internal operations. Each task entry displays key information including the task name, related case, assigned members, start and deadline dates, current status (e.g., In Progress, Deferred), and priority level (e.g., high, urgent). Users can edit or delete tasks using the actions dropdown, while the color-coded tags enhance clarity and quick recognition. This interface ensures organized workflows and efficient delegation of responsibilities within the firm.*
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/ef64ac3e-546d-4ad8-9674-4cec492c1044" />

> *📅 Appointment Management Interface:
This interface provides a clear and organized view of all scheduled client appointments. Users can filter appointments by date range, search by client name, and quickly scan essential details such as date, time, status, and contact information. Each entry includes an action menu for further interaction (e.g., view, edit, cancel). The interface ensures efficient planning and coordination of meetings, hearings, and consultations, helping legal professionals stay punctual and informed.*
> <img width="1920" height="1621" alt="image" src="https://github.com/user-attachments/assets/42740879-938a-4388-824c-bd0efe8295a0" />

> *🛡️ Role Management Interface:
The Role Management interface allows administrators to define and control user roles within the system. Each role—such as Admin, Lawyer, or Employee—can be managed from this centralized view. Through the actions dropdown, users can assign specific permissions, edit role details, or remove roles as needed. This interface supports fine-grained access control, ensuring users only interact with features relevant to their responsibilities, thus improving both security and operational clarity.*
> <img width="1920" height="1348" alt="image" src="https://github.com/user-attachments/assets/9205aa9b-214a-498e-8296-cc7d09445aba" />

> *🔐 Permissions Management Interface:
This interface enables administrators to assign fine-grained access control to different user roles. It presents a structured permissions matrix where menus and their submenus are listed alongside checkboxes for View, Add, Edit, and Delete actions. This modular permission system ensures that users only access the functionality relevant to their role, enhancing system security, data integrity, and operational focus. Changes can be saved or discarded with the provided action buttons.*
> <img width="1920" height="1816" alt="image" src="https://github.com/user-attachments/assets/440d7a99-5824-4506-97b8-a3f7768d303a" />

> *👤 Member Management Interface:
This interface allows administrators to view, manage, and organize system users. Each member entry displays essential details such as name, email, phone number, assigned role, and status. Admins can activate or deactivate users with a simple toggle and access additional actions (e.g., edit or delete) through a dropdown menu. This streamlined layout makes it easy to manage team members and ensure the right access for Admins, Lawyers, and Employees.*
> <img width="1920" height="1348" alt="image" src="https://github.com/user-attachments/assets/0e42fe17-c0b9-435a-8362-e81251cc291a" />

> *➕ Add Member Interface:
The Add Member interface is designed for creating new user accounts efficiently. It supports both English and Arabic languages and includes fields for all essential user information such as name, email, mobile number, address, password, and role assignment. The form features dropdowns for country, state, and city selection, and includes a profile picture uploader for personalization.
Built-in form validation ensures required fields are completed correctly, providing instant feedback to the user. The design is clean and responsive, supporting both LTR and RTL layouts to deliver a consistent experience for Arabic and English users.*
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/25353b5e-8fdb-44e6-a9da-85448041b6d8" />
> <img width="1920" height="1374" alt="image" src="https://github.com/user-attachments/assets/4eb9df86-e339-4620-9228-07364d3a0f67" />
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/7576a109-0a40-49b5-81db-53d26dd520ff" />
> <img width="1920" height="1239" alt="image" src="https://github.com/user-attachments/assets/29eda36d-098b-49a3-9906-0cad3d3d2aa4" />

> *⚙️ My Account Interface (Profile & Password Settings):
The My Account module allows users to update their personal information and manage password security. It includes two primary tabs:
Profile Tab: Enables users to update details like name, email, mobile number, registration number, address, and assigned role. The interface also allows users to upload or remove a profile picture, enhancing personalization within the system. Country, state, and city dropdowns ensure precise location settings.
Password Tab: Facilitates secure password changes by requiring the current password, a new password, and confirmation. Validation feedback is displayed in both English and Arabic, with real-time error prompts guiding users to complete the form correctly.
This interface is bilingual and designed with usability in mind, supporting accessibility, security, and a smooth user experience for all roles.*
> <img width="1920" height="1330" alt="image" src="https://github.com/user-attachments/assets/3c561f3a-94c6-410e-82a4-951653d2b3f6" />
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/531d9c3b-f2ef-4c3e-a4ae-ea268b0a283a" />
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/443042db-838f-4b60-8e39-9f530e184cd3" />
> <img width="1920" height="1312" alt="image" src="https://github.com/user-attachments/assets/7b5fd2f5-e0f3-4afc-8ff1-6128b59d8207" />

---

## 🛠️ Technologies Used

### Backend
- **PHP:** 7.1 – 7.3 (Laravel Framework 5.7)
- **Database:** MySQL 5.7
- **Caching & Queues:** Redis / File
- **Servers:** Nginx (Alpine) & Apache

### Frontend
- HTML5, CSS3 (Bootstrap & Custom RTL Support)
- JavaScript, jQuery, AJAX

### DevOps & Infrastructure
- **Containerization:** Docker & Docker Compose (Multi-container architecture: App, Web, DB, Redis, Queue Worker, phpMyAdmin)
- **Environment:** Linux (WSL2 / Ubuntu 22.04) & Windows (XAMPP)
- **Tools:** Visual Studio Code, Git, StarUML, Laravel Debugbar, PHPUnit

---

## 🔐 Security Features
- CSRF protection
- Password hashing (bcrypt)
- Session management
- Role-based access and permission control (RBAC)
- Sensitive data encryption
- Strict file permission handling across Linux and Windows environments

---

## 📁 Project Structure (Laravel)

```

app/            → Application logic (Controllers, Models, Helpers, Traits)
resources/views/→ Blade templates (UI & Bilingual Layouts)
routes/web.php  → Application routing
public/         → Public assets (CSS, JS, Uploads symlink)
database/       → Migrations, seeders
docker/         → Custom Docker configurations (PHP-FPM & Nginx)
config/         → Configuration files

```

---

## 📱 Future Enhancements
- 📱 Mobile App (Android/iOS)
- 📩 Email & Calendar Integration
- 🧠 AI-Based Legal Analytics
- 🗂️ Legal Document Uploads
- 💬 Internal Chat System
- 📊 Advanced Reporting Dashboard

---

## 👥 Demo User Credentials

The system includes four predefined user types for testing:

| Role        | Email                     | Password        |
|-------------|---------------------------|-----------------|
| Super Admin | superadmin@gmail.com      | @Super12345     |
| Admin       | admin@gmail.com           | @Admin12345     |
| Lawyer      | lawyer@gmail.com          | @Lawyer12345    |
| Employee    | employee@gmail.com        | @Employee12345  |

---

## 🚀 Getting Started

### Prerequisites
- **For Docker (Recommended):** Docker & Docker Compose installed on Linux / WSL2.
- **For Traditional Setup:** PHP (7.1 - 7.3), Composer v1, MySQL 5.7, and XAMPP (or any Apache server).

### Option A: Modern Deployment via Docker (Recommended)
This repository is fully dockerized with an isolated environment to prevent port conflicts.

```bash
# 1. Clone the repository
git clone [https://github.com/Ammar-1993/lawprosystem.git](https://github.com/Ammar-1993/lawprosystem.git)
cd lawprosystem

# 2. Build and start containers in detached mode
docker compose up -d --build

# 3. Install dependencies using Composer v1 inside the container
docker exec -it lawpro_app composer self-update --1
docker exec -it lawpro_app composer install

# 4. Setup environment and generate application key
cp .env.example .env
docker exec -it lawpro_app php artisan key:generate

# 5. Link storage and assets for Nginx rendering
docker exec -it lawpro_app php artisan storage:link
docker exec -it lawpro_app ln -sf /var/www/html/assets /var/www/html/public/assets

# 6. Set correct permissions for Linux environment
docker exec -it lawpro_app chown -R www-data:www-data storage bootstrap/cache public
docker exec -it lawpro_app chmod -R 775 storage bootstrap/cache

# 7. Import database (Assuming your SQL file is named backup.sql in the project root)
docker exec -i lawpro_db mysql -u root -proot lawpro_db < backup.sql

```

Access the application at: **http://localhost:8090**

Access database management (phpMyAdmin) at: **http://localhost:8091**

---

### Option B: Traditional Setup (XAMPP / Windows)

```bash
git clone [https://github.com/Ammar-1993/lawprosystem.git](https://github.com/Ammar-1993/lawprosystem.git)
cd lawprosystem
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve

```

Access the system at: **http://127.0.0.1/lawprosystem** or **http://localhost:8000**

---

## 🧪 Testing

* Feature testing using Laravel's built-in `PHPUnit`
* Real-time background queue testing via Docker isolated Redis workers
* Browser testing via Chrome DevTools
* Database validation through phpMyAdmin (both local and containerized)

---

## 🤝 Author

**Ammar Al-Najjar** — Full-Stack Software Engineer

Sole developer of this system's architecture, backend, database, and frontend.

* GitHub: https://github.com/Ammar-1993
* Portfolio: https://ammar1993.vercel.app/

---

## Contact Us

For any questions, feedback, or support, please contact:

**Ammar-1993**

* WhatsApp: [Click here](https://wa.me/967714294340)
* Gmail: [Click here](https://www.google.com/search?q=mailto%3Aammaralnggar%40gmail.com)

---

## 📄 License

This project is shared publicly as a portfolio piece. All rights reserved by the author. Feel free to explore the code for learning purposes; for commercial use or collaboration inquiries, please contact me directly via the channels above.

---