Bagian 1: Struktur Aplikasi

aplikasi-web-spring-boot/
├── pom.xml
└── src/
    ├── main/
    │   ├── java/
    │   │   └── com/
    │   │       └── example/
    │   │           └── tugas/
    │   │               ├── AplikasiTugasApplication.java   @SpringBootApplication
    │   │               ├── web/                            lapisan controller
    │   │               ├── layanan/                        lapisan service
    │   │               ├── data/                           lapisan repository
    │   │               └── domain/                         entitas + DTO
    │   └── resources/
    │       └── application.properties                      konfigurasi
    └── test/
        └── java/
            └── com/example/tugas/
                └── ...                                     pengujian

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                             https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.5.0</version>
        <relativePath/>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>aplikasi-web-spring-boot</artifactId>
    <version>1.0.0</version>

    <properties>
        <java.version>25</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
    </dependencies>
</project>

/**
 * Status daur hidup tugas pada aplikasi web manajemen tugas.
 * TODO berarti tugas masih terbuka, SELESAI berarti tugas tuntas.
 */
public enum StatusTugasWeb {
    TODO,
    SELESAI
}

import java.time.LocalDate;

/**
 * Satu tugas sebagai entitas domain: judul, pemilik, status, dan tenggat.
 * Record dipilih karena tugas adalah nilai yang tidak berubah di tempat;
 * perubahan dilakukan lewat method salinan di bawah, persis pola wither.
 */
public record TugasWeb(int id, String judul, String pemilik, StatusTugasWeb status,
        LocalDate tenggat) {

    public TugasWeb {
        if (judul == null || judul.isBlank()) {
            throw new IllegalArgumentException("judul tugas wajib diisi");
        }
        if (pemilik == null || pemilik.isBlank()) {
            throw new IllegalArgumentException("pemilik tugas wajib diisi");
        }
        if (status == null) {
            throw new IllegalArgumentException("status tugas wajib diisi");
        }
        if (tenggat == null) {
            throw new IllegalArgumentException("tenggat tugas wajib diisi");
        }
        judul = judul.strip();
        pemilik = pemilik.strip();
    }

    /** Salinan tugas dengan id berbeda; dipakai repository saat menetapkan id. */
    public TugasWeb denganId(int idBaru) {
        return new TugasWeb(idBaru, judul, pemilik, status, tenggat);
    }

    /** Salinan tugas dengan status berbeda; dipakai layanan saat transisi status. */
    public TugasWeb denganStatus(StatusTugasWeb statusBaru) {
        return new TugasWeb(id, judul, pemilik, statusBaru, tenggat);
    }

    /** Ringkasan satu baris untuk pencatatan di terminal. */
    public String formatRingkas() {
        return "#" + id + " [" + status + "] " + judul
                + " (pemilik " + pemilik + ", tenggat " + tenggat + ")";
    }
}

/**
 * Muatan permintaan pembuatan dan pembaruan tugas: teks mentah dari klien
 * sebelum divalidasi. Record ini berperan seperti DTO pada controller
 * Spring; pemeriksaan isinya dilakukan lapisan layanan, bukan record ini.
 */
public record PermintaanTugas(String judul, String pemilik, String tenggat) {
}

import java.util.List;
import java.util.Optional;

/**
 * Kontrak lapisan penyimpanan untuk resource tugas. Layanan hanya mengenal
 * interface ini sehingga implementasi bebas ditukar: memori untuk pengujian,
 * berkas untuk persistensi Bagian 3, atau JDBC/JPA pada aplikasi nyata.
 */
public interface RepositoryTugasWeb {

    /** Menyimpan tugas baru; id ditetapkan otomatis oleh penyimpanan. */
    TugasWeb simpanBaru(TugasWeb tugas);

    /** Mencari satu tugas berdasarkan id. */
    Optional<TugasWeb> cari(int id);

    /** Seluruh tugas terurut menaik berdasarkan id. */
    List<TugasWeb> semua();

    /** Menyimpan perubahan tugas yang sudah ada; kosong bila id tidak ada. */
    Optional<TugasWeb> perbarui(TugasWeb tugas);

    /** Menghapus tugas; false bila id tidak ada. */
    boolean hapus(int id);
}

import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Optional;

/**
 * Penyimpanan dalam memori: LinkedHashMap menjaga urutan sisip sama dengan
 * urutan id, penghitung sederhana menetapkan id berurutan mulai dari 1.
 */
public class RepositoryTugasWebMemori implements RepositoryTugasWeb {

    private final Map<Integer, TugasWeb> data = new LinkedHashMap<>();
    private int urutan = 0;

    @Override
    public TugasWeb simpanBaru(TugasWeb tugas) {
        urutan++;
        TugasWeb tersimpan = tugas.denganId(urutan);
        data.put(urutan, tersimpan);
        return tersimpan;
    }

    @Override
    public Optional<TugasWeb> cari(int id) {
        return Optional.ofNullable(data.get(id));
    }

    @Override
    public List<TugasWeb> semua() {
        return new ArrayList<>(data.values());
    }

    @Override
    public Optional<TugasWeb> perbarui(TugasWeb tugas) {
        if (!data.containsKey(tugas.id())) {
            return Optional.empty();
        }
        data.put(tugas.id(), tugas);
        return Optional.of(tugas);
    }

    @Override
    public boolean hapus(int id) {
        return data.remove(id) != null;
    }
}

/**
 * Exception unchecked pembawa status HTTP. Ditangkap di satu titik pada batas
 * router, lalu diterjemahkan menjadi respons JSON berstatus sesuai. Peran ini
 * dipegang @ExceptionHandler pada aplikasi Spring Boot sungguhan.
 */
public class ApiException extends RuntimeException {

    private final int status;

    public ApiException(int status, String pesan) {
        super(pesan);
        this.status = status;
    }

    public int status() {
        return status;
    }
}

/**
 * Id tugas yang diminta tidak ada di penyimpanan.
 * Diterjemahkan router menjadi respons 404 Not Found.
 */
public class TugasTidakDitemukanException extends ApiException {

    public TugasTidakDitemukanException(int id) {
        super(404, "tugas dengan id " + id + " tidak ditemukan");
    }
}

/**
 * Operasi menabrak aturan bisnis yang bergantung pada kondisi terkini:
 * transisi status yang sudah lampau atau batas tugas aktif per pemilik.
 * Diterjemahkan router menjadi respons 409 Conflict.
 */
public class AturanBisnisException extends ApiException {

    public AturanBisnisException(String pesan) {
        super(409, pesan);
    }
}

import java.time.LocalDate;
import java.util.List;

/**
 * Lapisan layanan: pemilik aturan bisnis aplikasi web manajemen tugas.
 * Seluruh operasi lewat sini; lapisan web tidak pernah menyentuh repository
 * secara langsung, dan repository tidak pernah tahu bahwa HTTP ada.
 * Hari operasional disuntik lewat konstruktor agar aturan "tenggat lampau"
 * bisa diuji dengan tanggal beku, bukan LocalDate.now().
 */
public class LayananTugasWeb {

    /** Batas tugas berstatus TODO per pemilik: aturan bisnis lapisan layanan. */
    public static final int BATAS_TUGAS_AKTIF = 5;

    private final RepositoryTugasWeb repository;
    private final LocalDate hariIni;

    public LayananTugasWeb(RepositoryTugasWeb repository, LocalDate hariIni) {
        this.repository = repository;
        this.hariIni = hariIni;
    }

    /** Hari operasional aplikasi, disuntik lewat konstruktor. */
    public LocalDate hariIni() {
        return hariIni;
    }

    /**
     * Menyusun tugas baru: status selalu TODO (klien tidak boleh menetapkannya),
     * tenggat wajib belum lampau, dan pemilik belum menyentuh batas tugas aktif.
     * Validasi bentuk field menyusul di Bagian 2.
     */
    public TugasWeb buat(PermintaanTugas permintaan) {
        long aktif = repository.semua().stream()
                .filter(t -> t.pemilik().equals(permintaan.pemilik()))
                .filter(t -> t.status() == StatusTugasWeb.TODO)
                .count();
        if (aktif >= BATAS_TUGAS_AKTIF) {
            throw new AturanBisnisException("pemilik " + permintaan.pemilik()
                    + " sudah memiliki " + BATAS_TUGAS_AKTIF + " tugas TODO");
        }
        TugasWeb baru = new TugasWeb(0, permintaan.judul(), permintaan.pemilik(),
                StatusTugasWeb.TODO, LocalDate.parse(permintaan.tenggat()));
        return repository.simpanBaru(baru);
    }

    /** Seluruh tugas terurut id. */
    public List<TugasWeb> daftar() {
        return repository.semua();
    }

    /** Satu tugas berdasarkan id; 404 bila tidak ada. */
    public TugasWeb cari(int id) {
        return repository.cari(id)
                .orElseThrow(() -> new TugasTidakDitemukanException(id));
    }

    /**
     * Memperbarui judul, pemilik, dan tenggat; status dipertahankan apa adanya
     * karena transisi status hanya boleh lewat tandaiSelesai.
     */
    public TugasWeb ubah(int id, PermintaanTugas permintaan) {
        TugasWeb tugas = cari(id);
        TugasWeb baru = new TugasWeb(id, permintaan.judul(), permintaan.pemilik(),
                tugas.status(), LocalDate.parse(permintaan.tenggat()));
        return repository.perbarui(baru)
                .orElseThrow(() -> new TugasTidakDitemukanException(id));
    }

    /** Menandai tugas selesai; 409 bila tugas memang sudah SELESAI. */
    public TugasWeb tandaiSelesai(int id) {
        TugasWeb tugas = cari(id);
        if (tugas.status() == StatusTugasWeb.SELESAI) {
            throw new AturanBisnisException("tugas #" + id
                    + " sudah SELESAI, tidak bisa ditandai selesai ulang");
        }
        TugasWeb selesai = tugas.denganStatus(StatusTugasWeb.SELESAI);
        return repository.perbarui(selesai)
                .orElseThrow(() -> new TugasTidakDitemukanException(id));
    }

    /** Menghapus tugas; 404 bila id tidak ada. */
    public void hapus(int id) {
        cari(id);
        repository.hapus(id);
    }
}

import java.time.LocalDate;
import java.util.List;

/**
 * Titik masuk inti telanjang Bagian 1: perakit seluruh lapisan secara manual
 * lewat constructor injection, lalu menggiring beberapa operasi lewat layanan
 * untuk membuktikan bahwa lapisan tersambung dan penolakan aturan bisnis
 * tidak menghentikan program. Lapisan web (HTTP) menyusul di Bagian 2.
 */
public class AplikasiWeb {

    public static void main(String[] args) {
        System.out.println("=== AplikasiWeb: perakitan lapisan secara manual ===");
        RepositoryTugasWeb repository = new RepositoryTugasWebMemori();
        LayananTugasWeb layanan = new LayananTugasWeb(repository, LocalDate.of(2026, 1, 15));
        System.out.println("[Perakit] RepositoryTugasWebMemori dibuat");
        System.out.println("[Perakit] LayananTugasWeb dibuat; repository dan hari"
                + " operasional 2026-01-15 disuntik lewat konstruktor");

        System.out.println();
        System.out.println("=== Tiga tugas baru lewat layanan ===");
        layanan.buat(new PermintaanTugas("Belajar arsitektur berlapis", "Budi", "2026-02-01"));
        layanan.buat(new PermintaanTugas("Menulis dokumentasi API", "Siti", "2026-01-20"));
        layanan.buat(new PermintaanTugas("Riset keamanan aplikasi web", "Dewi", "2026-01-25"));
        for (TugasWeb tugas : layanan.daftar()) {
            System.out.println(tugas.formatRingkas());
        }

        System.out.println();
        System.out.println("=== Transisi status lewat layanan ===");
        TugasWeb selesai = layanan.tandaiSelesai(2);
        System.out.println(selesai.formatRingkas());

        System.out.println();
        System.out.println("=== Penolakan yang tetap sopan ===");
        try {
            layanan.tandaiSelesai(2);
        } catch (AturanBisnisException e) {
            System.out.println("Ditolak " + e.status() + ": " + e.getMessage());
        }
        try {
            layanan.cari(99);
        } catch (TugasTidakDitemukanException e) {
            System.out.println("Ditolak " + e.status() + ": " + e.getMessage());
        }

        System.out.println();
        System.out.println("=== Ubah dan hapus ===");
        TugasWeb revisi = layanan.ubah(1, new PermintaanTugas(
                "Belajar arsitektur berlapis (revisi)", "Budi", "2026-02-08"));
        System.out.println(revisi.formatRingkas());
        layanan.hapus(3);
        List<TugasWeb> sisa = layanan.daftar();
        System.out.println("Setelah hapus #3, tersisa " + sisa.size() + " tugas");
        for (TugasWeb tugas : sisa) {
            System.out.println(tugas.formatRingkas());
        }
    }
}

=== AplikasiWeb: perakitan lapisan secara manual ===
[Perakit] RepositoryTugasWebMemori dibuat
[Perakit] LayananTugasWeb dibuat; repository dan hari operasional 2026-01-15 disuntik lewat konstruktor

=== Tiga tugas baru lewat layanan ===
#1 [TODO] Belajar arsitektur berlapis (pemilik Budi, tenggat 2026-02-01)
#2 [TODO] Menulis dokumentasi API (pemilik Siti, tenggat 2026-01-20)
#3 [TODO] Riset keamanan aplikasi web (pemilik Dewi, tenggat 2026-01-25)

=== Transisi status lewat layanan ===
#2 [SELESAI] Menulis dokumentasi API (pemilik Siti, tenggat 2026-01-20)

=== Penolakan yang tetap sopan ===
Ditolak 409: tugas #2 sudah SELESAI, tidak bisa ditandai selesai ulang
Ditolak 404: tugas dengan id 99 tidak ditemukan

=== Ubah dan hapus ===
#1 [TODO] Belajar arsitektur berlapis (revisi) (pemilik Budi, tenggat 2026-02-08)
Setelah hapus #3, tersisa 2 tugas
#1 [TODO] Belajar arsitektur berlapis (revisi) (pemilik Budi, tenggat 2026-02-08)
#2 [SELESAI] Menulis dokumentasi API (pemilik Siti, tenggat 2026-01-20)

@SpringBootApplication
public class AplikasiTugasApplication {

    public static void main(String[] args) {
        SpringApplication.run(AplikasiTugasApplication.class, args);
    }
}

@Repository
public class RepositoryTugasMemori implements TugasRepository {

    private final Map<Integer, Tugas> data = new LinkedHashMap<>();

    public RepositoryTugasMemori() {
    }

    // ... operasi tambah/cari/simpan/hapus sama dengan versi telanjang
}

@Service
public class LayananTugas {

    private final TugasRepository repository;
    private final LocalDate hariIni;

    public LayananTugas(TugasRepository repository,
            @Value("${app.hari-operasional}") LocalDate hariIni) {
        this.repository = repository;
        this.hariIni = hariIni;
    }

    // ... aturan bisnis sama dengan versi telanjang
}