Add status column to Certificate model and update related functionality

- Introduced 'status' column with default value 'valid' to the Certificate model.
- Enhanced certificate verification response to include student and certificate timestamps.
- Updated database schema to ensure the new 'status' column is added if missing.
- Improved .env loading mechanism in view_database script for better environment variable management.

Co-authored-by: Copilot <copilot@github.com>

Author: orabe

backend/app/database.py

@@ -71,6 +71,10 @@ def ensure_certificate_schema(bind=None):
         missing_statements.append("ALTER TABLE certificates ADD COLUMN instruction_language VARCHAR")
     if "course_link" not in existing_columns:
         missing_statements.append("ALTER TABLE certificates ADD COLUMN course_link VARCHAR")
+    if "status" not in existing_columns:
+        # create status column with a sensible default so existing DBs don't fail on inserts
+        # Use DEFAULT and NOT NULL in a single statement when supported by the DB.
+        missing_statements.append("ALTER TABLE certificates ADD COLUMN status VARCHAR DEFAULT 'valid' NOT NULL")
 
     if not missing_statements:
         return

backend/app/main.py

@@ -65,6 +65,8 @@ def verify_certificate(certificate_id: str, db: Session = Depends(get_db)):
             "message": "Certificate not found"
         })
 
+    student = getattr(cert, "student", None)
+
     return {
         "status": "valid",
         "certificate_id": cert.certificate_id,
@@ -76,6 +78,15 @@ def verify_certificate(certificate_id: str, db: Session = Depends(get_db)):
         "duration_hours": cert.duration_hours,
         "issuer": cert.issuer,
         "instructor": cert.instructor,
+        "attendance_percentage": cert.attendance_percentage,
+        "assignment_completion_percentage": cert.assignment_completion_percentage,
+        "course_level": cert.course_level,
+        "course_format": cert.course_format,
+        "instruction_language": cert.instruction_language,
+        "certificate_created_at": cert.created_at,
+        "certificate_updated_at": cert.updated_at,
+        "student_created_at": getattr(student, "created_at", None) if student else None,
+        "student_updated_at": getattr(student, "updated_at", None) if student else None,
         "verified_at": datetime.utcnow().isoformat() + "Z",
         "verification_url": f"https://mathcodelab.de/verify/?id={cert.certificate_id}"
     }

backend/app/models.py

@@ -25,6 +25,7 @@ class Certificate(Base):
     course_format = Column(String, nullable=True)
     instruction_language = Column(String, nullable=True)
     course_link = Column(String, nullable=True)
+    status = Column(String, default="valid", server_default="valid", nullable=False)
 
     issuer = Column(String, default="MathCodeLab", nullable=False)
     instructor = Column(String, default="Mohammad Orabe", nullable=False)

backend/app/schemas.py

@@ -55,6 +55,12 @@ class CertificateVerificationResponse(BaseModel):
     course_level: Optional[str] = None
     course_format: Optional[str] = None
     instruction_language: Optional[str] = None
+    # Certificate timestamps
+    certificate_created_at: Optional[str] = None
+    certificate_updated_at: Optional[str] = None
+    # Student timestamps
+    student_created_at: Optional[str] = None
+    student_updated_at: Optional[str] = None
 
 
 class CertificateDeleteResponse(BaseModel):

backend/scripts/view_database.py

@@ -1,18 +1,50 @@
 import os
 import sys
+from datetime import datetime, timezone
+
+try:
+	from dotenv import load_dotenv
+except ModuleNotFoundError:
+	load_dotenv = None
 
-from dotenv import load_dotenv
 from sqlalchemy.orm import Session
 
 PROJECT_ROOT = os.path.dirname(os.path.dirname(__file__))
-load_dotenv(os.path.join(PROJECT_ROOT, ".env"))
+if load_dotenv:
+	load_dotenv(os.path.join(PROJECT_ROOT, ".env"))
+else:
+	# fallback: load simple KEY=VALUE pairs into env if .env exists
+	env_path = os.path.join(PROJECT_ROOT, ".env")
+	if os.path.exists(env_path):
+		with open(env_path, "r", encoding="utf-8") as f:
+			for raw in f:
+				line = raw.strip()
+				if not line or line.startswith("#") or "=" not in line:
+					continue
+				k, v = line.split("=", 1)
+				os.environ.setdefault(k.strip(), v.strip().strip('"').strip("'"))
+
 sys.path.append(PROJECT_ROOT)
 
 from app import database
 from app.database import SessionLocal
 from app.models import Certificate
 
 
+def _format_dt(dt: datetime) -> str:
+	if not dt:
+		return "-"
+	# ensure timezone-aware
+	if dt.tzinfo is None:
+		dt = dt.replace(tzinfo=timezone.utc)
+	# convert to local timezone for display
+	try:
+		local = dt.astimezone()
+	except Exception:
+		local = dt
+	return local.strftime("%d.%m.%Y, %H:%M %Z")
+
+
 def view_database(limit: int = 50):
 	# Ensure missing optional columns are added before selecting all model fields.
 	database.ensure_certificate_schema()
@@ -43,7 +75,7 @@ def view_database(limit: int = 50):
 			print(f"Instructor     : {cert.instructor}")
 			print(f"Course Link    : {cert.course_link or '-'}")
 			print(f"Status         : {getattr(cert, 'status', 'valid')}")
-			print(f"Created At     : {cert.created_at}")
+			print(f"Created At     : {_format_dt(cert.created_at)}")
 			print("=" * 50)
 
 	except Exception as e: