https://github.com/radanpro/taif-python

https://github.com/radanpro/taif-python

Last synced: 23 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/radanpro/taif-python
• Owner: radanpro
• Created: 2025-01-09T16:40:35.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-02-22T23:46:11.000Z (2 months ago)
• Last Synced: 2025-02-23T00:36:07.315Z (2 months ago)
• Language: Python
• Size: 260 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Taif Al-Salmi

Taif Al-Salmi is a Windows desktop application designed to manage various services, including passport issuance, visa processing, and ticket reservations. This project is implemented in Python, using a modular structure for easy maintenance and scalability.

---

## Features

- **Passport Services:**

  - Application for new passports

  - Renewal of existing passports

- **Visa Services:**

  - Umrah visa processing

  - Work visa management

  - Tourist and visit visa services

- **Ticket Reservations:**

  - Booking buses, cars, and flights

- **Reports Generation:**

  - Export data in PDF and Excel formats

---

## Project Structure

````

---

## Prerequisites

- **Python 3.8+**

- **pip** (Python package manager)

---

## Installation

1. Clone the repository:

   ```bash

   git clone https://github.com/radanpro/taif-python.git

   cd taif-python

````

2. Create a virtual environment:

   ```bash

   python -m venv venv

   source venv/bin/activate   # Linux/Mac

   venv\Scripts\activate      # Windows

   ```

3. Install dependencies:

   ```bash

   pip install -r requirements.txt

   ```

---

## Usage

1. Run the application:

   ```bash

   python main.py

   ```

2. Navigate through the UI to access different services:

   - Home Screen

   - Passport Services

   - Visa Services

   - Ticket Reservations

3. Generate reports in PDF or Excel format from the respective screens.

---

## Dependencies

- **Tkinter** or **PyQt5**: For building the user interface

- **SQLite3**: For database management

- **ReportLab**: For generating PDF reports

- **OpenPyXL**: For exporting Excel files

---

## License

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