Restructurign code

models/__init__.py

@@ -0,0 +1,21 @@
+"""
+Models package for QR Attendance Management System
+==================================================
+
+This package contains all SQLAlchemy models split from app.py for better organization.
+All models maintain backward compatibility and existing functionality.
+"""
+
+from . import base
+
+def set_db(database):
+    """Set the database instance for all models"""
+    base.db = database
+    
+    # Now import all models (they will use base.db)
+    from .user import User
+    from .qrcode import QRCode, QRCodeStyle
+    from .project import Project
+    from .attendance import AttendanceData
+    
+    return User, QRCode, QRCodeStyle, Project, AttendanceData

models/attendance.py

@@ -0,0 +1,58 @@
+"""
+Attendance Model for QR Attendance Management System
+===================================================
+
+AttendanceData model for tracking attendance records with location support.
+Extracted from app.py for better code organization.
+"""
+
+from datetime import datetime
+from . import base
+
+class AttendanceData(base.db.Model):
+    """Enhanced attendance tracking model with location support"""
+    __tablename__ = 'attendance_data'
+    
+    # Existing fields
+    id = base.db.Column(base.db.Integer, primary_key=True)
+    qr_code_id = base.db.Column(base.db.Integer, base.db.ForeignKey('qr_codes.id', ondelete='CASCADE'), nullable=False)
+    employee_id = base.db.Column(base.db.String(50), nullable=False)
+    check_in_date = base.db.Column(base.db.Date, nullable=False, default=datetime.today)
+    check_in_time = base.db.Column(base.db.Time, nullable=False, default=datetime.now().time)
+    device_info = base.db.Column(base.db.String(200))
+    user_agent = base.db.Column(base.db.Text)
+    ip_address = base.db.Column(base.db.String(45))
+    location_name = base.db.Column(base.db.String(100), nullable=False)
+    status = base.db.Column(base.db.String(20), default='present')
+    created_timestamp = base.db.Column(base.db.DateTime, default=datetime.utcnow)
+    updated_timestamp = base.db.Column(base.db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+    latitude = base.db.Column(base.db.Float, nullable=True)
+    longitude = base.db.Column(base.db.Float, nullable=True)
+    accuracy = base.db.Column(base.db.Float, nullable=True)
+    location_accuracy = base.db.Column(base.db.Float, nullable=True)
+    altitude = base.db.Column(base.db.Float, nullable=True)
+    location_source = base.db.Column(base.db.String(50), default='manual')
+    address = base.db.Column(base.db.String(500), nullable=True)
+    
+    # Relationships
+    qr_code = base.db.relationship('QRCode', backref=base.db.backref('attendance_records', lazy='dynamic'))
+    
+    def __repr__(self):
+        return f'<AttendanceData {self.employee_id} at {self.location_name} on {self.check_in_date}>'
+    
+    @property
+    def has_location_data(self):
+        """Check if this record has GPS coordinates"""
+        return self.latitude is not None and self.longitude is not None
+    
+    @property
+    def location_accuracy_level(self):
+        """Get human-readable accuracy level"""
+        if not self.accuracy:
+            return 'unknown'
+        elif self.accuracy <= 5:
+            return 'high'
+        elif self.accuracy <= 20:
+            return 'medium'
+        else:
+            return 'low'

models/base.py

@@ -0,0 +1,7 @@
+# models/base.py
+"""
+Base module to hold the database instance for all models
+"""
+
+# This will be set by app.py
+db = None

models/project.py

@@ -0,0 +1,40 @@
+"""
+Project Model for QR Attendance Management System
+================================================
+
+Project model to organize QR codes by projects.
+Extracted from app.py for better code organization.
+"""
+
+from datetime import datetime
+from . import base
+
+class Project(base.db.Model):
+    """
+    Project model to organize QR codes by projects
+    """
+    __tablename__ = 'projects'
+    
+    id = base.db.Column(base.db.Integer, primary_key=True)
+    name = base.db.Column(base.db.String(100), nullable=False)
+    description = base.db.Column(base.db.Text, nullable=True)
+    created_by = base.db.Column(base.db.Integer, base.db.ForeignKey('users.id'), nullable=True)
+    created_date = base.db.Column(base.db.DateTime, default=datetime.utcnow)
+    active_status = base.db.Column(base.db.Boolean, default=True)
+    
+    # Relationships
+    qr_codes = base.db.relationship('QRCode', backref='project', lazy='dynamic')
+    creator = base.db.relationship('User', backref='created_projects')
+    
+    def __repr__(self):
+        return f'<Project {self.name}>'
+    
+    @property
+    def qr_count(self):
+        """Get count of QR codes in this project"""
+        return self.qr_codes.filter_by(active_status=True).count()
+    
+    @property
+    def total_qr_count(self):
+        """Get total count of QR codes (including inactive) in this project"""
+        return self.qr_codes.count()

models/qrcode.py

@@ -0,0 +1,81 @@
+"""
+QRCode and QRCodeStyle Models for QR Attendance Management System
+================================================================
+
+QRCode models to manage QR code records and metadata with customization options.
+Extracted from app.py for better code organization.
+"""
+
+from datetime import datetime
+from . import base
+
+class QRCode(base.db.Model):
+    """
+    Enhanced QR Code model to manage QR code records and metadata with address coordinates
+    """
+    __tablename__ = 'qr_codes'
+    
+    id = base.db.Column(base.db.Integer, primary_key=True)
+    name = base.db.Column(base.db.String(100), nullable=False)
+    location = base.db.Column(base.db.String(100), nullable=False)
+    location_address = base.db.Column(base.db.Text, nullable=False)
+    location_event = base.db.Column(base.db.String(200), nullable=False)
+    qr_code_image = base.db.Column(base.db.Text, nullable=False)  # Base64 encoded image
+    created_by = base.db.Column(base.db.Integer, base.db.ForeignKey('users.id'), nullable=True)
+    created_date = base.db.Column(base.db.DateTime, default=datetime.utcnow)
+    active_status = base.db.Column(base.db.Boolean, default=True)
+    qr_url = base.db.Column(base.db.String(255), unique=True, nullable=True)
+    # Address Coordinates Fields
+    address_latitude = base.db.Column(base.db.Float, nullable=True)
+    address_longitude = base.db.Column(base.db.Float, nullable=True)
+    coordinate_accuracy = base.db.Column(base.db.String(50), nullable=True, default='geocoded')
+    coordinates_updated_date = base.db.Column(base.db.DateTime, nullable=True)
+    project_id = base.db.Column(base.db.Integer, base.db.ForeignKey('projects.id'), nullable=True)
+    # QR Code Customization fields
+    fill_color = base.db.Column(base.db.String(7), default="#000000")  # Hex color
+    back_color = base.db.Column(base.db.String(7), default="#FFFFFF")  # Background color
+    box_size = base.db.Column(base.db.Integer, default=10)
+    border = base.db.Column(base.db.Integer, default=4)
+    error_correction = base.db.Column(base.db.String(1), default='L')
+    style_id = base.db.Column(base.db.Integer, base.db.ForeignKey('qr_code_styles.id'), nullable=True)
+    
+    # Relationship to style
+    style = base.db.relationship('QRCodeStyle', backref='qr_codes')
+
+    @property
+    def has_coordinates(self):
+        """Check if this QR code has address coordinates"""
+        return self.address_latitude is not None and self.address_longitude is not None
+    
+    @property
+    def coordinates_display(self):
+        """Get formatted coordinates for display"""
+        if self.has_coordinates:
+            return f"{self.address_latitude:.10f}, {self.address_longitude:.10f}"
+        return "Coordinates not available"
+
+    def update_coordinates(self, latitude, longitude, accuracy='geocoded'):
+        """Update the address coordinates for this QR code"""
+        self.address_latitude = latitude
+        self.address_longitude = longitude
+        self.coordinate_accuracy = accuracy
+        self.coordinates_updated_date = datetime.utcnow()
+
+
+class QRCodeStyle(base.db.Model):
+    """QR Code customization styles"""
+    __tablename__ = 'qr_code_styles'
+    
+    id = base.db.Column(base.db.Integer, primary_key=True)
+    name = base.db.Column(base.db.String(100), nullable=False)  # Style name
+    fill_color = base.db.Column(base.db.String(7), default="#000000")  # Hex color for QR modules
+    back_color = base.db.Column(base.db.String(7), default="#FFFFFF")  # Hex color for background
+    box_size = base.db.Column(base.db.Integer, default=10)  # Size of each QR module
+    border = base.db.Column(base.db.Integer, default=4)  # Border size
+    error_correction = base.db.Column(base.db.String(1), default='L')  # L, M, Q, H
+    is_default = base.db.Column(base.db.Boolean, default=False)
+    created_at = base.db.Column(base.db.DateTime, default=datetime.utcnow)
+    created_by = base.db.Column(base.db.Integer, base.db.ForeignKey('users.id'))
+    
+    def __repr__(self):
+        return f'<QRCodeStyle {self.name}>'

models/user.py

@@ -0,0 +1,68 @@
+"""
+User Model for QR Attendance Management System
+==============================================
+
+User model to manage system users with role-based access control.
+Extracted from app.py for better code organization.
+"""
+
+from werkzeug.security import generate_password_hash, check_password_hash
+from datetime import datetime
+
+# Valid user roles (kept in sync with app.py)
+STAFF_LEVEL_ROLES = ['staff', 'payroll', 'project_manager']
+
+# Import db from app - this works because app.py imports this file after db is created
+import sys
+from . import base
+
+class User(base.db.Model):
+    """
+    User model to manage system users with role-based access control
+    """
+    __tablename__ = 'users'
+    
+    id = base.db.Column(base.db.Integer, primary_key=True)
+    full_name = base.db.Column(base.db.String(100), nullable=False)
+    email = base.db.Column(base.db.String(120), unique=True, nullable=False)
+    username = base.db.Column(base.db.String(80), unique=True, nullable=False)
+    password_hash = base.db.Column(base.db.String(255), nullable=False)
+    role = base.db.Column(base.db.String(20), nullable=False, default='staff')  # admin or staff
+    created_by = base.db.Column(base.db.Integer, base.db.ForeignKey('users.id'), nullable=True)
+    created_date = base.db.Column(base.db.DateTime, default=datetime.utcnow)
+    active_status = base.db.Column(base.db.Boolean, default=True)
+    last_login_date = base.db.Column(base.db.DateTime, nullable=True)
+    
+    # Relationships
+    created_users = base.db.relationship('User', backref=base.db.backref('creator', remote_side=[id]))
+    created_qr_codes = base.db.relationship('QRCode', backref='creator', lazy='dynamic')
+    
+    def set_password(self, password):
+        """Hash and set user password"""
+        self.password_hash = generate_password_hash(password)
+    
+    def check_password(self, password):
+        """Verify user password"""
+        return check_password_hash(self.password_hash, password)
+    
+    def is_admin(self):
+        """Check if user has admin privileges"""
+        return self.role == 'admin'
+    
+    def has_staff_permissions(self):
+        """Check if user has staff-level permissions (includes new roles)"""
+        return self.role in STAFF_LEVEL_ROLES
+    
+    def has_export_permissions(user_role):
+        """Check if user role has export permissions"""
+        return user_role in ['admin', 'payroll']
+
+    def get_role_display_name(self):
+        """Get user-friendly role name"""
+        role_names = {
+            'admin': 'Administrator',
+            'staff': 'Staff User',
+            'payroll': 'Payroll Specialist',
+            'project_manager': 'Project Manager'
+        }
+        return role_names.get(self.role, self.role.title())