chore(app): setup de api

[yubathom]

Atualmente a api é uma conversão de um arquivo excel gigantesco que o pessoal usa para gerenciar os projetos. os arquivos do diretório input/. E os dados estão disponibilizados são três arquivos json publicados no gh-pages.

o excel tem muito mais informações do que o necessário e não está bem estruturado (foi feito por não programadores), poderia enxugar bastante. Todos os dados importantes aparecem na tela do front.

Portanto, por hora, seria necessário:

• Determinar o modelo da api com base no frontend
• Criar uma api deste modelo

[m-dantas]

Segue a baixo o MER (Modelo Entidade Relacionamento) da API

[yubathom]

acho que faltou considerar os arquivos (e as etapas e subeteapas de cada arquivo)

[yubathom]

e a geometria dos perímetros

[m-dantas]

as etapas eu coloquei como entidade tramitacao e as subetapas eu coloquei como entidade categoria

[yubathom]

tem que considerar os agrupamentos de arquivos

o exemplo acima é do piu joquey

[m-dantas]

Beleza, verifiquei aqui. O fluxo de relacionamento que havia montado não tinha levado em conta uma possível tabela "Grupo Arquivo", sendo assim foi alterado.
Este é o fluxo de relacionamento atual:

[yubathom]

A entidade arquivo precisa ter os seguintes atributos:

• nome
• url
• id_projeto
• id_categoria
• id_grupo(opcional)

Um arquivo sempre se refere a um estado de um do projeto.

Desta forma, na estrutura do MER, ao mudar a id_tramitação perderíamos a referência entre projeto e arquivo. Precisa relacionar arquivo com projetos sendo que a tramitação e a categoria muda ao longo do tempo na entidade projeto.

Em outras palavras, precisaremos listar e agrupar arquivos de tramitações e categorias do passado.

[m-dantas]

Sim, faz sentido.
Por que o id_grupo seria opcional? Acredito que seja obrigatório pois como segue a image abaixo

todo arquivo possui um grupo.

[m-dantas]

MER v3

[yubathom]

Beleza. Grupos obrigatórios portanto.

Faltou incluir duas coisas. Ambas em categoria:

• status textual (opcional)
• datas de registro no SEI - o SEI é o processo eletrônico da prefeitura. Não é createdAt e updatedAt. São duas datas a serem incluídas pelo usuário.

[m-dantas]

MER v4.

[yubathom]

Será necessário atualizar o modelo "pra valer" do express. Seguindo o modelo atual meia boca usado na conversão do excel:
https://github.com/dev-spurbanismo/piu-monitoramento-backend/blob/master/tasks/excel/v2/models.js

[m-dantas]

API atualizada para o modelo passado em https://github.com/dev-spurbanismo/piu-monitoramento-backend/blob/master/tasks/excel/v2/models.js
As atualizações foram feitas nesta branch https://github.com/SPURB/piu-monitoramento-backend/tree/refactor/api

[yubathom]

vamos organizar essa bagaça.. vou atualizar o repositório do piu-monitoramento com a seguinte estrutura:

/app
/api
/admin

app é o cliente que está publicado no gestão urbana
api é a api deste seu último commit em refactor/api. vai ser publicado no servicos.spurbanismo.../:versão/piu-monitoramento
admin é o diretório/painel da branch feature/painel deste repositório e o seu build deverá ser publicado no gh-pages

vou transferir tudo para lá. Assim que terminar te dou um toque

[yubathom]

@m-dantas, reorganização de repositórios finalizado. Trabalharemos apenas neste repositório a partir de agora.