# luishenriqueom/usnets architecture

> Architecture diagram of the GitHub repository luishenriqueom/usnets, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luishenriqueom/usnets
- Repository: https://github.com/luishenriqueom/usnets

## Overview

Para orientar a criação de um diagrama de arquitetura claro e preciso para o projeto usNets — um sistema Java de comunicação cliente-servidor — siga as diretrizes abaixo, adaptadas à estrutura e ao propósito do projeto conforme indicado no arquivo de árvore de diretórios e no README.

##### Identificação do tipo de projeto e propósito
- usNets é um protótipo de aplicação distribuída em Java, cujo objetivo é demonstrar a comunicação entre múltiplos clientes e um servidor central.
- Não há banco de dados externo: a lógica de domínio (classes Node, Filial, Funcionario) é mantida em memória e compartilhada via mensagens sobre sockets TCP.

##### Principais componentes do sistema
a. **Clients**
- Classe Client.java
- Representa instâncias de usuário ou processos remotos que abrem conexões TCP ao servidor.
b. **Server**
- Classe Server.java
- Escuta numa porta fixa, aceita novas conexões e delega cada uma a um handler.
c. **ServerProcessClient**
- Classe que estende Runnable/Thread, processa requisições de cada cliente em um thread separado (padrão “thread-per-connection”).
d. **Domínio / Entidades**
- Node.java, Filial.java, Funcionario.java
- Modelam a lógica de negócio: nodos de rede, filiais e funcionários. São usadas tanto pelo cliente (para montar requisições) quanto pelo servidor (para processá-las).

##### Fluxo de interações e relacionamentos
- O **Main.java** inicializa o **Server** (Thread principal) e pode também disparar instâncias de **Client** (se previsto).
- Cada **Client** abre um **Socket** → envia objetos ou comandos (ex.: instância de Funcionario) → recebe resposta do servidor.
- O **Server**, ao aceitar um **Socket**, instancia um **ServerProcessClient** que:
- lê a requisição (InputStream)
- desserializa/analisa e atualiza estado interno (usando objetos Node, Filial, Funcionario)
- envia resposta pelo OutputStream ao cliente
- encerra ou aguarda próximas mensagens

##### Padrões e princípios arquiteturais
- Arquitetura cliente-servidor monolítica (um único processo de servidor).
- Concorrência por thread-per-connection para escalabilidade básica.
- Uso de serialização Java padrão ou protocol-pojo para troca de mensagens.
- Separação clara entre:
- Camada de transporte (java.net.Socket)
- Camada de processamento de negócio (ServerProcessClient + classes de domínio)
- Camada de apresentação / orquestração (Client.java, Main.java)

##### Tecnologias e bibliotecas-chave
- Java SE (JDK 8+): java.net.Socket, java.io.ObjectInputStream/ObjectOutputStream (ou Data streams)
- Threading: java.lang.Thread, Runnable
- (Opcional) Bibliotecas de logging ou utilitários de serialização

##### Como estruturar o diagrama de sistema
a. **Componentes**
- Blocos retangulares para: Clients, Server, ServerProcessClient, Domain Model
- Dentro de “Domain Model”, sub-blocos para Node, Filial, Funcionario
b. **Relacionamentos e fluxos**
- Setas direcionais Client → Server (requerimento)
- Server → ServerProcessClient (delegação de socket)
- ServerProcessClient ↔ Domain Model (operações de negócio)
- ServerProcessClient → Client (resposta)
c. **Destaques visuais**
- Use cores distintas:
- Azul para componentes de rede (Client, Server)
- Verde para threads/handlers (ServerProcessClient)
- Cinza claro para classes de domínio
- Formas:
- Cilindro apenas se houver persistência futura (não obrigatório aqui)
- Retângulos com cantos arredondados para processos
d. **Detalhes de diagramação**
- Rótulos claros: “Socket/Porta 12345” na conexão entre Client e Server
- Anote protocolos ou formatos de mensagem (ex.: “Objeto Funcionario serializado”)
- Indique o padrão thread-per-connection ao lado de ServerProcessClient
- Agrupe Server + ServerProcessClient dentro de um contêiner “Servidor Central”

##### Diretrizes finais para o diagrama
- Mantenha uma legenda explicando cores e formas.
- Numere fluxos principais (1. Conectar, 2. Enviar requisição, 3. Processar, 4. Responder).
- Verifique que todos os componentes listados no README aparecem representados.
- Seja o mais detalhado possível: capture classes, interfaces e fluxo de dados sem sobrecarregar com código de baixo nível.

Com esse guia, o engenheiro de software principal poderá elaborar um diagrama claro, mostrando:
- Separação de responsabilidades (transporte, processamento, domínio)
- Mecanismo de concorrência (threads)
- Fluxos de comunicação entre clientes e servidor

Esse diagrama servirá tanto para documentação técnica quanto para facilitar futuras expansões (por exemplo, introduzir um banco de dados ou um gateway de autenticação).

## Diagram (Mermaid)

```mermaid
flowchart TD
    Main["Main"]:::orchestration
    Client["Client"]:::network
    subgraph "Servidor Central"
        Server["Server"]:::network
        SPClient["ServerProcessClient\n(thread-per-connection)"]:::handler
    end
    subgraph "Domain Model"
        Node["Node"]:::domain
        Filial["Filial"]:::domain
        Funcionario["Funcionario"]:::domain
    end
    Main -->|"Inicializa"| Server
    Main -->|"Pode disparar"| Client
    Client -->|"1. Conectar\nSocket/Porta 12345"| Server
    Server -->|"delegação de socket"| SPClient
    Client -->|"2. Enviar requisição\nObjeto Funcionario serializado"| SPClient
    SPClient -->|"3.1 Leitura InputStream"| Node
    SPClient -->|"3.2 Atualiza estado"| Filial
    SPClient -->|"3.3 Atualiza estado"| Funcionario
    Node -->|"resultado"| SPClient
    Filial -->|"resultado"| SPClient
    Funcionario -->|"resultado"| SPClient
    SPClient -->|"4. Responder\nObjeto Funcionario serializado"| Client

    subgraph "Legenda"
        LNet["Componentes de Rede"]:::network
        LHandler["Handlers/Threads"]:::handler
        LDomain["Modelos de Domínio"]:::domain
        LOrch["Orquestração / Entry Point"]:::orchestration
    end

    click Client "https://github.com/luishenriqueom/usnets/blob/main/Client.java"
    click Server "https://github.com/luishenriqueom/usnets/blob/main/Server.java"
    click SPClient "https://github.com/luishenriqueom/usnets/blob/main/ServerProcessClient.java"
    click Node "https://github.com/luishenriqueom/usnets/blob/main/Node.java"
    click Filial "https://github.com/luishenriqueom/usnets/blob/main/Filial.java"
    click Funcionario "https://github.com/luishenriqueom/usnets/blob/main/Funcionario.java"
    click Main "https://github.com/luishenriqueom/usnets/blob/main/Main.java"

    classDef network fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef handler fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef domain fill:#D3D3D3,stroke:#333,stroke-width:1px;
    classDef orchestration fill:#FFFACD,stroke:#333,stroke-width:1px;
```
