Files
JavadocViewerService/CLAUDE.md
T
thischwa 6b5f0cf58a
Build and Push Docker Image / build-and-push (push) Successful in 57s
Refactor codebase:
- Add Markdown documentation (`CLAUDE.md`) outlining the technical stack and project structure.
- Introduce Google Checkstyle (`google_custom_checks.xml`) for code formatting and validation.
- Rename `HomeController` to `UiController` for consistency.
- Replace package `repository` with `jpa` for clarity in data access layer.
- Add `logback.xml` for enhanced logging configuration.
- Refactor Javadoc generation logic in `JavadocService`.
2026-07-04 20:41:17 +02:00

1.7 KiB

JavadocViewerService

Tech Stack

  • Java 21
  • Spring Boot 4.x (spring-boot-starter-parent)
    • Spring MVC (spring-boot-starter-web)
    • Spring Data JPA (spring-boot-starter-data-jpa)
    • Thymeleaf (spring-boot-starter-thymeleaf)
    • Bean Validation (spring-boot-starter-validation)
    • Liquibase (spring-boot-starter-liquibase)
  • H2 — file-based embedded database (./database/jdvsdb)
  • Lombok — boilerplate reduction (@Data, @RequiredArgsConstructor, @Slf4j)
  • JGit 7.x — Git operations (clone, fetch, tag resolution)
  • Jackson YAML — parsing of jdvs.yml config file
  • Maven — build tool

Configuration

  • application.yml — base configuration (datasource, JPA, default jdvs properties)
  • jdvs.yml — external runtime config (repositories, property overrides); imported via spring.config.import

Package Structure

  • codes.thischwa.jdvs.config@ConfigurationProperties beans
  • codes.thischwa.jdvs.service — business logic (Git, Javadoc generation, scheduling)
  • codes.thischwa.jdvs.jpa — Spring Data repositories
  • codes.thischwa.jdvs.model — JPA entities
  • codes.thischwa.jdvs.web — MVC controllers and WebMvcConfigurer

Coding

The generated code follows the principles of clean architecture and follows the SOLID principles. It is designed to be modular, testable, and maintainable. The code is written in a way that promotes readability and reduces complexity. It uses modern Java features and best practices to ensure efficient and reliable operation. To formate the code use che checkstyle definition in google_custom_checks.xml. Each changing of code must be verified with compiling.