Skip to content

v1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@khaledsAlshibani khaledsAlshibani released this 02 Feb 08:21
· 3 commits to main since this release
InitialRelease
aed3987

Complaints and Suggestions Web App v1.0 - "Inaugural Echo"

Overview

Welcome to the Complaints and Suggestions Web App, version 1.0, affectionately named "Inaugural Echo". This application is designed as a robust CRUD (Create, Read, Update, Delete) platform, employing PHP for the backend, MySQLi for seamless database interactions, and Bootstrap 5.3.2 for an aesthetically pleasing and responsive frontend. The codebase prioritizes clarity, with comprehensive comments for easy comprehension and customization.

Key Technologies

  • Frontend: HTML, Bootstrap 5.3.2
  • Backend: PHP, MySQLi, MySQL Database

Features

  • Structured Codebase: The code is not only functional but also well-organized and extensively commented, utilizing MySQLi for enhanced efficiency and transparency.
  • Authentication App: A robust login system caters to two user types: admin and regular users.
  • Error Logs: Comprehensive error logging is implemented in the error.log file for streamlined debugging.

Disadvantages

  1. Monolithic Configuration and Operations File:

    • The codebase currently relies on a single file handling both configuration and PHP operations/functions, potentially leading to maintenance challenges and decreased modularity.

  2. Fixed and Non-Dynamic Paths:

    • The application uses fixed paths instead of dynamically generating them, limiting flexibility.

  3. Primitive and Poor File Structure:

    • The current file structure is considered primitive and suboptimal, hindering scalability and making it challenging for developers to navigate and contribute effectively.

  4. Insecure Password Handling:

    • Passwords are stored in the database without proper hashing, posing a security risk. Future releases should implement secure password storage practices.

  5. No Create Account Form:

    • Users can only be manually created through phpMyAdmin or SQL terminal commands.

User Capabilities

  • Feedback Submission: Users can effortlessly submit complaints or suggestions.
  • Feedback Management: An intuitive interface empowers users to view, update, and delete their submitted feedback.

User Dashboard

Admin Capabilities

  • Feedback Review: Admins can provide feedback on all complaints or suggestions submitted by users.
  • Comprehensive Dashboard: Admins have access to an overview of all feedback, ensuring efficient management.
  • Feedback Administration: Admins have complete control to update feedback content or remove entries.

Admin Dashboard

Installation

  1. Clone the Repository:

    git clone https://github.com/khaledsAlshibani/simple-feedback-webapp.git

  2. Import the Database:

    • Navigate to the assets > db folder and locate the complaints_suggestions_db.sql file.
    • Create a MySQL database using your preferred method, such as phpMyAdmin for localhost installations.
    • Import the database file into the created database.

Login Credentials

Admin:

  • Username: Admin
  • Password: admin123

Users:

  1. Username: Ahmed

    • Password: ahmed123

  2. Username: Mohammed

    • Password: mohammed2123
Assets 2
Loading