# LifeDent HOF-Foto — Clinical Photo Workflow and Session Traceability for Orofacial Harmonization (v1.0)

**Project theme (PT-BR):** *Padronização e rastreabilidade fotográfica em Harmonização Orofacial: protocolo e sistema digital com mapa de aplicação.*

## Overview (EN)
**LifeDent HOF-Foto** is a browser-based web module that operationalizes a **standardized clinical photography protocol** for Orofacial Harmonization (HOF) using a **session-oriented record model**. It consolidates image series, capture metadata, and a **botulinum toxin application map** (points, units per point, per-region subtotals, and total units per session), aiming to improve **traceability**, **repeatability**, and longitudinal comparison (T0 → T1).

### What this module provides
- **Session-oriented structure:** each clinical session is a single traceable record linking photo series, metadata, and (when applicable) toxin mapping.
- **Standardized photo series organization:** protocol-driven series grouped by view and expression (e.g., frontal, 45° obliques, profiles; rest vs. smiles; selected mimics).
- **Guided framing & alignment tools:** overlay/grid references supporting geometric consistency (e.g., interpupillary plane and facial midline), with rotation/flip helpers (no destructive editing of original files).
- **Quality-control (QC) checkpoint:** completeness and alignment checks with an operational “recapture when needed” workflow.
- **Toxin mapping with automatic totalization:** point marking, renumbering, optional grouping by region/muscle, and automatic dose totals; exportable in image (PNG) and structured data (JSON/CSV).
- **Landmark annotator (optional):** stepwise marking of facial landmarks with checklist, drag-adjustment, zoom/pan, and export (JSON/CSV/PNG). Pixel→mm calibration is **optional** (disabled by default).

### Standardized capture protocol (summary)
The methodological development defined minimal capture parameters to reduce inter-session and inter-operator variability, including **environment/lighting**, **background**, **distance**, **framing**, and **cephalic orientation**. In the operational pilot, a Nikon D7000 with a 105 mm lens was used in manual mode (typical settings: f/8–f/11; 1/160–1/200 s; ISO 100–200), with symmetric diffuse LED lighting and fixed color temperature (e.g., 5600 K). Smartphone/tablet capture is supported as an alternative when standardized parameters are kept stable across sessions.

**Strict reproducibility principle (T1):** repeat the same framing and the same commanded expression used at T0, changing only tissue behavior due to muscle response—reducing pose/expression bias in pre–post comparisons.

### Session protocol structure (T0 and T1)
Each session is organized into two timepoints—**T0** (baseline) and **T1** (follow-up after muscle accommodation)—repeating the same views and commanded expressions. A typical timepoint includes **33 images** (66 per session when T0+T1 are completed), distributed as:
- **Main series (20 images):** 5 views (frontal, 45° right, 45° left, profile right, profile left) × 4 conditions (lips sealed, lips at rest, social smile, natural smile)
- **Dynamic series (6 images):** selected mimics for muscle response tracking
- **Complementary views (5 images):** when needed for regions of difficult reading
- **Mapping documentation (2 images):** application/marking records (when applicable)

**Laterality is recorded from the patient’s point of view** (right/left hemiface) to maintain operator consistency.

**QC (pilot thresholds, optional):** examples used in the pilot include normalized pixel checks such as interpupillary plane vertical deviation ≤1% of frame width, facial midline deviation ≤2%, scale variation (apparent interpupillary distance) ≤5% between T0 and T1, and cranial/chin margin variation ≤5% of frame height.

### Development stages
1. Capture protocol specification  
2. Session data model and record structure  
3. Standardization aids (framing alignment and acceptance checks)  
4. Dose mapping and calculation routines, with validation/recapture support

### Pilot status and limitations
An operational pilot assessed workflow feasibility (time and recapture needs) across multiple sessions and operators. Formal **quantitative validation** (e.g., intra-/inter-operator reliability statistics and measurement error) is planned for future work and is **not** claimed in this release.

## Descrição (PT-BR)
O **LifeDent HOF-Foto** é um módulo web executado no navegador que operacionaliza um **protocolo fotográfico padronizado** em Harmonização Orofacial (HOF) com **estrutura orientada por sessão**. Ele consolida séries de imagens, metadados de captura e um **mapa de aplicação de toxina botulínica** (pontos, U por ponto, subtotais por região e total por sessão), favorecendo **rastreabilidade**, **reprodutibilidade** e comparação longitudinal (T0 → T1).

### Recursos principais
- Registro **por sessão** (vínculo entre séries fotográficas, metadados e mapa/dose).
- Organização do protocolo por séries (vistas/expressões) e controle de completude.
- Ferramentas de **alinhamento** (overlay/grade), rotação e espelhamento sem alterar o arquivo original.
- **QC** ao final da sessão e rotina de **recaptura** quando necessário.
- **Mapeamento de aplicação** com numeração e **totalização automática** (por ponto/região) e exportação (PNG/JSON/CSV).
- **Landmark_annotator** (opcional) com checklist, arraste, zoom/pan e exportação; calibração px→mm é **opcional** e vem desativada por padrão.

### Protocolo de captura (resumo)
Foram definidos parâmetros mínimos para reduzir variações intersessões e interoperador (ambiente, iluminação, fundo, distância, enquadramento e orientação cefálica). Em T1, aplica-se o princípio de **reprodutibilidade estrita**: reproduzir o mesmo enquadramento e a mesma expressão de T0, alterando apenas o comportamento dos tecidos pela resposta muscular.

### Status e limitações
O piloto operacional avaliou viabilidade do fluxo (tempo total e necessidade de recaptura). **Não** se reivindica, neste release, validação estatística formal de confiabilidade intra/interoperador, que permanece como etapa futura.

## Contents (included in this deposit)
- `hof-foto/` — web module files and assets (HTML/CSS/JS; local browser prototype)
- `README.md` — quick start and usage notes
- `SECURITY.md` — security & confidentiality statement
- `CITATION.cff` — suggested citation metadata
- `CHANGELOG.md` — release notes

## Security & confidentiality (EN)
This record **does not include patient data** (no identifiable photos), user data, uploads, logs, database dumps, credentials, cryptographic keys, internal endpoints, or production configuration. Operational access is restricted to authorized users. Security-sensitive operational details are intentionally omitted.

## Segurança e sigilo (PT-BR)
Este registro **não contém dados de pacientes** (nem fotos identificáveis), dados de usuários, uploads, logs, dumps de banco, credenciais, chaves criptográficas, endpoints internos ou configuração de produção. O acesso ao sistema em operação é restrito a usuários autorizados. Detalhes operacionais sensíveis são intencionalmente omitidos.

## Suggested citation
Cite using the Zenodo DOI generated for this version.
