fix(ci): resolve test bootstrap failures by adding missing runtime dependencies for QR verification app

[udaycodespace]

📌 Description

This PR introduces the complete QR verification feature along with major architectural improvements, security enhancements, and CI stabilization.

It includes modularization of the Flask application, enhanced verification flows (QR + credential + blockchain), UI improvements, and fixes for CI test failures caused by missing runtime dependencies.

🚀 Scope of Work

This PR combines multiple improvements across backend, frontend, DevOps, and testing:

• QR verification system (end-to-end)
• Credential validation enhancements
• Application modularization using blueprints
• CI/CD and dependency fixes
• UI and architecture refinements

✅ Key Changes

🔐 Verification & Security

• Improved QR verification flow and reliability
• Enhanced credential validation logic
• Strengthened blockchain verification handling
• Implemented collision-safe hashing and privacy improvements

🧩 Backend Architecture

• Refactored monolithic app into modular blueprints
• Extracted core services for better separation of concerns
• Improved route organization and maintainability

🎨 UI & Product Improvements

• UI overhaul across portal
• Improved credential form structure (more realistic academic data)
• Better verifier and issuer workflows

🧪 Testing & Quality

• Updated test suite for new modular structure
• Added smoke test coverage
• Ensured compatibility with pytest fixture-based app loading

⚙️ DevOps & CI/CD

• Aligned Docker and docker-compose configurations
• Updated GitHub Actions workflows
• Standardized formatting with Black (Python 3.10 target)

🐛 CI Fix (Critical)

• Added missing runtime dependencies:

  • pyotp (admin OTP routes)
  • PyPDF2 (PDF services)

• Synced:

  • requirements.txt
  • pyproject.toml

• Fixed ModuleNotFoundError during CI test bootstrap

🧠 Root Cause (CI Failure)

• CI test job imports the Flask app during pytest fixture setup
• Blueprint imports depended on undeclared packages (pyotp, PyPDF2)
• This caused ModuleNotFoundError, blocking test collection

🛠️ Resolution

• Declared all required runtime dependencies
• Ensured clean app initialization during import
• Stabilized CI pipeline and unblocked test execution

🧪 Validation

• ✔️ Local test run: 69 passed, 0 failed
• ✔️ No import errors during test collection
• ✔️ Verified app startup after dependency installation
• ✔️ Smoke tests passing for key flows

📦 Commits Overview

Includes major commits such as:

• feat(portal): UI overhaul, RBAC security, and system improvements
• feat: implement privacy, hashing, and CI/CD security enhancements
• refactor(app): modularize routes into blueprints and services
• feat(verification): improve QR, credential, and blockchain validation
• test: update suite and add smoke coverage
• chore(devops): align docker and workflows
• fix(ci): add missing runtime dependencies

🧾 Notes for Reviewers

• This is a combined feature + refactor + CI fix PR

• Recommended review order:

  1. Backend modularization (blueprints/services)
  2. Verification logic
  3. CI/dependency fixes
  4. Tests