backend.components.camera_verification.verificationController

  1from flask import Blueprint, request, jsonify
  2
  3from backend.components.workers.workerService import get_worker_from_qr_code
  4from backend.components.camera_verification.faceid.faceidService import verify_worker_face
  5from backend.components.camera_verification.error_handling.errorService import verification_response_handler
  6from backend.components.utils.imageUtils import parse_image
  7from backend.components.reports.reportService import log_worker_entry
  8
  9
 10bp = Blueprint('bp_verification', __name__)
 11
 12@bp.route('/api/skan', methods=['POST'])
 13def post_camera_scan():
 14    """
 15    Verifies a worker by scanning a QR code and matching their face.
 16
 17    **Request Body**:
 18    - `file` (FileStorage): The image file containing the QR code and the worker's face.
 19
 20    **Process**:
 21    - Extracts and decodes the QR code from the image.
 22    - Retrieves the worker associated with the QR code.
 23    - Verifies the worker's face matches the one stored in the database.
 24
 25    **Returns**:
 26    - `tuple`: A tuple containing the verification result and the HTTP status code.
 27      - On success:
 28        - HTTP 200: Verification successful.
 29      - On failure:
 30        - HTTP 400: Malformed request (e.g., missing file or invalid QR code).
 31        - HTTP 403: Permission denied (e.g., expired QR code or face mismatch).
 32        - HTTP 500: Internal server error.
 33
 34    **Example Response**:
 35    ```json
 36    {
 37        "code": 0,
 38        "message": "Weryfikacja udana.",
 39        "logged": true
 40    }
 41    ```
 42
 43    ---
 44    tags:
 45      - Verification
 46    consumes:
 47      - multipart/form-data
 48    parameters:
 49      - name: file
 50        in: formData
 51        type: file
 52        required: true
 53        description: The image file containing the QR code and the worker's face.
 54    responses:
 55      200:
 56        description: Verification successful.
 57        schema:
 58          type: object
 59          properties:
 60            code:
 61              type: integer
 62              description: Response code (0 = success).
 63              example: 0
 64            message:
 65              type: string
 66              description: Human-readable result message.
 67              example: "Weryfikacja udana."
 68            logged:
 69              type: boolean
 70              description: Indicates if the entry was logged in the database.
 71              example: true
 72      400:
 73        description: Malformed request (e.g., missing file).
 74        schema:
 75          type: object
 76          properties:
 77            error:
 78              type: string
 79              example: 'Brak pliku w żądaniu (oczekiwano klucza "file").'
 80      403:
 81        description: Permission denied (e.g., face mismatch, expired QR).
 82        schema:
 83          type: object
 84          properties:
 85            code:
 86              type: integer
 87              description: Error code indicating the specific failure reason.
 88              example: 12
 89            message:
 90              type: string
 91              example: "Twarz nie pasuje do wzorca."
 92            logged:
 93              type: boolean
 94              example: true
 95      500:
 96        description: Internal server error.
 97    """
 98    if 'file' not in request.files:
 99        return jsonify({'error': 'Brak pliku w żądaniu (oczekiwano klucza "file").'}), 400
100
101    # Load and parse image
102    img_bytes = request.files['file'].read()
103    img_parsed = parse_image(img_bytes)
104
105    http_code, response, worker = None, None, None
106    try:
107        worker = get_worker_from_qr_code(img_parsed)
108        verify_worker_face(worker, img_parsed)
109        http_code = 200
110        response = verification_response_handler()
111
112    except Exception as e:
113        response = verification_response_handler(e)
114        if response.code == -1:
115            http_code = 500  # Unknown internal server error
116        elif response.code < 10:
117            http_code = 400  # Malformed request
118        elif response.code % 10 == 0:
119            http_code = 500  # Known internal server error
120        else:
121            http_code = 403  # Permission denied
122
123    finally:
124        if response.logged:
125            log_worker_entry(response.code, response.message, worker, img_bytes)
126        return jsonify(response.asdict()), http_code