Saúde Timon 24h - API

Sobre o Projeto

O aplicativo Saúde Timon 24h permite aos usuários realizar o cadastro para a vacinação contra a Covid-19 na cidade de Timon-MA.

Dentre as funcionalidades estão o cadastro para a vacinação por grupos, checagem do status do cadastro, consulta a locais de vacinação, entre outros.

Tecnologias e Estrutura

O projeto foi escrito utilizando as seguintes tecnologias:

• Linguagem: Typescript
• Plataforma: NodeJS
• Framework Principal: ExpressJs
• Mapeamento Objeto-Relacional: TypeORM
• Banco de dados preferencial: Postgres

O projeto foi estruturado no padrão Model-View-Controller (MVC), onde as views não foram utilizadas por se tratar de uma API Rest. A estrutura de pastas se divide em:

• src: Pasta principal que contém todos os arquivos importantes do projeto.
• src/app: Pasta que contém subpastas relacionas à regra de negócio da aplicação.
• src/app/controllers: Pasta que contém os controllers da aplicação.
• src/app/middlewares: Pasta que contém os middlewares utilizados nas rotas da aplicação.
• src/app/models: Pasta que contém as entidades da aplicação, que são utilizadas pelo TypeORM.
• src/app/validators: Pasta que contém middlewares de validação, utilizados antes de alguns controllers.
• src/config: Pasta que contém arquivos de configurações.
• src/database: Pasta que contém as configurações importantes do acesso ao banco de dados e as migrations utilizadas pelo TypeORM.
• src/typescript: Pasta que contém as tipagens e interfaces utilizadas pelo typescript.
• src/utils: Pasta que contém funções utilitárias.

Como executar o projeto

Desenvolvimento

1. Instalar as dependências.

$ npm i

$ yarn

2. Copiar o arquivo .env.example nomeando como .env e setar as variáveis de ambiente necessárias. OBS: As variáveis já setadas devem permanecer como estão.

3. Executar o projeto para a sincronização do TypeORM com o banco de dados.

$ npm run dev

$ yarn dev

4. Parar o projeto e executar os seeds do banco de dados utilizando o comando:

$ npm run seed:dev

$ yarn seed:dev

5. Após isso o projeto estará pronto para ser utilizado em desenvolvimento.

Produção

1. Instalar as dependências.

$ npm i

$ yarn

2. Gerar a build de produção.

$ npm run build

$ yarn build

3. Repetir o passo 2 da execução de desenvolvimento, com a diferença de que os paths do typeorm deverão ser absolutos (desde a raiz do sistema) e deverão apontar para os arquivos JS dentro da pasta build.

4. Executar o projeto para a sincronização do TypeORM com o banco de dados.

$ node build/server.js

5. Parar o projeto e executar os seeds do banco de dados utilizando o comando:

$ npm run seed:prod

$ yarn seed:prod

6. Após isso o projeto estará pronto para ser utilizado em produção.