This is a Python-based desktop application designed to generate sales summary reports for multiple sites by connecting to a SQL Server database. The app uses Tkinter for the GUI, supports parallel processing for faster report generation, and allows exporting reports as .zip
files containing individual .txt
files for each site.
- Database Connectivity: Connects to SQL Server databases using customizable IP addresses or server series (
10.16.x.x
or10.28.x.x
). π - Multi-Site Support: Generate reports for multiple sites via manual input or bulk upload (Excel, CSV, or text files). π
- Customizable Date Range: Select a date range for generating sales transaction summaries. π
- Parallel Processing: Processes multiple sites in parallel for faster report generation. β‘
- Export Reports: Automatically saves reports as
.zip
files containing.txt
files for each site. π₯ - Live Logs: Real-time logging of application activity for better transparency. π
- Error Handling: Gracefully handles connection errors and invalid inputs with clear error messages. ββ‘οΈβ
D π‘ E π M π― O π
Apollo.Sales.Report.mp4
Before running the application, ensure you have the following installed:
- Python 3.7+ π
- Required Python packages:
tkinter
tkcalendar
pyodbc
pandas
openpyxl
(for Excel file support)concurrent.futures
(built-in)
- ODBC Driver 17 for SQL Server π₯οΈ
- Access to the SQL Server database with valid credentials π
Install dependencies using the following command:
pip install pyodbc pandas openpyxl tkcalendar
- Clone the repository to your local machine:
git clone https://github.com/akashsg247777/Apollo-Sqles-Report.git
- Navigate to the project directory:
cd sales-summary-report-generator
- Install the required dependencies:
pip install -r requirements.txt
- Run the application:
python main.py
Step-by-Step Guide:
- Launch the Application : Run the script, and the GUI will appear. π₯οΈ
- Enter Database Credentials :
- Provide the username, password, and database name. π οΈ
- Optionally, enter a custom IP address for manual overrides. π
- Select Site IDs :
- Manually input a single site ID or upload a file containing multiple site IDs. π
- Set Date Range :
- Use the calendar widget to select the "From Date" and "To Date". π 5 Generate Reports :
- Click the "Generate Report" button to start processing. βοΈ
- Monitor the live log for progress updates. π
- Download Reports :
- Once completed, click the "Download Report" button to save the .zip file. π₯
Feel free to reach out if you have any questions or suggestions!
π+91 8618041675