# Prezenta Work - Workplace Attendance & Traceability System

## Project Structure

### 📁 Main Application Files
- **app.py** - Main application orchestrator (v3.0)
- **config_settings.py** - Centralized configuration (points to 192.168.1.103)
- **data/** - Local data storage (logs, device info, RFID tags)
- **Files/** - Package repository and dependencies

### 🔧 Core Modules (Production Ready)
- **api_routes_module.py** - Flask API endpoints and web interface
- **logger_module.py** - Local and remote logging system
- **device_module.py** - Device information management
- **system_init_module.py** - System initialization and hardware checks
- **dependencies_module.py** - Package management and verification
- **commands_module.py** - Secure command execution with allowlist
- **autoupdate_module.py** - Remote application updates
- **connectivity_module.py** - Network connectivity monitoring
- **rfid_module.py** - RFID reader initialization

### ✨ Enhancement Modules (v3.0)
- **logger_batch_module.py** - Batch logging with 75% network reduction
- **chrome_launcher_module.py** - Fullscreen Chrome UI launcher
- **wifi_recovery_module.py** - Auto WiFi recovery on server disconnect

### 📚 Documentation & Old Code
See `oldcode/` folder for:
- Legacy code and configuration files
- Complete architecture documentation
- Refactoring guides and summaries
- Setup and troubleshooting guides

## Quick Start

### Run Application
```bash
cd /srv/prezenta_work
python3 app.py
```

### Configuration
All settings are centralized in `config_settings.py`:
- **Monitoring Server:** 192.168.1.103:80
- **Flask Port:** 80
- **RFID Devices:** Auto-detected (/dev/ttyS0, /dev/ttyAMA0, etc.)

### Environment Variables
Override default settings:
```bash
export MONITORING_SERVER_HOST=192.168.1.100
export FLASK_PORT=8080
python3 app.py
```

## Key Features

### 🚀 v3.0 Enhancements
1. **Batch Logging (75% Network Reduction)**
   - Queues logs every 5 seconds or at 10 items
   - Deduplicates events within 3-second window
   - Single HTTP request vs 3-4 per second

2. **Chrome Fullscreen UI**
   - Auto-launches traceability web app
   - Fullscreen kiosk mode for workplace display
   - Optional auto-startup via systemd

3. **WiFi Auto-Recovery**
   - Monitors server connectivity (60-second ping)
   - Disables WiFi for 20 minutes on server loss
   - Auto-restarts WiFi and resumes operation

## System Requirements

- **OS:** Raspberry Pi OS / Linux
- **Python:** 3.7+
- **Ports:** 80 (Flask web server)
- **Hardware:** RFID reader, GPIO LEDs, WiFi interface

## API Endpoints

All endpoints available at `http://192.168.1.103:80`

### GET /status
Device status, uptime, disk usage, memory

### POST /logs
Log submission endpoint (batch supported)

### POST /execute_command
Execute pre-approved system commands

### POST /auto_update
Check and apply remote updates

## Monitoring & Logs

### Local Logs
```bash
tail -f data/log.txt
```

### Remote Server
```bash
curl http://192.168.1.103/status
```

## Git Workflow

### Current Status
- **Branch:** dev (latest v3.0 enhancements)
- **Remote:** Synced with origin/dev
- **Latest Commit:** Configuration update (192.168.1.103)

### View History
```bash
git log --oneline -5
```

## Troubleshooting

### RFID Reader Not Detected
- Check `/dev/ttyS0`, `/dev/ttyAMA0`, `/dev/ttyUSB0`, `/dev/ttyACM0`
- Verify UART is enabled on Raspberry Pi
- Check GPIO permissions

### WiFi Recovery Not Working
- Verify sudo permissions for `ip link set` commands
- Check if ping destination is reachable
- Review logs for recovery messages

### Batch Logging Issues
- Check network connectivity to 192.168.1.103
- Verify port 80 is open and Flask is running
- Monitor batch queue in logs

## Development Notes

### Adding New Modules
1. Create module in main directory
2. Import in app.py
3. Initialize in main() function
4. Test and commit

### Modifying Configuration
1. Edit config_settings.py
2. Changes take effect on next restart
3. Environment variables can override settings

### Testing
```bash
# Syntax check
python3 -m py_compile *.py

# Import test
python3 -c "import app; print('✓ OK')"
```

## Support

For detailed documentation, see `oldcode/` folder:
- MODULAR_ARCHITECTURE.md - Complete technical guide
- QUICKSTART.md - API reference
- DEPLOYMENT_CHECKLIST.md - Testing guide

## Version History

- **v3.0** - Enhanced with batch logging, Chrome UI, WiFi recovery
- **v2.8** - Performance optimization (skip dependency checks)
- **v2.7** - Fixed auto-update for case-sensitive systems
- **v2.0+** - Modular architecture implementation

---

**Last Updated:** December 18, 2025  
**Status:** Production Ready (dev branch)  
**Monitoring Server:** 192.168.1.103:80