Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/khushijtrivedi/shipmnt-task1

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/khushijtrivedi/shipmnt-task1
Owner: khushijtrivedi
Created: 2024-08-23T15:14:46.000Z (5 months ago)
Default Branch: main
Last Pushed: 2024-08-23T16:49:27.000Z (5 months ago)
Last Synced: 2024-08-24T17:26:56.646Z (5 months ago)
Language: Python
Homepage: https://shipmnt-task1-556q8ao2i-khushi-trivedis-projects.vercel.app/
Size: 52.3 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

## Local Database Setup

When deploying the application, you might encounter issues with local database connections. Below are screenshots demonstrating the local setup and how it looks when it's functioning properly.

### How It Works Locally

The following screenshot shows how the database setup appears when running the application locally:

![Application in Local Environment](static/data_uploaded.png)

The following screenshot shows the database entry in mysql workbench:

![Application in Local Environment](static/database.png)

The following screenshot shows how upload web page looks like:

![Application in Local Environment](static/upload_page.png)

The following screenshot shows how upload web page looks like when selecting any file to upload:

![Application in Local Environment](static/upload_option.png)

The following screenshot shows how data viewing web page looks like:

![Application in Local Environment](static/view_data.png)

# Data Upload and Review Application

This is a Flask-based web application that allows users to upload Excel files, review the uploaded data in a table format, and confirm or cancel the data upload. It uses MySQL as the database to store the data.

## Features

- **Upload Excel File**: Allows users to upload Excel files (.xls or .xlsx).
- **Review Data**: Displays the contents of the uploaded file in a table for review.
- **Confirm and Save**: Saves the reviewed data to a MySQL database upon confirmation.
- **Error Handling**: Provides feedback on errors during file processing and data insertion.

## Technologies Used

- **Frontend**: HTML, Bootstrap 4
- **Backend**: Flask (Python)
- **Database**: MySQL
- **Libraries**: `pandas`, `mysql-connector-python`

## Setup

### Prerequisites

- Python 3.x
- MySQL server

### Installation

1. Clone the repository:
```bash
git clone https://github.com/your-username/your-repository.git
cd your-repository
```

2. Create and activate a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```

3. Install dependencies:
```bash
pip install -r requirements.txt
```

4. Configure MySQL:
- Create a MySQL database named `shipmnt`.
- Ensure the `Author` and `Book` tables exist with appropriate schemas.

5. Run the Flask application:
```bash
python app.py
```

6. Navigate to `http://127.0.0.1:5000/` in your web browser to access the application.

## File Structure

- `app.py`: Main Flask application file.
- `templates/upload.html`: HTML file for uploading Excel files.
- `templates/view.html`: HTML file for reviewing uploaded data.
- `requirements.txt`: List of Python dependencies.

## Contributing

Feel free to submit issues or pull requests if you have any suggestions or improvements.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.