Renan Ferreirasistemas em operação

FULL-STACK · AGENDA · OPERAÇÃO

Freitas Auto Care

Plataforma de estética automotiva com catálogo, portfólio, clientes, veículos, agendamento e painel administrativo na mesma operação.

01 — CONTEXTO

Problema

Um site institucional mostra serviços, mas não resolve os conflitos de uma agenda real. Horários, duração, bloqueios, veículos, cancelamentos e alterações administrativas precisam compartilhar as mesmas regras, inclusive quando duas solicitações chegam quase juntas.

02 — SOLUÇÃO

O que construí

A aplicação centraliza regras no backend, calcula disponibilidade, revalida a escolha ao confirmar e usa uma constraint no PostgreSQL contra sobreposição. O painel administra serviços, horários, portfólio e avaliações; o assistente só executa tools permitidas e exige confirmação.

03 — FLUXO

Arquitetura

  1. 01Interface Next.js
  2. 02Route handlers
  3. 03Módulos de domínio
  4. 04Prisma
  5. 05PostgreSQL
  6. 06Nginx e backups

04 — ENGENHARIA

Decisões de construção

  • Revalidar horários no servidor e reforçar a regra com constraint no banco.
  • Salvar preço, duração e nome como snapshot do agendamento para preservar seu contexto histórico.
  • Dar ao assistente apenas tools estreitas e exigir confirmação explícita antes de preparar uma ação.

05 — REALIDADE

Desafios

  • Representar múltiplos intervalos de expediente, bloqueios e buffers sem duplicar regras no frontend.
  • Manter uploads persistentes e recuperáveis junto com o banco em uma implantação por containers.
  • Fazer a interface preta e dourada permanecer legível, rápida e sóbria em telas pequenas.

06 — RESPONSABILIDADE

Segurança e limites

  • Sessões usam cookie HTTP-only; somente o hash do token fica no banco.
  • Uploads são limitados por formato, assinatura e tamanho.
  • Login, cadastro, IA e uploads têm limites de requisição; ações administrativas geram auditoria.

07 — ESTADO REAL

Resultado atual

Existe um fluxo full-stack demonstrável, com migrations, seed idempotente, sessões revogáveis, backup de banco e imagens e documentação de deploy. A apresentação não afirma operação comercial ou resultados de negócio ainda não medidos.

08 — EVOLUÇÃO

O que aprendi

  • Regras críticas de agenda precisam existir no servidor e no banco; validação visual não resolve concorrência.
  • Snapshots preservam o significado histórico de uma transação quando o catálogo muda depois.

09 — CONTINUIDADE

Próximos passos

  • Ampliar testes de integração para os fluxos de agenda e autenticação.
  • Preparar uma demonstração com dados e imagens explicitamente licenciados.
  • Definir domínio e estratégia de deploy somente com o responsável pelo negócio.