Product Requirements Document (Master)

Sistema Integrado de Acesso Inteligente

Clínica Gandra

1. Visão Geral

Sistema de controle de acesso físico para a Clínica Gandra, integrado ao sistema de agenda. O objetivo é automatizar a abertura da fechadura eletromagnética apenas para agendamentos confirmados, utilizando hardware de baixo custo e arquitetura de software performática em Rust.

2. Pilares Tecnológicos

Backend (API)

Desenvolvido em Rust (Framework: Axum), rodando em servidor local.

Banco de Dados

SQLite (Armazenamento local, seguro e eficiente).

Hardware (IoT)

ESP32, Módulo de Biometria FPM10A e Relé 5V.

Protocolo

HTTP/REST (via Wi-Fi).

3. O que é a API, afinal?

A API é, essencialmente, o software. O fluxo funciona assim:

O software é escrito no VS Code (código-fonte em texto).
Rodamos o comando cargo build no terminal.
O compilador traduz esse texto para um arquivo binário (executável).
Ao rodar esse executável, ele inicia o servidor e fica "escutando" a rede aguardando um sinal do ESP32.

4. O Fluxo de Hardware (A Fechadura)

O Relé é o segredo: Desconecta-se o fio do interruptor atual da recepção e conecta-se ao módulo relé.
O ESP32: Escondido perto da porta. Ele recebe o comando via Wi-Fi do servidor Rust e fecha o circuito do relé.
Computador de TI: Um notebook dedicado na clínica atuará como servidor local.