ACESSE A APLICAÇÃO ONLINE (DEPLOY):
👉 https://school-system-api-3au1.onrender.com

Hospedei a aplicação na opção Free-Tier do Render, por isso, a aplicação demora 1-2 min para iniciar (Regras das plataforma de hospedagem)

Possivelmente ao iniciar, irá demorar 1 minuto para que os dados do banco sejam recebidos no Front End

O School System é um sistema de gerenciamento acadêmico focado em performance, integridade de dados e arquitetura limpa. Embora possua uma interface visual para demonstração, o coração do projeto é uma API RESTful robusta desenvolvida para resolver problemas complexos de alocação de turmas, gestão de grade horária, análise estatística tratamentos de possiveis erros.

O foco deste projeto é visa demonstrar boas práticas de engenharia de software no Backend, utilizando o ecossistema Java para garantir escalabilidade, manutenção e segurança.

A escolha tecnológica foi estratégica, visando simular um ambiente corporativo de alto confiabilidade para usuários e clientes

1. Robustez e Tipagem: A tipagem estática do Java previne uma classe inteira de erros comuns em tempo de execução, garantindo que regras de negócio críticas não quebrem em produção.
2. Ecossistema Enterprise: O Spring Boot é o padrão global para microsserviços. Sua capacidade de autoconfiguração aliada à Injeção de Dependência (IoC) permite focar puramente na lógica de domínio.
3. Escalabilidade e Performance: A JVM moderna oferece gerenciamento de memória e Garbage Collection otimizados para lidar com alta concorrência e processamento de dados massivos.
4. Dominio da Tecnologia: E Tecnologia onde tenho mais experiência

• Java 21 (LTS): Linguagem base, escolhida pela estabilidade e suporte a novos recursos de linguagem.
• Spring Boot 3: Framework principal (Web, Data JPA, Validation).
• Hibernate / JPA: ORM para abstração de banco de dados e proteção nativa contra SQL Injection.
• H2 Database: Banco em memória para testes de integração e desenvolvimento local (profile: dev).
• PostgreSQL: Banco de dados relacional robusto para o ambiente de produção (profile: prod).
• Maven: Gerenciamento de dependências e build.

• Vanilla JS + Bootstrap: Consumidor leve da API, sem frameworks pesados, demonstrando domínio de fundamentos da Web (DOM, Fetch API, Async/Await) e desacoplamento total entre cliente e servidor.

O projeto segue rigorosamente o padrão MVC (Model-View-Controller) com camadas de serviço e repositório bem definidas.

graph TD
    subgraph Project [📂 school-system]
        src[src/main/java]
        
        %% Packages
        src --> controller[📂 controller]
        src --> model[📂 model]
        src --> repo[📂 repository]
        src --> service[📂 service]
        src --> dto[📂 dto]

        %% Controllers
        controller --> C1[StudentController]
        controller --> C2[TeacherController]
        controller --> C3[SchoolScheduleController]

        %% Models
        model --> M1[Student]
        model --> M2[Teacher]
        model --> M3[SchoolSchedule]
        model --> M4[ClassEntity]

        %% Repositories
        repo --> R1[StudentRepository]
        repo --> R2[TeacherRepository]
        repo --> R3[SchoolSchedulerRepository]
    end

    style Project fill:#f9f9f9,stroke:#333,stroke-width:2px
    style controller fill:#e3f2fd,stroke:#1565c0
    style model fill:#fff9c4,stroke:#fbc02d
    style repo fill:#e8f5e9,stroke:#2e7d32

O diagrama abaixo ilustra os relacionamentos complexos ManyToOne (Muitos Para Um) gerenciados pelo JPA para vincular Professores, Matérias e Turmas na grade horária.

classDiagram
    %% Relacionamentos
    Student "*" --> "1" ClassEntity : Pertence a
    ClassEntity "*" --> "1" Degree : Pertence a
    
    SchoolSchedule "*" --> "1" Teacher : Tem
    SchoolSchedule "*" --> "1" Matter : Tem
    SchoolSchedule "*" --> "1" ClassEntity : Tem

    %% Classes Principais
    class Student {
        +Integer id
        +String name
        +Integer classId
    }

    class Teacher {
        +Integer id
        +String name
        +String subject
    }

    class SchoolSchedule {
        +Integer id
        +Teacher teacher
        +Matter matter
        +ClassEntity classEntity
    }

    %% Cores
    style Student fill:#fff9c4,stroke:#fbc02d
    style Teacher fill:#fff9c4,stroke:#fbc02d
    style SchoolSchedule fill:#ffe0b2,stroke:#f57c00

• Java 21+
• Maven (Opcional, wrapper incluso no projeto)
• Docker (Opcional, para containerização)

Clone o repositório:

git clone https://github.com/seu-usuario/school-system.git
cd school-system

Execute a aplicação (usando Maven Wrapper):

./mvnw spring-boot:run

Acesse:

• Aplicação Web: http://localhost:8080
• Swagger UI: http://localhost:8080/swagger-ui/index.html
• Console H2: http://localhost:8080/h2-console

A API segue os padrões REST. Abaixo estão os exemplos de corpo (body) JSON para as principais requisições.

• Criar Aluno
  POST /students/create
  Body:

  {
    "name": "Roberto Silva",
    "classId": 5
  }

• Atualizar Aluno
  PUT /students/update/{id}
  Body:

  {
    "name": "Roberto Silva Junior",
    "classId": 2
  }

• Deletar Aluno
  DELETE /students/delete/{id}

• Resetar Base de Dados (Limpeza)
  DELETE /students/clear

• Criar Professor
  POST /teachers/create
  Body:

  {
    "name": "Prof. Girafales",
    "subject": "Matemática Avançada"
  }

• Atualizar Professor
  PUT /teachers/update/{id}
  Body:

  {
    "name": "Prof. Girafales",
    "subject": "Física"
  }

Este endpoint gerencia a alocação de aulas, exigindo o relacionamento entre três entidades.

• Criar Agendamento
  POST /schedule/create
  Nota: O payload deve conter os objetos aninhados com seus respectivos IDs.
  Body:

  {
    "teacher": { "id": 1 },
    "matter": { "id": 2 },
    "classEntity": { "id": 5 }
  }

• Deletar Agendamento
  DELETE /schedule/delete/{id}