Fiz a listagem das etapas do ciclo de receita hospitalar e suas respectivas funcionalidades.
cadastro de novos itens, respeitando a estrutura do ciclo de receita hospitalar e opcao de editar, tela para editar itens existentes, exclusao, um home para acesso rapido as funcionalidades e login com jwt.
O projeto ja tem a injecao dos enviroments direto do docker-compose e os arquivos de dockerfile ja estao configurados no no front e backend.
Front nextjs, e next-auth e zod Python com FastAPI e SQLAlchemy. (tenho mais experiencia com com NestJS, mas fiz com python por conta dos requisitos)
Este projeto é uma aplicação full-stack projetada para gerenciar as etapas do Ciclo de Receita Hospitalar. A solução permite cadastrar, visualizar e acompanhar a jornada financeira de um atendimento, desde a pré-autorização do convênio até o pagamento final.
O fluxo do ciclo de receita implementado inclui as seguintes etapas:
- Pré-autorização: Validações de elegibilidade e cobertura do convênio.
- Atendimento: Execução do procedimento médico.
- Faturamento/Codificação: Geração da conta hospitalar com os códigos (TUSS/CBHPM) e anexos.
- Glosa/Adjudicação: Análise da conta pelo pagador, com possíveis ajustes e recursos.
- Pagamento: Liquidação financeira e baixa da conta.
Este projeto foi construído utilizando um stack moderno, escalável e robusto.
- Backend: FastAPI (Python) ou NesJS (Typescript)
- ORM: SQLAlchemy com Alembic para migrações.
- Validação: Pydantic.
- Autenticação: JWT (JSON Web Tokens).
- Frontend: React
- Gerenciamento de Estado: Context API.
- Estilização: Styled-Components.
- Roteamento: React Router.
- Banco de Dados: PostgreSQL.
- Infraestrutura & DevOps:
- Containerização: Docker & Docker Compose.
- CI/CD: GitLab CI.
- Cloud Provider: AWS (ECR para registro de imagens e ECS para deploy).
- ✅ Autenticação de Usuários: Sistema seguro de registro e login com JWT.
- ✅ CRUD Completo: Crie, leia, atualize e remova registros do ciclo de receita.
- ✅ Rotas Protegidas: Acesso apenas para usuários autenticados nas rotas principais.
- ✅ Interface Intuitiva: Formulários claros para login, registro e gerenciamento dos ciclos.
- ✅ Documentação de API: Geração automática de documentação interativa com Swagger (OpenAPI).
- ✅ Ambiente Containerizado: Facilidade para rodar o ambiente de desenvolvimento com um único comando.
/
├── backend/
│ ├── app/
│ │ ├── api/
│ │ ├── core/
│ │ ├── db/
│ │ └── models/
│ ├── migrations/
│ ├── Dockerfile
│ └── requirements.txt
│
├── frontend/
│ ├── public/
│ ├── src/
│ │ ├── components/
│ │ ├── contexts/
│ │ ├── pages/
│ │ └── services/
│ ├── Dockerfile
│ └── package.json
│
├── .gitlab-ci.yml
├── docker-compose.yml
└── README.md
| Campo | Tipo de Dado | Descrição |
|---|---|---|
id |
Integer (PK) |
Identificador único. |
patientId |
String |
ID do paciente. |
payer |
String |
Nome do convênio/pagador. |
procedureCode |
String |
Código do procedimento (TUSS/CBHPM). |
amount |
Numeric |
Valor do procedimento. |
stage |
Enum(PRE_AUTH, ATTENDANCE, BILLING, ADJUDICATION, PAYMENT) |
Etapa atual do ciclo. |
claimStatus |
Enum(OPEN, DENIED, APPROVED, PAID, CANCELLED) |
Status da conta/fatura. |
dueDate |
Date |
Data de vencimento do pagamento. |
paidDate |
Date (Nullable) |
Data em que o pagamento foi efetuado. |
notes |
Text (Nullable) |
Observações adicionais. |
createdAt |
DateTime |
Data de criação do registro. |
updatedAt |
DateTime |
Data da última atualização. |



