refactor(attendance): target lombok boilerplate

docs/tests/unit/lombok-attendance-boilerplate.md

@@ -0,0 +1,105 @@
+# Test Evidence: Attendance targeted Lombok boilerplate retrofit
+
+- **Test type:** Unit source-contract audit
+- **Requirement IDs:** `ATT-001`–`ATT-012`, `CAL-001`, `CAL-006`–`CAL-009`
+- **Scenario IDs:** `AC-ATT-001`–`AC-ATT-005`, `AC-CAL-003`, `AC-CAL-004`
+- **Test class/method:** `com.lab.labtimesheet.feature.attendance.AttendanceLombokBoilerplateTest`
+- **Implementation commit:** `pending`
+
+## Protected behavior
+
+Attendance uses the installed Lombok processor only for mechanical constructors while preserving package-level
+Spring injection access, protected JPA construction, immutable records, domain constructors and mutations, raw punch
+and attached-policy history rules, composite-key identity, and existing public API names.
+
+## Test method
+
+The source-contract test inspects only `feature.attendance` production Java. It enumerates the exact injection-only
+components and JPA/stateless no-argument constructors eligible for Lombok, rejects retained handwritten equivalents
+and blanket `@Data`, and asserts that records and business-significant methods remain explicit.
+
+## Hand-derived expected result
+
+Five injection-only components use package-scoped `@RequiredArgsConstructor`; six JPA/embeddable types use protected
+`@NoArgsConstructor`; the stateless domain service uses a package-scoped `@NoArgsConstructor`. No record is replaced,
+and no validated constructor, state mutation, identity method, or stable domain-style accessor is generated away.
+
+## RED
+
+**Command**
+
+```text
+export JAVA_HOME=/opt/homebrew/opt/openjdk@25
+export PATH="$JAVA_HOME/bin:$PATH"
+./mvnw -Dtest=AttendanceLombokBoilerplateTest test
+```
+
+**Observed result**
+
+```text
+Tests run: 3, Failures: 2, Errors: 0, Skipped: 0
+The injection-component assertion first failed on AttendanceController because the required package-scoped
+@RequiredArgsConstructor and Lombok imports were absent. The JPA/stateless assertion first failed on
+AttendancePolicyEntity because the protected @NoArgsConstructor and Lombok imports were absent. The record and
+business-method retention guard passed.
+BUILD FAILURE
+Process exited 1.
+```
+
+## GREEN
+
+**Command**
+
+```text
+export JAVA_HOME=/opt/homebrew/opt/openjdk@25
+export PATH="$JAVA_HOME/bin:$PATH"
+./mvnw -Dtest=AttendanceLombokBoilerplateTest test
+```
+
+**Observed result**
+
+```text
+Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
+BUILD SUCCESS
+Process exited 0.
+```
+
+## Affected suite
+
+**Command and result**
+
+```text
+export JAVA_HOME=/opt/homebrew/opt/openjdk@25
+export PATH="$JAVA_HOME/bin:$PATH"
+export DOCKER_HOST=unix:///Users/sechmachine/.orbstack/run/docker.sock
+./mvnw -Dtest='*Attendance*Test' test
+Tests run: 38, Failures: 0, Errors: 0, Skipped: 0
+PostgreSQL 18.4 started and Flyway applied V1 for the persistence and concurrency contexts.
+BUILD SUCCESS
+Process exited 0.
+```
+
+## External-test boundaries
+
+The source audit does not replace compilation, reflection/JPA bootstrapping, MVC property access, PostgreSQL
+persistence, or Javadoc/doclint. Those checks are required as affected verification after the source contract turns
+GREEN. No application behavior or public API is intentionally changed by this retrofit.
+
+Additional verification on the same source tree:
+
+```text
+./mvnw -DskipTests compile
+BUILD SUCCESS
+
+./mvnw -Dtest=AttendanceLombokBoilerplateTest,AttendanceLayerStructureTest,AttendancePolicyTest,AttendanceServiceTest,AttendanceApplicationServiceTest,AttendanceControllerTest test
+Tests run: 27, Failures: 0, Errors: 0, Skipped: 0
+BUILD SUCCESS
+
+./mvnw -Dtest=AttendancePersistenceIntegrationTest,AttendanceConcurrencyIntegrationTest test
+Tests run: 8, Failures: 0, Errors: 0, Skipped: 0
+PostgreSQL 18.4; BUILD SUCCESS
+
+javadoc -quiet -Xdoclint:all -d target/attendance-javadocs -classpath "target/classes:<Maven dependency classpath>" -sourcepath src/main/java -subpackages com.lab.labtimesheet.feature.attendance
+Process exited 0. The source frontend reported seven generated-constructor missing-comment warnings because it does not
+expand Lombok constructors; repository policy exempts generated trivial constructors from duplicate Javadoc.
+```