How ethic41/fingerprint works
This is a PHP web app for enrolling and verifying Digital Persona fingerprints, backed by a gRPC fingerprint-engine service. Its principal workflow is to submit captured fingerprint data, enroll it into a stored template or compare it against enrolled templates, and use the result in the web app. The sampled code shows service-side gRPC calls and database helpers; the README documents the web-app capabilities and MySQL example. Several app entry-point and UI connections are not visible in the excerpts, so those links are marked unverified rather than asserted.
Main entry points: Jar.php Cookie jar · index.php Web entry · enroll.php Enrollment flow · verify.php Verification flow
Components 22
Web application
- Web entry
index.php - Enrollment flow
src/core/enroll.php - Verification flow
src/core/verify.php - User queries
src/core/querydb.php - Database access
src/core/Database.php
Fingerprint service
- Service entry
fingerprint_service/index.php - Enrollment endpoint
fingerprint_service/coreComponents/enroll.php - Verification endpoint
fingerprint_service/coreComponents/verify.php - Service setup
fingerprint_service/coreComponents/basicRequirements.php - Fingerprint operations
fingerprint_service/coreComponents/fingerprint.php
gRPC engine
- PHP gRPC client
fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/FingerPrintClient.php - Protocol messages
fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/EnrollmentRequest.php - Protocol schema
fingerprint_service/thirdparty/grpc-fingerprint-engine/src/protos/fingerprint.proto - C++ engine server
fingerprint_service/thirdparty/grpc-fingerprint-engine/src/cpp/fingerprint_server.cc
HTTP utilities
- HTTP sessions
src/core/helpers/Requests/src/Session.php - Cookie jar
src/core/helpers/Requests/src/Cookie/Jar.php - Cookie handling
src/core/helpers/Requests/src/Cookie.php - IRI processing
src/core/helpers/Requests/src/Iri.php - Input validation
src/core/helpers/Requests/src/Utility/InputValidator.php - Hook dispatch
src/core/helpers/Requests/src/HookManager.php - HTTP response
src/core/helpers/Requests/src/Response.php
Other components
- Web user
Connections 24
- Web user → Web entry: uses
README.md - Web entry → Enrollment flow: routes to
- Web entry → Verification flow: routes to
- Enrollment flow → User queries: uses
- Verification flow → User queries: uses
- User queries → Database access: uses
src/core/querydb.php - Enrollment flow → Enrollment endpoint: submits template
README.md - Verification flow → Verification endpoint: submits comparison
README.md - Service entry → Enrollment endpoint: dispatches
- Service entry → Verification endpoint: dispatches
- Enrollment endpoint → Service setup: loads
fingerprint_service/coreComponents/enroll.php - Verification endpoint → Service setup: loads
fingerprint_service/coreComponents/verify.php - Service setup → Fingerprint operations: loads
fingerprint_service/coreComponents/basicRequirements.php - Fingerprint operations → PHP gRPC client: calls
fingerprint_service/coreComponents/fingerprint.php - Fingerprint operations → C++ engine server: sends gRPC requests
fingerprint_service/coreComponents/fingerprint.php - PHP gRPC client → Protocol messages: accepts messages
fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/FingerPrintClient.php - Protocol messages → Protocol schema: implements schema
- HTTP sessions → Cookie jar: creates
src/core/helpers/Requests/src/Session.php - Cookie jar → Cookie handling: parses
src/core/helpers/Requests/src/Cookie/Jar.php - Cookie jar → IRI processing: matches domains
src/core/helpers/Requests/src/Cookie/Jar.php - Cookie jar → HTTP response: attaches cookies
src/core/helpers/Requests/src/Cookie/Jar.php - Cookie jar → Hook dispatch: registers callbacks
src/core/helpers/Requests/src/Cookie/Jar.php - Cookie handling → Input validation: validates with
src/core/helpers/Requests/src/Cookie.php - IRI processing → Input validation: validates with
src/core/helpers/Requests/src/Iri.php