# jessicapersou/lending architecture

> Architecture diagram of the GitHub repository jessicapersou/lending, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jessicapersou/lending
- Repository: https://github.com/jessicapersou/lending

## Overview

This is a lending service whose evidenced runtime workflow is client registration: an HTTP request is mapped into the domain, validated, persisted, assigned an activation token, and published as an activation event. The tree also contains proposal intake and lending records for proposals, contracts, calculations, interest rates, and installments, but the README and sampled code do not establish their processing flows. Those subsystems are represented without guessed connections; several adapters are unsampled, so their wiring remains uncertain.

Main entry points: [`src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java`](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java) (Registration Use Case), [`src/main/java/com/persou/lending/adapter/out/persistence/entity/ProposalEntity.java`](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/entity/ProposalEntity.java) (Lending Records), [`src/main/java/com/persou/lending/adapter/in/api/ClientController.java`](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/api/ClientController.java) (Client API), [`src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java`](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java) (Client Persistence Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and Intake"]
  node_client_api["Client API"]
  node_api_mapping["API Mapping"]
  node_proposal_consumer["Proposal Consumer"]
  node_proposal_mapping["Proposal Mapping"]
end

subgraph group_application["Client Registration"]
  node_registration["Registration Use Case"]
end

subgraph group_domain["Lending Domain"]
  node_client_domain["Client and Validation<br/>[Client.java]"]
  node_proposal_domain["Proposal<br/>[Proposal.java]"]
  node_contract_domain["Contract<br/>[Contract.java]"]
  node_installment_domain["Installment<br/>[Installment.java]"]
  node_calculation_domain["Calculation Result"]
  node_interest_domain["Interest Rate<br/>[InterestRate.java]"]
  node_activation_event["Activation Event"]
end

subgraph group_adapters["Persistence and Events"]
  node_client_persistence["Client Persistence Adapter"]
  node_client_mapper["Persistence Mapping<br/>[ClientMapper.java]"]
  node_client_entity[("Client Record<br/>[ClientEntity.java]")]
  node_client_jpa["Client Repository"]
  node_token_adapter["Activation Token Store"]
  node_activation_producer["Activation Producer"]
  node_event_mapper["Event Mapping"]
  node_lending_records[("Lending Records")]
end

node_client(("Client"))
node_kafka["Kafka"]

node_client -->|"submits"| node_client_api
node_client_api -->|"maps request"| node_api_mapping
node_client_api -->|"invokes"| node_registration
node_registration -->|"validates"| node_client_domain
node_registration -->|"saves client"| node_client_persistence
node_client_persistence -->|"maps records"| node_client_mapper
node_client_persistence -->|"uses repository"| node_client_jpa
node_client_jpa -->|"stores"| node_client_entity
node_registration -.->|"requests token"| node_token_adapter
node_registration -->|"creates event"| node_activation_event
node_registration -.->|"publishes event"| node_activation_producer
node_activation_producer -->|"maps event"| node_event_mapper
node_activation_producer -.->|"publishes"| node_kafka
node_kafka -.->|"delivers proposal"| node_proposal_consumer
node_proposal_consumer -.->|"maps proposal"| node_proposal_mapping
node_client_domain -->|"references"| node_proposal_domain
node_client_entity -->|"relates proposals"| node_lending_records
node_lending_records -.-> node_contract_domain
node_lending_records -.-> node_installment_domain
node_lending_records -.-> node_calculation_domain
node_lending_records -.-> node_interest_domain

click node_client_api "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/api/ClientController.java"
click node_api_mapping "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/api/mapper/CreateClientMapper.java"
click node_proposal_consumer "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/kafka/ProposalKafkaConsumer.java"
click node_proposal_mapping "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/kafka/ClientProposalMapper.java"
click node_registration "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java"
click node_client_domain "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Client.java"
click node_proposal_domain "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Proposal.java"
click node_contract_domain "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Contract.java"
click node_installment_domain "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Installment.java"
click node_calculation_domain "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/CalculationResult.java"
click node_interest_domain "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/InterestRate.java"
click node_activation_event "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/event/ActivationClientEvent.java"
click node_client_persistence "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java"
click node_client_mapper "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/application/mapper/ClientMapper.java"
click node_client_entity "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/entity/ClientEntity.java"
click node_client_jpa "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/repository/ClientJpaRepository.java"
click node_token_adapter "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/AccountActivationTokenPersistenceAdapterOut.java"
click node_activation_producer "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientKafkaProducer.java"
click node_event_mapper "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientEventMapper.java"
click node_lending_records "https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/entity/ProposalEntity.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client_api,node_api_mapping,node_proposal_consumer,node_proposal_mapping,node_client toneBlue
class node_registration toneAmber
class node_client_domain,node_proposal_domain,node_contract_domain,node_installment_domain,node_calculation_domain,node_interest_domain,node_activation_event toneMint
class node_client_persistence,node_client_mapper,node_client_entity,node_client_jpa,node_token_adapter,node_activation_producer,node_event_mapper,node_lending_records toneRose
class node_kafka toneIndigo
```

## Components

### API and Intake

- [Client API](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/api/ClientController.java): `src/main/java/com/persou/lending/adapter/in/api/ClientController.java`
- [API Mapping](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/api/mapper/CreateClientMapper.java): `src/main/java/com/persou/lending/adapter/in/api/mapper/CreateClientMapper.java`
- [Proposal Consumer](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/kafka/ProposalKafkaConsumer.java): `src/main/java/com/persou/lending/adapter/in/kafka/ProposalKafkaConsumer.java`
- [Proposal Mapping](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/in/kafka/ClientProposalMapper.java): `src/main/java/com/persou/lending/adapter/in/kafka/ClientProposalMapper.java`

### Client Registration

- [Registration Use Case](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java): `src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java`

### Lending Domain

- [Client and Validation](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Client.java): `src/main/java/com/persou/lending/domain/model/Client.java`
- [Proposal](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Proposal.java): `src/main/java/com/persou/lending/domain/model/Proposal.java`
- [Contract](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Contract.java): `src/main/java/com/persou/lending/domain/model/Contract.java`
- [Installment](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/Installment.java): `src/main/java/com/persou/lending/domain/model/Installment.java`
- [Calculation Result](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/CalculationResult.java): `src/main/java/com/persou/lending/domain/model/CalculationResult.java`
- [Interest Rate](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/model/InterestRate.java): `src/main/java/com/persou/lending/domain/model/InterestRate.java`
- [Activation Event](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/domain/event/ActivationClientEvent.java): `src/main/java/com/persou/lending/domain/event/ActivationClientEvent.java`

### Persistence and Events

- [Client Persistence Adapter](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java): `src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java`
- [Persistence Mapping](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/application/mapper/ClientMapper.java): `src/main/java/com/persou/lending/application/mapper/ClientMapper.java`
- [Client Record](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/entity/ClientEntity.java): `src/main/java/com/persou/lending/adapter/out/persistence/entity/ClientEntity.java`
- [Client Repository](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/repository/ClientJpaRepository.java): `src/main/java/com/persou/lending/adapter/out/persistence/repository/ClientJpaRepository.java`
- [Activation Token Store](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/AccountActivationTokenPersistenceAdapterOut.java): `src/main/java/com/persou/lending/adapter/out/persistence/AccountActivationTokenPersistenceAdapterOut.java`
- [Activation Producer](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientKafkaProducer.java): `src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientKafkaProducer.java`
- [Event Mapping](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientEventMapper.java): `src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientEventMapper.java`
- [Lending Records](https://github.com/jessicapersou/lending/blob/develop/src/main/java/com/persou/lending/adapter/out/persistence/entity/ProposalEntity.java): `src/main/java/com/persou/lending/adapter/out/persistence/entity/ProposalEntity.java`

### Other components

- **Client**
- **Kafka**

## Connections

- Client → Client API: submits (evidence: `src/main/java/com/persou/lending/adapter/in/api/ClientController.java`)
- Client API → API Mapping: maps request (evidence: `src/main/java/com/persou/lending/adapter/in/api/ClientController.java`)
- Client API → Registration Use Case: invokes (evidence: `src/main/java/com/persou/lending/adapter/in/api/ClientController.java`)
- Registration Use Case → Client and Validation: validates (evidence: `src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java`)
- Registration Use Case → Client Persistence Adapter: saves client (evidence: `src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java`)
- Client Persistence Adapter → Persistence Mapping: maps records (evidence: `src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java`)
- Client Persistence Adapter → Client Repository: uses repository (evidence: `src/main/java/com/persou/lending/adapter/out/persistence/ClientPersistenceAdapterOut.java`)
- Client Repository → Client Record: stores (evidence: `src/main/java/com/persou/lending/adapter/out/persistence/repository/ClientJpaRepository.java`)
- Registration Use Case → Activation Token Store: requests token
- Registration Use Case → Activation Event: creates event (evidence: `src/main/java/com/persou/lending/application/usecase/CreateClienteUseCase.java`)
- Registration Use Case → Activation Producer: publishes event
- Activation Producer → Event Mapping: maps event (evidence: `src/main/java/com/persou/lending/adapter/out/messaging/kafka/producer/ActivationClientKafkaProducer.java`)
- Activation Producer → Kafka: publishes
- Kafka → Proposal Consumer: delivers proposal
- Proposal Consumer → Proposal Mapping: maps proposal
- Client and Validation → Proposal: references (evidence: `src/main/java/com/persou/lending/domain/model/Client.java`)
- Client Record → Lending Records: relates proposals (evidence: `src/main/java/com/persou/lending/adapter/out/persistence/entity/ClientEntity.java`)
- Lending Records → Contract
- Lending Records → Installment
- Lending Records → Calculation Result
- Lending Records → Interest Rate
