Desenvolvedor Back-End Python/Fastapi para Sistema Cmms com Integração Whatsapp

Estamos buscando um desenvolvedor Back-End experiente para criar a base de um sistema CMMS (Computerized Maintenance Management System). O objetivo principal é desenvolver uma aplicação robusta capaz de processar mensagens recebidas via WhatsApp e gerar Ordens de Serviço (OS) de forma automática.

Escopo Técnico Detalhado:

1. Desenvolvimento da Aplicação FastAPI: Criar uma aplicação Fastapi com os seguintes endpoints rest:
  - post /webhook/whatsapp: para receber e processar mensagens do twilio.
  - GET /ordens: Para listar todas as ordens de serviço existentes.
  - POST /ordens: Para criar uma nova ordem de serviço.
  - PUT /ordens/{id}: Para atualizar o status de uma ordem de serviço (ex: em andamento, concluída, etc.).

2. Configuração do Banco de Dados PostgreSQL: Implementar um schema PostgreSQL com a tabela 'ordens', contendo os seguintes campos: id, título, descrição, data, status, origem, equipamento e prioridade. Será necessário implementar migrações de banco de dados utilizando Alembic.

3. Integração com Twilio WhatsApp API: O endpoint /webhook/whatsapp deve ser capaz de receber requisições POST do Twilio, extrair o remetente (From) e o corpo da mensagem (Body). Após o processamento, a mensagem deve ser armazenada no banco de dados e uma confirmação deve ser retornada via Twilio.

4. Documentação e Testes: A aplicação deve incluir documentação interativa de API (Swagger, acessível via /docs) e a capacidade de realizar testes locais utilizando ngrok e o Twilio Sandbox para simular a integração.

Entregáveis:
- Repositório no GitHub contendo todo o código-fonte, com um arquivo README detalhado.
- Banco de dados conectado e o webhook do Twilio funcional.
- Implementação de logs básicos para monitoramento da aplicação.

Critérios de Sucesso:
- A capacidade de receber uma mensagem via WhatsApp, criar um registro correspondente no banco de dados e retornar uma resposta de "OS criada com sucesso" ao remetente.
- Código bem organizado, limpo e devidamente documentado.

Perfil Ideal do Desenvolvedor:
Buscamos um profissional com experiência comprovada em FastAPI e na integração com a API do Twilio. É Fundamental ter sólido conhecimento em PostgreSQL e boas práticas de documentação de código. Além disso, valorizamos a comunicação clara e proativa para garantir um alinhamento contínuo durante o projeto.

Prazo e Forma de Trabalho:
O prazo estimado para a conclusão deste projeto é de 1 a 2 semanas. O acompanhamento será realizado através do GitHub e reuniões rápidas para alinhamento e feedback. A entrega final consiste em um repositório funcional com todas as instruções necessárias para setup e execução.