Documentação da Arquitetura

Visão geral

Este documento visa registrar a aquitetura proposta para o projeto SideChef.

O software consiste em uma aplicação mobile arquitetada em microsserviços, com o frontend desenvolvido em React Native cuja comunicação de backend é feita utilizando a framework FastAPI. O microsserviço referente aos usuários contará com um banco de dados PostgreSQL, enquanto o referente às receitas com um MongoDB.

Metas e restrições da arquitetura

Restrição	Ferramenta
Linguagem	Python e TypeScript
Framework	React Native e FastAPI
Plataforma	Mobile
Segurança	Cada usuário contará com uma conta autenticada via token, visto que o aplicativo dará suporte para criação de receitas personalizadas.
Idioma	Português

Representação da Arquitetura

1. Diagrama de Tecnologias

DiagramaTecnologias Autor: Felipe Moura

O diagrama de tecnologias demonstra as tecnologias utilizadas no projeto, e como interagem entre si. Pode se ver também a arquitetura de microsserviços explicitada no diagrama e como esta junto a seus componentes se encaixam no sistema.

Serviços

Podem ser considerados como serviços os diversos subcomponentes do sistema que fornecem algum tipo de interação, ou para com o cliente diretamente, ou para o próprio sistema interno.

UserService

O microserviço UserService é responsável pela gerência e armazenamento das contas de usuário do sistema.

RecipeService

O microsserviço RecipeService é responável pela gerência e armazenamento das receitas registrado no sistema, tanto as pré-armazenadas pela equipe de desenvolvimento, quanto as criadas pelos próprios usuários.

FrontEnd

O frontend consiste na parte visual e utilitária ao qual o usuário interage, no caso será o aplicativo mobile desenvolvido em React Native.

2. Diagrama de sequência

--- title: Side Chef diagrama de sequência usuários --- sequenceDiagram actor Usuario Usuario->>+Mobile: Usuario não possui conta Mobile->>+UserService: POST cadastrarUsuario UserService->>+PostgreSQL: salva usuario no banco PostgreSQL->>-UserService: retorna mensagem de sucesso UserService->>-Mobile: status code 201 Mobile->>-Usuario: Usuario criado Usuario->>+Mobile: Possui conta Mobile->>+UserService: POST loginUsuario UserService->>+PostgreSQL: Verifica credenciais no banco PostgreSQL->>-UserService: Valida login UserService->>-Mobile: status code 201 Mobile->>-Usuario: Usuario logado com sucesso

--- title: Side Chef diagrama de sequência receitas --- sequenceDiagram actor Usuario Usuario->>+Mobile: Pesquisa lista de receitas Mobile->>+RecipeService: GET recitas RecipeService->>+MongoDB: Consulta receitas no banco MongoDB->>-RecipeService: Retorna receitas encontradas no banco RecipeService->>-Mobile: Retorna lista de receitas encontradas Mobile->>-Usuario: Mostra lista de receitas pesquisadas Usuario->>+Mobile: Clica em adicionar receitas Mobile->>Usuario: Atualiza página Usuario->>Mobile: Adiciona ingrediente Mobile->>Usuario: Aciona câmera Usuario->>Mobile: Tira a foto Mobile->>+RecipeService: POST ingrediente RecipeService->>+RecipeService: Aciona OCR para verificar texto RecipeService->>-RecipeService: Retorna texto verificado OCR RecipeService->>Mobile: Aciona ingrediente a lista Mobile->>RecipeService: POST Receitas RecipeService->>+MongoDB: Adiciona receita ao banco MongoDB->>-RecipeService: Retorna receitas finalizada RecipeService->>-Mobile: Retorna receita adicionada Mobile->>-Usuario: Mostra receita adicionada

Autor: Bruno Kishibe

3. Diagrama de Classes

--- title: Side Chef diagrama de classe --- classDiagram class Usuario{ +int idUsuario +string nome +string email +cadastrarUsuario() +deletarUsuario() +atualizarCadastro() } class Receita{ +int receitaId +string nome +double totalCalorias +double totalProteinas +List~Ingrediente~ Ingredientes +adicionaIngrediente() -calcularProteinas() -calcularCalorias() } class Ingrediente{ +int ingredienteId +string nome +enum unidadeMedida +double calorias +double proteinas } class Camera { +capturarImagem(): Imagem } class OcrService { +identificarIngrediente(imagem: Imagem): Ingrediente +identificarInformacoesNutricionais(imagem: Imagem): Nutricao } class ReceitaPessoal{ -int idUsuario +verificaAcesso() +listaReceitas() } Camera --> OcrService : fornece imagem Receita <-- Usuario Receita o-- Ingrediente Ingrediente o-- OcrService Receita <|-- ReceitaPessoal

Autor: Bruno Kishibe

4. Arquitetura de banco de dados

4.1 Diagrama Entidade Relacionamento

4.1.1 Microsserviço do Usuário (UserService)

DiagramaEntidadeRelacionamento
Autor: Diógenes Júnior

4.1.2 Microsserviço das Receitas (RecipeService)

{
  "id": "id-da-receita",
  "nome": "nome",
  "ingredientes": ["ingrediente_1", "ingrediente_2"],
  "instrucoes": "Instruções",
  "usuarios_que_salvaram": [
    "id-do-usuario-1",
    "id-do-usuario-2"
  ]
}

Autor: Diógenes Júnior

4.2 Modelo Lógico de Dados

4.2.1 Microsserviço do Usuário (UserService)

ModeloLógicoDeDadosUsuário
Autor: Diógenes Júnior

4.2.2 Microsserviço das Receitas (RecipeService)

{
  "id": "<ObjectId>",               
  "nome": "string",                      
  "ingredientes": ["string"],          
  "instrucoes": "string",               
  "usuarios_que_salvaram": ["string"]    
}

Autor: Diógenes Júnior

Referências Bibliográficas

[1] EQUIPE ARANDU 2024-2. Documento de Arquitetura. Disponível em: https://fga-eps-mds.github.io/2024.2-ARANDU-DOC/projeto/arquitetura/
[2] EQUIPE SYSARQ 2021-1. Documento de Arquitetura. Disponível em: https://fga-eps-mds.github.io/2021.1-PC-GO1/doc_arquitetura/ [3] DEVMEDIA. Orientações básicas na elaboração de um diagrama de classes. Disponível em: https://www.devmedia.com.br/orientacoes-basicas-na-elaboracao-de-um-diagrama-de-classes/37224. [4] Documentação Oficial MongoDB. Disponível em: https://www.mongodb.com/pt-br/docs/v6.0/core/data-modeling-introduction/

Histórico de versões

Versão	Alteração	Responsável	Data Alteração
1.0	Criação do documento, descrição da visão geral, metas e restrições e criação de diagrama de tecnologias	Felipe Candido de Moura	28/04/2025
1.1	Criação da Arquitetura do Banco de Dados	Diógenes Dantas Lélis Júnior	29/04/2025
1.2	Criação diagrama de sequência e classes	Bruno Seiji Kishibe	29/04/2025