Skip to content

README.md

Latest commit

 

History

History
190 lines (133 loc) · 3.61 KB

README.md

File metadata and controls

190 lines (133 loc) · 3.61 KB
Raw

Gulf Coast HVAC & Supply

Gulf Coast HVAC & Supply is a full-stack PHP and MySQL e-commerce web application developed as part of a computer science course project. The application simulates an online HVAC supply store and includes user authentication, product management, shopping cart functionality, checkout processing, and informational business pages.

This project was designed to demonstrate practical experience with full-stack web development concepts including database integration, session management, Docker containerization, reusable PHP components, and responsive front-end design.

The application runs in a fully containerized Docker environment with PHP, MySQL, and phpMyAdmin services configured through Docker Compose.

Technologies Used

  • PHP
  • MySQL
  • Docker
  • Docker Compose
  • phpMyAdmin
  • Bootstrap 4
  • HTML5
  • CSS3
  • Git
  • GitHub

Skills Demonstrated

  • Full-stack web application development
  • PHP session management
  • MySQL database integration
  • Docker containerization
  • Responsive front-end development
  • CRUD operations
  • Authentication workflows
  • Reusable PHP components
  • Git and GitHub version control
  • Environment variable configuration

Features

  • User registration and login system
  • Session-based authentication
  • Dynamic navigation bar
  • Product catalog connected to MySQL database
  • Shopping cart functionality
  • Checkout workflow
  • About Us page
  • Contact page
  • Privacy Policy page
  • Reusable PHP includes for:
    • Header
    • Navigation bar
    • Footer
    • Scripts

Project Structure

gulf-coast-hvac-store/
│
├── database/
│   └── gulfcoasthvacstore.sql
│
├── screenshots/
│
├── src/
│   └── app/
│       ├── assets/
│       ├── auth/
│       ├── config/
│       ├── includes/
│       ├── index.php
│       ├── products.php
│       ├── cart.php
│       └── checkout.php
│
├── .env.example
├── .gitignore
├── docker-compose.yml
├── Dockerfile
├── LICENSE
└── README.md

Local Development Setup

1. Clone the Repository

git clone <repository-url>

2. Open the Project

Open the project folder in:

  • VS Code
  • WebStorm
  • IntelliJ IDEA
  • Or your preferred IDE

3. Start Docker Containers

docker compose up -d --build

4. Open the Application

Application URL:

http://localhost:8080/app/

phpMyAdmin URL:

http://localhost:8081/

Database Setup

The project uses MySQL running inside Docker.

A sanitized sample database file is included for local development:

/database/gulfcoasthvacstore.sql

Import the SQL file into phpMyAdmin or MySQL to initialize the database.

Screenshots

Homepage

Homepage

Products Page

Products

Shopping Cart Page

Shopping Cart

Checkout Page

Check Out

Register Page

Register

Login Page

Login

Future Improvements

Planned future enhancements include:

  • Password hashing and improved authentication security
  • Payment gateway integration
  • Order history tracking
  • Product search and filtering
  • Admin dashboard
  • Responsive mobile improvements
  • Deployment to a cloud hosting platform

Educational Purpose

This project was created for educational and portfolio purposes to demonstrate practical web development and database integration skills.

No real payment processing is implemented in this application.