# ethic41/fingerprint architecture

> Architecture diagram of the GitHub repository ethic41/fingerprint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ethic41/fingerprint
- Repository: https://github.com/ethic41/fingerprint

## Overview

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: [`src/core/helpers/Requests/src/Cookie/Jar.php`](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Cookie/Jar.php) (Cookie jar), [`index.php`](https://github.com/ethic41/fingerprint/blob/master/index.php) (Web entry), [`src/core/enroll.php`](https://github.com/ethic41/fingerprint/blob/master/src/core/enroll.php) (Enrollment flow), [`src/core/verify.php`](https://github.com/ethic41/fingerprint/blob/master/src/core/verify.php) (Verification flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web_entry["Web entry<br/>[index.php]"]
  node_enroll_flow["Enrollment flow<br/>[enroll.php]"]
  node_verify_flow["Verification flow<br/>[verify.php]"]
  node_db_queries["User queries<br/>[querydb.php]"]
  node_database[("Database access<br/>[Database.php]")]
end

subgraph group_service["Fingerprint service"]
  node_service_entry["Service entry<br/>[index.php]"]
  node_service_enroll["Enrollment endpoint<br/>[enroll.php]"]
  node_service_verify["Verification endpoint<br/>[verify.php]"]
  node_service_requirements["Service setup"]
  node_fingerprint_ops["Fingerprint operations<br/>[fingerprint.php]"]
end

subgraph group_engine["gRPC engine"]
  node_engine_client["PHP gRPC client"]
  node_proto_messages["Protocol messages"]
  node_proto_schema["Protocol schema<br/>[fingerprint.proto]"]
  node_cpp_engine["C++ engine server"]
end

subgraph group_http["HTTP utilities"]
  node_requests_session["HTTP sessions<br/>[Session.php]"]
  node_cookie_jar["Cookie jar<br/>[Jar.php]"]
  node_cookie["Cookie handling<br/>[Cookie.php]"]
  node_iri["IRI processing<br/>[Iri.php]"]
  node_input_validation["Input validation<br/>[InputValidator.php]"]
  node_hooks["Hook dispatch<br/>[HookManager.php]"]
  node_http_response["HTTP response<br/>[Response.php]"]
end

node_user(("Web user"))

node_user -.->|"uses"| node_web_entry
node_web_entry -.->|"routes to"| node_enroll_flow
node_web_entry -.->|"routes to"| node_verify_flow
node_enroll_flow -.->|"uses"| node_db_queries
node_verify_flow -.->|"uses"| node_db_queries
node_db_queries -->|"uses"| node_database
node_enroll_flow -.->|"submits template"| node_service_enroll
node_verify_flow -.->|"submits comparison"| node_service_verify
node_service_entry -.->|"dispatches"| node_service_enroll
node_service_entry -.->|"dispatches"| node_service_verify
node_service_enroll -->|"loads"| node_service_requirements
node_service_verify -->|"loads"| node_service_requirements
node_service_requirements -->|"loads"| node_fingerprint_ops
node_fingerprint_ops -->|"calls"| node_engine_client
node_fingerprint_ops -.->|"sends gRPC requests"| node_cpp_engine
node_engine_client -->|"accepts messages"| node_proto_messages
node_proto_messages -.->|"implements schema"| node_proto_schema
node_requests_session -->|"creates"| node_cookie_jar
node_cookie_jar -->|"parses"| node_cookie
node_cookie_jar -->|"matches domains"| node_iri
node_cookie_jar -->|"attaches cookies"| node_http_response
node_cookie_jar -->|"registers callbacks"| node_hooks
node_cookie -->|"validates with"| node_input_validation
node_iri -->|"validates with"| node_input_validation

click node_web_entry "https://github.com/ethic41/fingerprint/blob/master/index.php"
click node_enroll_flow "https://github.com/ethic41/fingerprint/blob/master/src/core/enroll.php"
click node_verify_flow "https://github.com/ethic41/fingerprint/blob/master/src/core/verify.php"
click node_db_queries "https://github.com/ethic41/fingerprint/blob/master/src/core/querydb.php"
click node_database "https://github.com/ethic41/fingerprint/blob/master/src/core/Database.php"
click node_service_entry "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/index.php"
click node_service_enroll "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/enroll.php"
click node_service_verify "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/verify.php"
click node_service_requirements "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/basicRequirements.php"
click node_fingerprint_ops "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/fingerprint.php"
click node_engine_client "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/FingerPrintClient.php"
click node_proto_messages "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/EnrollmentRequest.php"
click node_proto_schema "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/protos/fingerprint.proto"
click node_cpp_engine "https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/cpp/fingerprint_server.cc"
click node_requests_session "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Session.php"
click node_cookie_jar "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Cookie/Jar.php"
click node_cookie "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Cookie.php"
click node_iri "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Iri.php"
click node_input_validation "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Utility/InputValidator.php"
click node_hooks "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/HookManager.php"
click node_http_response "https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Response.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_entry,node_enroll_flow,node_verify_flow,node_db_queries,node_database,node_user toneBlue
class node_service_entry,node_service_enroll,node_service_verify,node_service_requirements,node_fingerprint_ops toneAmber
class node_engine_client,node_proto_messages,node_proto_schema,node_cpp_engine toneMint
class node_requests_session,node_cookie_jar,node_cookie,node_iri,node_input_validation,node_hooks,node_http_response toneRose
```

## Components

### Web application

- [Web entry](https://github.com/ethic41/fingerprint/blob/master/index.php): `index.php`
- [Enrollment flow](https://github.com/ethic41/fingerprint/blob/master/src/core/enroll.php): `src/core/enroll.php`
- [Verification flow](https://github.com/ethic41/fingerprint/blob/master/src/core/verify.php): `src/core/verify.php`
- [User queries](https://github.com/ethic41/fingerprint/blob/master/src/core/querydb.php): `src/core/querydb.php`
- [Database access](https://github.com/ethic41/fingerprint/blob/master/src/core/Database.php): `src/core/Database.php`

### Fingerprint service

- [Service entry](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/index.php): `fingerprint_service/index.php`
- [Enrollment endpoint](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/enroll.php): `fingerprint_service/coreComponents/enroll.php`
- [Verification endpoint](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/verify.php): `fingerprint_service/coreComponents/verify.php`
- [Service setup](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/basicRequirements.php): `fingerprint_service/coreComponents/basicRequirements.php`
- [Fingerprint operations](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/coreComponents/fingerprint.php): `fingerprint_service/coreComponents/fingerprint.php`

### gRPC engine

- [PHP gRPC client](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/FingerPrintClient.php): `fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/FingerPrintClient.php`
- [Protocol messages](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/EnrollmentRequest.php): `fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/EnrollmentRequest.php`
- [Protocol schema](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/protos/fingerprint.proto): `fingerprint_service/thirdparty/grpc-fingerprint-engine/src/protos/fingerprint.proto`
- [C++ engine server](https://github.com/ethic41/fingerprint/blob/master/fingerprint_service/thirdparty/grpc-fingerprint-engine/src/cpp/fingerprint_server.cc): `fingerprint_service/thirdparty/grpc-fingerprint-engine/src/cpp/fingerprint_server.cc`

### HTTP utilities

- [HTTP sessions](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Session.php): `src/core/helpers/Requests/src/Session.php`
- [Cookie jar](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Cookie/Jar.php): `src/core/helpers/Requests/src/Cookie/Jar.php`
- [Cookie handling](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Cookie.php): `src/core/helpers/Requests/src/Cookie.php`
- [IRI processing](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Iri.php): `src/core/helpers/Requests/src/Iri.php`
- [Input validation](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Utility/InputValidator.php): `src/core/helpers/Requests/src/Utility/InputValidator.php`
- [Hook dispatch](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/HookManager.php): `src/core/helpers/Requests/src/HookManager.php`
- [HTTP response](https://github.com/ethic41/fingerprint/blob/master/src/core/helpers/Requests/src/Response.php): `src/core/helpers/Requests/src/Response.php`

### Other components

- **Web user**

## Connections

- Web user → Web entry: uses (evidence: `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 (evidence: `src/core/querydb.php`)
- Enrollment flow → Enrollment endpoint: submits template (evidence: `README.md`)
- Verification flow → Verification endpoint: submits comparison (evidence: `README.md`)
- Service entry → Enrollment endpoint: dispatches
- Service entry → Verification endpoint: dispatches
- Enrollment endpoint → Service setup: loads (evidence: `fingerprint_service/coreComponents/enroll.php`)
- Verification endpoint → Service setup: loads (evidence: `fingerprint_service/coreComponents/verify.php`)
- Service setup → Fingerprint operations: loads (evidence: `fingerprint_service/coreComponents/basicRequirements.php`)
- Fingerprint operations → PHP gRPC client: calls (evidence: `fingerprint_service/coreComponents/fingerprint.php`)
- Fingerprint operations → C++ engine server: sends gRPC requests (evidence: `fingerprint_service/coreComponents/fingerprint.php`)
- PHP gRPC client → Protocol messages: accepts messages (evidence: `fingerprint_service/thirdparty/grpc-fingerprint-engine/src/php/Fingerprint/FingerPrintClient.php`)
- Protocol messages → Protocol schema: implements schema
- HTTP sessions → Cookie jar: creates (evidence: `src/core/helpers/Requests/src/Session.php`)
- Cookie jar → Cookie handling: parses (evidence: `src/core/helpers/Requests/src/Cookie/Jar.php`)
- Cookie jar → IRI processing: matches domains (evidence: `src/core/helpers/Requests/src/Cookie/Jar.php`)
- Cookie jar → HTTP response: attaches cookies (evidence: `src/core/helpers/Requests/src/Cookie/Jar.php`)
- Cookie jar → Hook dispatch: registers callbacks (evidence: `src/core/helpers/Requests/src/Cookie/Jar.php`)
- Cookie handling → Input validation: validates with (evidence: `src/core/helpers/Requests/src/Cookie.php`)
- IRI processing → Input validation: validates with (evidence: `src/core/helpers/Requests/src/Iri.php`)
