🚀 Flask Backend API

Backend JWT • Diagnostic Engine • Production Ready

API Documentation System Health

System Status

Current system health and configuration

API Active

REST API is running

Database Connected

PostgreSQL connection healthy

JWT Enabled

Authentication system active

JWT Auth

Authentication integration active

🚀 Quick Access

Access admin panel and system features

🔐 Authentication

Backend JWT: login, verify, refresh, logout

API Docs

🌐 API Endpoints

RESTful API documentation and testing

View API

❤️ System Health

Monitor system status and performance

Health Check

🚀 Key Features

Enterprise-grade features built for production

🔐 Backend JWT Auth

  • HS256 JWT: httpOnly cookie + Bearer header
  • Server-side revocation on logout (token version)
  • Token refresh on a still-valid session
  • Per-consultant scoping (404, never 403)
  • Account lockout protection

⚡ High Performance

  • Minimal, focused API design
  • Lightweight request handling
  • Optimized for speed
  • Efficient database queries
  • Production-ready architecture

👥 User Sync

  • Consultant accounts with roles
  • Profile data synchronization
  • Email and name mapping
  • Role preservation in local DB
  • Seamless integration

🗄️ Database Layer

  • PostgreSQL with SQLAlchemy ORM
  • Connection pooling optimization
  • User model with role-based access
  • Timestamp tracking
  • Migration support

🌐 API Endpoints

Available REST API endpoints

Method Endpoint Description Auth Required
POST /api/v1/login Authenticate and receive a JWT ❌
GET /api/v1/verify-token Validate the token, return the consultant ✅
GET /api/v1/core/health Backend health status ❌
GET /api/v1/ API documentation and info ❌
GET /health Basic system health check ❌
GET /health/detailed Detailed health with database ❌

📚 Getting Started

Quick start guide and administration

🚀 Quick Start

  1. Check System Health
  2. Review API Documentation
  3. Integrate with your frontend application
  4. Start building amazing features!

Authentication

Login: POST /api/v1/login
Verify: GET /api/v1/verify-token
🔧 Set SECRET_KEY and JWT_ACCESS_TOKEN_EXPIRES in .env

⚡ Architecture

flask-backend/
├── src/
│   ├── auth/        # Backend JWT auth
│   ├── core/        # Health & Monitoring
│   ├── models/      # User Model
│   ├── services/    # External services
│   └── templates/   # Public Pages
├── config/          # Environment Settings
└── requirements.txt # Dependencies

🎯 Design Philosophy

Simple > Perfect
Focused backend for the diagnostic engine.
Frontend handles all business logic.