Glossário¶
Termos Técnicos¶
API REST¶
Interface de programação que utiliza HTTP para comunicação entre cliente e servidor. O Billings Ease utiliza REST para comunicação entre frontend, mobile e backend.
JWT (JSON Web Token)¶
Token de autenticação stateless usado no sistema. Contém informações do usuário (ID, tipo, email) e é assinado com uma chave secreta.
Middleware¶
Camada intermediária que processa requisições antes de chegarem aos handlers. No Billings Ease, há middlewares para autenticação, verificação de roles e aprovação de perfil.
ORM (Object-Relational Mapping)¶
Ferramenta que mapeia objetos para tabelas de banco de dados. O backend usa GORM para interagir com PostgreSQL.
Repository Pattern¶
Padrão arquitetural que abstrai acesso a dados. Repositories encapsulam queries e operações de banco de dados.
Service Layer¶
Camada de lógica de negócio. Services implementam regras de negócio e orquestram chamadas a repositories.
Stateless¶
Sistema que não mantém estado entre requisições. O Billings Ease é stateless, usando JWT para autenticação.
Conceitos de Domínio¶
Ápice (Peak)¶
Último dia de muco fértil antes da mudança para muco infértil. Identificado pelo símbolo "fertilidade apice". Marca o início do período pós-ovulação.
Ciclo Menstrual¶
Período desde o primeiro dia de sangramento até o dia anterior ao próximo sangramento. Cada usuária pode ter apenas um ciclo ativo por vez.
Método Billings (MBO/MOB)¶
Método de Ovulação Billings - método natural de reconhecimento da fertilidade baseado na observação diária de sinais de fertilidade.
Observação Diária¶
Registro diário dos sinais de fertilidade: símbolo, sensação, aparência, sangramento e relação sexual. Apenas uma observação por dia por usuária.
Período Fértil¶
Período do ciclo em que a mulher está fértil. Determinado pelas regras do Método Billings baseadas em símbolos, ápice e dias do ciclo.
Período Infértil¶
Período do ciclo em que a mulher não está fértil. Após o 4º dia do ápice até o próximo sangramento.
Símbolo¶
Representação visual do muco cervical. Exemplos: "seca", "fertilidade", "fluxo", "fertilidade apice".
Sensação¶
Sensação percebida no muco cervical. Exemplos: "seca", "úmida", "lubrificante".
Aparência¶
Aparência visual do muco cervical. Exemplos: "transparente", "opaca", "espessa".
Abreviações Usadas¶
API¶
Application Programming Interface - Interface de programação de aplicações.
CRUD¶
Create, Read, Update, Delete - Operações básicas de banco de dados.
CORS¶
Cross-Origin Resource Sharing - Mecanismo que permite requisições de diferentes origens.
DI¶
Dependency Injection - Injeção de dependências.
EAS¶
Expo Application Services - Serviços da Expo para build e distribuição.
HTTP¶
Hypertext Transfer Protocol - Protocolo de comunicação web.
HTTPS¶
HTTP Secure - Versão segura do HTTP com criptografia.
ID¶
Identifier - Identificador único.
JWT¶
JSON Web Token - Token de autenticação.
MBO¶
Método Billings de Ovulação - Nome completo do método.
MOB¶
Método de Ovulação Billings - Abreviação alternativa.
MOP¶
Método de Ovulação Personalizado - Variação do método (não usado no sistema atual).
ORM¶
Object-Relational Mapping - Mapeamento objeto-relacional.
REST¶
Representational State Transfer - Estilo arquitetural para APIs.
R2¶
Cloudflare R2 - Serviço de armazenamento de objetos compatível com S3.
SQL¶
Structured Query Language - Linguagem de consulta estruturada.
UI¶
User Interface - Interface do usuário.
UX¶
User Experience - Experiência do usuário.
UUID¶
Universally Unique Identifier - Identificador único universal.
Perfis de Usuário¶
Admin¶
Administrador do sistema. Tem acesso a todas as funcionalidades, incluindo gerenciamento de usuários, planos e configuração do Método Billings.
Client¶
Cliente (paciente). Mulher que utiliza o Método Billings. Registra observações diárias, visualiza status de fertilidade e pode se vincular a profissionais.
Professional¶
Profissional de saúde especializado no Método Billings. Acompanha pacientes vinculados, analisa ciclos e fornece orientações. Precisa ter perfil aprovado por admin.
Status e Estados¶
Active (Ativo)¶
Ciclo que está em andamento. Apenas um ciclo ativo por usuária.
Approved (Aprovado)¶
Perfil profissional que foi aprovado por um administrador. Necessário para algumas funcionalidades.
Pending (Pendente)¶
Perfil profissional aguardando aprovação de administrador.
Verified (Verificado)¶
Email de usuário que foi verificado através do link enviado por email.
Termos Adicionais¶
Clean Architecture¶
Arquitetura em camadas com separação clara de responsabilidades. O backend segue uma versão simplificada: Handlers → Services → Repositories → Models.
Dependency Injection (DI)¶
Padrão onde dependências são injetadas externamente ao invés de criadas internamente. Facilita testes e flexibilidade.
Eager Loading¶
Técnica de carregar dados relacionados antecipadamente para evitar N+1 queries. Usado com Preload no GORM.
Health Check¶
Endpoint que verifica se o serviço está funcionando. No Billings Ease: GET /health.
Rate Limiting¶
Limitação de requisições por tempo para prevenir abuso. Implementado no backend para OAuth e rotas gerais.
Refresh Token¶
Token usado para obter novos access tokens sem precisar fazer login novamente. Tem validade maior que access token.
Soft Delete¶
Exclusão lógica onde registros são marcados como deletados mas não removidos fisicamente do banco. Usado em vários modelos.
Sync ID¶
Identificador único usado para sincronização entre mobile e backend. Permite identificar registros criados offline.
TanStack Query¶
Biblioteca React para gerenciar estado de servidor, cache e sincronização. Anteriormente conhecida como React Query.
Vite¶
Build tool moderna para frontend. Substitui Create React App, oferecendo build mais rápido e HMR (Hot Module Replacement).