3. Project Management - Kevin-Gu-2022/salus-lilac GitHub Wiki

Deliverables and Key Performance Indicators

KPIs

For the project to be considered a success, the following Key Performance Indicators (KPIs) are to be met:

  1. Authentication Success Rate (%)

    • Formula: (Successful Authentications / Total Authentication Attempts) × 100
    • Purpose: Measures reliability and efficiency of user authentication.
  2. Tamper Detection Accuracy (%)

    • Formula: (True Tamper Detections / Total Tamper Events) × 100
    • Purpose: Evaluates the effectiveness of magnetometer and ultrasonic sensors in detecting real threats versus false positives.
  3. Blockchain Logging Integrity (%)

    • Formula: (Logged Events Verified / Total Events Triggered) × 100
    • Purpose: Ensures that all events (access, tamper, etc.) are immutably recorded and retrievable.
  4. Bluetooth Detection Latency (ms)

    • Formula: Average time from Bluetooth signal detection to initiation of passcode prompt
    • Purpose: Measures responsiveness of the system in recognizing authorized devices.
  5. Credential Revocation Response Time (seconds)

    • Formula: Average time from revocation command to enforcement
    • Purpose: Measures how quickly the system can react to revoked access, affecting real-time security.

Deliverables

Ultimately, the project will deliver on the following items:

  1. Base Node (B-L4S5I-IOT01A)

    • Bluetooth-based user authentication
    • User credential management (MAC address, alias, passcode)
    • BLE communication with sensor and camera nodes
    • Access control logic and servo/speaker actuation
    • Tamper and intrusion detection via sensor data
    • Blockchain-based event logging
    • Passcode entry via keypad
  2. Mobile Node (M5Stack Core2)

    • Bluetooth pairing with base node
    • Real-time feedback on authentication status
  3. Sensors Node (B-L4S5I-IOT01A)

    • Ultrasonic: Visitor presence detection
    • Magnetometer: Tamper detection
    • BLE-based real-time data transmission to base node
  4. Actuation Subsystem

    • Servo motor: Simulated door lock/unlock
  5. Web Dashboard (TagoIO)

    • Real-time system status and event log display
    • Visual verification of access attempts
    • Immutable blockchain event audit trail
  6. Blockchain Integration

    • Logging of all access events and alerts
    • Ensures verifiable, tamper-resistant records

Project Management

gantt
    title Smart Entry System Gantt Chart
    dateFormat  DD-MM-YYYY
    axisFormat  %d %b

    section Planning
    Requirements Gathering           :p1, 12-05-2025, 2d
    System Design                   :p2, 14-05-2025, 2d
    Component Selection             :p3, 16-05-2025, 1d

    section Setup
    Hardware Setup & Testing          :a1, 17-05-2025, 4d
    MQTT Broker Setup                 :a2, 17-05-2025, 1d
    Base Node Firmware (BLE+MQTT)    :a3, 17-05-2025, 6d
    Sensor Node Firmware             :a4, 17-05-2025, 6d
    ESP32-CAM Image Capture          :a5, 19-05-2025, 6d
    Mobile Node BLE UI               :a6, 19-05-2025, 6d

    section Integration
    BLE Integration (Base ↔ Mobile)  :b1, 25-05-2025, 3d
    MQTT Sensor Integration          :b2, 25-05-2025, 3d
    Camera Trigger & Upload          :b3, 28-05-2025, 3d
    UART to HTTP + TagoIO            :b4, 28-05-2025, 3d

    section Finalisation
    System Testing                   :c1, 31-05-2025, 3d
    Debug & Optimisation             :c2, 03-06-2025, 3d
    Field Testing                   :c3, 06-06-2025, 3d
    Final Deployment                :c4, 09-06-2025, 2d