|
1 |
| -<p align="center"> |
2 |
| - <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="200" alt="Nest Logo" /></a> |
3 |
| -</p> |
| 1 | +# README para o Backend do App de Ajuda em Enchentes |
4 | 2 |
|
5 |
| -[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456 |
6 |
| -[circleci-url]: https://circleci.com/gh/nestjs/nest |
| 3 | +Este repositório contém o backend de um aplicativo desenvolvido para organizar e distribuir suprimentos, bem como coordenar voluntários durante os alagamentos no Rio Grande do Sul. O backend fornece APIs para autenticação de usuários, gerenciamento de abrigos e suprimentos, entre outros. |
7 | 4 |
|
8 |
| - <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p> |
9 |
| - <p align="center"> |
10 |
| -<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a> |
11 |
| -<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a> |
12 |
| -<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a> |
13 |
| -<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a> |
14 |
| -<a href="https://coveralls.io/github/nestjs/nest?branch=master" target="_blank"><img src="https://coveralls.io/repos/github/nestjs/nest/badge.svg?branch=master#9" alt="Coverage" /></a> |
15 |
| -<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a> |
16 |
| -<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a> |
17 |
| -<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a> |
18 |
| - <a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg"/></a> |
19 |
| - <a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a> |
20 |
| - <a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow"></a> |
21 |
| -</p> |
22 |
| - <!--[](https://opencollective.com/nest#backer) |
23 |
| - [](https://opencollective.com/nest#sponsor)--> |
| 5 | +## Sobre o Projeto |
24 | 6 |
|
25 |
| -## Description |
| 7 | +O sistema backend é projetado para ser robusto e escalável, garantindo que possa lidar com o alto volume de acessos durante emergências. Ele opera com diversas APIs que permitem a interação com o frontend e outros serviços potenciais. |
26 | 8 |
|
27 |
| -[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository. |
| 9 | +## Tecnologias Utilizadas |
28 | 10 |
|
29 |
| -## Installation |
| 11 | +- **Node.js**: Ambiente de execução para JavaScript. |
| 12 | +- **Express**: Framework para aplicação web para Node.js. |
| 13 | +- **MongoDB**: Banco de dados NoSQL para armazenar dados de forma eficiente. |
| 14 | +- **JWT**: Para autenticação segura via tokens. |
30 | 15 |
|
31 |
| -```bash |
32 |
| -$ npm install |
33 |
| -``` |
| 16 | +## API Endpoints |
34 | 17 |
|
35 |
| -## Running the app |
| 18 | +### Usuários |
| 19 | +- **POST /users** - Cadastrar um novo usuário. |
| 20 | +- **PUT /users** - Atualizar um usuário existente. |
36 | 21 |
|
37 |
| -```bash |
38 |
| -# development |
39 |
| -$ npm run start |
| 22 | +### Sessões |
| 23 | +- **POST /sessions** - Criar uma nova sessão de usuário (login). |
| 24 | +- **GET /sessions/:sessionId** - Obter detalhes de uma sessão. |
| 25 | +- **PUT /sessions/:sessionId** - Atualizar uma sessão específica. |
40 | 26 |
|
41 |
| -# watch mode |
42 |
| -$ npm run start:dev |
| 27 | +### Abrigos |
| 28 | +- **POST /shelters** - Cadastrar um novo abrigo. |
| 29 | +- **PUT /shelters/:shelterId** - Atualizar um abrigo existente. |
| 30 | +- **GET /shelters** - Listar abrigos. |
43 | 31 |
|
44 |
| -# production mode |
45 |
| -$ npm run start:prod |
46 |
| -``` |
| 32 | +### Suprimentos |
| 33 | +- **POST /supply** - Cadastrar um novo item de suprimento. |
| 34 | +- **PUT /supplies/:supplyId** - Atualizar um suprimento. |
| 35 | +- **GET /supplies** - Listar suprimentos. |
47 | 36 |
|
48 |
| -## Test |
| 37 | +### Categorias de Suprimentos |
| 38 | +- **POST /supply-categories** - Cadastrar uma nova categoria de suprimentos. |
| 39 | +- **PUT /supply-categories/:categoryId** - Atualizar uma categoria de suprimentos. |
| 40 | +- **GET /supply-categories** - Listar categorias de suprimentos. |
49 | 41 |
|
50 |
| -```bash |
51 |
| -# unit tests |
52 |
| -$ npm run test |
| 42 | +## Configuração Inicial |
53 | 43 |
|
54 |
| -# e2e tests |
55 |
| -$ npm run test:e2e |
| 44 | +1. Clone o repositório: |
| 45 | + ```bash |
| 46 | + git clone https://github.com/seuusuario/projeto-enchentes-backend.git |
| 47 | + ``` |
| 48 | +2. Entre no diretório do projeto: |
| 49 | + ```bash |
| 50 | + cd projeto-enchentes-backend |
| 51 | + ``` |
| 52 | +3. Instale as dependências: |
| 53 | + ```bash |
| 54 | + npm install |
| 55 | + ``` |
| 56 | +4. Inicie o servidor: |
| 57 | + ```bash |
| 58 | + npm start |
| 59 | + ``` |
| 60 | + A API estará acessível via `http://localhost:4000`. |
56 | 61 |
|
57 |
| -# test coverage |
58 |
| -$ npm run test:cov |
59 |
| -``` |
| 62 | +## Contribuição |
60 | 63 |
|
61 |
| -## Support |
| 64 | +Contribuições são bem-vindas! Se quiser contribuir, por favor faça um fork do repositório, crie uma branch para suas modificações e depois envie um pull request. |
62 | 65 |
|
63 |
| -Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support). |
64 | 66 |
|
65 |
| -## Stay in touch |
66 |
| - |
67 |
| -- Author - [Kamil Myśliwiec](https://kamilmysliwiec.com) |
68 |
| -- Website - [https://nestjs.com](https://nestjs.com/) |
69 |
| -- Twitter - [@nestframework](https://twitter.com/nestframework) |
70 |
| - |
71 |
| -## License |
72 |
| - |
73 |
| -Nest is [MIT licensed](LICENSE). |
| 67 | +Sua participação é essencial para ajudarmos a comunidade afetada pelas enchentes no Rio Grande do Sul! |
0 commit comments