Pular para o conteúdo principal

Dhedalos Schedule Manager

Introducao ao documento​

Repositorio Laravel responsavel por painel administrativo e API de agendamentos do ecossistema Dhedalos.

Versionamento​

  • Versao do README: 1.0.0
  • Ultima atualizacao: 2026-03-17
  • Responsavel: GitHub Copilot

Referencial teorico​

  • Laravel 11
  • Docker e Docker Compose
  • Documentacao padrao docs-hub (camada micro)

Visao geral do repositorio​

  • API HTTP para agendamentos, colaboradores, clientes e exportacao.
  • Painel administrativo protegido por autenticacao web e autorizacao por gates.
  • Notificacoes por e-mail em eventos de agendamento e cancelamento.

Contexto C4 L1 (atores, integracoes e dependencias)​

Atores​

  • Sistema consumidor da API (com API key).
  • Usuario administrativo do painel.

Sistema em foco​

  • dhedalos-app-laravel-schedule-manager.

Integracoes/dependencias​

  • MySQL (persistencia)
  • Redis (cache/fila)
  • SMTP (e-mail)
  • AWS S3 (exportacao CSV)

Como rodar​

Desenvolvimento local (Docker)​

  1. Copie ambiente e suba os servicos:
cp .env.example .env
docker-compose up -d --build
  1. Execute migracoes e seeds:
docker exec -it laravel php artisan migrate --seed
  1. (Opcional) Suba o Horizon:
docker exec -it laravel php artisan horizon
  1. Acesse a aplicacao em http://localhost:8001.

Execucao sem Docker (baseline)​

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm install
npm run build
php artisan serve

Comandos principais (dev/test/build)​

# frontend
npm run dev
npm run build

# backend
php artisan migrate
php artisan test

# testes phpunit
./vendor/bin/phpunit

Variaveis de ambiente​

Consulte .env.example. Principais grupos:

  • Aplicacao: APP_ENV, APP_DEBUG, APP_URL
  • Banco: DB_*
  • Cache/Fila: CACHE_DRIVER, QUEUE_CONNECTION, REDIS_*
  • Mail: MAIL_*
  • AWS: AWS_*

Endpoints principais​

  • API: /api/* (ex.: /api/appointments, /api/export-appointments)
  • Admin web: /admin/*

Repositorios relacionados​

  • ../dhedalos-app-frontend-nextjs
  • ../dhedalos-app-dashboard-laravel
  • ../dhedalos-app-backend-wordpress
  • ../docs-hub

Documentacao tecnica​

  • Inventario: docs/overview.md
  • Arquitetura: docs/architecture/c4-component.md
  • API: docs/api/openapi.yaml e docs/api/examples.md
  • Dados: docs/data/model.md
  • Operacao: docs/operations/runbook.md e docs/operations/observability.md
  • Features: docs/features/README.md
  • ADR: docs/adr/0001-architecture-overview.md

Praticas complementares​

  • Storybook: nao identificado neste repositorio.
  • JSDoc/Docstrings/PHPDoc: uso parcial em classes e controllers.
  • Mindmap de arquitetura: docs/architecture/mindmap.md.

Credenciais de desenvolvimento (seed)​