Skip to content

MohammedMogeab/AgencyBusiness

Repository files navigation

Agency Business Management System

Agency Business PHP XAMPP License Branch

πŸ“‹ Project Overview

Agency Business Management System is a comprehensive web application designed to streamline and manage agency operations. This system provides a robust platform for handling various aspects of agency business management, with a focus on backend development and system architecture.

πŸš€ Features

  • User Authentication & Authorization
  • Project Management
  • Client Management
  • Task Tracking
  • Contact Management
  • Responsive Design
  • Secure Session Handling
  • Modern UI/UX
  • RESTful API Architecture
  • Database Management
  • File Upload System

πŸ› οΈ Technology Stack

  • Backend: PHP 8.4.2+
  • Server: Apache (XAMPP)
  • Database: MySQL
  • Frontend: HTML5, CSS3, JavaScript
  • Additional Tools:
    • Composer (Dependency Management)
    • Bootstrap (UI Framework)
    • Custom MVC Architecture
    • RESTful API Design

πŸ‘₯ Team Members

Development Team

Mohammed Ali
Backend Developer
Database Design
Mohammed Mogeab Ahmed Al-hajj
Backend Developer
System Architecture
Mobarak Asharf
Backend Developer
API Development

πŸ—οΈ Project Structure

C:.
β”‚   .gitignore
β”‚   bootstrap.php
β”‚   composer.json
β”‚   composer.lock
β”‚   config.php
β”‚   Database_web.1.1.1.sql
β”‚   README.md
β”‚   routes.php
β”‚   s
β”‚
β”œβ”€β”€β”€assets
β”‚   β”œβ”€β”€β”€css
β”‚   β”‚       about.css
β”‚   β”‚       base.css
β”‚   β”‚       contact.css
β”‚   β”‚       footer.css
β”‚   β”‚       header.css
β”‚   β”‚       home.css
β”‚   β”‚       projects.css
β”‚   β”‚
β”‚   └───images
β”‚           blog-1.jpg
β”‚           blog-2.jpg
β”‚           logo-light.svg
β”‚
β”œβ”€β”€β”€core
β”‚   β”‚   App.php
β”‚   β”‚   Authenticator.php
β”‚   β”‚   Container.php
β”‚   β”‚   Database.php
β”‚   β”‚   functions.php
β”‚   β”‚   Response.php
β”‚   β”‚   Router.php
β”‚   β”‚   session.php
β”‚   β”‚   ValidationException.php
β”‚   β”‚   validator.php
β”‚   β”‚
β”‚   └───middleware
β”‚           Authenticated.php
β”‚           Guest.php
β”‚           Middleware.php
β”‚
β”œβ”€β”€β”€database
β”œβ”€β”€β”€Http
β”‚   β”‚   new.txt
β”‚   β”‚
β”‚   └───Controllers
β”‚       β”‚   about.php
β”‚       β”‚   contact.php
β”‚       β”‚   index.php
β”‚       β”‚
β”‚       β”œβ”€β”€β”€blogs
β”‚       β”‚       show.php
β”‚       β”‚
β”‚       β”œβ”€β”€β”€ForgetPassword
β”‚       β”‚       create.php
β”‚       β”‚       store.php
β”‚       β”‚
β”‚       β”œβ”€β”€β”€manage
β”‚       β”‚       dashboard.php
β”‚       β”‚
β”‚       β”œβ”€β”€β”€project
β”‚       β”‚       create.php
β”‚       β”‚       show.php
β”‚       β”‚
β”‚       β”œβ”€β”€β”€projects
β”‚       β”‚       projects.php
β”‚       β”‚       store.php
β”‚       β”‚
β”‚       β”œβ”€β”€β”€registration
β”‚       β”‚       create.php
β”‚       β”‚       store.php
β”‚       β”‚
β”‚       └───sessions
β”‚               create.php
β”‚               destory.php
β”‚               store.php
β”‚
β”œβ”€β”€β”€public
β”‚   β”‚   .htaccess
β”‚   β”‚   check.php
β”‚   β”‚   index.php
β”‚   β”‚
β”‚   └───assets
β”‚       β”œβ”€β”€β”€css
β”‚       β”‚       about.css
β”‚       β”‚       base.css
β”‚       β”‚       contact.css
β”‚       β”‚       footer.css
β”‚       β”‚       header.css
β”‚       β”‚       home.css
β”‚       β”‚       projects.css
β”‚       β”‚
β”‚       └───images
β”‚               blog-1.jpg
β”‚               blog-2.jpg
β”‚               logo-light.svg
β”‚
β”œβ”€β”€β”€vendor
β”‚   β”‚   autoload.php
β”‚   β”‚
β”‚   β”œβ”€β”€β”€composer
β”‚   β”‚       autoload_classmap.php
β”‚   β”‚       autoload_namespaces.php
β”‚   β”‚       autoload_psr4.php
β”‚   β”‚       autoload_real.php
β”‚   β”‚       autoload_static.php
β”‚   β”‚       ClassLoader.php
β”‚   β”‚       installed.json
β”‚   β”‚       installed.php
β”‚   β”‚       InstalledVersions.php
β”‚   β”‚       LICENSE
β”‚   β”‚       platform_check.php
β”‚   β”‚
β”‚   └───phpmailer
β”‚       └───phpmailer
β”‚           β”‚   COMMITMENT
β”‚           β”‚   composer.json
β”‚           β”‚   get_oauth_token.php
β”‚           β”‚   LICENSE
β”‚           β”‚   README.md
β”‚           β”‚   SECURITY.md
β”‚           β”‚   SMTPUTF8.md
β”‚           β”‚   VERSION
β”‚           β”‚
β”‚           β”œβ”€β”€β”€language
β”‚           β”‚       phpmailer.lang-af.php
β”‚           β”‚       phpmailer.lang-ar.php
β”‚           β”‚       phpmailer.lang-as.php
β”‚           β”‚       phpmailer.lang-az.php
β”‚           β”‚       phpmailer.lang-ba.php
β”‚           β”‚       phpmailer.lang-be.php
β”‚           β”‚       phpmailer.lang-bg.php
β”‚           β”‚       phpmailer.lang-bn.php
β”‚           β”‚       phpmailer.lang-ca.php
β”‚           β”‚       phpmailer.lang-cs.php
β”‚           β”‚       phpmailer.lang-da.php
β”‚           β”‚       phpmailer.lang-de.php
β”‚           β”‚       phpmailer.lang-el.php
β”‚           β”‚       phpmailer.lang-eo.php
β”‚           β”‚       phpmailer.lang-es.php
β”‚           β”‚       phpmailer.lang-et.php
β”‚           β”‚       phpmailer.lang-fa.php
β”‚           β”‚       phpmailer.lang-fi.php
β”‚           β”‚       phpmailer.lang-fo.php
β”‚           β”‚       phpmailer.lang-fr.php
β”‚           β”‚       phpmailer.lang-gl.php
β”‚           β”‚       phpmailer.lang-he.php
β”‚           β”‚       phpmailer.lang-hi.php
β”‚           β”‚       phpmailer.lang-hr.php
β”‚           β”‚       phpmailer.lang-hu.php
β”‚           β”‚       phpmailer.lang-hy.php
β”‚           β”‚       phpmailer.lang-id.php
β”‚           β”‚       phpmailer.lang-it.php
β”‚           β”‚       phpmailer.lang-ja.php
β”‚           β”‚       phpmailer.lang-ka.php
β”‚           β”‚       phpmailer.lang-ko.php
β”‚           β”‚       phpmailer.lang-ku.php
β”‚           β”‚       phpmailer.lang-lt.php
β”‚           β”‚       phpmailer.lang-lv.php
β”‚           β”‚       phpmailer.lang-mg.php
β”‚           β”‚       phpmailer.lang-mn.php
β”‚           β”‚       phpmailer.lang-ms.php
β”‚           β”‚       phpmailer.lang-nb.php
β”‚           β”‚       phpmailer.lang-nl.php
β”‚           β”‚       phpmailer.lang-pl.php
β”‚           β”‚       phpmailer.lang-pt.php
β”‚           β”‚       phpmailer.lang-pt_br.php
β”‚           β”‚       phpmailer.lang-ro.php
β”‚           β”‚       phpmailer.lang-ru.php
β”‚           β”‚       phpmailer.lang-si.php
β”‚           β”‚       phpmailer.lang-sk.php
β”‚           β”‚       phpmailer.lang-sl.php
β”‚           β”‚       phpmailer.lang-sr.php
β”‚           β”‚       phpmailer.lang-sr_latn.php
β”‚           β”‚       phpmailer.lang-sv.php
β”‚           β”‚       phpmailer.lang-tl.php
β”‚           β”‚       phpmailer.lang-tr.php
β”‚           β”‚       phpmailer.lang-uk.php
β”‚           β”‚       phpmailer.lang-ur.php
β”‚           β”‚       phpmailer.lang-vi.php
β”‚           β”‚       phpmailer.lang-zh.php
β”‚           β”‚       phpmailer.lang-zh_cn.php
β”‚           β”‚
β”‚           └───src
β”‚                   DSNConfigurator.php
β”‚                   Exception.php
β”‚                   OAuth.php
β”‚                   OAuthTokenProvider.php
β”‚                   PHPMailer.php
β”‚                   POP3.php
β”‚                   SMTP.php
β”‚
└───views
    β”‚   403.php
    β”‚   404.php
    β”‚   about.view.php
    β”‚   contact.view.php
    β”‚   index.view.php
    β”‚   projects.view.php
    β”‚
    β”œβ”€β”€β”€assets
    β”‚   β”œβ”€β”€β”€css
    β”‚   β”‚       about.css
    β”‚   β”‚       base.css
    β”‚   β”‚       contact.css
    β”‚   β”‚       footer.css
    β”‚   β”‚       header.css
    β”‚   β”‚       home.css
    β”‚   β”‚       style.css
    β”‚   └───images
    β”‚           blog-1.jpg
    β”‚           blog-2.jpg
    β”‚           logo-light.svg
    β”‚
    β”œβ”€β”€β”€blogs
    β”‚       blog.php
    β”‚
    β”œβ”€β”€β”€ForgetPassword
    β”‚
    β”‚       dashboard.view.php
    β”‚
    β”œβ”€β”€β”€partials
    β”‚       footer.php
    β”‚       header.php
    β”‚
    β”œβ”€β”€β”€project
    β”‚       create.view.php
    β”‚       new.txt
    β”‚       show.view.php
    β”‚
    β”œβ”€β”€β”€projects
    β”œβ”€β”€β”€registration
    β”‚       create.view.php
    β”‚
    └───session
            create.view.php

πŸš€ Getting Started

Prerequisites

  • XAMPP (PHP 8.4.2+)
  • MySQL
  • Composer (for dependency management)

XAMPP Configuration

  1. Open XAMPP Control Panel
  2. Click on "Config" button next to Apache
  3. Select "Apache (httpd.conf)"
  4. Find and modify these lines:
    DocumentRoot "C:/xampp/htdocs/AgencyBusiness/public"
    <Directory "C:/xampp/htdocs/AgencyBusiness/public">
  5. Save the file
  6. Restart Apache in XAMPP Control Panel

Installation

  1. Clone the repository:

    git clone [repository-url]
  2. Navigate to project directory:

    cd AgencyBusiness
  3. Switch to main branch (if not already on it):

    git checkout main
  4. Configure your database in config.php

  5. Start XAMPP and ensure Apache and MySQL are running

  6. Access the application:

    http://localhost/
    

πŸ”’ Security

  • All user inputs are validated and sanitized
  • Password hashing implemented
  • Session security measures in place
  • CSRF protection enabled
  • XSS prevention measures
  • SQL Injection prevention
  • Secure API endpoints

πŸ“ License

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

🀝 Contributing

  1. Always work on the main branch
  2. Pull the latest changes before starting work:
    git pull origin main
  3. Make your changes
  4. Test thoroughly
  5. Commit your changes:
    git commit -m 'Description of changes'
  6. Push to main:
    git push origin main

πŸ“ž Contact

For any queries or support, please contact the development team.


Made with ❀️ by the Agency Business Team

Releases

No releases published

Packages

 
 
 

Contributors