feat: otimização de performance e ajustes finais

2026-05-18 10:49:32 +00:00
commit 52a7c4f9cf
579 changed files with 156489 additions and 0 deletions
@@ -0,0 +1,158 @@
+# SIGEFP - Sistema Integrado de Gestão do Estado
+
+Sistema modular para gestão governamental desenvolvido em Java 21+ com Spring Boot 3.
+
+## Estrutura do Projeto
+
+O projeto segue uma arquitetura em camadas limpas (Clean Architecture) com separação clara de responsabilidades:
+
+```
+sigefp-parent/
+├── sigefp-common/          # Utilitários e classes compartilhadas
+├── sigefp-admin/           # Módulo de administração (utilizadores, perfis, auditoria)
+├── sigefp-org/             # Módulo de organização (ministérios, unidades, posições)
+├── sigefp-rh/              # Módulo de recursos humanos (agentes, contratos, folha)
+├── sigefp-budget/          # Módulo de orçamento (exercícios, linhas, execução)
+├── sigefp-treasury/        # Módulo de tesouraria (pagamentos)
+└── sigefp-api/             # API REST principal
+```
+
+## Estrutura de Camadas
+
+Cada módulo segue a seguinte estrutura:
+
+```
+src/main/java/br/gov/sigefp/{modulo}/
+├── domain/                 # Entidades JPA, Value Objects, Domain Services
+├── application/            # DTOs, Application Services (use cases)
+├── infrastructure/         # Repositories JPA, Configurações
+└── api/                    # Controllers REST
+```
+
+## Tecnologias
+
+- **Java 21+**
+- **Spring Boot 3.2.0**
+- **Spring Data JPA**
+- **Spring Security**
+- **PostgreSQL**
+- **Maven**
+- **Lombok**
+
+## Boas Práticas Implementadas
+
+### 1. Gestão de Datas
+- ✅ Uso de `LocalDate` e `LocalDateTime` ao invés de strings
+- ✅ Value Object `PeriodId` para períodos (ano-mês)
+- ✅ Evita concatenação de strings para datas
+
+### 2. Arquitetura
+- ✅ Separação clara de camadas (Domain, Application, Infrastructure, API)
+- ✅ DTOs para transferência de dados
+- ✅ Repositories JPA na camada de infraestrutura
+- ✅ Services na camada de aplicação
+
+### 3. Entidades
+- ✅ UUID como identificador (evita problemas em ambientes distribuídos)
+- ✅ Auditoria automática (createdAt, updatedAt, createdBy, updatedBy)
+- ✅ Versionamento otimista (@Version)
+- ✅ Índices apropriados nas tabelas
+
+## Configuração
+
+### Pré-requisitos
+- Java 21+
+- Maven 3.8+
+- PostgreSQL 12+
+
+### Banco de Dados
+
+Criar o banco de dados:
+
+```sql
+CREATE DATABASE sigefp;
+CREATE USER sigefp_user WITH PASSWORD 'sigefp_password';
+GRANT ALL PRIVILEGES ON DATABASE sigefp TO sigefp_user;
+```
+
+### Executar a Aplicação
+
+```bash
+# Compilar o projeto
+mvn clean install
+
+# Executar a aplicação
+cd sigefp-api
+mvn spring-boot:run
+
+# Ou executar com perfil específico
+mvn spring-boot:run -Dspring-boot.run.profiles=dev
+```
+
+A aplicação estará disponível em: `http://localhost:8080`
+
+## Endpoints
+
+### Admin
+- `POST /api/admin/users` - Criar utilizador
+- `GET /api/admin/users/{id}` - Buscar utilizador
+- `GET /api/admin/users` - Listar utilizadores (paginação)
+- `PUT /api/admin/users/{id}` - Atualizar utilizador
+- `DELETE /api/admin/users/{id}` - Deletar utilizador
+
+## Documentação
+
+- **[STATUS_PROJETO.md](STATUS_PROJETO.md)** - Documentação completa do status do projeto, o que foi implementado e o que falta fazer
+- **[ESTRUTURA_PROJETO.md](ESTRUTURA_PROJETO.md)** - Detalhamento da estrutura de pacotes e organização
+
+## Endpoints Disponíveis
+
+### Admin (`/api/admin`)
+- **Users**: `GET`, `POST`, `PUT`, `GET /{id}`, `POST /{id}/roles`
+- **Roles**: `GET`, `POST`, `PUT`, `GET /{id}`
+- **Audit Logs**: `GET` (com filtros: userId, module, período)
+
+### Org (`/api/org`)
+- **Ministries**: `GET`, `POST`, `PUT`, `GET /{id}`
+- **Org Units**: `GET`, `POST`, `PUT`, `GET /{id}`, `GET /tree/{ministryId}`
+- **Positions**: `GET`, `POST`, `PUT`, `GET /{id}`
+
+### RH (`/api/rh`)
+- **Agents**: `GET`, `POST`, `PUT`, `GET /{id}`
+- **Payroll Periods**: `GET`, `POST`
+- **Payroll Runs**: `GET /{id}`, `POST`
+
+### Budget (`/api/budget`)
+- **Fiscal Years**: `GET`, `POST`, `GET /{id}`, `GET /current`, `POST /{id}/open`, `POST /{id}/close`
+- **Budget Lines**: `GET`, `POST`, `PUT`, `GET /{id}`
+- **Budget Execution**: `GET`, `POST`
+
+### Treasury (`/api/treasury`)
+- **Payment Batches**: `GET`, `POST`, `GET /{id}`, `POST /{id}/status`
+- **Payment Orders**: `GET`, `POST`, `GET /{id}`, `POST /{id}/status`
+- **Payments**: `GET`, `POST`
+
+### Common (`/api/common`)
+- **Banks**: `GET`, `POST`, `PUT`, `GET /{id}`
+
+## Status do Projeto
+
+✅ **Estrutura Base**: 100% Completo
+✅ **Entidades JPA**: 100% Completo
+✅ **Repositories**: 100% Completo
+✅ **Services**: 100% Completo (CRUD básico)
+✅ **Controllers REST**: 100% Completo
+✅ **DTOs e Validações**: 100% Completo
+
+⚠️ **Pendente**:
+- Autenticação JWT completa
+- Testes unitários e de integração
+- Documentação Swagger/OpenAPI
+- Integrações avançadas entre módulos
+
+Para mais detalhes, consulte [STATUS_PROJETO.md](STATUS_PROJETO.md).
+
+## Licença
+
+Este é um projeto governamental.
+