Programação Orientada a Objetos (POO)

O que é

• POO modela o domínio do negócio com entidades que possuem estado (atributos) e comportamento (métodos).
• No Sistema de Atividades, classes como Atividade e Usuario concentram regras que antes ficariam espalhadas em funções soltas.

Pilares e práticas

• Classe: molde; objeto: instância concreta em memória.
• Encapsulamento: esconder detalhes e expor interface estável (ex.: método cancelar() em Atividade).
• Herança: reutilizar e especializar — preferir composição quando “tem um” for mais claro que “é um”.
• Polimorfismo: mesma operação, implementações diferentes (ex.: notificar por e-mail ou SMS).
• SOLID e camadas (domínio, aplicação, infraestrutura) organizam projetos médios e grandes.

Modelo textual — classe (POO)

• Especificação textual complementa diagrama de classes UML do módulo ADS.

────────────────────────────────────────────────────────────
CLASSE — ESPECIFICAÇÃO
────────────────────────────────────────────────────────────

Pacote:         [namespace / módulo]
Classe:         [Nome]
Responsabilidade: [uma frase]

Atributos:
  - [nome]: [tipo] — [descrição]

Construtor:
  - [Nome]([params]): inicializa estado obrigatório

Métodos públicos:
  + [nome]([params]): [retorno] — [o que faz]

Métodos privados (se houver):
  - [nome]([params]): [detalhe interno]

Invariantes:
  - [regra sempre verdadeira]

────────────────────────────────────────────────────────────
EXEMPLO — Atividade (domínio)
────────────────────────────────────────────────────────────

Pacote:         dominio.atividades
Classe:         Atividade
Responsabilidade: Representar um registro operacional rastreável

Atributos:
  - id: UUID
  - dataHora: DateTime
  - descricao: string
  - status: StatusAtividade
  - idResponsavel: UUID

Métodos públicos:
  + cancelar(motivo: string): void — altera status para CANCELADA se permitido
  + conferir(): void — altera para CONFERIDA

Invariantes:
  - dataHora não pode ser futura em relação ao relógio do servidor