https://github.com/thallyta-castro-cv/java-clean-arch
Este projeto implementa um sistema de cadastro de usuários utilizando os princípios da Arquitetura Limpa (Clean Architecture). O objetivo é organizar o código de forma que seja independente de frameworks, fácil de manter e de escalar, promovendo a separação de responsabilidades entre as camadas.
https://github.com/thallyta-castro-cv/java-clean-arch
clean-architecture java spring
Last synced: 2 months ago
JSON representation
Este projeto implementa um sistema de cadastro de usuários utilizando os princípios da Arquitetura Limpa (Clean Architecture). O objetivo é organizar o código de forma que seja independente de frameworks, fácil de manter e de escalar, promovendo a separação de responsabilidades entre as camadas.
- Host: GitHub
- URL: https://github.com/thallyta-castro-cv/java-clean-arch
- Owner: thallyta-castro-cv
- Created: 2024-12-21T19:17:17.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-01-01T23:35:31.000Z (over 1 year ago)
- Last Synced: 2025-01-02T00:21:59.977Z (over 1 year ago)
- Topics: clean-architecture, java, spring
- Language: Java
- Homepage:
- Size: 19.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Projeto: Site de venda de ingressos com Arquitetura Limpa
Este projeto implementa um sistema de cadastro de usuários utilizando os princípios da **Arquitetura Limpa** (Clean Architecture).
O objetivo é organizar o código de forma que seja independente de frameworks, fácil de manter e de escalar, promovendo a separação de responsabilidades entre as camadas.
## Diagrama de classes
```mermaid
classDiagram
class Event {
- category: Category
- address: Address
- date: Date
- typeTicket: List~TypeTicket~
+ method(): Type
}
class TypeTicket {
- event: Event
- sector: Sector
- definition: Definition
- value: Double
- totalAvailable: int
+ method(): Type
}
class Ticket {
- code: String
- typeTicket: TypeTicket
+ method(): Type
}
class User {
- cpf: String
- name: String
- bornDate: Date
- email: String
- address: Address
+ method(): Type
}
class Sale {
- user: User
- tickets: List~Ticket~
+ method(): Type
}
class Address {
- cep: String
- number: Integer
- complement: String
+ Address(String, Integer, String)
}
class Definition {
<>
INTEIRA
ESTUDANTE
IDOSO
PCD
MEIA
OUTROS
}
class Sector {
<>
PISTA
PISTA_PREMIUM
CADEIRA
CAMAROTE
}
class Category {
<>
FESTIVAL
MUSICA
TEATRO
OUTROS
}
Event --> TypeTicket
TypeTicket --> Ticket
Ticket --> Sale
Sale --> User
Event --> Address
User --> Address
Event --> Category
TypeTicket --> Sector
TypeTicket --> Definition
```
### Descrição das Camadas do Projeto
#### 1. Application
Essa camada concentra os casos de uso e interfaces que permitem que os dados transitem entre as camadas sem depender de implementações concretas.
- **gateway**: Interface que define os contratos para operações de persistência relacionadas às entidades do domínio.
- **usecase**: Casos de uso para as entidades.
#### 2. Config
Camada responsável pelos arquivos de configuração do projeto, como beans do Spring ou outras dependências.
- **Config**: Arquivos gerais de configuração da aplicação.
#### 3. Domain
Camada onde estão as entidades do domínio e regras de negócio puras.
- **domain**: Classes que representam as entidades principais do domínio.
#### 4. Infra
Camada responsável pelas interações externas, como frameworks e bibliotecas.
- **controller**: Controladores REST para exposição de endpoints relacionados às entidades.
- **gateway**: Mappers para conversão entre objetos de entidades e DTOs e implementações concretas do repositório usando JPA.
- **persistence**: Interfaces que representam as operações no banco de dados e Classes que representam as entidades no banco de dados.
## Configuração do Ambiente
1. Clone o repositório:
```bash
git clone https://github.com/thallyta/clean-architecture-user.git
```
2. Acesse o diretório do projeto:
```bash
cd clean-architecture-user
```
3. Compile o projeto:
```bash
mvn clean install
```
4. Execute a aplicação:
```bash
mvn spring-boot:run
```
## Testes
Os testes de unidade e integração estão localizados no diretório `src/test/java`. Para executar os testes:
```bash
mvn test
```
## Referências Futuras
Esta documentação serve como referência para o uso e manutenção do projeto. Considere as boas práticas adotadas aqui como base para futuros sistemas que utilizem a Arquitetura Limpa.
## Autor
- **Thallyta Castro**
[LinkedIn](https://www.linkedin.com/in/thallyta-castro)
[GitHub](https://github.com/thallyta)