Backoffice Process Manager

Sistema completo para gestão de processos internos, com foco em produtividade, colaboração e rastreabilidade.
Permite criar, editar, comentar e acompanhar processos com controle de status, urgência e histórico.

Este projeto é fullstack, composto por Angular 19 no frontend e Spring Boot 3 (Java 21) no backend, com persistência em PostgreSQL e infraestrutura via Docker.

This is a challenge by Coodesh

---

🚀 Tech Stack

Frontend

• Angular 19
• RxJS
• Nginx (SPA routing + static assets)

Backend

• Spring Boot 3.4
• Java 21
• Spring Security + OAuth2 Resource Server
• Spring Data JPA
• Flyway (migrations)
• PostgreSQL
• Lombok
• MapStruct
• Springdoc OpenAPI (Swagger UI)

Infraestrutura

• Docker + Docker Compose
• Healthchecks configurados
• Rede interna isolada
• Nginx configurado para manter rotas do Angular no frontend

---

📂 Estrutura do Projeto

backoffice-process-manager/
│
├── backend/                # API REST com Spring Boot
│   ├── src/main/java/...   # Código Java
│   ├── pom.xml             # Configuração Maven
│   └── Dockerfile
│
├── frontend/               # Aplicação Angular
│   ├── src/                # Componentes, páginas, serviços
│   ├── angular.json
│   ├── package.json
│   ├── nginx.conf          # Configuração para SPA no Nginx
│   └── Dockerfile
│
├── docker-compose.yml      # Orquestração dos serviços
└── README.md

---

🧩 Arquitetura

• Frontend SPA: Angular 19 com roteamento client-side, servido via Nginx.
• Backend REST: Spring Boot com autenticação via OAuth2 Resource Server e JWT.
• Banco de Dados: PostgreSQL com versionamento via Flyway.
• Infraestrutura: Docker Compose com rede isolada e dependências entre serviços.
• Comunicação: Frontend consome a API via HTTP, protegida por token OAuth2.

---

🐳 Executando com Docker

docker-compose up --build

Serviços

• Frontend → http://localhost:4200
• Backend → http://localhost:8080
• Banco de Dados → PostgreSQL (porta 5432)

---

📖 Funcionalidades

• Autenticação via OAuth2 (Google e Microsoft)
• Listagem de processos com paginação e filtros
• Criação e edição de processos
• Comentários em processos com resposta encadeada
• Controle de status e urgência
• Histórico de criação e atualização
• Modal de confirmação para ações críticas

---

📦 Build Manual

Frontend

cd frontend
npm run build

Saída em frontend/dist/.

Backend

cd backend
./mvnw clean package

Saída em backend/target/.

---

📑 Documentação da API

A API REST está documentada com Springdoc:

• Swagger UI → http://localhost:8080/swagger-ui.html
• OpenAPI JSON → http://localhost:8080/v3/api-docs
• Redoc → http://localhost:8080/redoc

---

📁 .gitignore

Use um .gitignore adequado para projetos Angular, Java e Docker.
Gere em toptal.com/developers/gitignore

---

👨‍💻 Autor

Wesley Brito
📧 wesleymuniz20@gmail.com
🔗 GitHub