Sistema de Gestão de Salão de Beleza

Overview

A full-stack salon management system that centralizes daily operations for beauty salons. The React/Vite frontend provides a modern, responsive dashboard integrated with a Django REST API. It supports client, team, services, and appointment management, with conflict prevention, localized validations, health checks, and analytics.

Key Features

Client Management
Full CRUD with name, email, phone, and address. Brazilian phone validation and formatting.
Team Management
Manage professionals with contact info and specialties, linked to the services they perform.
Service Catalog
Create and maintain services with name, description, price, and duration (validated).
Appointment Scheduling
Book appointments linking clients, professionals, and one or more services. Tracks date/time, total price, notes, and status workflow: scheduled, confirmed, in progress, completed, cancelled, no-show.
Conflict Prevention
Backend prevents double-booking when a professional is already occupied.
Admin Dashboard UI
Sidebar navigation for Dashboard, Clients, Team, Services, and Appointments. Responsive design with gradients and subtle animations.
API-First + Docs
Django REST Framework API with Swagger/OpenAPI documentation for clients, team, services, and appointments.
Localization & Validation
Configured for Brazilian locale (timezone, language) and phone formatting/validation.
Health Checks & Error Handling
Frontend tests API health, shows live connection status, displays friendly error toasts, and provides retry.
Analytics
Page view tracking on route changes for usage insights.

Tech Stack

Frontend: React 18, Vite, React Router, Axios, CSS3
Backend: Django 5, Django REST Framework, drf-yasg (Swagger/OpenAPI), django-cors-headers, python-dotenv
Database: SQLite (dev) / PostgreSQL (prod-ready)
DevOps: Docker / Docker Compose, environment-based configuration

Notable Endpoints

/api/clients/ — list/create, /api/clients/{id}/ — retrieve/update/delete
/api/team/ — list/create, /api/team/{id}/ — retrieve/update/delete
/api/services/ — list/create, /api/services/{id}/ — retrieve/update/delete
/api/appointments/ — list/create, /api/appointments/{id}/ — retrieve/update/delete
Swagger docs: /swagger/

Screens / UX

Sidebar-driven dashboard with sections for operational tasks
Responsive layout, clean typography, and status indicators for API connectivity

Notes

CORS configured for SPA development
Environment variables for easy deployments
Optional Docker setup for dev and production

🇧🇷 Esta página também está disponível em Português

Visão Geral

Sistema completo de gestão para salões de beleza que centraliza as operações diárias. O frontend em React/Vite oferece um painel moderno e responsivo integrado a uma API Django REST. Suporta gestão de clientes, equipe, serviços e agendamentos, com prevenção de conflitos, validações localizadas, verificações de saúde da API e analytics.

Principais Funcionalidades

Gestão de Clientes
CRUD completo com nome, e-mail, telefone e endereço. Validação e formatação de telefone brasileiro.
Gestão de Equipe
Gerencie profissionais com informações de contato e especialidades, vinculados aos serviços que realizam.
Catálogo de Serviços
Crie e mantenha serviços com nome, descrição, preço e duração (validados).
Agendamento de Consultas
Agende atendimentos vinculando clientes, profissionais e um ou mais serviços. Registra data/hora, preço total, observações e fluxo de status: agendado, confirmado, em andamento, concluído, cancelado, não compareceu.
Prevenção de Conflitos
O backend impede duplo agendamento quando um profissional já está ocupado.
Interface do Painel Administrativo
Navegação lateral para Dashboard, Clientes, Equipe, Serviços e Agendamentos. Design responsivo com gradientes e animações sutis.
API-First + Documentação
API Django REST Framework com documentação Swagger/OpenAPI para clientes, equipe, serviços e agendamentos.
Localização & Validação
Configurado para o locale brasileiro (fuso horário, idioma) e formatação/validação de telefone.
Verificações de Saúde & Tratamento de Erros
O frontend testa a saúde da API, exibe o status de conexão em tempo real, mostra toasts de erro amigáveis e oferece retry.
Analytics
Rastreamento de visualizações de página nas mudanças de rota para insights de uso.

Stack Tecnológica

Frontend: React 18, Vite, React Router, Axios, CSS3
Backend: Django 5, Django REST Framework, drf-yasg (Swagger/OpenAPI), django-cors-headers, python-dotenv
Banco de Dados: SQLite (dev) / PostgreSQL (pronto para produção)
DevOps: Docker / Docker Compose, configuração baseada em variáveis de ambiente

Endpoints Principais

/api/clients/ — listar/criar, /api/clients/{id}/ — recuperar/atualizar/deletar
/api/team/ — listar/criar, /api/team/{id}/ — recuperar/atualizar/deletar
/api/services/ — listar/criar, /api/services/{id}/ — recuperar/atualizar/deletar
/api/appointments/ — listar/criar, /api/appointments/{id}/ — recuperar/atualizar/deletar
Documentação Swagger: /swagger/

Telas / UX

Painel com navegação lateral para tarefas operacionais
Layout responsivo, tipografia limpa e indicadores de status de conectividade da API

Observações

CORS configurado para desenvolvimento SPA
Variáveis de ambiente para facilitar implantações
Configuração Docker opcional para desenvolvimento e produção

🇺🇸 This page is also available in English