PLATAFORMA MULTIEMPRESA DE AGENDAMENTO DE SERVIÇOS

 

1. OBJETIVO PRINCIPAL

Criar um motor de agendamento que permita que qualquer empresa portuguesa cadastre:

• empresa,
• profissionais,
• serviços,
• categorias,
• preços,
• duração,
• horários,
• disponibilidade,
• áreas de atendimento,
• códigos postais,
• adicionais,
• descontos,
• recorrências,
• pagamentos,
• avaliações,

e permita ao cliente:

1. encontrar uma empresa,
2. escolher um serviço,
3. informar localização,
4. receber preço automaticamente,
5. verificar disponibilidade,
6. escolher data,
7. escolher horário,
8. cadastrar seus dados,
9. pagar,
10. receber confirmação,
11. acompanhar o profissional,
12. receber notificações,
13. avaliar o serviço.

O sistema deve funcionar inicialmente para empresas de limpeza, mas sua arquitetura deve permitir qualquer segmento de serviços.

---

2. PRIMEIRO NICHO: LIMPEZA

Criar inicialmente categorias como:

Limpeza doméstica

• Limpeza de manutenção
• Limpeza única
• Limpeza profunda
• Limpeza pós-obra
• Limpeza de mudança
• Limpeza de apartamentos
• Limpeza de moradias
• Limpeza de escritórios
• Limpeza de condomínios
• Limpeza de lojas
• Limpeza de alojamento local

Serviços específicos

• Limpeza de vidros
• Limpeza de janelas
• Limpeza de estores
• Limpeza de persianas
• Limpeza de forno
• Limpeza de frigorífico
• Limpeza de armários
• Limpeza de sofás
• Limpeza de colchões
• Limpeza de tapetes
• Limpeza de carpetes
• Limpeza a vapor
• Desinfeção
• Limpeza de pavimentos
• Limpeza de garagens

Empresarial

• Escritórios
• Lojas
• Clínicas
• Escolas
• Infantários
• Restaurantes
• Condomínios
• Armazéns
• Espaços comerciais
• Instalações industriais

Eventos

• Antes do evento
• Durante o evento
• Depois do evento
• Limpeza completa de evento

A arquitetura deve permitir criar novas categorias sem modificar o código.

---

3. PREÇOS INICIAIS

Criar um sistema de preços totalmente parametrizável.

Como referência inicial de mercado para Portugal, utilizar:

Limpeza de manutenção

18,50 €/hora

Mínimo: 4 horas-equipe.

Limpeza única

18,50 €/hora

Mínimo: 6 horas-equipe.

Limpeza profunda

20,50 €/hora

Mínimo: 8 horas-equipe.

Pós-obra

20,50 €/hora

Mínimo: 8 horas-equipe.

Serviços específicos

Utilizar inicialmente valores configuráveis, por exemplo:

Vidros: 18,50 €/hora

Pavimentos: 18,50 €/hora

Desinfeção: 20,50 €/hora

Limpeza a vapor: 25 €/hora

Engomadoria: 18,50 €/hora

IMPORTANTE:

Esses valores NÃO devem ficar hardcoded.

Criar:

SERVICE_PRICING

com:

• preço base,
• preço por hora,
• preço mínimo,
• duração mínima,
• preço adicional,
• IVA,
• taxa de deslocação,
• preço por profissional,
• preço por equipa,
• preço por área,
• preço por quantidade,
• preço personalizado.

O administrador deve conseguir alterar tudo pelo painel.

---

4. SISTEMA DE EQUIPE

O cálculo precisa diferenciar:

HORAS DO SERVIÇO

de

HORAS-EQUIPE.

Exemplo:

2 profissionais × 3 horas = 6 horas-equipe.

Se o serviço custa 18,50 €/hora-equipe:

6 × 18,50 = 111 €.

Permitir que a empresa configure:

• 1 profissional,
• 2 profissionais,
• 3 profissionais,
• 4 ou mais profissionais.

Também permitir preço fixo por equipe.

---

5. CALCULADORA DE ORÇAMENTO

Antes do cliente realizar o agendamento, apresentar uma calculadora.

Perguntar:

Local

• código postal,
• morada,
• número,
• complemento,
• freguesia,
• concelho,
• distrito.

Imóvel

• apartamento,
• moradia,
• escritório,
• loja,
• clínica,
• restaurante,
• condomínio,
• outro.

Dimensão

• T0,
• T1,
• T2,
• T3,
• T4,
• T5+,
• metragem em m².

Serviço

• manutenção,
• única,
• profunda,
• pós-obra,
• específico.

Frequência

• única,
• semanal,
• quinzenal,
• mensal.

Extras

• forno,
• frigorífico,
• armários,
• vidros,
• estores,
• varanda,
• terraço,
• sofá,
• colchão,
• tapetes,
• engomadoria,
• vapor,
• desinfeção.

Calcular automaticamente:

SUBTOTAL

• EXTRAS
• DESLOCAÇÃO
• TAXAS

• DESCONTO

• IVA

= TOTAL

Mostrar claramente o preço final.

---

6. CÓDIGOS POSTAIS DE PORTUGAL

Criar uma estrutura específica para códigos postais.

Tabela:

POSTAL_CODES

Campos:

• id,
• postal_code,
• district,
• municipality,
• parish,
• locality,
• latitude,
• longitude,
• active.

Criar também:

SERVICE_AREAS

Campos:

• empresa,
• código postal,
• raio,
• taxa,
• disponibilidade,
• ativo.

Permitir:

Área gratuita

Área com taxa

Área fora de cobertura

Área sob consulta.

---

7. EXEMPLO DE LISBOA

Utilizar inicialmente como área de teste:

Lisboa

Alvalade

1700-253

Rua Jorge Colaço

O sistema deve permitir cadastrar:

Rua Jorge Colaço, 32 A
1700-253
Alvalade
Lisboa

e verificar automaticamente se a empresa atende essa região.

---

8. DISPONIBILIDADE

Criar API:

GET /api/v1/availability

Receber:

• service_id,
• company_id,
• postal_code,
• date,
• duration,
• team_size.

Retornar somente horários realmente disponíveis.

Exemplo:

{
“date”: “2026-10-05”,
“available”: true,
“slots”: [
“09:00”,
“10:00”,
“11:00”,
“14:00”,
“15:00”
] }

Impedir:

• dupla reserva,
• conflito de profissional,
• conflito de equipe,
• conflito de horário,
• conflito de deslocamento.

---

9. AGENDA

Criar agenda:

• diária,
• semanal,
• mensal.

Visualizações:

CALENDÁRIO

LISTA

MAPA

AGENDA POR PROFISSIONAL

AGENDA POR EQUIPE

AGENDA POR EMPRESA.

Permitir:

• criar,
• editar,
• cancelar,
• remarcar,
• bloquear horário,
• férias,
• feriados,
• indisponibilidade,
• pausa,
• horário extraordinário.

---

10. AGENDAMENTO

Criar:

POST /api/v1/bookings

Exemplo:

{
“company_id”: 10,
“service_id”: 101,
“date”: “2026-10-05”,
“start_time”: “10:00”,
“duration”: 4,
“team_size”: 2,
“postal_code”: “1700-253”,
“address”: “Rua Jorge Colaço, 32 A”,
“customer”: {
“name”: “João Silva”,
“phone”: “+351912000000”,
“email”: “cliente@email.pt”
}
}

Retornar:

{
“booking_id”: “CP-20261005-000145”,
“status”: “pending_payment”,
“total”: 92.50,
“currency”: “EUR”
}

---

11. STATUS DO AGENDAMENTO

Criar máquina de estados:

PENDING

CONFIRMED

PAYMENT_PENDING

PAID

ASSIGNED

PROFESSIONAL_ON_THE_WAY

ARRIVED

IN_PROGRESS

COMPLETED

REVIEW_PENDING

REVIEWED

CANCELLED

RESCHEDULED

NO_SHOW

REFUND_PENDING

REFUNDED.

Registrar histórico de cada mudança.

---

12. AGENDAMENTO RECORRENTE

Implementar:

• semanal,
• quinzenal,
• mensal,
• dias específicos,
• intervalo personalizado.

Exemplo:

{
“frequency”: “weekly”,
“weekday”: “monday”,
“start_date”: “2026-10-05”
}

Gerar automaticamente os próximos agendamentos.

Permitir:

• pausar,
• cancelar,
• alterar,
• pular uma ocorrência.

---

13. CLIENTE

Criar cadastro:

Nome

NIF

Email

Telefone

WhatsApp

Data de nascimento opcional

Moradas

Código postal

Histórico

Agendamentos

Pagamentos

Faturas

Avaliações

Favoritos

Empresas utilizadas.

Um cliente pode ter várias moradas.

---

14. EMPRESA

Cada empresa terá:

Nome comercial

Nome legal

NIF

CAE

Morada

Código postal

Concelho

Distrito

Telefone

Email

Website

Logo

Fotos

Descrição

Horário

Serviços

Profissionais

Áreas atendidas

Avaliações

Políticas

Dados fiscais.

---

15. PROFISSIONAIS

Cadastro:

Nome

Foto

Telefone

Email

Documento interno

Especialidades

Serviços autorizados

Áreas atendidas

Horário

Dias de trabalho

Férias

Avaliação

Status:

ACTIVE

INACTIVE

VACATION

BLOCKED.

---

16. EQUIPES

Permitir criar equipes:

Equipe Lisboa Centro

Equipe Alvalade

Equipe Porto Centro

etc.

Cada equipe pode possuir vários profissionais.

O sistema deve verificar disponibilidade da equipe.

---

17. PAGAMENTOS

Preparar arquitetura para:

• cartão,
• MB WAY,
• Multibanco,
• transferência bancária,
• pagamento no local.

Criar abstração:

PAYMENT_PROVIDER

para futuramente integrar gateways diferentes sem alterar o sistema principal.

---

18. FATURAÇÃO

Criar:

• fatura,
• recibo,
• nota de crédito,
• estado de pagamento,
• IVA,
• NIF,
• dados fiscais.

Preparar integração futura com software de faturação certificado em Portugal.

---

19. NOTIFICAÇÕES

Enviar:

Email

SMS

WhatsApp

Push.

Eventos:

• reserva criada,
• pagamento recebido,
• reserva confirmada,
• profissional atribuído,
• lembrete,
• profissional a caminho,
• serviço iniciado,
• serviço concluído,
• cancelamento,
• alteração de horário,
• avaliação solicitada.

---

20. PROFISSIONAL A CAMINHO

Criar opção:

“Estou a caminho”

O cliente recebe:

PROFISSIONAL A CAMINHO

e posteriormente:

“Profissional chegou.”

Preparar arquitetura para localização GPS em tempo real, mas deixar esse recurso opcional.

---

21. AVALIAÇÕES

Após conclusão:

★★★★★

Avaliar:

• qualidade,
• pontualidade,
• atendimento,
• profissionalismo,
• custo-benefício.

Permitir comentário e fotos.

Criar sistema antifraude básico:

somente clientes com reserva concluída podem avaliar.

---

22. PAINEL ADMINISTRATIVO

Criar dashboard com:

Agendamentos hoje

Agendamentos amanhã

Receita hoje

Receita mensal

Serviços realizados

Serviços cancelados

Taxa de ocupação

Ticket médio

Novos clientes

Clientes recorrentes

Profissionais ativos

Empresas ativas.

Gráficos:

receita,

reservas,

cancelamentos,

serviços por categoria,

região,

profissional,

empresa.

---

23. PAINEL DA EMPRESA

Cada empresa deve enxergar apenas seus próprios dados.

Menu:

Dashboard

Agenda

Reservas

Clientes

Profissionais

Equipes

Serviços

Preços

Extras

Áreas atendidas

Códigos postais

Pagamentos

Faturas

Avaliações

Relatórios

Configurações.

---

24. PAINEL DO PROFISSIONAL

O profissional deve enxergar:

Agenda

Hoje

Próximos serviços

Endereço

Cliente

Serviço

Observações

Check-in

Iniciar serviço

Finalizar serviço

Fotos antes/depois

Ocorrências.

---

25. MULTIEMPRESA

ESTE É UM REQUISITO FUNDAMENTAL.

O sistema deve ser multi-tenant.

Empresa A não pode visualizar dados da Empresa B.

Estruturar todas as entidades com:

tenant_id/company_id.

Criar:

SUPER_ADMIN

COMPANY_ADMIN

MANAGER

PROFESSIONAL

CUSTOMER.

Aplicar RBAC.

---

26. API COMPLETA

Criar:

/api/v1/auth/

/api/v1/customers/

/api/v1/companies/

/api/v1/professionals/

/api/v1/teams/

/api/v1/services/

/api/v1/service-categories/

/api/v1/service-addons/

/api/v1/pricing/

/api/v1/postal-codes/

/api/v1/service-areas/

/api/v1/availability/

/api/v1/bookings/

/api/v1/recurring-bookings/

/api/v1/addresses/

/api/v1/payments/

/api/v1/invoices/

/api/v1/coupons/

/api/v1/notifications/

/api/v1/reviews/

/api/v1/reports/

/api/v1/dashboard/.

Documentar cada endpoint.

---

27. SEGURANÇA

Implementar:

JWT/OAuth2

refresh tokens

RBAC

rate limiting

CORS

CSRF quando aplicável

validação de entrada

sanitização

logs

auditoria

criptografia de dados sensíveis

password hashing

proteção contra brute force

proteção contra SQL Injection

proteção contra XSS

proteção contra IDOR

controle de acesso por tenant.

Nunca expor dados de uma empresa para outra.

---

28. RGPD / GDPR

O sistema será utilizado em Portugal.

Implementar:

consentimento,

política de privacidade,

direito de acesso,

direito de correção,

direito de eliminação,

exportação de dados,

retenção de dados,

logs de consentimento,

preferências de comunicação.

Criar mecanismo de anonimização quando necessário.

---

29. BANCO DE DADOS

Criar estrutura relacional completa.

Tabelas mínimas:

users

roles

permissions

companies

company_settings

customers

customer_addresses

professionals

teams

team_members

services

service_categories

service_addons

service_pricing

postal_codes

service_areas

availability

working_hours

holidays

blocked_times

bookings

booking_items

booking_addons

booking_professionals

recurring_bookings

payments

payment_transactions

invoices

coupons

notifications

reviews

review_photos

audit_logs.

Criar chaves estrangeiras, índices e constraints.

---

30. ARQUITETURA

Escolha uma stack moderna, segura e escalável.

Preferencialmente:

BACKEND:

Python + FastAPI

DATABASE:

PostgreSQL

CACHE:

Redis

TASK QUEUE:

Celery ou alternativa adequada

FRONTEND:

Next.js / React

UI:

Tailwind CSS

API:

REST + possibilidade futura de GraphQL

DOCUMENTAÇÃO:

OpenAPI / Swagger.

Caso escolha outra stack, explique tecnicamente a razão.

---

31. INTERFACE

A interface deve ser:

moderna,

limpa,

rápida,

responsiva,

mobile-first,

profissional,

adequada ao mercado português.

Criar:

Landing Page

Busca de serviços

Busca por localização

Página da empresa

Página do serviço

Calculadora

Checkout

Agenda

Área do cliente

Área da empresa

Área do profissional

Admin.

---

32. FLUXO DO CLIENTE

Implementar exatamente este fluxo:

1. Entrar no portal.
2. Escolher serviço.
3. Informar localização.
4. Verificar cobertura.
5. Responder perguntas.
6. Calcular preço.
7. Escolher data.
8. Escolher horário.
9. Escolher profissional/equipe quando permitido.
10. Adicionar extras.
11. Criar conta ou continuar como convidado.
12. Confirmar morada.
13. Escolher pagamento.
14. Confirmar.
15. Receber número da reserva.
16. Receber notificações.
17. Acompanhar serviço.
18. Confirmar conclusão.
19. Avaliar.

---

33. MODELO DE DADOS DO PREÇO

Não assumir que todo serviço é cobrado por hora.

Criar tipos:

HOURLY

FIXED

PER_SQUARE_METER

PER_UNIT

PER_PERSON

PER_ROOM

PER_SERVICE

QUOTE.

Exemplos:

Limpeza = hora

Limpeza pós-obra = m² ou orçamento

Vidros = unidade/m²

Sofá = unidade

Colchão = unidade

Evento = orçamento

Isso tornará o sistema reutilizável para outros segmentos.

---

34. MARKETPLACE

Preparar o sistema para o Comércio Portugal.

O portal deverá futuramente permitir:

CLIENTE

↓

SERVIÇO

↓

EMPRESA

↓

PROFISSIONAL

↓

AGENDA

↓

PAGAMENTO

↓

AVALIAÇÃO.

Criar também possibilidade de várias empresas oferecerem o mesmo serviço.

Exemplo:

“Limpeza doméstica em Alvalade”

Empresa A

Empresa B

Empresa C

O cliente poderá visualizar:

preço,

disponibilidade,

avaliação,

distância,

serviços,

horários.

Não criar ranking político ou qualquer sistema inadequado; o ordenamento deve ser baseado em critérios objetivos e configuráveis, como disponibilidade, distância, preço ou relevância.

---

35. SEO LOCAL

Preparar URLs:

/lisboa/

/lisboa/alvalade/

/lisboa/alvalade/limpeza/

/lisboa/alvalade/limpeza-domestica/

/lisboa/alvalade/limpeza-profunda/

/lisboa/alvalade/empresas/

/lisboa/alvalade/empresas/limpeza/

E posteriormente:

/codigo-postal/1700-253/

/1700-253/limpeza/

/1700-253/empresas/

As páginas devem possuir conteúdo útil e exclusivo.

Não gerar milhares de páginas vazias ou duplicadas.

---

36. IMPORTANTE SOBRE SEO

Criar páginas somente quando houver:

• empresas,
• serviços,
• dados locais,
• conteúdo útil,
• informações relevantes.

Evitar doorway pages.

Evitar conteúdo duplicado.

Evitar geração automática de páginas sem valor.

---

37. API PARA O COMÉRCIO PORTUGAL

Criar uma camada de integração:

POST /api/v1/marketplace/listings

POST /api/v1/marketplace/leads

GET /api/v1/marketplace/services

GET /api/v1/marketplace/providers

POST /api/v1/marketplace/booking.

Assim, o Comércio Portugal poderá consumir a API.

---

38. LEADS

Criar sistema de leads.

Cliente pode escolher:

“Quero contratar agora”

ou:

“Quero receber orçamentos”.

No segundo caso:

Criar LEAD.

Enviar para empresas compatíveis.

Registrar:

empresa,

cliente,

serviço,

localização,

valor estimado,

data,

status.

Status:

NEW

SENT

VIEWED

CONTACTED

QUOTED

ACCEPTED

REJECTED

EXPIRED.

---

39. ORÇAMENTO PERSONALIZADO

Empresa poderá responder ao lead:

Preço

Prazo

Data disponível

Observações

Materiais

Condições.

Cliente pode:

aceitar,

recusar,

pedir alteração.

Se aceitar:

LEAD → BOOKING.

---

40. CUPONS

Criar:

percentual,

valor fixo,

primeira reserva,

cliente recorrente,

empresa específica,

serviço específico,

código postal,

período.

---

41. PROGRAMA DE RECORRÊNCIA

Criar descontos configuráveis:

Semanal

Quinzenal

Mensal.

Exemplo:

5% semanal

3% quinzenal

2% mensal.

Esses valores devem ser apenas configuração inicial e totalmente editáveis.

---

42. REGRAS DE CANCELAMENTO

Permitir configuração por empresa:

cancelamento gratuito até X horas,

taxa de cancelamento,

remarcação gratuita,

taxa de no-show.

Nunca deixar essas regras fixas no código.

---

43. RELATÓRIOS

Criar:

faturamento,

reservas,

clientes,

serviços,

profissionais,

ocupação,

cancelamentos,

origem dos clientes,

códigos postais,

áreas mais solicitadas,

serviços mais vendidos,

ticket médio,

recorrência.

Exportação:

CSV

Excel

PDF.

---

44. WEBHOOKS

Criar:

booking.created

booking.confirmed

booking.cancelled

booking.rescheduled

booking.started

booking.completed

payment.created

payment.paid

payment.failed

review.created

lead.created

lead.accepted.

---

45. WEBHOOK RECEIVER

Permitir integração futura com:

CRM

ERP

faturação

WhatsApp

email

SMS

marketplace

Comércio Portugal.

---

46. DOCUMENTAÇÃO

Entregar:

README

arquitetura

diagrama do banco

ERD

documentação API

Swagger

variáveis de ambiente

instalação

Docker

Docker Compose

migrações

seeds

usuários de teste.

---

47. DADOS DE DEMONSTRAÇÃO

Criar ambiente demo com:

5 empresas

20 profissionais

50 clientes

30 serviços

100 reservas

vários códigos postais de Lisboa.

Criar especificamente dados de teste para:

Alvalade

1700-253

Rua Jorge Colaço.

---

48. TESTES

Criar testes:

unitários

integração

API

autenticação

multi-tenant

preços

disponibilidade

conflito de agenda

recorrência

pagamento

cancelamento

RBAC.

Testar principalmente:

duas pessoas tentando reservar o mesmo horário simultaneamente.

O sistema deve impedir double booking.

---

49. ESTRUTURA DO PROJETO

Entregar uma estrutura organizada.

Exemplo:

backend/

frontend/

database/

docker/

tests/

docs/

scripts/

.env.example

docker-compose.yml

README.md.

---

50. NÃO ENTREGAR APENAS UMA DEMONSTRAÇÃO

Quero código funcional.

Não quero apenas:

• wireframes,
• pseudocódigo,
• descrição,
• exemplos incompletos.

Quero que você construa a aplicação.

Quando alguma parte externa exigir credenciais, criar uma interface/mock funcional e indicar claramente onde inserir as credenciais reais.

---

51. PRIORIDADE DE DESENVOLVIMENTO

Desenvolver nesta ordem:

FASE 1

Banco de dados

Autenticação

Multi-tenancy

Empresas

Clientes

Serviços.

FASE 2

Preços

Calculadora

Códigos postais

Áreas de atendimento.

FASE 3

Agenda

Disponibilidade

Reservas

Recorrência.

FASE 4

Profissionais

Equipes

Check-in

Execução do serviço.

FASE 5

Pagamentos

Faturação

Notificações.

FASE 6

Avaliações

Leads

Orçamentos.

FASE 7

Marketplace

Comércio Portugal.

FASE 8

Analytics

SEO

Otimização.

---

52. REGRA PRINCIPAL

Pense neste projeto não como um simples “sistema de agenda”.

Ele deve ser construído como:

INFRAESTRUTURA DE AGENDAMENTO E MARKETPLACE DE SERVIÇOS PARA PORTUGAL.

O primeiro caso de uso será:

limpeza doméstica em Lisboa.

Mas a arquitetura precisa estar preparada para:

qualquer empresa de serviços em Portugal.

Posteriormente deverá ser possível conectar dezenas de milhares de empresas ao Comércio Portugal.

---

53. RESULTADO FINAL

Ao terminar, apresente:

1. Arquitetura geral.
2. Stack escolhida.
3. Estrutura de diretórios.
4. Banco de dados.
5. APIs.
6. Código backend.
7. Código frontend.
8. Sistema de autenticação.
9. Sistema multiempresa.
10. Sistema de preços.
11. Calculadora.
12. Agenda.
13. Disponibilidade.
14. Agendamento.
15. Recorrência.
16. Profissionais.
17. Equipes.
18. Pagamentos.
19. Faturação.
20. Notificações.
21. Avaliações.
22. Leads.
23. Orçamentos.
24. Marketplace.
25. Integração futura com Comércio Portugal.
26. Dados de demonstração.
27. Testes.
28. Docker.
29. README.
30. Instruções completas de instalação e execução.

Antes de finalizar, faça uma auditoria técnica procurando:

• bugs,
• endpoints quebrados,
• falhas de segurança,
• problemas de concorrência,
• double booking,
• problemas de multi-tenancy,
• erros de cálculo,
• problemas de timezone,
• problemas de moeda,
• problemas de IVA,
• problemas de recorrência,
• problemas de permissões.

Corrija os problemas encontrados antes de considerar o projeto concluído.

O sistema deve utilizar EUR (€) e considerar Portugal/Europe-Lisbon como configuração inicial de timezone.

Não faça suposições silenciosas. Quando uma decisão arquitetural for necessária, escolha a solução tecnicamente mais adequada, documente a decisão e continue o desenvolvimento.

O objetivo é entregar uma base real para produção, não apenas uma prova de conceito.