# ffcfelps1/projeto_semestral_entrega_via_drones architecture

> Architecture diagram of the GitHub repository ffcfelps1/projeto_semestral_entrega_via_drones, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ffcfelps1/projeto_semestral_entrega_via_drones
- Repository: https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones

## Overview

SkySwift is a web application for autonomous-drone delivery management. A customer browses the site, can sign in, creates and confirms a delivery request, and follows its status and history; a separate tracking view calculates a route. The frontend also exposes pricing, help, sales contact, and notifications. Backend microservices handle identity, orders, routing, email, and notifications, with an event bus distributing service events. The tree also contains serverless API dispatchers for several services. The README documents their role, but their runtime wiring beyond sampled dispatchers is not fully visible.

Main entry points: [`front/src/App.jsx`](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/App.jsx) (App shell), [`back/gestao_de_pedidos/routes/pedidos.js`](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/gestao_de_pedidos/routes/pedidos.js) (Order service), [`back/barramento_eventos/server.js`](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/barramento_eventos/server.js) (Event bus), [`back/notificacoes/server.js`](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/notificacoes/server.js) (Notification service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_app["App shell<br/>[App.jsx]"]
  node_order_ui["Order pages<br/>[PedidoPage.jsx]"]
  node_order_hook["Order state<br/>[usePedidos.js]"]
  node_order_client["Order client"]
  node_tracking["Drone tracking"]
  node_account["Account pages<br/>[AccountPage.jsx]"]
  node_login["Login page<br/>[LoginPage.jsx]"]
  node_notifications_ui["Notifications page"]
  node_pricing["Pricing page<br/>[PrecosPage.jsx]"]
  node_support["Help center<br/>[SuportePage.jsx]"]
  node_notification_client["Notification client"]
end

subgraph group_orders["Delivery operations"]
  node_orders_api["Order service<br/>[pedidos.js]"]
  node_orders_db[("Order database<br/>[database.js]")]
end

subgraph group_services["Platform services"]
  node_auth_service["User service<br/>[server.js]"]
  node_drone_service["Route service<br/>[server.js]"]
  node_email_service["Email service<br/>[server.js]"]
  node_notifications_service["Notification service<br/>[server.js]"]
  node_event_bus["Event bus<br/>[server.js]"]
  node_runtime["Service runtime<br/>[runtime.js]"]
end

subgraph group_serverless["Serverless APIs"]
  node_orders_serverless["Order API router<br/>[handler.js]"]
  node_orders_helpers["Order API rules<br/>[_utils.js]"]
  node_auth_serverless["User API router<br/>[handler.js]"]
  node_auth_helpers["User API helpers<br/>[_utils.js]"]
  node_email_api["Email API<br/>[handler.js]"]
  node_drone_api["Route API<br/>[handler.js]"]
  node_event_api["Event API<br/>[handler.js]"]
  node_notifications_api["Notifications API<br/>[handler.js]"]
end

node_customer(("Customer"))
node_routing_provider["Routing provider"]
node_mysql[("MySQL")]

node_customer -->|"uses"| node_app
node_app -->|"renders"| node_order_ui
node_order_ui -->|"uses"| node_order_hook
node_order_hook -->|"calls"| node_order_client
node_order_client -->|"requests"| node_orders_api
node_app -->|"renders"| node_tracking
node_app -->|"renders"| node_login
node_app -->|"renders"| node_account
node_app -->|"routes"| node_pricing
node_app -->|"routes"| node_support
node_app -->|"routes"| node_notifications_ui
node_app -->|"calls"| node_notification_client
node_notification_client -->|"requests"| node_notifications_service
node_app -->|"requests"| node_auth_service
node_app -->|"requests"| node_email_service
node_orders_api -->|"reads/writes"| node_orders_db
node_orders_api -->|"persists"| node_mysql
node_orders_serverless -->|"uses"| node_orders_helpers
node_auth_serverless -->|"uses"| node_auth_helpers
node_drone_service -->|"requests route"| node_routing_provider
node_drone_service -->|"publishes route event"| node_event_bus
node_orders_api -.->|"publishes order events"| node_event_bus
node_event_bus -.->|"delivers events"| node_orders_api
node_event_bus -.->|"delivers events"| node_notifications_service
node_notifications_service -.->|"persists"| node_mysql
node_auth_service -.->|"reads/writes"| node_mysql
node_orders_serverless -.->|"alternative deployment"| node_orders_api
node_auth_serverless -.->|"alternative deployment"| node_auth_service
node_email_api -.->|"alternative deployment"| node_email_service
node_drone_api -.->|"alternative deployment"| node_drone_service
node_event_api -.->|"alternative deployment"| node_event_bus
node_notifications_api -.->|"alternative deployment"| node_notifications_service
node_auth_service -->|"uses lifecycle"| node_runtime
node_drone_service -->|"uses lifecycle"| node_runtime
node_event_bus -->|"uses lifecycle"| node_runtime
node_notifications_service -->|"uses lifecycle"| node_runtime
node_orders_api -.->|"updates order status"| node_event_bus

click node_app "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/App.jsx"
click node_order_ui "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/PedidoPage.jsx"
click node_order_hook "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/usePedidos.js"
click node_order_client "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/pedidosEntregaService.js"
click node_tracking "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/DroneTrackingSection.jsx"
click node_account "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/AccountPage.jsx"
click node_login "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/LoginPage.jsx"
click node_notifications_ui "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/NotificacoesPage.jsx"
click node_pricing "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/PrecosPage.jsx"
click node_support "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/SuportePage.jsx"
click node_notification_client "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/notificacoesService.js"
click node_orders_api "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/gestao_de_pedidos/routes/pedidos.js"
click node_orders_db "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/gestao_de_pedidos/database.js"
click node_orders_serverless "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/gestao_de_pedidos/handler.js"
click node_orders_helpers "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/gestao_de_pedidos/_utils.js"
click node_auth_service "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/cadastro_usuario/server.js"
click node_auth_serverless "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/cadastro_usuario/handler.js"
click node_auth_helpers "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/cadastro_usuario/_utils.js"
click node_drone_service "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/entrega_via_drone/server.js"
click node_email_service "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/contato_email/server.js"
click node_notifications_service "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/notificacoes/server.js"
click node_event_bus "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/barramento_eventos/server.js"
click node_runtime "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/shared/runtime.js"
click node_email_api "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/contato_email/handler.js"
click node_drone_api "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/entrega_via_drone/handler.js"
click node_event_api "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/barramento_eventos/handler.js"
click node_notifications_api "https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/notificacoes/handler.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_order_ui,node_order_hook,node_order_client,node_tracking,node_account,node_login,node_notifications_ui,node_pricing,node_support,node_notification_client toneBlue
class node_orders_api,node_orders_db,node_mysql toneAmber
class node_auth_service,node_drone_service,node_email_service,node_notifications_service,node_event_bus,node_runtime toneMint
class node_orders_serverless,node_orders_helpers,node_auth_serverless,node_auth_helpers,node_email_api,node_drone_api,node_event_api,node_notifications_api toneRose
class node_customer,node_routing_provider toneIndigo
```

## Components

### Web experience

- [App shell](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/App.jsx): `front/src/App.jsx`
- [Order pages](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/PedidoPage.jsx): `front/src/PedidoPage.jsx`
- [Order state](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/usePedidos.js): `front/src/usePedidos.js`
- [Order client](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/pedidosEntregaService.js): `front/src/pedidosEntregaService.js`
- [Drone tracking](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/DroneTrackingSection.jsx): `front/src/DroneTrackingSection.jsx`
- [Account pages](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/AccountPage.jsx): `front/src/AccountPage.jsx`
- [Login page](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/LoginPage.jsx): `front/src/LoginPage.jsx`
- [Notifications page](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/NotificacoesPage.jsx): `front/src/NotificacoesPage.jsx`
- [Pricing page](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/PrecosPage.jsx): `front/src/PrecosPage.jsx`
- [Help center](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/SuportePage.jsx): `front/src/SuportePage.jsx`
- [Notification client](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/front/src/notificacoesService.js): `front/src/notificacoesService.js`

### Delivery operations

- [Order service](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/gestao_de_pedidos/routes/pedidos.js): `back/gestao_de_pedidos/routes/pedidos.js`
- [Order database](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/gestao_de_pedidos/database.js): `back/gestao_de_pedidos/database.js`

### Platform services

- [User service](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/cadastro_usuario/server.js): `back/cadastro_usuario/server.js`
- [Route service](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/entrega_via_drone/server.js): `back/entrega_via_drone/server.js`
- [Email service](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/contato_email/server.js): `back/contato_email/server.js`
- [Notification service](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/notificacoes/server.js): `back/notificacoes/server.js`
- [Event bus](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/barramento_eventos/server.js): `back/barramento_eventos/server.js`
- [Service runtime](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/back/shared/runtime.js): `back/shared/runtime.js`

### Serverless APIs

- [Order API router](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/gestao_de_pedidos/handler.js): `api/gestao_de_pedidos/handler.js`
- [Order API rules](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/gestao_de_pedidos/_utils.js): `api/gestao_de_pedidos/_utils.js`
- [User API router](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/cadastro_usuario/handler.js): `api/cadastro_usuario/handler.js`
- [User API helpers](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/cadastro_usuario/_utils.js): `api/cadastro_usuario/_utils.js`
- [Email API](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/contato_email/handler.js): `api/contato_email/handler.js`
- [Route API](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/entrega_via_drone/handler.js): `api/entrega_via_drone/handler.js`
- [Event API](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/barramento_eventos/handler.js): `api/barramento_eventos/handler.js`
- [Notifications API](https://github.com/ffcfelps1/projeto_semestral_entrega_via_drones/blob/main/api/notificacoes/handler.js): `api/notificacoes/handler.js`

### Other components

- **Customer**
- **Routing provider**
- **MySQL**

## Connections

- Customer → App shell: uses (evidence: `README.md`)
- App shell → Order pages: renders (evidence: `front/src/App.jsx`)
- Order pages → Order state: uses (evidence: `front/src/PedidoPage.jsx`)
- Order state → Order client: calls (evidence: `front/src/usePedidos.js`)
- Order client → Order service: requests (evidence: `README.md`)
- App shell → Drone tracking: renders (evidence: `front/src/App.jsx`)
- App shell → Login page: renders (evidence: `front/src/App.jsx`)
- App shell → Account pages: renders (evidence: `front/src/App.jsx`)
- App shell → Pricing page: routes (evidence: `README.md`)
- App shell → Help center: routes (evidence: `README.md`)
- App shell → Notifications page: routes (evidence: `front/src/App.jsx`)
- App shell → Notification client: calls (evidence: `front/src/App.jsx`)
- Notification client → Notification service: requests (evidence: `README.md`)
- App shell → User service: requests (evidence: `front/src/App.jsx`)
- App shell → Email service: requests (evidence: `front/src/App.jsx`)
- Order service → Order database: reads/writes (evidence: `back/gestao_de_pedidos/routes/pedidos.js`)
- Order service → MySQL: persists
- Order API router → Order API rules: uses (evidence: `api/gestao_de_pedidos/handler.js`)
- User API router → User API helpers: uses (evidence: `api/cadastro_usuario/handler.js`)
- Route service → Routing provider: requests route (evidence: `back/entrega_via_drone/server.js`)
- Route service → Event bus: publishes route event (evidence: `back/entrega_via_drone/server.js`)
- Order service → Event bus: publishes order events (evidence: `README.md`)
- Event bus → Order service: delivers events (evidence: `README.md`)
- Event bus → Notification service: delivers events (evidence: `README.md`)
- Notification service → MySQL: persists (evidence: `README.md`)
- User service → MySQL: reads/writes (evidence: `README.md`)
- Order API router → Order service: alternative deployment (evidence: `README.md`)
- User API router → User service: alternative deployment (evidence: `README.md`)
- Email API → Email service: alternative deployment (evidence: `README.md`)
- Route API → Route service: alternative deployment (evidence: `README.md`)
- Event API → Event bus: alternative deployment (evidence: `README.md`)
- Notifications API → Notification service: alternative deployment (evidence: `README.md`)
- User service → Service runtime: uses lifecycle (evidence: `back/cadastro_usuario/server.js`)
- Route service → Service runtime: uses lifecycle (evidence: `back/entrega_via_drone/server.js`)
- Event bus → Service runtime: uses lifecycle (evidence: `back/barramento_eventos/server.js`)
- Notification service → Service runtime: uses lifecycle (evidence: `back/notificacoes/server.js`)
- Order service → Event bus: updates order status (evidence: `README.md`)
