Documentacao renderizada
Esta pagina renderiza o Markdown e Mermaid do modulo diretamente da fonte publica de documentacao.
Overview#
The Profile Image Management domain delivers secure, scalable image storage and facial recognition capabilities for user avatars, reference photos, and identity documents across all profile types. It enables upload with automatic facial indexing, face similarity search, multi-image management per profile, and biometric identification with organization-scoped privacy protection.
Key Features#
- Presigned URL upload workflow with client-side direct upload for scalable file transfers
- Automatic face detection and indexing for person profile images
- Face search capability matching evidence images against indexed profile faces with configurable thresholds
- Multi-image support with avatar, reference, ID document, and other image categories
- Per-organization collection isolation preventing cross-tenant identification
- Primary image designation per profile with soft delete protection
- Storage metering with automatic usage tracking for billing and quota enforcement
- RBAC integration with write permission checks and organization-scoped access control
- Graceful error handling with best-effort cleanup for face indexing and storage operations
- Support for JPEG, PNG, and WebP formats with configurable size limits
Use Cases#
- Uploading and managing profile photos with automatic face enrollment for biometric search
- Searching indexed faces using evidence photos for suspect identification in investigations
- Managing multiple reference photos per person for improved recognition accuracy
- Tracking storage usage per tenant for billing and capacity planning
Integration#
The Profile Image Management domain connects with evidence services for face search, usage metering for billing, and RBAC for access control. It supports multi-tenant deployment with per-organization isolation.
Last Reviewed: 2026-02-23