README

BarberManager

BarberManager é um sistema completo e moderno para a gestão de barbearias, projetado para revolucionar a conexão entre barbeiros e clientes. O projeto visa eliminar o atrito dos agendamentos manuais e oferecer um controle financeiro e administrativo robusto para os proprietários.

Este projeto é desenvolvido como requisito da disciplina de Programação Web, aplicando boas práticas de Engenharia de Software, UI/UX Design moderno e Arquitetura Limpa.

Sumário

• Visão Geral do Sistema
• Arquitetura e Tecnologias
• Diagramas de Arquitetura (C4 Model)
• Telas e Navegação (Protótipo Interativo)
• Módulos e Funcionalidades
• Funcionalidades Implementadas (Back-End)
• Estrutura do Repositório
• Próximos Passos (Roadmap)
• Como Executar Localmente

Visão Geral do Sistema

O sistema é dividido em dois universos distintos, compartilhando a mesma base de código (Single Codebase) graças ao poder do Delphi FMX:

• App Mobile (Para Clientes): Focado na experiência do utilizador (UX), permitindo cadastro ágil, escolha de serviços e agendamento de horários em poucos cliques.
• Dashboard Web/Desktop (Para Administradores): Um painel de controle de alta produtividade (resolução 1280x720) para os barbeiros gerirem a fila de espera, serviços oferecidos e a faturação diária.

Arquitetura e Tecnologias

Diagramas de Arquitetura (C4 Model)

A arquitetura do sistema foi modelada seguindo o C4 Model, que descreve o software em diferentes níveis de abstração — do contexto geral até os componentes internos e a infraestrutura de servidor.

Diagrama de Contexto

Visão macro do sistema: mostra o BarberManager e como ele se relaciona com os atores externos (Cliente, Barbeiro/Admin) e sistemas de terceiros.

Diagrama de Componentes

Detalha os principais componentes internos da aplicação e suas responsabilidades, evidenciando a separação entre o universo Mobile (Cliente) e Desktop (Admin).

Diagrama de Servidor

Representa a infraestrutura de implantação planejada, incluindo a comunicação entre os clientes, o servidor de aplicação e a base de dados.

Telas e Navegação (Protótipo Interativo)

Atualmente, o projeto encontra-se na fase de Integração Front × Back, onde todas as telas estão conectadas à base de dados Firebird e os dados são carregados e persistidos em tempo real.

Universo Cliente — App Mobile

Tela 01 — Login

Acesso seguro com design limpo e logo em destaque. Ponto de entrada principal do app mobile.

Tela 02 — Criar Nova Conta

Formulário amigável de cadastro com ícones ilustrativos e identificação visual clara para novos utilizadores.

Tela 03 — Home do Cliente

Carrossel de categorias de serviços, banners de ofertas em destaque e listagem de serviços disponíveis.

Tela 04 — Agendamento

Motor de agendamento completo: calendário interativo, grelha de horários disponíveis via FlowLayout e tela de confirmação do pedido.

Universo Administrador — Dashboard Web/Desktop

Tela 05 — Dashboard Administrativo

Visão geral financeira com KPIs principais (Faturação, Ticket Médio, Agendamentos Pendentes) e Linha do Tempo da agenda do dia.

Tela 06 — Gestão de Serviços

Catálogo dinâmico de serviços com filtros, contadores, e ações rápidas de edição e exclusão — construído com componentes nativos, sem dependências de terceiros.

Nota: Para visualizar as imagens em alta resolução, acesse o diretório docs/Telas/ neste repositório.

Módulos e Funcionalidades

Módulo Cliente (Front-End + Back-End Concluídos)

• [x] Autenticação (Login e Cadastro com ícones nos inputs)
• [x] Login real com validação na base de dados e hash SHA-256
• [x] Navegação por "Bottom Navigation" (Início, Agenda, Carrinho, Perfil)
• [x] Catálogo de Serviços carregado dinamicamente de TB_SERVICOS
• [x] Filtros de categoria funcionais (Todos / Cabelo / Barba / Estética)
• [x] Motor de Agendamento completo (Serviço + Barbeiro + Horário)
• [x] Persistência do agendamento em TB_AGENDAMENTOS com cálculo automático de HR_FIM

Módulo Barbeiro/Admin (Front-End + Back-End Concluídos)

• [x] Sidebar de Navegação responsiva
• [x] Cards de Resumo Financeiro com dados reais do dia (KPIs via query agregada)
• [x] Linha do Tempo com agendamentos reais, coloridos por status
• [x] Tela de Gestão de Serviços (visual concluído — lógica CRUD em desenvolvimento)

Funcionalidades Implementadas (Back-End)

Esta secção detalha o que foi efectivamente desenvolvido e integrado com a base de dados Firebird nas Fases 5, 6 e 7.

Conexão à Base de Dados — Model.Conexao.pas

TdmConexao é um DataModule singleton criado inteiramente por código (sem componentes no designer), garantindo portabilidade e controlo total da ligação FireDAC.

• Ligação ao Firebird 3.0 via protocolo Local (fbclient.dll)
• CharacterSet UTF-8, credenciais configuradas em código
• FDConnection1 exposto como public para acesso por todos os Forms e Frames

Autenticação Real — View.Principal.pas

O login deixou de ser simulado e passou a validar as credenciais directamente na tabela TB_USUARIOS.

• Query à TB_USUARIOS com filtro por e-mail e hash SHA-256 da password
• Redireccionamento automático: perfil CLIENTE → Home Mobile; perfil ADMIN → Dashboard Desktop
• Password armazenada como SHA-256 em maiúsculas (UpperCase(THashSHA2.GetHashString(...)))

Catálogo de Serviços Dinâmico

Os cards de serviços na Home do cliente são criados programaticamente a partir dos registos activos em TB_SERVICOS.

• Cards (TLayout) criados em runtime com Align=None e Position.Y explícito
• Filtros de categoria aplicam cláusula WHERE CATEGORIA = :CAT dinamicamente
• Cor e estado visual actualizados via StyledSettings := [] + TextSettings.FontColor

Motor de Agendamento

Fluxo completo: o cliente selecciona serviço → barbeiro → horário → confirma. O registo é inserido na base de dados.

• Barbeiros carregados de TB_BARBEIROS com JOIN a TB_USUARIOS
• 20 slots de horário gerados programaticamente no TFlowLayout, com estados disponível/ocupado
• HR_FIM calculado automaticamente com IncMinute(HR_INICIO, DURACAO_MIN)
• INSERT em TB_AGENDAMENTOS com todos os campos (cliente, barbeiro, serviço, datas, valor)

Dashboard Administrativo com KPIs Reais

Os dados exibidos no painel deixaram de ser estáticos — são calculados em tempo real a partir dos agendamentos do dia.

• Query agregada a TB_AGENDAMENTOS com filtro DT_AGENDAMENTO = CURRENT_DATE
• KPIs actualizados: Faturação (SUM), Total, Pendentes e Cancelados (SUM CASE WHEN)
• Linha do Tempo: JOIN entre TB_AGENDAMENTOS, TB_USUARIOS, TB_BARBEIROS e TB_SERVICOS
• Cards dinâmicos na linha do tempo com cores por status: Concluído / Em Andamento / Pendente / Cancelado

Estrutura do Repositório

BarberManager
 ??? database
 ??? ??? BARBERMANAGER.FDB          # Base de dados Firebird 3.0
 ??? docs
 ??? ??? Diagramas_C4               # Diagramas C4 Model da arquitetura (.png)
 ??? ??? Telas                      # Prints das telas de UI/UX aprovadas (.png)
 ??? src
 ??? ??? Model
 ??? ??? ??? Model.Conexao.pas        # DataModule de liga????o FireDAC/Firebird
 ??? ??? View
 ???   ??? View.Principal.pas       # App Mobile ??? Login, Home, Agendamento
 ???   ??? View.DashboardAdmin.pas  # Dashboard Admin ??? KPIs e Linha do Tempo
 ???   ??? View.Frame.Servicos.pas  # Frame injet??vel de Gest??o de Servi??os
 ??? CLAUDE.md                    # Contexto t??cnico do projecto para o assistente IA
 ??? README.md                    # Esta documenta????o

Próximos Passos (Roadmap)

A metodologia de desenvolvimento adotada separa estritamente o Front-end do Back-end. Estado actual das fases:

• [x] Fase 1: Definição de Escopo e Requisitos
• [x] Fase 2: Design System e Protótipos no Figma
• [x] Fase 3: Construção do Front-End (UI) no Delphi FMX
• [x] Fase 4: Navegação, Transições e UX interativa (Mockups)
• [x] Fase 5: Modelagem da Base de Dados Relacional (DER) e criação do schema Firebird ✅
• [x] Fase 6: Criação do Back-End (Regras de Negócio — Conexão, Login, Agendamento, KPIs) ✅
• [x] Fase 7: Integração Front × Back (Data Binding e Persistência) — parcial ✅
• [ ] Fase 8: CRUD completo de Serviços no Frame Admin + Deploy via D2Bridge ⏳
• [ ] Fase 9: Testes Automatizados da API (Postman/Newman) 🔄 Em andamento
  • [x] Módulo Auth (login válido, senha inválida, email não cadastrado)
  • [x] Módulo Servicos (CRUD completo + validação, com 3 bugs encontrados e documentados)
  • [x] Módulo Agendamentos (2 bugs críticos encontrados e confirmados em 2 bancos diferentes: sem validação de conflito de horário, valor não calculado)
  • [ ] Módulo Dashboard
  • [ ] Módulo Clientes
  • [ ] Módulo Barbeiros
  • [ ] Módulo Avaliacoes
  • [ ] Módulo Usuarios
  • Ver docs/Qualidade/BUGS_ENCONTRADOS.md para o relatório detalhado de bugs

Como Executar Localmente

Pré-requisitos

1. Clone o repositório

git clone https://github.com/miguettohuertas/BarberManager.git

2. Configure a base de dados

a) Certifique-se de que o servidor Firebird 3.0 está instalado em:

C:\Program Files (x86)\Firebird\Firebird_3_0\

b) O ficheiro da base de dados já está incluído no repositório em:

database\BARBERMANAGER.FDB

c) Verifique que o caminho em src\Model\Model.Conexao.pas aponta para a localização correcta:

FDConnection1.Params.Database :=
  'C:\ProjetosDelphi\BarberManager\BarberManager\database\barbermanager.fdb';

Ajuste o caminho se tiver clonado o repositório para outra directoria.

3. Compile e execute

a) Abra o arquivo .dproj no Embarcadero Delphi 12.

b) Defina a plataforma alvo como Windows 32-bit.

c) Pressione F9 para compilar e executar.

Credenciais de Teste

Navegação de Teste

Desenvolvido como projeto acadêmico — Disciplina de Programação Web