Initial commit: Kivy database interface application with search, add/update, delete functionality and Windows build support
This commit is contained in:
82
WINDOWS_README.md
Normal file
82
WINDOWS_README.md
Normal file
@@ -0,0 +1,82 @@
|
||||
# Windows Setup Instructions
|
||||
|
||||
## Prerequisites
|
||||
1. Python 3.8 or higher
|
||||
2. MariaDB or MySQL server (local or remote)
|
||||
|
||||
## Installation Steps
|
||||
|
||||
### 1. Install Python
|
||||
- Download from: https://www.python.org/downloads/
|
||||
- During installation, check "Add Python to PATH"
|
||||
|
||||
### 2. Setup the Application
|
||||
Open Command Prompt in the application folder and run:
|
||||
|
||||
```cmd
|
||||
# Create virtual environment
|
||||
python -m venv venv
|
||||
|
||||
# Activate virtual environment
|
||||
venv\Scripts\activate
|
||||
|
||||
# Install dependencies
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### 3. Database Setup (if using local database)
|
||||
- Install MariaDB or MySQL
|
||||
- Run the setup script:
|
||||
```cmd
|
||||
mysql -u root -p < setup_user.sql
|
||||
```
|
||||
|
||||
### 4. Run the Application
|
||||
|
||||
#### Option A: Using the batch file
|
||||
Simply double-click `run_app.bat`
|
||||
|
||||
#### Option B: Using command line
|
||||
```cmd
|
||||
venv\Scripts\activate
|
||||
python main.py
|
||||
```
|
||||
|
||||
## Configuration
|
||||
- Use the **Settings** button in the app to configure the database server IP address
|
||||
- Default connection:
|
||||
- Host: localhost
|
||||
- Database: cantare_injectie
|
||||
- User: omron
|
||||
- Password: Initial01!
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Missing modules error
|
||||
```cmd
|
||||
venv\Scripts\activate
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### Database connection error
|
||||
- Check if MariaDB/MySQL service is running
|
||||
- Verify database credentials
|
||||
- Use Settings button to update server IP address
|
||||
|
||||
### Kivy installation issues
|
||||
```cmd
|
||||
pip install --upgrade pip
|
||||
pip install kivy --pre --extra-index-url https://kivy.org/downloads/simple/
|
||||
```
|
||||
|
||||
## Features
|
||||
- **Fullscreen mode**: App starts in fullscreen by default
|
||||
- **Search**: Enter ID and press Enter
|
||||
- **Add/Update**: Click Add/Update button to enable editing
|
||||
- **Delete**: Use Delete button in update section
|
||||
- **Reset**: Clear all fields with Reset Values button
|
||||
- **Settings**: Configure database server IP address
|
||||
|
||||
## Keyboard Shortcuts
|
||||
- **F11** or **Esc**: Exit fullscreen
|
||||
- **Enter**: Search for ID (when in ID field)
|
||||
Reference in New Issue
Block a user