FaceGuard MVP v1

FaceGuard MVP v1 - Release Notes

Tag: v1.0.0

Release title: FaceGuard MVP v1

Target: final Assignment 3 commit on main

Summary

FaceGuard MVP v1 delivers the first end-to-end access-control increment. It connects the administrator frontend, central backend, persistent database, local recognition agent, and camera integration path.

MVP v1 is hardware-dependent. The frontend and backend are runnable from the repository, while the recognition agent runs locally on a team laptop in development mode using a built-in or USB camera. This model was selected because the customer recommended stabilizing the recognition workflow on Ubuntu/laptop cameras before moving to Raspberry Pi and a fixed entrance camera.

Implemented User Stories

• US-01: View all people with access
• US-02: Add a person to the access list
• US-03: View system dashboard
• US-11: View connected entrance camera

Supporting PBIs

• PBI-01: Persist authorized people in the central backend
• PBI-02: Connect the People page to the backend API
• PBI-03: Implement the add-person flow with reference photographs
• PBI-04: Implement authorized-person removal
• PBI-05: Integrate the real camera and face-recognition agent
• PBI-06: Expose camera image and status to the web application
• PBI-07: Store recognition and access events
• PBI-08: Display recent recognition events on the dashboard
• PBI-09: Connect dashboard metrics and charts to real data
• PBI-10: Integrate and verify the MVP v1 end-to-end workflow

Access and Run Instructions

Use the root README.md for exact local run instructions.

For laptop-camera testing:

HARDWARE_MODE=development
CAMERA_INDEX=0

The camera and recognition agent are not exposed as a permanent public stream because they depend on local hardware and may process biometric data.

Evidence

• MVP v1 integration PR #37
• Week 3 report
• Public sanitized demo video

Known Limitation

After a person is added or removed, the recognition agent currently requires restart or model rebuild before the recognition model uses the updated data. This is tracked as BUG-01 / issue #35.

Notes for GitHub Release Publication

When publishing the GitHub Release:

• create tag v1.0.0;
• set release title to FaceGuard MVP v1;
• target the final Assignment 3 commit on main;
• paste these release notes into the GitHub release description;
• verify that the automatically generated source-code ZIP/tar.gz archives are available.