https://github.com/sans-arch/freelance-adm-platform

Plataforma de gestão de freelancers que conecta clientes e prestadores de serviço. Permite cadastro de projetos, envio e negociação de propostas, acompanhamento de status, simulação de pagamentos e envio de notificações.
https://github.com/sans-arch/freelance-adm-platform

h2 jwt-authentication lombok openapi postgresql spring-boot spring-security spring-validation

Last synced: 1 day ago
JSON representation

Plataforma de gestão de freelancers que conecta clientes e prestadores de serviço. Permite cadastro de projetos, envio e negociação de propostas, acompanhamento de status, simulação de pagamentos e envio de notificações.

• Host: GitHub
• URL: https://github.com/sans-arch/freelance-adm-platform
• Owner: Sans-arch
• Created: 2025-05-09T16:28:50.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-09-19T00:43:16.000Z (9 months ago)
• Last Synced: 2025-10-26T11:42:07.679Z (8 months ago)
• Topics: h2, jwt-authentication, lombok, openapi, postgresql, spring-boot, spring-security, spring-validation
• Language: Java
• Homepage:
• Size: 190 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🌟 Plataforma de Gestão de Freelancers | Freelancer Management Platform  

  

    

    

    

    

    

  


Uma plataforma completa que conecta **clientes** e **freelancers**, permitindo cadastro de projetos, envio e negociação de propostas, acompanhamento de status e simulação de pagamentos.  

A complete platform that connects **clients** and **freelancers**, allowing project creation, proposal submission and negotiation, project tracking, and payment simulation.  

---

## 📑 Sumário | Table of Contents  

- [🇧🇷 Português](#-português)  

  - [✨ Funcionalidades Principais](#-funcionalidades-principais)  

- [🇬🇧 English](#-english)  

  - [✨ Main Features](#-main-features)  

- [🛠️ Tecnologias | Technologies](#️-tecnologias--technologies)  

- [🚀 Objetivo | Goal](#-objetivo--goal)  

- [📅 Status](#-status)  

- [🤝 Contribuição | Contributing](#-contribuição--contributing)  

---

## 🇧🇷 Português  

### ✨ Funcionalidades Principais  

- 👤 **Cadastro de Usuários**  

  - Dois tipos: **Cliente** e **Freelancer**  

  - Dados obrigatórios: Nome, CPF/CNPJ, E-mail único, Senha  

  - Um usuário pode atuar nos dois papéis  

- 📌 **Cadastro de Projetos** *(somente clientes)*  

  - Campos: **Título**, **Descrição**, **Prazo**, **Orçamento**  

  - Status: `Aberto`, `Em negociação`, `Em andamento`, `Concluído`, `Cancelado`  

- 💼 **Propostas de Freelancers**  

  - Freelancers podem enviar valor ofertado e prazo estimado  

  - Clientes podem **aceitar** ou **recusar**  

  - Aceitando, o status muda para **Em andamento**  

- ✅ **Entrega & Conclusão**  

  - Freelancer marca como **Concluído**  

  - Cliente valida antes de finalizar  

  - Ajustes possíveis (volta para **Em andamento**)  

- 💳 **Pagamentos (simulação)**  

  - Mock de **gateway de pagamentos** (`POST /pagamento/autorizar`)  

  - Liberação só após aprovação do cliente  

  - Retentativa automática em falhas  

- 🔔 **Notificações**  

  - Via **e-mail** ou **webhook** para:  

    - Proposta enviada  

    - Proposta aceita  

    - Projeto concluído  

  - Mock externo (`POST /notificacao/enviar`)  

---

## 🇬🇧 English  

### ✨ Main Features  

- 👤 **User Registration**  

  - Two types: **Client** and **Freelancer**  

  - Required fields: Full Name, CPF/CNPJ (or ID), Unique Email, Password  

  - A user can act as both roles  

- 📌 **Project Management** *(clients only)*  

  - Fields: **Title**, **Description**, **Deadline**, **Estimated Budget**  

  - Status: `Open`, `Negotiating`, `In Progress`, `Completed`, `Canceled`  

- 💼 **Freelancer Proposals**  

  - Freelancers submit price and estimated deadline  

  - Clients can **accept** or **reject**  

  - If accepted → status changes to **In Progress**  

- ✅ **Delivery & Completion**  

  - Freelancer marks as **Completed**  

  - Client validates before finalizing  

  - Adjustments possible (status returns to **In Progress**)  

- 💳 **Payments (simulation)**  

  - Mock **payment gateway** (`POST /payment/authorize`)  

  - Released only after client approval  

  - Automatic retries on failures  

- 🔔 **Notifications**  

  - Via **email** or **webhook** for:  

    - Proposal submitted  

    - Proposal accepted  

    - Project completed  

  - Mock service (`POST /notification/send`)  

---

## 🛠️ Tecnologias | Technologies  

- Java + Spring Boot ☕  

- PostgreSQL 🐘  

- Arquitetura Hexagonal + DDD 📐  

- Mock Services  

---

## 🚀 Objetivo | Goal  

🇧🇷 Fornecer uma simulação ponta a ponta do fluxo de contratação de freelancers, com foco em **boas práticas de arquitetura** e **regras de negócio**.  

🇬🇧 Provide an end-to-end simulation of the freelancer hiring flow, with focus on **clean architecture** and **business domain rules**.  

---

## 📅 Status  

🇧🇷 🔧 Em desenvolvimento – novas features em andamento.  

🇬🇧 🔧 In development – new features coming soon.  

---

## 🤝 Contribuição | Contributing  

🇧🇷 Pull Requests são bem-vindos! Abra uma issue para sugestões ou melhorias.  

🇬🇧 Pull Requests are welcome! Open an issue for suggestions or improvements.