... | @@ -8,9 +8,79 @@ |
... | @@ -8,9 +8,79 @@ |
|
|
|
|
|
# Página da Arquitetura do Sistema
|
|
# Página da Arquitetura do Sistema
|
|
|
|
|
|
<p align="center">
|
|
<img src="uploads/b24a1e7cbd94e5e31283f712246be634/Untitled_Diagram.drawio.png" align="center"
|
|
|
|
alt="Picture"
|
|
![Untitled_Diagram.drawio](uploads/b24a1e7cbd94e5e31283f712246be634/Untitled_Diagram.drawio.png)
|
|
style="display: block; margin: 0 auto" />
|
|
|
|
|
|
</p>
|
|
A arquitetura de pacotes pensada para o projeto divide-se em três núcleos:
|
|
|
|
|
|
|
|
* **Frontend:**
|
|
|
|
|
|
|
|
Será um sistema projetado para acesso via internet por meio de um navegador (WebApp) feito em ReactJS. O ReactJS é uma biblioteca de JavaScript com o foco de criar interfaces de usuário em páginas web misturando códigos de HTML, CSS e JavaScript por meio da prática componentização.
|
|
|
|
|
|
|
|
Tecnologias:
|
|
|
|
- [React](https://pt-br.reactjs.org/docs/getting-started.html)
|
|
|
|
- [Material UI](https://mui.com/)
|
|
|
|
- [HTML/CSS](https://www.w3schools.com/html/default.asp)
|
|
|
|
|
|
|
|
* **Backend:**
|
|
|
|
|
|
|
|
Será uma Interface de Programação de Aplicações (API) com Transferência de Estado Representacional (REST) que ficará encarregada de comunicar-se com o Frontend e Banco de Dados para que troquem informações.
|
|
|
|
|
|
|
|
Faremos uso do framework NestJS para facilitar o desenvolvimento da API. O NestJS é um framework para desenvolvimento eficiente e escalável de aplicações no lado do servidor. Utilizaremos um Mapeamento objeto-relacional (ORM), que será o Prisma, para parte da comunicação com o Banco de Dados.
|
|
|
|
|
|
|
|
Utilizaremos também o Swagger, que é uma ferramenta de software que ajuda a projetar, construir, documentar e consumir serviços da web RESTful. Ele fornece uma interface amigável para desenvolvedores e pode gerar automaticamente a documentação do serviço, além de permitir a validação de solicitações e respostas.
|
|
|
|
|
|
|
|
Tecnologias:
|
|
|
|
- [NestJS](https://docs.nestjs.com/first-steps)
|
|
|
|
- [Swagger](https://swagger.io/)
|
|
|
|
- [Prisma](https://www.prisma.io/)
|
|
|
|
|
|
|
|
* **Banco de Dados:**
|
|
|
|
|
|
|
|
O Banco de dados que optamos por utilizar na nossa aplicação será o PostgreSQL. É um sistema gerenciador de banco de dados objeto relacional (SGBD) que foi desenvolvido como projeto de código aberto.
|
|
|
|
|
|
|
|
Tecnologias:
|
|
|
|
- [PostgresSQL](https://www.postgresql.org/)
|
|
|
|
|
|
|
|
# Boas práticas no desenvolvimento
|
|
|
|
### O que são códigos de status HTTP ?
|
|
|
|
|
|
|
|
Sempre que você clicar em um link ou digitar uma URL e pressionar Enter, seu navegador envia um pedido ao servidor web para o site que você está tentando acessar. O servidor recebe e processa a solicitação, e depois envia de volta os recursos relevantes juntamente com um cabeçalho HTTP.
|
|
|
|
|
|
|
|
### Sobre as classes de código de status HTTP
|
|
|
|
|
|
|
|
Os códigos de status HTTP são divididos em 5 “classes", que são:
|
|
|
|
|
|
|
|
* **100**s: Códigos informativos indicando que a solicitação iniciada pelo navegador continua.
|
|
|
|
* **200**s: Códigos de sucesso retornados quando o pedido do navegador foi recebido, compreendido e processado pelo servidor.
|
|
|
|
* **300**s: Códigos de redirecionamento retornados quando um novo recurso foi substituído pelo recurso solicitado.
|
|
|
|
* **400**s: Códigos de erro do cliente indicando que houve um problema com o pedido.
|
|
|
|
* **500**s: Os códigos de erro do servidor indicam que a solicitação foi aceita, mas que um erro no servidor impediu o cumprimento da solicitação.
|
|
|
|
|
|
|
|
### Os mais utilizados
|
|
|
|
|
|
|
|
* **200**: "**OK**". Este é o código que é entregue quando uma página web ou um recurso age exatamente da maneira que é esperado.
|
|
|
|
* **201**: “**Created**”. O servidor cumpriu o pedido do navegador e, como resultado, criou um novo recurso.
|
|
|
|
* **204**: “**No content**”. Este código significa que o servidor processou a solicitação com sucesso, mas não vai devolver nenhum conteúdo.
|
|
|
|
* **400**: "**Bad Request**". O servidor não pode retornar uma resposta devido a um erro no lado do cliente. Veja o nosso guia para resolver este erro.
|
|
|
|
* **401**: “**Not authorized**”. Isto é devolvido pelo servidor quando o recurso alvo não possui credenciais de autenticação válidas.
|
|
|
|
* **403**: “**Forbidden**”. Este código é devolvido quando um usuário tenta acessar algo que não tem permissão para visualizar. Por exemplo, tentar chegar ao conteúdo protegido por senha sem entrar no sistema pode produzir um erro 403.
|
|
|
|
* **404**: “**Not Found**”. Esta é a mensagem de erro mais comum de todas elas. Este código significa que o recurso solicitado não existe, e o servidor não sabe se ele alguma vez existiu.
|
|
|
|
* **405**: “**Method Not Allowed**“. Isto é gerado quando o servidor de hospedagem (servidor de origem) suporta o método recebido, mas o recurso de destino não suporta.
|
|
|
|
* **500**: “**Interal Server Error**”. Este é um código genérico que significa simplesmente “erro interno do servidor”. Algo correu mal no servidor e o recurso solicitado não foi entregue.
|
|
|
|
* **502**: “**Bad Gateway**”. Este código de erro tipicamente significa que um servidor recebeu uma resposta inválida de outro, tal como quando um servidor proxy está em uso. Outras vezes uma consulta ou pedido demorará muito tempo, e por isso é cancelado ou morto pelo servidor e a conexão com a base de dados quebra.
|
|
|
|
|
|
|
|
### Methods – Backend API
|
|
|
|
|
|
|
|
Nas requisições, especificamos o que chamamos de método HTTP ou verbo. Na versão 1.1 do protocolo HTTP(que é a que todos usamos atualmente) temos 9 verbos diferentes. Os mais utilizados são:
|
|
|
|
|
|
|
|
**GET**: Essa é a requisição mais comum de todas. Através dessa requisição nós pedimos a representação de um recurso: que pode ser um arquivo html, xml, json, etc.
|
|
|
|
|
|
|
|
**POST**: O método POST é utilizado quando queremos criar um recurso. Quando usamos POST, os dados vão no corpo da requisição e não na URI.
|
|
|
|
|
|
|
|
**PUT**: Requisita que um recurso seja "guardado" na URI fornecida. Se o recurso já existir, ele deve ser atualizado. Se não existir, pode ser criado.
|
|
|
|
|
|
|
|
**DELETE**: Exclui o recurso especificado.
|
|
|
|
|
|
|
|
**PATCH**: Serve para atualizar partes de um recurso, e não o recurso todo. |
|
|
|
\ No newline at end of file |