From ab5982e955e57e3f3687d0a03b154b55cb53d66e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 12:21:03 +0900 Subject: [PATCH] =?UTF-8?q?refactor(repo)!:=20=EC=83=98=ED=94=8C=20?= =?UTF-8?q?=EB=AA=A8=EB=93=88=EA=B3=BC=20=EA=B7=B8=20=EC=B0=B8=EC=A1=B0?= =?UTF-8?q?=EB=A5=BC=20=EC=A7=80=EC=9A=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: src/sample-portfolio(311파일)와 src/Dockerfile.sample이 빌드 8곳, registry, PR job, spotbugs 제외, 매뉴얼·leaf 문서 수십 곳에 얽혀 있다. 매뉴얼과 생성 명령이 예시를 맡게 된 뒤로 샘플은 유지 비용만 남았고, 문서 일부는 이미 없는 태스크(sampleOffTest)와 ArchUnit 규칙을 가리킨다. 고른 방법: 소유자 결정(2026-11-07)대로 샘플을 폴더째 지우고 역할은 옮기지 않는다. 샘플을 가리키던 것도 같은 변경에서 지운다. - 빌드: registry 행, 루트 build.gradle의 샘플 태스크·의존·단계 (sampleWebContractCheck, :sample-portfolio:*, strict lane 단계), app-bootstrap architectureTestRuntimeOnly, spotbugs 제외 3곳 - CI: ci-quality-gates.yml의 sample-portfolio job과 release-gate 칸 - 테스트: SampleRuntimeDefaultsContractTest, Dockerfile.sample 비교 테스트, ArchUnit 규칙의 죽은 sample 패키지 제외. build-logic 테스트와 application-core 테스트의 가짜 이름은 example-app으로 바꾼다 - 문서: 매뉴얼 예시를 실제 코드(durable operation, identifier, ErrorCodeRegistryMappingTest)로 바꾸고, 템플릿에 예가 없는 기법 (유일 제약 → 같은 409)은 규칙과 확인 방법만 적는다. 결정 색인의 샘플 전용 행은 "샘플과 함께 사라짐"으로 표시한다 버린 대안: 설계서 권장안(OpenAPI 스냅숏·웹 계약을 옮긴 뒤 삭제)은 소유자가 고르지 않았다. 위험·한계: - 샘플 안에만 있던 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC 전파, 요청당 SQL 수 단언)가 함께 사라진다. 소유자가 남기라 하면 총괄이 따로 맡긴다. - APP_CACHE_REDIS_ENABLED는 샘플이 읽지 않는 키라(설계서 가정과 다름) 지우지 않고 src/README.md 문장만 고쳤다. 제거 기한 2026-11-30은 그대로. - docs/capability-status.md 「제거된 코드」 표와 docs/work/evidence.md의 샘플 경로는 이력이라 두었다. 검증(desktop, 트리 0525e14e, ~/t1-layout-logs/): - ./gradlew :ci --warning-mode=fail rc=0 (502 executed, 83 from cache) - :verifyStrictLaneStages --dry-run rc=0 - :app-bootstrap:documentContractTest rc=0 - -p build-logic check rc=0 - :verifyDependencyLocks rc=0 - python3 scripts/check-work-docs.py, 상대 링크 검사 rc=0 Refs: design-docs repo-structure/README.md 3.1, repo-structure/01-backend-layout.md 6.2 BREAKING CHANGE: src/sample-portfolio, src/Dockerfile.sample, 샘플 태스크와 job이 없어진다. 샘플을 고쳐 쓰던 파생 서비스는 병합 때 수정 대 삭제 충돌이 난다. docs/upgrade/2026-11-maturity-review.md B-49. --- .github/workflows/ci-quality-gates.yml | 17 - .github/workflows/integration-main.yml | 2 +- AGENTS.md | 13 +- CLAUDE.md | 2 +- README.md | 19 +- docs/capability-status.md | 4 +- docs/ci-cd/template-vs-consumer.md | 7 +- docs/fileserver/design-deviations.md | 5 +- docs/jpa/entity-mapping-guide.md | 4 +- docs/jpa/migration-guide.md | 7 +- docs/jpa/support-matrix.md | 4 +- docs/manual/02-new-feature.md | 2 +- docs/manual/03-placement.md | 35 +- docs/manual/04-persistence.md | 31 +- docs/manual/05-idempotency.md | 5 +- docs/manual/06-errors.md | 8 +- docs/manual/07-authorization.md | 4 +- docs/manual/08-testing.md | 2 +- docs/manual/09-outbox-events.md | 12 +- docs/manual/README.md | 10 +- docs/registries/env-keys.yaml | 4 +- docs/runbooks/outbox-dead-letter.md | 4 +- docs/upgrade/2026-11-maturity-review.md | 25 +- docs/web/advanced-capabilities.md | 2 +- docs/web/repository-adaptation.md | 5 +- docs/work/delegate.md | 2 +- docs/work/new-feature.md | 6 +- docs/work/reference/decisions.md | 11 +- docs/work/reference/defect-patterns.md | 10 +- docs/work/reference/gates.md | 5 +- docs/work/reference/review-criteria.md | 10 +- .../Uuid__Feature__IdFactory.java.tmpl | 2 +- src/Dockerfile.sample | 159 ---- src/README.md | 13 +- src/adapter/inbound/graphql/CLAUDE.md | 4 +- src/adapter/inbound/graphql/README.md | 8 +- src/adapter/inbound/grpc/CLAUDE.md | 2 +- .../inbound/grpc/ApiErrorException.java | 2 +- src/adapter/inbound/web-advanced/CLAUDE.md | 4 +- src/adapter/inbound/web-advanced/README.md | 2 +- src/adapter/inbound/web/CLAUDE.md | 12 +- src/adapter/inbound/web/README.md | 23 +- .../WebSecurityAutoConfiguration.java | 14 +- src/adapter/inbound/websocket/CLAUDE.md | 2 +- src/adapter/outbound/fileserver/CLAUDE.md | 2 +- src/adapter/outbound/identifier/CLAUDE.md | 5 +- src/adapter/outbound/identifier/README.md | 4 +- src/adapter/outbound/identifier/build.gradle | 2 +- .../UuidV7DurableOperationIdFactory.java | 6 +- src/adapter/outbound/messaging/README.md | 2 +- .../outbound/notification/build.gradle | 2 +- .../platform/dispatch/UuidV7Generator.java | 4 +- src/adapter/outbound/objectstorage/CLAUDE.md | 3 +- .../outbound/persistence-jpa/CLAUDE.md | 6 +- .../outbound/persistence-jpa/README.md | 11 +- .../config/PersistenceJpaConfig.java | 2 +- .../outbox/jpa/JpaOutboxStore.java | 2 +- .../startup/JpaStartupAutoConfiguration.java | 2 +- .../CandidateAdapterCompositionTest.java | 11 +- .../outbound/persistence-mongo/CLAUDE.md | 5 +- src/app-bootstrap/CLAUDE.md | 8 +- src/app-bootstrap/README.md | 6 +- src/app-bootstrap/build.gradle | 12 +- .../RuntimeProfileAccessArchitectureTest.java | 2 +- .../src/main/resources/config/security.yml | 3 +- .../DeveloperExperienceContractTest.java | 24 - .../SampleRuntimeDefaultsContractTest.java | 214 ----- src/application-core/CLAUDE.md | 9 +- src/application-core/README.md | 7 +- ...egrationEventContractContributionTest.java | 6 +- .../buildlogic/ModuleRegistryTest.java | 14 +- ...ectureResolvedClasspathFunctionalTest.java | 16 +- ...NoIgnoredSourcePackagesFunctionalTest.java | 8 +- .../WorkflowGradleInvocationsTest.java | 4 +- src/build.gradle | 41 +- src/composition/idempotency/README.md | 4 +- src/composition/idempotency/build.gradle | 2 +- src/composition/service-runtime/README.md | 11 +- src/composition/service-runtime/build.gradle | 4 - src/config/architecture/modules.json | 18 - src/config/spotbugs/exclude-test.xml | 9 - src/config/spotbugs/exclude.xml | 25 +- src/domain-core/README.md | 13 +- src/gradle/libs.versions.toml | 4 +- src/sample-portfolio/.jqwik-database | Bin 4 -> 0 bytes src/sample-portfolio/CLAUDE.md | 72 -- src/sample-portfolio/README.md | 571 ------------- src/sample-portfolio/build.gradle | 255 ------ src/sample-portfolio/gradle.lockfile | 351 -------- ...UploadIntentRepositoryIntegrationTest.java | 150 ---- .../PosterRepositoryAdapterContractTest.java | 71 -- ...osterRepositoryAdapterIntegrationTest.java | 309 -------- .../WorkLogRepositoryAdapterContractTest.java | 78 -- ...rkLogRepositoryAdapterIntegrationTest.java | 122 --- ...reatePosterConcurrencyIntegrationTest.java | 187 ----- ...ampleIdempotencyReplayIntegrationTest.java | 122 --- .../SampleMigrationStreamIsolationTest.java | 89 --- ...eIdempotencyRotationQualificationTest.java | 55 -- ...osterImageRetirementQualificationTest.java | 134 ---- ...sterImageV8MigrationQualificationTest.java | 236 ------ ...TitleUniqueMigrationQualificationTest.java | 113 --- .../portfolio/SamplePortfolioApplication.java | 40 - .../web/controller/OperationsController.java | 44 -- .../web/controller/PosterController.java | 151 ---- .../PosterImagePublicationController.java | 109 --- .../web/controller/WebRequestParams.java | 91 --- .../web/controller/WorkLogController.java | 243 ------ .../web/dto/request/CreatePosterRequest.java | 11 - .../web/dto/request/CreateWorkLogRequest.java | 32 - .../dto/request/SamplePolymorphicRequest.java | 23 - .../web/dto/request/UpdatePosterRequest.java | 27 - .../web/dto/request/UpdateWorkLogRequest.java | 40 - .../dto/request/WorkLogValidationGroups.java | 10 - .../PosterImagePublicationResponse.java | 4 - .../PosterImagePublicationStatusResponse.java | 10 - .../web/dto/response/PosterResponse.java | 11 - .../web/dto/response/RepoStatsResponse.java | 3 - .../web/dto/response/WorkLogResponse.java | 19 - .../dto/response/WorkLogSummaryResponse.java | 14 - .../web/error/DomainExceptionHandler.java | 91 --- .../inbound/web/error/PortfolioErrorCode.java | 51 -- .../inbound/web/json/PosterIdSerializer.java | 23 - .../inbound/web/json/WorkLogIdSerializer.java | 23 - .../PosterImagePublicationWebMapper.java | 33 - .../inbound/web/mapper/PosterWebMapper.java | 35 - .../inbound/web/mapper/WorkLogWebMapper.java | 91 --- .../MultipartObjectContentProducer.java | 63 -- .../inbound/web/operation/Operation.java | 40 - .../web/operation/OperationStatus.java | 16 - .../SampleOperationNotFoundException.java | 23 - .../web/operation/SampleOperationStore.java | 35 - .../web/operation/WorkLogExportResult.java | 7 - ...acPosterImageIdempotencyScopeDigester.java | 120 --- .../identifier/UuidOutboxEventIdFactory.java | 19 - .../identifier/UuidPosterIdFactory.java | 21 - .../UuidPosterImageOperationIdFactory.java | 18 - .../identifier/UuidWorkLogIdFactory.java | 21 - .../persistence/config/JpaConfig.java | 17 - .../persistence/entity/PosterEntity.java | 86 -- .../PosterImageIdempotencyKeyEpochEntity.java | 58 -- .../PosterImageRetirementIntentEntity.java | 198 ----- .../entity/PosterImageUploadIntentEntity.java | 311 -------- .../persistence/entity/WorkLogEntity.java | 208 ----- ...mageRetirementIntentPersistenceMapper.java | 54 -- ...terImageUploadIntentPersistenceMapper.java | 110 --- .../mapper/PosterPersistenceMapper.java | 44 -- .../mapper/WorkLogPersistenceMapper.java | 77 -- .../PosterImageAttachmentCasRepository.java | 76 -- ...ImageIdempotencyKeyEpochJpaRepository.java | 20 - ...eIdempotencyKeyEpochRepositoryAdapter.java | 48 -- ...terImageRetirementIntentJpaRepository.java | 40 - ...mageRetirementIntentRepositoryAdapter.java | 95 --- .../PosterImageUploadIntentJpaRepository.java | 41 - ...terImageUploadIntentRepositoryAdapter.java | 119 --- .../repository/PosterJpaRepository.java | 16 - .../repository/PosterRepositoryAdapter.java | 130 --- .../repository/WorkLogJpaRepository.java | 37 - .../repository/WorkLogRepositoryAdapter.java | 88 --- .../WorkLogSummaryQueryAdapter.java | 72 -- .../repository/WorkLogSummaryRow.java | 20 - .../repostats/RawRepoStatsResponse.java | 4 - .../repostats/RepoStatsAclMapper.java | 21 - .../repostats/RepoStatsPortClient.java | 33 - .../event/OutboxEventIdFactory.java | 17 - .../event/PortfolioEventContract.java | 80 -- .../event/PortfolioEventOutbox.java | 90 --- .../poster/ArchivePosterCommand.java | 12 - .../poster/ArchivePosterUseCase.java | 49 -- .../poster/CreatePosterCommand.java | 15 - .../poster/CreatePosterUseCase.java | 63 -- .../poster/DeletePosterCommand.java | 12 - .../poster/DeletePosterUseCase.java | 83 -- .../application/poster/GetPosterQuery.java | 12 - .../application/poster/GetPosterUseCase.java | 31 - .../application/poster/ListPostersQuery.java | 14 - .../poster/ListPostersUseCase.java | 31 - .../poster/PosterCreatedPayload.java | 11 - .../poster/PosterEventContracts.java | 45 -- .../poster/PosterEventPublisher.java | 51 -- .../application/poster/PosterIdPayload.java | 12 - .../poster/PosterNotFoundException.java | 13 - .../poster/PublishPosterCommand.java | 12 - .../poster/PublishPosterUseCase.java | 50 -- .../poster/UpdatePosterCommand.java | 21 - .../poster/UpdatePosterUseCase.java | 58 -- .../AbortPosterImageUploadCommand.java | 21 - .../AbortPosterImageUploadUseCase.java | 119 --- .../GetPosterImagePublicationStatusQuery.java | 15 - ...etPosterImagePublicationStatusUseCase.java | 53 -- .../PosterImageAlreadyPublishedException.java | 14 - ...osterImageAttachmentCompareAndSetPort.java | 21 - .../PosterImageAttachmentPrepared.java | 13 - .../PosterImageAttachmentPreparedPayload.java | 16 - .../PosterImageAttachmentReadyPayload.java | 18 - .../PosterImageAttachmentReadyV2.java | 15 - .../PosterImageEventContracts.java | 31 - .../PosterImageIdempotencyKeyEpochPort.java | 9 - .../PosterImageIdempotencyScopeDigest.java | 28 - ...sterImageIdempotencyScopeDigesterPort.java | 16 - .../PosterImageOperationIdFactory.java | 19 - .../PosterImagePublicationEventPublisher.java | 51 -- .../PosterImagePublicationFingerprint.java | 44 -- .../PosterImagePublicationParameters.java | 36 - .../PosterImagePublicationPolicy.java | 34 - .../PosterImagePublicationReservation.java | 14 - ...osterImagePublicationReservationCodec.java | 28 - .../PosterImagePublicationStatus.java | 38 - .../PosterImageRetirementIntent.java | 213 ----- .../PosterImageRetirementIntentState.java | 14 - .../PosterImageRetirementIntentStorePort.java | 20 - .../PosterImageRetirementResult.java | 25 - ...ageSanitizedIdempotencyContextFactory.java | 58 -- .../posterimage/PosterImageUploadIntent.java | 348 -------- .../PosterImageUploadIntentClaim.java | 14 - ...terImageUploadIntentConflictException.java | 11 - .../PosterImageUploadIntentState.java | 16 - .../PosterImageUploadIntentStorePort.java | 31 - .../PublishPosterImageCommand.java | 39 - .../PublishPosterImageUseCase.java | 254 ------ ...ReconcilePosterImageRetirementCommand.java | 31 - ...ReconcilePosterImageRetirementUseCase.java | 112 --- .../ReconcilePosterImageUploadCommand.java | 21 - .../ReconcilePosterImageUploadUseCase.java | 227 ------ .../posterimage/RetirePosterImageCommand.java | 24 - .../posterimage/RetirePosterImageUseCase.java | 84 -- .../worklog/BatchCreateWorkLogsCommand.java | 15 - .../worklog/BatchCreateWorkLogsUseCase.java | 64 -- .../worklog/CreateWorkLogCommand.java | 31 - .../worklog/CreateWorkLogUseCase.java | 85 -- .../worklog/DeleteWorkLogCommand.java | 13 - .../worklog/DeleteWorkLogUseCase.java | 40 - .../worklog/GetRepoStatsQuery.java | 12 - .../worklog/GetRepoStatsUseCase.java | 27 - .../application/worklog/GetWorkLogQuery.java | 13 - .../worklog/GetWorkLogUseCase.java | 31 - .../ListRecentWorkLogSummariesQuery.java | 11 - .../ListRecentWorkLogSummariesUseCase.java | 36 - .../worklog/ListWorkLogsQuery.java | 13 - .../worklog/ListWorkLogsUseCase.java | 33 - .../application/worklog/RepoStatsPort.java | 8 - .../worklog/UpdateWorkLogCommand.java | 42 - .../worklog/UpdateWorkLogUseCase.java | 90 --- .../worklog/WorkLogNotFoundException.java | 12 - .../worklog/WorkLogNotOwnedException.java | 17 - .../WorkLogReservedContractContribution.java | 69 -- .../worklog/WorkLogReservedPayload.java | 20 - .../application/worklog/WorkLogSummary.java | 20 - .../worklog/WorkLogSummaryPage.java | 14 - .../worklog/WorkLogSummaryQueryPort.java | 29 - .../WorkLogVersionMismatchException.java | 13 - .../SampleApplicationUseCaseConfig.java | 213 ----- .../SampleManagementSecurityConfig.java | 39 - .../objectstorage/PosterImageApiConfig.java | 9 - .../objectstorage/PosterImageApiSettings.java | 17 - .../PosterImageIdempotencyConfig.java | 110 --- ...PosterImageIdempotencyKeyRingSettings.java | 20 - .../PosterImageObjectStorageConfig.java | 158 ---- .../PosterImagePublicationSettings.java | 36 - .../PosterImageRetirementConfig.java | 23 - .../PosterImageRetirementJob.java | 42 - .../PosterImageRetirementSettings.java | 49 -- .../SamplePostgreSqlPersistenceConfig.java | 53 -- .../runtime/SampleSchedulingConfig.java | 24 - .../security/SampleDemoAccounts.java | 53 -- .../SampleDemoAccountsProductionGuard.java | 72 -- .../security/SampleDemoSecurityConfig.java | 95 --- .../portfolio/domain/poster/Poster.java | 155 ---- .../domain/poster/PosterArchived.java | 13 - .../domain/poster/PosterCreated.java | 18 - .../domain/poster/PosterDeleted.java | 13 - .../portfolio/domain/poster/PosterId.java | 29 - .../domain/poster/PosterIdFactory.java | 9 - .../domain/poster/PosterImageAttachment.java | 7 - .../domain/poster/PosterImageReference.java | 37 - .../poster/PosterInvariantException.java | 29 - .../portfolio/domain/poster/PosterPage.java | 15 - .../domain/poster/PosterPublished.java | 13 - .../domain/poster/PosterRepository.java | 41 - .../domain/poster/PosterSortField.java | 10 - .../portfolio/domain/poster/PosterStatus.java | 24 - .../PosterTitleAlreadyExistsException.java | 20 - .../PublishedPosterImageAttachment.java | 17 - .../portfolio/domain/worklog/Period.java | 21 - .../portfolio/domain/worklog/RepoStats.java | 4 - .../domain/worklog/WorkCategory.java | 9 - .../portfolio/domain/worklog/WorkLog.java | 248 ------ .../portfolio/domain/worklog/WorkLogId.java | 29 - .../domain/worklog/WorkLogIdFactory.java | 9 - .../worklog/WorkLogInvariantException.java | 29 - .../domain/worklog/WorkLogOwner.java | 16 - .../domain/worklog/WorkLogRepository.java | 25 - .../domain/worklog/WorkLogReserved.java | 20 - .../domain/worklog/WorkLogSortField.java | 12 - .../domain/worklog/WorkLogStatus.java | 7 - .../sample/portfolio/package-info.java | 2 - .../src/main/resources/application.yml | 234 ------ .../portfolio.worklog.reserved/v1.schema.json | 18 - .../v1.schema.sha256 | 1 - .../messaging/poster.archived/v1.schema.json | 18 - .../messaging/poster.created/v1.schema.json | 23 - .../messaging/poster.deleted/v1.schema.json | 18 - .../v1.schema.json | 33 - .../v2.schema.json | 38 - .../messaging/poster.published/v1.schema.json | 18 - .../db/sample-migration/V2__work_log.sql | 65 -- .../db/sample-migration/V7__poster.sql | 31 - .../V8_1__poster_title_unique.sql | 43 - .../V8__poster_image_publication.sql | 128 --- .../SampleApplicationContextTest.java | 96 --- .../inbound/web/SampleApiDocsSystemTest.java | 57 -- .../persistence/InsertRoundTripCounter.java | 119 --- .../RecordingStatementInspector.java | 36 - .../WorkLogStatementCostSystemTest.java | 200 ----- .../SampleDemoProfilesStartupSystemTest.java | 65 -- .../SampleWorkLogAuthorizationSystemTest.java | 247 ------ .../systemTest/resources/application-test.yml | 189 ----- .../OperationsControllerWireTest.java | 98 --- .../controller/PosterControllerWireTest.java | 344 -------- ...terImagePublicationControllerWireTest.java | 163 ---- .../web/controller/WebRequestParamsTest.java | 51 -- .../controller/WorkLogControllerWireTest.java | 747 ------------------ ...PolymorphicTypeValidatorAllowlistTest.java | 149 ---- .../request/SamplePolymorphicRequestTest.java | 93 --- .../web/dto/response/BulkEnvelopeTest.java | 86 -- .../web/error/DomainExceptionHandlerTest.java | 158 ---- ...PortfolioErrorCodeRegistryMappingTest.java | 103 --- .../web/error/PortfolioErrorCodeTest.java | 19 - .../VirtualThreadMdcPropagationTest.java | 92 --- .../web/json/WorkLogIdSerializerTest.java | 23 - .../MultipartObjectContentProducerTest.java | 109 --- .../inbound/web/operation/OperationTest.java | 47 -- .../web/versioning/VersioningPrefixTest.java | 66 -- ...sterImageIdempotencyScopeDigesterTest.java | 91 --- .../identifier/UuidWorkLogIdFactoryTest.java | 48 -- .../persistence/entity/WorkLogEntityTest.java | 47 -- .../mapper/WorkLogPersistenceMapperTest.java | 66 -- .../WorkLogRepositoryAdapterTest.java | 197 ----- .../WorkLogSummaryQueryAdapterTest.java | 133 ---- .../repostats/RepoStatsAclMapperTest.java | 64 -- .../CommandSelfValidationTest.java | 95 --- .../event/PortfolioEventContractsTest.java | 58 -- .../event/PortfolioEventOutboxTest.java | 129 --- .../event/SamplePayloadSchemaReleaseTest.java | 18 - .../DeletePosterImageRetirementTest.java | 108 --- .../poster/PosterEventPublisherTest.java | 83 -- .../PosterImageAbortReconcileRaceTest.java | 315 -------- ...terImagePublicationEventPublisherTest.java | 16 - .../PosterImagePublicationWorkflowTest.java | 307 ------- .../PosterImageRetirementCrashMatrixTest.java | 188 ----- ...anitizedIdempotencyContextFactoryTest.java | 38 - .../worklog/CreateWorkLogOutboxTest.java | 121 --- .../worklog/GetRepoStatsUseCaseTest.java | 37 - ...ListRecentWorkLogSummariesUseCaseTest.java | 85 -- ...LogReservedConsumerDedupeContractTest.java | 107 --- ...rkLogReservedContractContributionTest.java | 309 -------- .../worklog/WorkLogUseCasesTest.java | 391 --------- .../architecture/SampleArchitectureTest.java | 98 --- .../WorkLogAuthorizationContractTest.java | 267 ------- .../authz/WorkLogAuthorizationE2ETest.java | 196 ----- .../SampleActuatorLoggersAccessTest.java | 31 - .../PosterImageIdempotencyConfigTest.java | 84 -- .../PosterImageRetirementConfigTest.java | 64 -- .../SampleMigrationLockWaitTest.java | 51 -- ...SamplePostgreSqlPersistenceConfigTest.java | 35 - .../SampleSchemaOwnershipDefaultsTest.java | 36 - ...SampleDemoAccountsProductionGuardTest.java | 95 --- .../SampleDemoSecurityConfigTest.java | 201 ----- .../portfolio/domain/poster/PosterIdTest.java | 31 - .../poster/PosterImageReferenceTest.java | 25 - .../portfolio/domain/poster/PosterTest.java | 142 ---- .../InMemoryPosterRepositoryContractTest.java | 19 - .../portfolio/domain/worklog/PeriodTest.java | 47 -- .../domain/worklog/WorkLogIdPropertyTest.java | 79 -- .../domain/worklog/WorkLogIdTest.java | 40 - .../domain/worklog/WorkLogInvariantTest.java | 77 -- .../portfolio/domain/worklog/WorkLogTest.java | 153 ---- ...InMemoryWorkLogRepositoryContractTest.java | 27 - .../fixtures/SamplePortfolioFixture.java | 18 - .../v1.invalid-unknown-field.json | 1 - .../portfolio.worklog.reserved/v1.valid.json | 1 - .../contracts/released-payload-schemas.sha256 | 10 - .../SamplePortfolioTestApplication.java | 18 - ...emoryPosterImageRetirementIntentStore.java | 98 --- .../InMemoryPosterImageUploadIntentStore.java | 77 -- .../testkit/InMemoryWorkLogSummaryQuery.java | 72 -- .../testkit/InMemoryPosterRepository.java | 114 --- .../testkit/PosterRepositoryContract.java | 119 --- .../testkit/InMemoryWorkLogRepository.java | 75 -- .../testkit/WorkLogRepositoryContract.java | 333 -------- .../testinfra/PostgreSqlTestContainer.java | 18 - .../contract/OpenApiDriftContractTest.java | 185 ----- .../web/date/DateHeaderContractTest.java | 90 --- .../web/filter/VirtualThreadMdcE2ETest.java | 197 ----- .../web/openapi/OpenApiSnapshotTest.java | 116 --- .../openapi/worklogs-openapi-snapshot.json | 507 ------------ src/shared-contract/README.md | 4 +- 396 files changed, 262 insertions(+), 23901 deletions(-) delete mode 100644 src/Dockerfile.sample delete mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java delete mode 100644 src/sample-portfolio/.jqwik-database delete mode 100644 src/sample-portfolio/CLAUDE.md delete mode 100644 src/sample-portfolio/README.md delete mode 100644 src/sample-portfolio/build.gradle delete mode 100644 src/sample-portfolio/gradle.lockfile delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterContractTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterContractTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterConcurrencyIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/idempotency/SampleIdempotencyReplayIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationStreamIsolationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterTitleUniqueMigrationQualificationTest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/OperationsController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterImagePublicationController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WebRequestParams.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/CreatePosterRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/CreateWorkLogRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/SamplePolymorphicRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/UpdatePosterRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/UpdateWorkLogRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/WorkLogValidationGroups.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/PosterImagePublicationResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/PosterImagePublicationStatusResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/PosterResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/RepoStatsResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/WorkLogResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/WorkLogSummaryResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/DomainExceptionHandler.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCode.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/json/PosterIdSerializer.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/json/WorkLogIdSerializer.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/PosterImagePublicationWebMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/PosterWebMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/WorkLogWebMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/objectstorage/MultipartObjectContentProducer.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/Operation.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/OperationStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/SampleOperationNotFoundException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/SampleOperationStore.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/WorkLogExportResult.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/HmacPosterImageIdempotencyScopeDigester.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidOutboxEventIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidPosterIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidPosterImageOperationIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidWorkLogIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/config/JpaConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterImageIdempotencyKeyEpochEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterImageRetirementIntentEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterImageUploadIntentEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/WorkLogEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/PosterImageRetirementIntentPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/PosterImageUploadIntentPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/PosterPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/WorkLogPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageAttachmentCasRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageIdempotencyKeyEpochJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageIdempotencyKeyEpochRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageRetirementIntentJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageRetirementIntentRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogSummaryQueryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogSummaryRow.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RawRepoStatsResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RepoStatsAclMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RepoStatsPortClient.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/OutboxEventIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventContract.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventOutbox.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/GetPosterQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/GetPosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ListPostersQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ListPostersUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterCreatedPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterEventContracts.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterEventPublisher.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterIdPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterNotFoundException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PublishPosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PublishPosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/UpdatePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/UpdatePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/AbortPosterImageUploadCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/AbortPosterImageUploadUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/GetPosterImagePublicationStatusQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/GetPosterImagePublicationStatusUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAlreadyPublishedException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentCompareAndSetPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentPrepared.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentPreparedPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentReadyPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentReadyV2.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageEventContracts.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageIdempotencyKeyEpochPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageIdempotencyScopeDigest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageIdempotencyScopeDigesterPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageOperationIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationEventPublisher.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationFingerprint.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationParameters.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationPolicy.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationReservation.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationReservationCodec.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementIntent.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementIntentState.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementIntentStorePort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementResult.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageSanitizedIdempotencyContextFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntent.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentClaim.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentConflictException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentState.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentStorePort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PublishPosterImageCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PublishPosterImageUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageRetirementCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageRetirementUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageUploadCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageUploadUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/RetirePosterImageCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/RetirePosterImageUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/BatchCreateWorkLogsCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/BatchCreateWorkLogsUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/CreateWorkLogCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/CreateWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/DeleteWorkLogCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/DeleteWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetRepoStatsQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetRepoStatsUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetWorkLogQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListRecentWorkLogSummariesQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListRecentWorkLogSummariesUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListWorkLogsQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListWorkLogsUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/RepoStatsPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/UpdateWorkLogCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/UpdateWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogNotFoundException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogNotOwnedException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedContractContribution.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogSummary.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogSummaryPage.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogSummaryQueryPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogVersionMismatchException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/application/SampleApplicationUseCaseConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/management/SampleManagementSecurityConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageApiConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageApiSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageIdempotencyConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageIdempotencyKeyRingSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageObjectStorageConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImagePublicationSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementJob.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/runtime/SampleSchedulingConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoAccounts.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoAccountsProductionGuard.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoSecurityConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/Poster.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterArchived.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterCreated.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterDeleted.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterId.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterImageAttachment.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterImageReference.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterInvariantException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterPage.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterPublished.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterSortField.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterTitleAlreadyExistsException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PublishedPosterImageAttachment.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/Period.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/RepoStats.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkCategory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLog.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogId.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogInvariantException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogOwner.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogReserved.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogSortField.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/package-info.java delete mode 100644 src/sample-portfolio/src/main/resources/application.yml delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/portfolio.worklog.reserved/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/portfolio.worklog.reserved/v1.schema.sha256 delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.archived/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.created/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.deleted/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.image-attachment-prepared/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.image-attachment-ready/v2.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.published/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V2__work_log.sql delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V7__poster.sql delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V8_1__poster_title_unique.sql delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V8__poster_image_publication.sql delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/SampleApiDocsSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/InsertRoundTripCounter.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/RecordingStatementInspector.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/WorkLogStatementCostSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoProfilesStartupSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleWorkLogAuthorizationSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/resources/application-test.yml delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/OperationsControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterImagePublicationControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WebRequestParamsTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/BasicPolymorphicTypeValidatorAllowlistTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/SamplePolymorphicRequestTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/BulkEnvelopeTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/DomainExceptionHandlerTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCodeRegistryMappingTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCodeTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcPropagationTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/json/WorkLogIdSerializerTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/objectstorage/MultipartObjectContentProducerTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/OperationTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/versioning/VersioningPrefixTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/HmacPosterImageIdempotencyScopeDigesterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidWorkLogIdFactoryTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/WorkLogEntityTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/WorkLogPersistenceMapperTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogSummaryQueryAdapterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RepoStatsAclMapperTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/CommandSelfValidationTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventContractsTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventOutboxTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/event/SamplePayloadSchemaReleaseTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterImageRetirementTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/poster/PosterEventPublisherTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAbortReconcileRaceTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationEventPublisherTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationWorkflowTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementCrashMatrixTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageSanitizedIdempotencyContextFactoryTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/CreateWorkLogOutboxTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/GetRepoStatsUseCaseTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/ListRecentWorkLogSummariesUseCaseTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedConsumerDedupeContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedContractContributionTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogUseCasesTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/authz/WorkLogAuthorizationContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/authz/WorkLogAuthorizationE2ETest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/management/SampleActuatorLoggersAccessTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageIdempotencyConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationLockWaitTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleSchemaOwnershipDefaultsTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoAccountsProductionGuardTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoSecurityConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/PosterIdTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/PosterImageReferenceTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/PosterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/testkit/InMemoryPosterRepositoryContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/PeriodTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogIdPropertyTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogIdTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogInvariantTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/InMemoryWorkLogRepositoryContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/fixtures/SamplePortfolioFixture.java delete mode 100644 src/sample-portfolio/src/test/resources/contracts/messaging/portfolio.worklog.reserved/v1.invalid-unknown-field.json delete mode 100644 src/sample-portfolio/src/test/resources/contracts/messaging/portfolio.worklog.reserved/v1.valid.json delete mode 100644 src/sample-portfolio/src/test/resources/contracts/released-payload-schemas.sha256 delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/application/posterimage/testkit/InMemoryPosterImageRetirementIntentStore.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/application/posterimage/testkit/InMemoryPosterImageUploadIntentStore.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/application/worklog/testkit/InMemoryWorkLogSummaryQuery.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/poster/testkit/InMemoryPosterRepository.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/poster/testkit/PosterRepositoryContract.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/InMemoryWorkLogRepository.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/WorkLogRepositoryContract.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/resources/openapi/worklogs-openapi-snapshot.json diff --git a/.github/workflows/ci-quality-gates.yml b/.github/workflows/ci-quality-gates.yml index 83986f9e..78568530 100644 --- a/.github/workflows/ci-quality-gates.yml +++ b/.github/workflows/ci-quality-gates.yml @@ -58,20 +58,6 @@ jobs: - name: Verify Compose profile contracts render exactly as declared run: bash scripts/verify-compose-profile-contracts.sh - sample-portfolio: - # The sample is excluded from production architecture/runtime membership policy, but it is still - # the reference implementation adopters copy. Compile/test/OpenAPI drift must therefore block PRs. - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 - - uses: ./.github/actions/setup-gradle-java - # `qualityCheck` too: the root one covers the production leaves only, so the sample — the code - # adopters copy first — was analysed by no stage, and its SpotBugs exclusions matched nothing - # (review 2026-11-03 RR-06-05). - - name: Verify the standalone sample application - working-directory: src - run: ./gradlew :sample-portfolio:check :sample-portfolio:qualityCheck --stacktrace - optional-platforms: runs-on: ubuntu-latest steps: @@ -123,7 +109,6 @@ jobs: release-gate: needs: - quality-gates - - sample-portfolio - optional-platforms - grpc-proto-buf if: always() @@ -134,14 +119,12 @@ jobs: - name: Require every current blocking job to succeed env: QUALITY_RESULT: ${{ needs.quality-gates.result }} - SAMPLE_RESULT: ${{ needs.sample-portfolio.result }} OPTIONAL_PLATFORMS_RESULT: ${{ needs.optional-platforms.result }} GRPC_PROTO_BUF_RESULT: ${{ needs.grpc-proto-buf.result }} run: | set -euo pipefail for result in \ "${QUALITY_RESULT}" \ - "${SAMPLE_RESULT}" \ "${OPTIONAL_PLATFORMS_RESULT}" \ "${GRPC_PROTO_BUF_RESULT}"; do if [[ "${result}" != "success" ]]; then diff --git a/.github/workflows/integration-main.yml b/.github/workflows/integration-main.yml index 2fdf8b10..8c86e828 100644 --- a/.github/workflows/integration-main.yml +++ b/.github/workflows/integration-main.yml @@ -60,7 +60,7 @@ concurrency: jobs: # The main-branch stage of the Gradle gates (`:mainCheck`): the environment contract, full-boot - # qualification, the sample web contract, the public-path baseline, the conditional transport + # qualification, the public-path baseline, the conditional transport # lanes, the messaging contract lanes and each leaf's document-contract lanes. API surfaces are # in the pull-request `check` (owner decision 20). The rest left the pull-request gate (review # 2026-09-24 BUILD, item 12); none of them is deleted. diff --git a/AGENTS.md b/AGENTS.md index 26d2371b..064de985 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ 이 저장소는 단순한 예제 블로그 애플리케이션이 아니라, Java 21 + 버전 카탈로그에 고정된 Spring Boot 4.x + Gradle 멀티모듈 기반의 Clean Architecture 템플릿이다. -기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 엔지니어링 작업 기록 게시판)에 격리한다. 새 프로젝트를 시작할 때는 도메인 이름, 패키지, 엔티티, 유스케이스를 교체할 수 있지만, 모듈 경계와 의존성 방향은 유지해야 한다. +기본 패키지는 `dev.caskeleton`이다. 업무 기능의 예시는 `scripts/new-feature.sh`의 출력과 `docs/manual/`이다. 새 프로젝트를 시작할 때는 도메인 이름, 패키지, 엔티티, 유스케이스를 교체할 수 있지만, 모듈 경계와 의존성 방향은 유지해야 한다. ## Prime Directive @@ -85,7 +85,7 @@ root `CLAUDE.md`는 작업을 시작할 때 읽는 지도이고, 이 목록을 - `src/build.gradle`: 루트 라이프사이클(`ci`, `mainCheck`, `integrationCheck`, `performanceCheck`, `releaseCheck`, `qualityCheck`, `configContractCheck`)과 버전/리비전. `verifyStrictLaneStages --dry-run`(PR 게이트)은 그 빌드에서 `explicitOnly`가 아닌 strict lane이 workflow가 실제로 실행하는 - 단계(main 빌드: `ci`·`sample-portfolio:check`·`mainCheck`·`integrationCheck`·`performanceCheck`· + 단계(main 빌드: `ci`·`mainCheck`·`integrationCheck`·`performanceCheck`· `releaseCheck`, optional-platforms 빌드: `-p optional-platforms`로 부르는 `ci`·`integrationCheck`· `performanceCheck`·`releaseCheck`) 중 하나에 들어 있는지, 그리고 workflow의 접힌(`>`) run 블록이 빈 줄 때문에 옵션을 별개 명령으로 떼어 내지 않는지 검사한다. 두 빌드가 각자 검사를 돌린다. `-x`로 뺀 @@ -148,7 +148,6 @@ commit 정책은 모든 플랫폼에서 `human-only`이며 agent는 stage/commit file server, HTTP client, identifier 능력을 port 뒤에서 구현한다. adapter 간 허용 edge는 registry만 따른다. - `shared-contract`: skeleton-wide 운영 계약. business/domain 개념 저장 금지. -- `sample-portfolio`: 샘플/fixture consumer. production leaf가 의존하면 안 된다. - `app-bootstrap`: Spring Boot entrypoint와 composition root. 비즈니스 유스케이스 금지. ## 의존성 방향 @@ -159,7 +158,6 @@ family 수준 기본 방향: app-bootstrap -> adapter:inbound:* -> application-core -> domain-core app-bootstrap -> adapter:outbound:* -> application-core -> domain-core runtime modules -> shared-contract -sample-portfolio -> registered runtime leaves (fixture consumer only) ``` 개별 edge는 `src/config/architecture/modules.json`의 `allowed_dependencies`가 유일한 목록이다. @@ -181,8 +179,7 @@ Gradle 의존성 검증도 같은 registry를 읽는다. root 문서나 기억 10. focused test를 먼저 돌리고, 가능한 경우 전체 Gradle test를 돌린다. 단계별 판단 지점(배치·저장 포트·트랜잭션·멱등성·오류·권한)은 `docs/manual/`, 뼈대는 -`scripts/new-feature.sh `이 계층 leaf에 만든다. `sample-portfolio`는 모든 계층을 한 leaf에 -두는 지울 수 있는 샘플이라 배치 예시가 아니다. 실제 기능은 계층 leaf별로 나눈다. +`scripts/new-feature.sh `이 계층 leaf에 만든다. 실제 기능은 계층 leaf별로 나눈다. ## 테스트 전략 @@ -232,7 +229,7 @@ cd src ./gradlew qualityCheck # SpotBugs + FindSecBugs (leaf check에는 없다) ./gradlew testQualityCheck # 같은 분석을 테스트 source set에(config/spotbugs/exclude-test.xml, main 단계·optional 빌드는 ci) ./gradlew ci # PR 게이트 = leaf check + architecture + quality -./gradlew mainCheck # main 단계 = env 계약·전체 기동(샘플 포함)·public path·전송/메시징 레인·leaf 문서 대조 레인·기능 생성 왕복(verifyFeatureScaffold)·테스트 코드 정적 분석(testQualityCheck) +./gradlew mainCheck # main 단계 = env 계약·전체 기동·public path·전송/메시징 레인·leaf 문서 대조 레인·기능 생성 왕복(verifyFeatureScaffold)·테스트 코드 정적 분석(testQualityCheck) ./gradlew integrationCheck # 실제 컨테이너 integration 레인 전체(main·nightly, Docker 필요) ./gradlew performanceCheck # 부하·종료·자원 한계 레인(main·nightly). 상한은 항상 단언, 끄면 실패 ./gradlew verifyStrictLaneStages --dry-run # 이 빌드의 strict lane이 workflow가 실행하는 단계에 속하는지(optional 빌드는 -p optional-platforms로 따로) @@ -307,7 +304,7 @@ Docker/runtime 규칙: gRPC 플랫폼을 쓰면 proto 조직 이름 `caskeleton`(`src/grpc/grpc-contract/src/main/proto/caskeleton/`의 디렉터리, 각 `.proto`의 `package`·`java_package`)도 함께 바꾸고 `buf lint`로 확인한다. 3. `CaSkeletonApplication` 이름을 새 애플리케이션 이름으로 바꾼다. -4. production 모듈에는 목표 도메인의 entity, repository port, use case, adapter만 추가하고, 예시 코드는 `sample-portfolio`에 격리한다. +4. production 모듈에는 목표 도메인의 entity, repository port, use case, adapter만 추가한다. 5. 모듈 이름과 경계는 유지한다. 6. Docker image/application 이름을 새 프로젝트 기준으로 수정한다. 7. `.env`, `.env.local`, `application.yml`의 예시 값을 새 런타임 요구사항에 맞춘다. diff --git a/CLAUDE.md b/CLAUDE.md index 86356844..97838d8e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -59,7 +59,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이 - **`composition:*` leaf는 조립만 한다.** outbox relay, 멱등성 executor, durable operation처럼 bootstrap에서 떼어 낸 조립이다. 각각 `runtimeOnly` 한 줄로 고른다. - **capability는 한 줄로 켜고 끈다.** 기본 조립은 web inbound, 운영 관측, core들, support·identifier뿐이다. JPA도 `src/app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄로 켠다. 규칙은 `AGENTS.md` 「부가 기능(capability) 모듈 규칙」이다. - **gRPC 플랫폼 라이브러리는 다른 빌드다.** `src/grpc/*`·`src/grpc-advanced/*`(registry의 `"build": "optional-grpc"`)는 `-p optional-platforms`로 돈다. `adapter:inbound:grpc`는 애플리케이션 adapter라 주 빌드에 있다. -- **`src/sample-portfolio`는 지울 수 있는 샘플이다.** 한 leaf에 모든 계층을 둔 모양이라 배치를 따라 하지 않는다. 새 기능의 예시는 `scripts/new-feature.sh`의 출력이다. +- **새 기능의 예시는 `scripts/new-feature.sh`의 출력이다.** 샘플 모듈은 2026-11-07에 지웠다. 기법 예시는 `docs/manual/`이 실제 코드(fileserver, durable operation)를 가리킨다. - **성능 lane에는 단언을 끄는 스위치가 없다.** convention이 상한을 매번 단언하고, `performance.assertions.enabled`에 `true` 아닌 값이 들어오거나 skip이 있으면 테스트 전에 실패한다. 손으로 돌리든 workflow든 같다(`AGENTS.md` 「Gradle 정책 권위」). - **저장소 파일을 읽는 테스트는 태그가 있다.** 문서와 대조하는 테스트는 `document-contract`(main 단계 `mainCheck`), 빌드 스크립트·workflow를 읽는 테스트는 `repository-contract`(PR)다. 문서를 고치면 그 문서를 읽는 테스트를 찾는다. - **커밋 정책은 `human-only`다.** brief가 허용한 것만 자기 브랜치에 한다. 커밋과 push는 따로 허용된다. 자세한 것은 [docs/work/README.md](docs/work/README.md) 4절이다. diff --git a/README.md b/README.md index 3d6b69a0..ed140e9c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # ca-skeleton — Clean Architecture Spring Boot 템플릿 -ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Gradle 멀티모듈 기반의 Clean Architecture 백엔드 템플릿입니다. fork해서 도메인·패키지·엔티티·유스케이스만 교체하면 새 서비스를 시작할 수 있고, 모듈 경계와 의존 방향은 그대로 유지합니다. 기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 작업 기록 게시판)에 격리합니다. +ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Gradle 멀티모듈 기반의 Clean Architecture 백엔드 템플릿입니다. fork해서 도메인·패키지·엔티티·유스케이스만 교체하면 새 서비스를 시작할 수 있고, 모듈 경계와 의존 방향은 그대로 유지합니다. 기본 패키지는 `dev.caskeleton`입니다. 업무 기능의 예시는 생성 명령 `scripts/new-feature.sh`의 출력과 [docs/manual/](docs/manual/README.md)입니다. 이 문서는 전체 구조와 첫 실행만 다룹니다. 모듈별 상세 규칙과 설계 근거는 각 모듈의 README와 `CLAUDE.md`가, 빌드·환경 변수 상세는 [src/README.md](src/README.md)가 소유합니다. @@ -12,7 +12,6 @@ ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Grad app-bootstrap -> adapter:inbound:* -> application-core -> domain-core app-bootstrap -> adapter:outbound:* -> application-core -> domain-core 모든 런타임 모듈 -> shared-contract -sample-portfolio -> 등록된 런타임 리프 (fixture 소비자 전용) ``` family 수준의 책임은 다음과 같습니다. @@ -26,7 +25,6 @@ family 수준의 책임은 다음과 같습니다. | `adapter:outbound:*` | support(공유 베이스)·messaging·cache·notification·object storage·file·HTTP client·identifier 능력을 port 뒤에서 구현. 기본 조립에는 support·identifier만 들어 있고, 나머지는 `app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄로 고릅니다 | | `shared-contract` | skeleton 전역 운영 계약. business/domain 개념 저장 금지 | | `app-bootstrap` | Spring Boot entrypoint와 composition root | -| `sample-portfolio` | WorkLog 예시 도메인(fixture/reference). production이 의존하지 않음 | 등록된 leaf 목록과 각 leaf의 Gradle path·소스 경로·허용 production 의존 edge는 [src/config/architecture/modules.json](src/config/architecture/modules.json)이 SSOT입니다. focused @@ -91,10 +89,10 @@ H2 실행은 wiring과 애플리케이션 동작만 검증하고, migration과 v 애플리케이션 이름 등 나머지 rename 단계는 위 체크리스트를 따릅니다. -3. `CaSkeletonApplication`을 새 애플리케이션 이름으로 바꾸고, 목표 도메인의 엔티티·repository port·유스케이스·adapter를 production 모듈에 추가합니다. 예시 코드는 `sample-portfolio`에만 둡니다. +3. `CaSkeletonApplication`을 새 애플리케이션 이름으로 바꾸고, 목표 도메인의 엔티티·repository port·유스케이스·adapter를 production 모듈에 추가합니다. 새 업무 기능은 `scripts/new-feature.sh `으로 만듭니다. 4. 모듈 이름과 경계는 그대로 유지합니다. -검증은 먼저 composition root의 빠른 테스트와 sample-off 계약을 확인합니다. 루트에서 +검증은 먼저 composition root의 빠른 테스트와 아키텍처 검사를 확인합니다. 루트에서 `./gradlew test`를 호출하면 등록된 모든 하위 프로젝트의 `test`를 실행하므로 일상적인 로컬 피드백 명령으로 사용하지 않습니다. 저장소 전체 qualification은 CI 또는 명시적인 `ci` task가 담당합니다. @@ -102,14 +100,11 @@ H2 실행은 wiring과 애플리케이션 동작만 검증하고, migration과 v ```bash cd src ./gradlew :app-bootstrap:test -./gradlew :sample-portfolio:check ./gradlew architectureCheck ``` 병합 전 저장소 전체 검증이 필요하면 `./gradlew ci`를 실행합니다. -`sample-portfolio`는 템플릿이 유지하는 fixture/reference 모듈이라 production 모듈이 의존하지 않고, runtime에 sample bean이나 endpoint를 넣지 않습니다. 다운스트림 fork에서 fixture가 더 필요 없을 때만 sample-off 테스트를 통과시킨 뒤 정리합니다. - ## 아키텍처 규칙과 검증 애플리케이션이 동작하더라도 아래를 어기면 병합하지 않습니다. HARD-STOP 7개 조건의 정본 로컬 @@ -135,8 +130,7 @@ cd src ## 수동 전용 Gradle 태스크 -아래 세 태스크는 **어떤 워크플로도 실행하지 않으며, 그게 의도다.** 자동 실행이 틀린 이유를 각각 -적어 둔다. +아래 태스크는 **어떤 워크플로도 실행하지 않으며, 그게 의도다.** 자동 실행이 틀린 이유를 적어 둔다. 여기 적힌 태스크 이름이 실재하는지 검사하던 `verifyReadmeCommands`는 삭제했다. 그건 이 문서의 ```bash 블록을 직접 파싱해 `./gradlew`·`docker compose`·`make` 토큰을 실제 태스크 그래프와 대조하는 @@ -146,16 +140,11 @@ Markdown 명령 파서였고, 그 결과 "README에 무엇을 쓸 수 있는가" ```bash cd src ./gradlew :grpc:grpc-testkit:grpcPerformanceTest -./gradlew :sample-portfolio:openapiCheckSnapshot -PapproveOpenApiChange ``` - `grpcPerformanceTest` — latency percentile·saturation·drain budget을 **측정**한다. 공유 CI runner의 측정값은 흔들리고, 흔들리는 게이트는 결국 꺼진다. leaf `build.gradle`이 이 태스크의 태그를 `test`에서 제외하는 이유도 같다. 성능 회귀가 의심될 때 사람이 이름으로 부른다. -- `openapiCheckSnapshot` — 드리프트 검사 자체는 이미 자동으로 돈다. 이 태스크가 감싸는 - `OpenApiDriftContractTest`는 `:sample-portfolio:test`의 일부이고, 그건 `check` 안이며 stage 1에서 - 실행된다. 이 태스크의 고유한 역할은 `-PapproveOpenApiChange`로 **커밋된 스냅샷을 다시 만드는 것** - — 의도된 API 변경을 사람이 승인하는 지점이다. 자동으로 돌리면 승인이 승인이 아니게 된다. ## 더 알아보기 diff --git a/docs/capability-status.md b/docs/capability-status.md index b70e0120..d8d41b98 100644 --- a/docs/capability-status.md +++ b/docs/capability-status.md @@ -27,11 +27,11 @@ lanes and CI; it is not a deployment artifact. | Capability | Enabled key (property / env, default) | IMPLEMENTED | WIRED | QUALIFIED | Evidence | | --- | --- | --- | --- | --- | --- | -| Relational persistence (JPA/PostgreSQL) | `ca-skeleton.persistence-jpa.enabled` / `APP_PERSISTENCE_JPA_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:persistence-jpa')`) | yes | Not in the default composition. The one line brings everything — its own `AutoConfiguration.imports` (`PersistenceJpaAutoConfiguration`, `PersistenceJpaRuntimeConfig`, `JpaStartupAutoConfiguration`), its environment handling (`JpaActivationEnvironmentPostProcessor`, `spring.factories`: readiness `db` while on; with `false` it also excludes Boot's JDBC, Hibernate, Spring Data JPA and Flyway auto-configuration, so no DataSource is bound), the startup guards (Flyway strategy, datasource/OSIV/DDL/pool/TLS/vendor checks, exit codes unchanged) and its settings (`config/module-defaults/persistence-jpa.yml`). `persistence-jpa:PersistenceJpaCapabilityAssemblyTest` proves the module assembles on its own; the `postgresql*IntegrationTest` readiness lanes, run by `integration-main.yml` → `integration-check` (`:integrationCheck`), qualify it against PostgreSQL. `sample-portfolio` selects it by its build dependency and the module's auto-configuration (no broad scan of the persistence package). `bootRunH2` adds the module to its own classpath only. | +| Relational persistence (JPA/PostgreSQL) | `ca-skeleton.persistence-jpa.enabled` / `APP_PERSISTENCE_JPA_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:persistence-jpa')`) | yes | Not in the default composition. The one line brings everything — its own `AutoConfiguration.imports` (`PersistenceJpaAutoConfiguration`, `PersistenceJpaRuntimeConfig`, `JpaStartupAutoConfiguration`), its environment handling (`JpaActivationEnvironmentPostProcessor`, `spring.factories`: readiness `db` while on; with `false` it also excludes Boot's JDBC, Hibernate, Spring Data JPA and Flyway auto-configuration, so no DataSource is bound), the startup guards (Flyway strategy, datasource/OSIV/DDL/pool/TLS/vendor checks, exit codes unchanged) and its settings (`config/module-defaults/persistence-jpa.yml`). `persistence-jpa:PersistenceJpaCapabilityAssemblyTest` proves the module assembles on its own; the `postgresql*IntegrationTest` readiness lanes, run by `integration-main.yml` → `integration-check` (`:integrationCheck`), qualify it against PostgreSQL. `bootRunH2` adds the module to its own classpath only. | | Document persistence (MongoDB) | `ca-skeleton.persistence-mongo.enabled` / `APP_PERSISTENCE_MONGO_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:persistence-mongo')`) | yes | On when present; `false` also excludes Boot's Mongo auto-configuration (`MongoCapabilityActivationTest`). The connection-source rule (`SPRING_MONGODB_URI` or the selected profile's `uri-secret`) is checked by the module's own `MongoDefaultsEnvironmentPostProcessor`. Six container lanes (`mongoReplicaSetTest`, `mongoFailoverTest`, …), run by `integration-main.yml` → `integration-check` (`:integrationCheck`) | | Messaging (Kafka) | `app.messaging.enabled` / `APP_MESSAGING_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:messaging-kafka')`, which brings the application bridge, the legacy `KafkaSender` seam and the vendored platform with its Kafka transport) | Kafka only | On when present (`KafkaCapabilityActivationTest`). `messaging-kafka:messagingCertificationTest` behind `verifyMessagingCertificationEvidence`, run by `messaging-certification.yml`; the starter's `integrationTest` is the live Kafka round trip. Kafka is the only registered broker; the RabbitMQ broker keys were removed (no transport). | | Redis capabilities (cache / rate-limit / lease / idempotency) | `app.redis.enabled` / `APP_REDIS_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:cache-redis')`, which brings `redis-runtime`) | yes | `cache-redis:redisContainerContractTest` (Testcontainers Redis, `integrationCheck`); `cache-redis:redisTopologyTest`, run by `redis-sdk-topology.yml`. Not in the default composition. On when present; `false` contributes no Redis bean — no settings, client, connection, thread or health contributor. The module owns its readiness contribution (`RedisReadinessGroupPostProcessor`, `spring.factories`) and its settings (`config/module-defaults/cache-redis.yml`: `app.redis.enabled`, `app.rate-limit.*`, the Redis `ca-skeleton.capabilities.*`). No `app-bootstrap` main source names a Redis type. | -| Request idempotency | `APP_IDEMPOTENCY_PROVIDER` (`disabled` \| `redis` \| `postgresql`; a selector, not an on/off key) | yes | yes | Redis and PostgreSQL | One generation: the application `IdempotencyExecutor`, built once by `composition:idempotency` (`IdempotencyAutoConfiguration`) over the one store the selected provider contributes (`cache-redis` or `persistence-jpa`); startup is refused unless exactly one store exists. `app-bootstrap` and `sample-portfolio` both take that module with one `runtimeOnly` line, so there is no second assembly. Redis is covered by the row above. PostgreSQL has `persistence-jpa:postgresqlIdempotencyIntegrationTest`, run by `integration-main.yml` → `integration-check` (`:integrationCheck`). The `postgresql` provider refuses a non-PostgreSQL data source, so `bootRunH2` uses `disabled` or `redis`. Each store comes with its module: `postgresql` needs the persistence-jpa line, `redis` the cache-redis one. | +| Request idempotency | `APP_IDEMPOTENCY_PROVIDER` (`disabled` \| `redis` \| `postgresql`; a selector, not an on/off key) | yes | yes | Redis and PostgreSQL | One generation: the application `IdempotencyExecutor`, built once by `composition:idempotency` (`IdempotencyAutoConfiguration`) over the one store the selected provider contributes (`cache-redis` or `persistence-jpa`); startup is refused unless exactly one store exists. `app-bootstrap`이 그 모듈을 `runtimeOnly` 한 줄로 받고, 다른 조립은 없다. Redis is covered by the row above. PostgreSQL has `persistence-jpa:postgresqlIdempotencyIntegrationTest`, run by `integration-main.yml` → `integration-check` (`:integrationCheck`). The `postgresql` provider refuses a non-PostgreSQL data source, so `bootRunH2` uses `disabled` or `redis`. Each store comes with its module: `postgresql` needs the persistence-jpa line, `redis` the cache-redis one. | | Transactional outbox relay | `ca-skeleton.outbox.enabled` / `APP_OUTBOX_ENABLED`, `false` (+ `APP_OUTBOX_RELAY_ENABLED`, `false`; persistence-jpa settings) | yes | yes (with the persistence-jpa line; the scheduler also needs the messaging-kafka line) | yes | The store and its settings are persistence-jpa's; the relay (`OutboxConfig`) is application composition in `app-bootstrap` because a driven adapter must not build or call a use case. It turns on only when an `OutboxStorePort` bean exists, and the scheduler only when an `OutboxMessagePublishPort` does (the messaging bridge), each ordered after its contributor by `afterName` — so an environment with no publisher keeps its PENDING rows. The bridge registers no stand-in publisher: a present-and-enabled bridge with a blank broker and no canonical transport is refused at startup. `postgresqlLegacyOutboxConcurrentRelayIntegrationTest` qualifies claim/fencing against PostgreSQL. | | Notification platform | `ca-skeleton.notification.platform.enabled` / `APP_NOTIFICATION_PLATFORM_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':composition:notification-platform')`, plus the persistence-jpa line) | claim-scoped | Not in the default composition. The one line brings the use-case assembly, `adapter:outbound:notification`, the HTTP surface `adapter:inbound:web-notification` and its own settings (`config/module-defaults/notification.yml`), each registered through the module's own `AutoConfiguration.imports`; `adapter:inbound:web` no longer depends on `application-notification`. `verifyNotificationEvidence` refuses a grade in `docs/notification/support-matrix.md` that no proven claim backs; run by `notification-platform.yml`. There is no real-SMTP lane, and the matrix says so rather than implying one. | | File server platform | `app.fileserver-platform.enabled` / `APP_FILESERVER_PLATFORM_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':composition:fileserver-platform')`, plus the persistence-jpa line) | yes | On when present; module-owned `config/module-defaults/fileserver.yml` also carries the servlet multipart ceiling. `app-bootstrap:integrationTest` → `FileserverCompositionIntegrationTest` (required by the strict lane), run by `integration-main.yml` → `integration-check` (`:integrationCheck`) | diff --git a/docs/ci-cd/template-vs-consumer.md b/docs/ci-cd/template-vs-consumer.md index 964e2552..76303394 100644 --- a/docs/ci-cd/template-vs-consumer.md +++ b/docs/ci-cd/template-vs-consumer.md @@ -4,8 +4,8 @@ 이 저장소에는 성격이 다른 두 종류의 검증이 섞여 있다. -1. **스켈레톤을 만드는 사람**에게 필요한 검증 — sample 모듈이 정말 제거 가능한가, optional 모듈 - 조합이 모두 빌드되는가, 레지스트리가 확장 가능한가. +1. **스켈레톤을 만드는 사람**에게 필요한 검증 — optional 모듈 조합이 모두 빌드되는가, 레지스트리가 + 확장 가능한가. 2. **스켈레톤을 가져다 서비스를 만드는 사람**에게 필요한 검증 — 내 애플리케이션의 테스트, 아키텍처 방향, 보안, 릴리스. @@ -16,9 +16,6 @@ | 대상 | 무엇을 지키는가 | | --- | --- | -| `:app-bootstrap:sampleOffTest`, `ci-quality-gates.yml`의 `sample-off` job | sample 픽스처를 지워도 애플리케이션이 빌드·부팅되는가 | -| `sample-portfolio` leaf 전체 | 참조 구현 | -| `Dockerfile.sample`, `docker-compose.*` 중 sample 관련 | 위와 동일 | | `docs/superpowers/**` | 이 템플릿을 만든 과정의 설계/계획 기록 | | `gradle/qualification/**` | 이 템플릿이 벤더링한 플랫폼(JPA, messaging)의 인증 체계 | | `*-certification.yml`, `*-qualification.yml`, `jpa-next-*.yml` | 템플릿이 광고하는 지원 매트릭스의 근거 | diff --git a/docs/fileserver/design-deviations.md b/docs/fileserver/design-deviations.md index 0bf0a744..0273e4a9 100644 --- a/docs/fileserver/design-deviations.md +++ b/docs/fileserver/design-deviations.md @@ -113,9 +113,8 @@ The metadata store, session store, quota service, queues, ledger, and staging lo `@ConditionalOnProperty(app.fileserver-platform.enabled)` even though the rest of `adapter:outbound:persistence-jpa` is unconditional. -Without the gate, every composition root that includes the persistence module built these beans — -including `sample-portfolio`, which has no Fileserver — and each of them needs collaborators only -the Fileserver configuration provides. That is the same rule the design states for the transport +게이트가 없으면 persistence 모듈을 포함한 조립 루트는 Fileserver를 쓰지 않아도 이 bean들을 만들고, 그 bean마다 +Fileserver 설정만 주는 협력 객체가 필요하다. That is the same rule the design states for the transport surface, applied to persistence: no surface appears merely because the dependency is present. `FileStateMachine` is bound alongside them, in `FileserverStorageConfiguration`. It had no diff --git a/docs/jpa/entity-mapping-guide.md b/docs/jpa/entity-mapping-guide.md index 2a09c7d5..aae8772c 100644 --- a/docs/jpa/entity-mapping-guide.md +++ b/docs/jpa/entity-mapping-guide.md @@ -96,8 +96,8 @@ second `UPDATE`, and the entity graph is a cycle. Keep the association on one si an ID or a query (re-review round 2, RR-02-15). A class that links to itself is a pair only when a second member points back the other way (`@ManyToOne parent` with `@OneToMany children`); two `@ManyToOne` links of a class to itself (a manager and a mentor) pass, because both keys point into -the one table and there are no two tables to order. `JpaProductionArchitectureTest` (app-bootstrap -`architectureTest`) runs it over the production graph and `SampleArchitectureTest` over the sample. +the one table and there are no two tables to order. 이 규칙은 `JpaProductionArchitectureTest`(app-bootstrap +`architectureTest`)가 운영 그래프 전체에 건다. The failure message names the fields and these alternatives. Chosen and rejected: diff --git a/docs/jpa/migration-guide.md b/docs/jpa/migration-guide.md index c8a85f1a..0a6b3e61 100644 --- a/docs/jpa/migration-guide.md +++ b/docs/jpa/migration-guide.md @@ -103,10 +103,9 @@ from its list that lock an existing table with no bound in force: `ALTER TABLE`, FULL`; `REFERENCES` on the table it references, in a new table as much as in an `ALTER TABLE` (a foreign key locks its parent against writes while it is added); `CREATE TRIGGER` and `DROP TRIGGER` on their table; `UPDATE` and `DELETE`. It reads text, so a statement outside the list is not -checked. `MigrationLockWaitTest` runs it over every tree this leaf's database runs, -`SampleMigrationLockWaitTest` over the sample's stream; a service stream copies the latter with its -own directory. Both find the migrations the way Flyway does, decimal versions (`V22_1__`) included -(`VersionedMigrationFiles`, testkit). The migrations released before the rule wait unbounded and +checked. `MigrationLockWaitTest`는 이 leaf의 데이터베이스가 돌리는 모든 트리에 이 검사를 건다. 서비스 +스트림은 이 테스트를 복사해 자기 폴더를 넣는다. 이 테스트는 Flyway와 같은 방식으로 마이그레이션을 찾고, 소수 +버전(`V22_1__`)도 포함한다(`VersionedMigrationFiles`, testkit). The migrations released before the rule wait unbounded and stay that way (they are applied, and applied files are never edited); the test lists them and refuses any new one. `PostgreSqlMigrationLockWaitIntegrationTest` (`postgresqlMigrationLockWaitIntegrationTest`) shows on real PostgreSQL that a bounded migration diff --git a/docs/jpa/support-matrix.md b/docs/jpa/support-matrix.md index 1de1114b..793821bf 100644 --- a/docs/jpa/support-matrix.md +++ b/docs/jpa/support-matrix.md @@ -118,8 +118,8 @@ Each row is a way the platform could pass its tests and still be wrong in produc ### The audit mechanism `audit/AuditableEntity` is the only one: `created_*`/`updated_*`, a 256-character actor, stamped -explicitly by the repository adapter. It is what the sample entities extend and what the migrations -were written for. A second, Spring Data listener-based mechanism (`auditing/AuditMetadata`) was never +explicitly by the repository adapter. 서비스의 엔티티는 이것을 상속하고, 마이그레이션도 이 열에 +맞춰 썼다. A second, Spring Data listener-based mechanism (`auditing/AuditMetadata`) was never composed and has been removed; `JpaAuditMechanismRule.entitiesUseExactlyOneAuditMechanism` keeps it from coming back on an entity. diff --git a/docs/manual/02-new-feature.md b/docs/manual/02-new-feature.md index d4902048..0f36708c 100644 --- a/docs/manual/02-new-feature.md +++ b/docs/manual/02-new-feature.md @@ -35,7 +35,7 @@ - **기본값**: 서버가 만든다. domain `XIdFactory extends IdFactory` + `adapter:outbound:identifier` 구현. 문법은 id 값 객체 생성자에서 검사한다. - **예외**: 클라이언트가 자연 키(주문번호 등)를 주는 기능은 그 키를 id로 쓴다. 이때 중복은 DB 유일성 - 제약이 막는다(04장). UUIDv7이 필요하면 `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidWorkLogIdFactory.java`처럼 바꾼다. + 제약이 막는다(04장). UUIDv7이 필요하면 `src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java`처럼 바꾼다. ### 판단: 불변식을 어디 두나 diff --git a/docs/manual/03-placement.md b/docs/manual/03-placement.md index 3344a841..395780c9 100644 --- a/docs/manual/03-placement.md +++ b/docs/manual/03-placement.md @@ -2,9 +2,9 @@ ## 핵심 -새 기능을 두는 모양은 셋이다. **업무 기능의 기본은 ① 계층 leaf 안 `` 패키지**다. -선택해서 켜고 끄는 플랫폼 기능만 ② 별도 `application-*` leaf로 만든다. ③ 한 leaf 수직 슬라이스는 -지울 수 있는 샘플 전용이다. 생성 명령은 ①만 만든다. +새 기능을 두는 모양은 둘이다. **업무 기능의 기본은 ① 계층 leaf 안 `` 패키지**다. +선택해서 켜고 끄는 플랫폼 기능만 ② 별도 `application-*` leaf로 만든다. 한 leaf에 모든 계층을 두는 +수직 슬라이스는 쓰지 않는다. 생성 명령은 ①만 만든다. ```text ① 계층 leaf 안 패키지 (기본) @@ -13,21 +13,18 @@ ② 기능 전용 leaf (capability) application- -> persistence-, adapter:outbound:, adapter:inbound:web- -> composition:-platform app-bootstrap/build.gradle 에 runtimeOnly 한 줄 - -③ 한 leaf 수직 슬라이스 (샘플 전용) - sample-portfolio = domain + application + adapter + bootstrap 패키지 ``` ## 기준표 -| 질문 | ① 계층 leaf 패키지 | ② 기능 leaf | ③ 수직 슬라이스 | -| --- | --- | --- | --- | -| 서비스마다 켜고 끌 수 있어야 하나 | 아니오 | **예** | — | -| 다른 서비스가 같은 기능을 라이브러리로 받나 | 아니오 | **예** | 아니오 | -| 한 줄 지워 기능을 통째로 빼야 하나 | 아니오(패키지 삭제) | **예**(`runtimeOnly` 한 줄) | 예(leaf 삭제) | -| leaf 단위 의존 방향 검사가 기능 안에도 걸리나 | 예(계층이 leaf) | 예 | **아니오**(ArchUnit 패키지 규칙에만 기댐) | -| 고칠 공용 파일 | 없음(+ imports 한 줄) | `modules.json`, `settings.gradle` 매핑, `app-bootstrap/build.gradle`, lockfile | `modules.json` | -| 예시 | 생성 명령 출력, `application-core/.../operation` | `application-notification`, `application-fileserver`, `application-objectstorage` | `sample-portfolio` | +| 질문 | ① 계층 leaf 패키지 | ② 기능 leaf | +| --- | --- | --- | +| 서비스마다 켜고 끌 수 있어야 하나 | 아니오 | **예** | +| 다른 서비스가 같은 기능을 라이브러리로 받나 | 아니오 | **예** | +| 한 줄 지워 기능을 통째로 빼야 하나 | 아니오(패키지 삭제) | **예**(`runtimeOnly` 한 줄) | +| leaf 단위 의존 방향 검사가 기능 안에도 걸리나 | 예(계층이 leaf) | 예 | +| 고칠 공용 파일 | 없음(+ imports 한 줄) | `modules.json`, `settings.gradle` 매핑, `app-bootstrap/build.gradle`, lockfile | +| 예시 | 생성 명령 출력, `application-core/.../operation` | `application-notification`, `application-fileserver`, `application-objectstorage` | ### 판단: ①과 ② 중 무엇인가 @@ -39,19 +36,18 @@ - **다시 볼 조건**: 파생 서비스가 둘 이상 생겨 같은 업무 기능을 공유하거나, application-core 컴파일·테스트 시간이 문제가 되면 ①을 ②로 옮긴다. -### 판단: ③을 써도 되나 +### 판단: 한 leaf 수직 슬라이스를 써도 되나 -- **기본값**: 쓰지 않는다. ③은 leaf 하나가 모든 계층에 의존해서 leaf 단위 방향 검사가 기능 안에서는 +- **기본값**: 쓰지 않는다. leaf 하나가 모든 계층에 의존해서 leaf 단위 방향 검사가 기능 안에서는 아무것도 막지 못한다. -- **예외**: 통째로 지울 수 있어야 하는 샘플·데모. `sample-portfolio`가 그 예다. 샘플을 계층 leaf로 쪼개지 - 않는 이유는 "leaf 하나 지우면 끝"이라는 성질을 지키려는 것이다. +- **예외**: 없다. 이 모양이던 샘플 모듈은 매뉴얼과 생성 명령이 예시를 맡아 2026-11-07에 지웠다. ## ① 안의 패키지 규칙 | 계층 | 패키지 | 하위 패키지 | | --- | --- | --- | | domain | `dev.caskeleton.domain.` | fake·계약은 testFixtures `dev.caskeleton.domain..testkit` | -| application | `dev.caskeleton.application.` | 종류별 하위 패키지(`command`, `usecase`, `port`)를 만들지 않는다. 기능별 한 패키지(`sample-portfolio`도 2026-09-29에 이 배치로 옮겼다) | +| application | `dev.caskeleton.application.` | 종류별 하위 패키지(`command`, `usecase`, `port`)를 만들지 않는다. 기능별 한 패키지 | | outbound | `dev.caskeleton.adapter.outbound..` | | | inbound | `dev.caskeleton.adapter.inbound.web.` | | | bootstrap | `dev.caskeleton.bootstrap.autoconfigure.` | `@AutoConfiguration`만(`BOOTSTRAP_AUTOCONFIGURE_STEREOTYPES_ARE_AUTO_CONFIGURATIONS`) | @@ -73,4 +69,3 @@ - 업무 기능 = ① 계층 leaf 패키지. 생성 명령이 이 모양을 만든다. - 켜고 끄는 플랫폼 기능 = ② 별도 leaf, capability 기준 7개. -- sample-portfolio는 기법 참고용이지 배치 예시가 아니다. diff --git a/docs/manual/04-persistence.md b/docs/manual/04-persistence.md index 70195ca0..cf10e492 100644 --- a/docs/manual/04-persistence.md +++ b/docs/manual/04-persistence.md @@ -31,7 +31,7 @@ use case ── tx.inWrite ──▶ XRepository (domain 포트) adapter는 호출자 트랜잭션 밖의 호출을 거부하므로(아래 「트랜잭션 안에서만 쓴다」), 계약의 `inTransaction(Supplier)`을 재정의해 거기서 트랜잭션을 열고 커밋한다. 계약은 모든 저장소 호출을 그 hook으로 부른다. fake는 기본값(그냥 실행)을 쓴다. - 예: `src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterContractTest.java`. + 예: `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/operation/JpaDurableOperationStoreContractTest.java`. 5. adapter를 bean으로 등록하는 자동 설정을 쓰고, 기능의 `XConfig`에 `afterName`으로 그 순서를 적는다. ## 판단: 저장 adapter를 둘 leaf @@ -44,7 +44,6 @@ use case ── tx.inWrite ──▶ XRepository (domain 포트) ("모듈을 아는 곳은 모듈 자신뿐")을 어기고, ② 그 leaf의 공개 API 기준선 (`docs/architecture/jpa-api-surface.txt`)과 엔티티 scan 목록(`PersistenceJpaConfig`, `PersistenceEntityScanCoverageTest`)을 고쳐야 하며, ③ upstream 병합 충돌 면이 넓어진다. - sample은 자기 leaf 안에 adapter를 둔다(③ 수직 슬라이스라서). - 새 leaf는 `modules.json` 등록, lockfile 생성, `app-bootstrap/build.gradle` 한 줄이 필요하다(10장). ## 엔티티 매핑 @@ -80,22 +79,22 @@ store는 자기 트랜잭션을 열지 않는다. 유스케이스가 연 트랜 - 중복 금지 → 유일성 제약/인덱스. 유스케이스의 사전 조회(`existsBy…`)는 빠른 거절일 뿐이다. READ COMMITTED에서 두 요청이 모두 "없음"을 보고 둘 다 insert한다. - adapter가 그 **이름 붙은 제약**의 위반만 잡아 기능 예외로 바꾼다. 다른 제약 위반은 그대로 둔다. - 예: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapter.java` - (`DataIntegrityViolationException` → 제약 이름 확인 → `PosterTitleAlreadyExistsException` 409), - 제약은 `src/sample-portfolio/src/main/resources/db/sample-migration/V8_1__poster_title_unique.sql`. + 순서는 `DataIntegrityViolationException`을 잡는다 → 원인의 제약 이름이 그 제약인지 본다 → 맞으면 + 기능 예외(예: `TitleAlreadyExistsException`, 409)를 던지고, 아니면 다시 던진다. 템플릿 코드에는 이 + 모양의 예가 없다. 확인은 아래 공유 계약 테스트와 동시성 테스트로 한다. - **충돌을 바꾸는 곳은 하나다.** 업무 규칙 충돌(같은 제목)은 포트 옆 domain 패키지의 예외 타입이고, 포트가 `@throws`로 선언하고 adapter가 던진다. 유스케이스의 사전 조회도 같은 타입을 던져 두 경로가 같은 409가 된다. application 예외를 domain 포트가 Javadoc으로만 가리키면 fake·mock은 그 약속을 지킬 수 없다. 기술 충돌(버전 불일치·교착)은 adapter가 프레임워크 예외 그대로 두고 아래 `PersistenceExceptionTranslator`가 - `DB_*` 코드로 바꾼다(WorkLog의 `ObjectOptimisticLockingFailureException` → `DB_OPTIMISTIC_CONFLICT`). + `DB_*` 코드로 바꾼다(`ObjectOptimisticLockingFailureException` → `DB_OPTIMISTIC_CONFLICT`). - 그 약속은 포트 소유자 testFixtures의 공유 계약 테스트로 고정한다. fake와 adapter가 같은 계약을 상속한다. - 예: `PosterRepositoryContract`(`InMemoryPosterRepository`, `PosterRepositoryAdapterContractTest`). + 예: `DurableOperationStoreContract`(`InMemoryDurableOperationStore`, `JpaDurableOperationStoreContractTest`). - 여러 인스턴스가 집는 작업 → `FOR UPDATE SKIP LOCKED`는 **트랜잭션 안에서**, 그리고 lease(만료 시각)와 fence 값을 함께 저장한다. 예: `ReconciliationJobStorePort.claimDue`(application-notification), gRPC operation ledger의 claim. - - 수정 충돌 → 버전 열(낙관적 잠금). 예: `UpdateWorkLogUseCase`의 version 비교와 `@Version`. + - 수정 충돌 → 버전 열(낙관적 잠금). 예: `DurableOperationEntity`(persistence-jpa)의 `@Version` 열 `row_version`. - **예외**: DB가 볼 수 없는 규칙(외부 시스템 상태)은 분산 락(`DistributedLockPort`)이나 멱등성 키(05장). -- 동시성 테스트는 실 DB lane에서 동시 요청 N개 → 행 1개를 단언한다(sample `integrationTest` 참고). +- 동시성 테스트는 실 DB lane에서 동시 요청 N개 → 행 1개를 단언한다. ## 기술 실패는 공통 코드로 나간다 @@ -110,14 +109,11 @@ SQLState 표를 복사하지 않는다. ```text 템플릿 운영 스트림 classpath:db/migration/postgresql V1 … V19 … (upstream이 계속 늘린다) capability 스트림 db/migration/jpa/ 각자 history table -샘플 스트림 db/sample-migration flyway_sample_schema_history 서비스 스트림(권장) db/migration/ flyway__schema_history ``` - **고르는 기준**: upstream 템플릿을 계속 받을 것인가. - **기본값**: 서비스 마이그레이션은 **자기 위치 + 자기 history table** 스트림에 둔다. 모양은 - `SamplePostgreSqlPersistenceConfig.sampleMigrationStrategy` - (`src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java`)와 `NotificationSchemaStream`(persistence-notification). 그러면 번호가 템플릿 스트림과 독립이라 V1부터 쓴다. 자기 스트림의 Flyway는 `Flyway.configure()`가 아니라 `FlywaySchemaPolicy.configure()`(persistence-jpa)로 만든다. Flyway의 PostgreSQL 잠금을 세션에 두어야 `CREATE INDEX CONCURRENTLY` 마이그레이션이 끝난다. @@ -128,21 +124,20 @@ capability 스트림 db/migration/jpa/ 각자 histor 겹친다. 어쩔 수 없으면 upstream이 쓰지 않을 큰 번호대를 정해 문서에 적는다. - 이미 적용된 파일은 고치지 않는다. 고치면 체크섬 불일치로 기동이 멈추고, `repair`는 쓰지 않는다 (`docs/jpa/migration-guide.md`). -- 같은 스트림 안에서 기존 두 버전 사이에 끼워야 하면 소수 버전(`V8_1`)을 쓴다. 샘플 테스트 일부가 운영 - 스트림과 샘플 스트림을 한 목록으로 합치는데, 정수 V9 이상은 운영이 이미 쓰고 있어서 2026-11-01 샘플에 - 포스터 제목 유일 제약을 더할 때 `V8_1`을 골랐다. -- 기존 데이터가 새 제약을 어기면 마이그레이션이 이유를 남기고 멈추게 쓴다(`V8_1`의 `DO $$` 블록). 조용히 +- 같은 스트림 안에서 기존 두 버전 사이에 끼워야 하면 소수 버전(`V8_1`)을 쓴다. 두 스트림을 한 목록으로 + 합쳐 검사하는 테스트가 있으면, 다른 스트림이 이미 쓴 정수 번호를 피하려고 이렇게 끼운다. +- 기존 데이터가 새 제약을 어기면 마이그레이션이 이유를 남기고 멈추게 쓴다(`DO $$` 블록의 `RAISE EXCEPTION`). 조용히 지우지 않는다. - 운영 중인 테이블을 잠그는 문장(`ALTER TABLE`, `CONCURRENTLY` 없는 `CREATE INDEX`, `UPDATE`·`DELETE`, 기존 테이블을 가리키는 `REFERENCES`, trigger 만들기·지우기 등 — 전체 목록은 `docs/jpa/migration-guide.md`)이 있으면 - 그 앞에 `SET LOCAL lock_timeout = '5s';`를 둔다(`V8_1`, `V22`). 값은 0이 아니어야 하고, + 그 앞에 `SET LOCAL lock_timeout = '5s';`를 둔다(`V22`). 값은 0이 아니어야 하고, `executeInTransaction=false` 마이그레이션에서는 `SET LOCAL`이 효과가 없으니 잠그는 문장을 거기 두지 않는다. Flyway가 스스로 트랜잭션 밖에서 돌리는 문장(`VACUUM`, `CREATE INDEX CONCURRENTLY` 등 — 목록은 같은 가이드)이 하나라도 있는 파일도 트랜잭션 밖에서 돌므로, 그런 문장은 따로 한 파일에 둔다. `VACUUM FULL`처럼 트랜잭션 안에서 돌 수 없는 잠금 문장은 상한을 걸 수 없으니 마이그레이션에 두지 않고 운영 절차로 돌린다. 상한이 없으면 그 테이블을 건드린 열린 트랜잭션 하나(`ALTER TABLE`이면 읽기만 한 것도) 뒤에서 마이그레이션이 끝없이 기다리고, 그동안 뒤에 온 그 테이블의 쓰기(`ALTER TABLE`이면 읽기까지)가 모두 마이그레이션 뒤에 줄을 선다. 상한이 있으면 5초 뒤 실패·롤백되고 새 버전이 뜨지 않을 뿐이다. 자기 스트림에도 - `SampleMigrationLockWaitTest`처럼 `LockWaitMigrationInspector`(persistence-jpa testkit) 검사를 둔다 + `MigrationLockWaitTest`(persistence-jpa)처럼 `LockWaitMigrationInspector`(persistence-jpa testkit) 검사를 둔다 (`docs/jpa/migration-guide.md` "Bound the lock wait"). ## 지금 이해하면 되는 것 diff --git a/docs/manual/05-idempotency.md b/docs/manual/05-idempotency.md index 45b62dd5..25280c6c 100644 --- a/docs/manual/05-idempotency.md +++ b/docs/manual/05-idempotency.md @@ -40,8 +40,9 @@ DB 커밋 중 연결 끊김 ───────────────── 5. 저장소 provider를 고른다: `app.capabilities.idempotency.provider` = `postgresql` 또는 `redis` (기본 `disabled`). 운영에서 in-memory 금지. -예: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/` 의 -`PosterImagePublicationController`(키 헤더 검증), 유스케이스 쪽은 sample `application/posterimage`. +예: 키 헤더 검증은 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/http/IdempotencyKeyHeader.java`, +executor 조립과 실제 PostgreSQL 저장소 왕복은 `PostgreSqlIdempotencyProviderIntegrationTest`(app-bootstrap +`integrationTest`)다. KEYED 유스케이스를 HTTP부터 끝까지 이은 업무 기능 예는 템플릿에 없다. ## 클라이언트에게 무엇을 약속하나 diff --git a/docs/manual/06-errors.md b/docs/manual/06-errors.md index 20a36e35..5f59d9f5 100644 --- a/docs/manual/06-errors.md +++ b/docs/manual/06-errors.md @@ -26,9 +26,7 @@ gRPC/GraphQL/WebSocket: 같은 ApiErrorCarrier를 자기 status 모양으로 - **기본값**: application 기능 패키지의 `XErrorCode implements ApiErrorCode` enum + 예외가 `ApiErrorCarrier` 구현. 전송마다 핸들러를 만들 필요가 없다. 생성 명령 출력이 이 모양이다 (`ErrorCode`, `NotFoundException`, `RejectedException`). -- **예외**: 한 전송에서만 의미가 있는 실패(HTTP 헤더 형식 등)는 그 전송 adapter에 둔다. sample은 기능 - 코드를 web 패키지(`PortfolioErrorCode`, `DomainExceptionHandler`)에 두는데, 한 leaf 수직 샘플이라 - 가능한 모양이다. 따라 하지 않는다. +- **예외**: 한 전송에서만 의미가 있는 실패(HTTP 헤더 형식 등)는 그 전송 adapter에 둔다. ## 판단: 어떤 예외 타입으로 던지나 @@ -58,8 +56,8 @@ gRPC/GraphQL/WebSocket: 같은 ApiErrorCarrier를 자기 status 모양으로 - 템플릿 운영 코드: `OperationalError` + `docs/registries/error-codes.yaml`을 같은 변경에서 고친다. `ErrorCodeRegistryMappingTest`(app-bootstrap)가 status 일치를 검사한다. - 서비스 기능 코드: 그 registry에 넣지 않는다(registry 머리말 "Product/fork ApiErrorCode enums own local - registries"). 서비스 자기 registry를 만들고 같은 모양의 대조 테스트를 둔다. 예: - `src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCodeRegistryMappingTest.java`. + registries"). 서비스 자기 registry를 만들고 같은 모양의 대조 테스트를 둔다. 모양은 위 + `ErrorCodeRegistryMappingTest`(`src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java`)다. ## 지금 이해하면 되는 것 diff --git a/docs/manual/07-authorization.md b/docs/manual/07-authorization.md index 0dc62084..4f56ff53 100644 --- a/docs/manual/07-authorization.md +++ b/docs/manual/07-authorization.md @@ -25,8 +25,8 @@ | 프록시 가능 | `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/authz/RequiresPermissionProxyabilityTest.java` | 검사 자동 설정은 인증 체인(`WebSecurityAutoConfiguration`)과 **분리**되어 있다. 서비스가 자기 인증 -방식으로 인증 체인을 바꿔도 권한 검사는 꺼지지 않는다(2026-11-01부터. 전에는 샘플이 인증 체인 자동 설정을 -빼자 권한 검사도 함께 빠졌다). +방식으로 인증 체인을 바꿔도 권한 검사는 꺼지지 않는다(2026-11-01부터. 전에는 인증 체인 자동 설정을 빼면 +권한 검사도 함께 빠졌다). ### 지켜야 할 것 셋 diff --git a/docs/manual/08-testing.md b/docs/manual/08-testing.md index 738ae979..ae0560a5 100644 --- a/docs/manual/08-testing.md +++ b/docs/manual/08-testing.md @@ -62,7 +62,7 @@ lane으로 선언하고 단계를 지정한다. 선언은 `ca.strict-test-lane`( | 성능·부하 | performance 범주 | `performanceCheck` | | 외부 입력 필요(자격증명 등) | `explicitOnly(reason)` | 어떤 집계에도 안 들어가고 이유가 출력된다 | -예: `src/sample-portfolio/build.gradle`의 `strictTestLanes { lane('integrationTest') { integration() … } }`, +예: `src/app-bootstrap/build.gradle`의 `strictTestLanes { lane('integrationTest') { integration() … } }`, `src/app-bootstrap/build.gradle`의 `publicPathSnapshotTest`(`mainStage()`). ### 판단: 새 테스트를 어느 lane에 diff --git a/docs/manual/09-outbox-events.md b/docs/manual/09-outbox-events.md index 2a208669..68affbe9 100644 --- a/docs/manual/09-outbox-events.md +++ b/docs/manual/09-outbox-events.md @@ -23,15 +23,15 @@ DB 저장과 broker 발행을 따로 하면(dual write) 둘 중 하나만 성공 ## 순서 1. 계약을 정한다: 계약 id(`..`), 버전, payload record, JSON schema 파일과 해시. - 예: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedContractContribution.java`, - `src/sample-portfolio/src/main/resources/contracts/messaging/portfolio.worklog.reserved/v1.schema.json`(+ `.sha256`). + 예: `src/application-core/src/main/java/dev/caskeleton/application/operation/DurableOperationSubmittedContract.java`, + `src/application-core/src/main/resources/contracts/messaging/durable-operation.submitted/v1.schema.json`(해시는 계약 클래스 안). 2. payload record(`IntegrationPayload`)를 만든다. 3. 유스케이스의 `tx.inWrite` 안에서 저장 뒤 draft → encode → append. 예: - `CreateWorkLogUseCase`(sample)와 그 헬퍼 `PortfolioEventOutbox`. + `SubmitDurableOperationUseCase`(application-core `operation`). 4. 계약 contribution을 조립에서 `@Bean`으로 등록한다. encoder는 컨텍스트의 계약 bean으로 만들어진다. 등록을 빠뜨리면 append 때 실패한다. 예: `DurableOperationAutoConfiguration.durableOperationSubmittedContract()`. 5. 테스트: 계약 contribution 테스트(해시 고정), 유스케이스가 append했는지(`InMemoryOutboxStore`), - 소비자 중복 제거 계약(sample `WorkLogReservedConsumerDedupeContractTest`). + 소비자가 있으면 같은 event id를 두 번 받아도 효과가 한 번인지 보는 중복 제거 계약. 6. schema를 출시한다: `src/test/resources/contracts/released-payload-schemas.sha256`에 새 version 파일의 해시를 한 줄 더한다. 출시한 version 파일은 고치지 않는다 — 바뀌면 `ReleasedPayloadSchemaContract` 테스트가 실패한다. 필드를 바꾸는 변경은 새 version으로 낸다. 절차: `src/application-core/README.md` @@ -44,7 +44,7 @@ DB 저장과 broker 발행을 따로 하면(dual write) 둘 중 하나만 성공 - **고르는 기준**: 같은 서비스 안에서 이 사실에 반응하는 코드가 있는가. - **기본값**: 통합 이벤트만. 유스케이스가 저장 뒤 바로 payload를 만든다. - **예외**: aggregate 안에서 일어난 사실을 여러 유스케이스가 같은 방식으로 내보내면 domain - `@DomainEvent` record를 두고 유스케이스가 그것을 payload로 옮긴다(sample `WorkLogReserved`). + `@DomainEvent` record를 두고 유스케이스가 그것을 payload로 옮긴다. ### payload에 무엇을 넣나 @@ -57,7 +57,7 @@ draft는 `IntegrationEventDrafts.draft(contract, eventId, aggregate, order, occu 만든다(`src/application-core/src/main/java/dev/caskeleton/application/messaging/event/IntegrationEventDrafts.java`). 계약 id·payload 버전·목적지는 계약에서 오고, 기능이 정하는 것은 aggregate·순서·payload뿐이다. `new IntegrationEventDraft<>(…)`를 직접 쓰면 빌드가 막는다(`INTEGRATION_EVENT_DRAFTS_ARE_BUILT_BY_THE_SHARED_HELPER`). -예: sample `PortfolioEventOutbox`, `SubmitDurableOperationUseCase`. +예: `SubmitDurableOperationUseCase`. - event id: 정규 소문자 UUIDv7, 소비자 중복 제거 키. draft(`IntegrationEventDraft`)가 다른 값(대문자, v4, `event-1` 같은 문자열)을 거부하므로 업무 쓰기에서 바로 실패한다 — 커밋된 뒤 relay에서 DEAD가 되지 diff --git a/docs/manual/README.md b/docs/manual/README.md index ea2ce530..47d7cc38 100644 --- a/docs/manual/README.md +++ b/docs/manual/README.md @@ -55,13 +55,13 @@ ## 따라 할 예시는 하나 -예시가 셋(sample-portfolio 수직, onboarding fixture, durable operation)이라 어느 것을 베끼느냐에 따라 -배치가 달라졌다(2026-11-01 성숙도 리뷰). 이제 **새 업무 기능의 예시는 생성 명령의 출력 하나**다. +예시가 셋(한 leaf에 모든 계층을 둔 샘플 모듈, onboarding fixture, durable operation)이라 어느 것을 베끼느냐에 따라 +배치가 달라졌다(2026-11-01 성숙도 리뷰). 이제 **새 업무 기능의 예시는 생성 명령의 출력 하나**다. 샘플 모듈은 +2026-11-07에 지웠다. | 코드 | 역할 | 따라 하나 | | --- | --- | --- | | `scripts/new-feature.sh` 출력 | 계층 leaf에 나눈 업무 기능 | **이것을 따른다** | -| `src/sample-portfolio` | 한 leaf에 모든 계층을 둔 지울 수 있는 샘플. 개별 기법(조건부 PATCH, 페이지, outbox, DB 유일성 제약)의 참고 | 기법만 본다. 배치는 따르지 않는다 | | `src/app-bootstrap/src/test/java/dev/caskeleton/onboarding/**` | ArchUnit 규칙이 새 기능 모양에 적용되는지 확인하는 테스트 fixture | 따르지 않는다 | | `application-core/.../operation` + `DurableOperationAutoConfiguration`(composition:durable-operation) | 템플릿 플랫폼 기능 | 조립 모양(`@ConditionalOnBean` + 유스케이스 `@Bean`)만 본다 | @@ -74,12 +74,12 @@ | Envelope는 null 필드를 내보내지 않는다 | `docs/web/http-contract.md` 1절 | 06 | | 처리 중 409 `IDEMPOTENT_IN_FLIGHT`는 `retryable=true` + `Retry-After: 2`, 같은 키로 재전송 | `docs/web/http-contract.md` 2절 | 05 | | 커밋 중 연결이 끊기면 재시도 가능이 아니라 결과 불명(`DB_COMPLETION_UNKNOWN`, 500) | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/failure/PersistenceExceptionTranslator.java`, `docs/adr/ADR-JPA-003-completion-unknown.md` | 05 | -| 중복 규칙은 조회 후 insert가 아니라 DB 유일성 제약, 위반은 같은 409로 변환 | `src/sample-portfolio/src/main/resources/db/sample-migration/V8_1__poster_title_unique.sql`, `PosterRepositoryAdapter` | 04 | +| 중복 규칙은 조회 후 insert가 아니라 DB 유일성 제약, 위반은 같은 409로 변환 | 04장 「중복·경쟁은 DB가 막는다」(템플릿 코드에 예 없음) | 04 | | 여러 인스턴스가 집는 작업은 lease 있는 claim | `ReconciliationJobStorePort.claimDue`(application-notification) | 04 | | 양방향 연관관계 금지를 ArchUnit으로 | `JpaArchitectureRules.associationsAreMappedFromOneSideOnly()` | 04 | | store는 호출자 트랜잭션을 요구한다 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/CallerTransaction.java` | 04 | | `@RequiresPermission` 검사는 인증 체인과 분리된 자동 설정 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebMethodSecurityAutoConfiguration.java` | 07 | | JWT audience 필수, 자기 client role만 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/auth/JwtDecoderConfig.java`, `docs/runbooks/auth-audience-mismatch.md` | 07 | | strict lane은 반드시 어떤 단계에 속한다 | `verifyStrictLaneStages`(`src/build.gradle` `strictLaneStages`) | 08 | -| 샘플 마이그레이션은 별도 history table, 번호는 운영과 겹치지 않게 | `SamplePostgreSqlPersistenceConfig`, `V8_1__…` | 04 | +| 서비스 마이그레이션은 별도 history table, 번호는 운영과 겹치지 않게 | `NotificationSchemaStream`(persistence-notification) | 04 | | 재시도 가능한 broker 거부는 DEAD가 아니라 재시도 | `docs/runbooks/outbox-dead-letter.md` | 09 | diff --git a/docs/registries/env-keys.yaml b/docs/registries/env-keys.yaml index 954205da..3c5e8954 100644 --- a/docs/registries/env-keys.yaml +++ b/docs/registries/env-keys.yaml @@ -2631,8 +2631,8 @@ env_keys: required_test: cache-contract:redis-soft-hard-ttl-order - name: APP_CACHE_REDIS_TTL_JITTER - # DEPRECATED 2026-11-02: no settings class binds it. Its only reader was a block in - # sample-portfolio's application.yml that nothing bound either (07-10), removed with it. + # DEPRECATED 2026-11-02: no settings class binds it. Its only reader was a block in the + # sample module's application.yml that nothing bound either (07-10), removed with it. # Kept so a deployment still setting it is told it does nothing. deprecated_orphaned: true removal_deadline: 2027-02-28 diff --git a/docs/runbooks/outbox-dead-letter.md b/docs/runbooks/outbox-dead-letter.md index 0e6b4375..4799c29c 100644 --- a/docs/runbooks/outbox-dead-letter.md +++ b/docs/runbooks/outbox-dead-letter.md @@ -152,7 +152,7 @@ rolling 중 옛 버전이 방금 쓴 번호(floor보다 초당 10⁶씩 큰 벽 소비자는 그 사이 새 이벤트를 버린다. 그래서 **tenant scope를 바꾸는 배포는 rolling으로 하지 않는다**: 옛 버전 인스턴스를 모두 멈춘 뒤(옛·새 버전이 함께 쓰는 구간 없이) 새 버전을 띄운다. -tenant scope를 바꾼 서비스(샘플은 `portfolio` → 단일 scope)는 배포 전에 옛 scope의 미발행 행이 +tenant scope를 바꾼 서비스(예: 기능별 scope → 단일 scope)는 배포 전에 옛 scope의 미발행 행이 없는지 확인한다. 옛 scope 행과 새 scope 행은 서로 다른 aggregate로 보여 claim gate가 서로를 막지 않고, partition key도 달라 다른 partition으로 간다. @@ -252,7 +252,7 @@ COMMIT; ``` Step 1을 다시 돌려 0행이면 배포한다. 정리와 배포 사이에 옛 버전이 새 중복을 만들 수 있다(벽시계로 -순서 번호를 만든 샘플 코드가 그 원인이었다). 그래도 V21은 실패하고 롤백될 뿐이니 Step 1부터 다시 한다. +순서 번호를 만든 옛 코드가 그 원인이었다). 그래도 V21은 실패하고 롤백될 뿐이니 Step 1부터 다시 한다. `outbox_event_v21_duplicates`는 확인이 끝나면 지운다. 확인 쿼리, 정리 SQL, Step 0의 인덱스 SQL은 이 문서에서 그대로 읽어 실제 PostgreSQL에서 실행하는 diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index b0398c6c..79dd2d15 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -4,7 +4,7 @@ - 커밋: `34565130` High·P1 19건 · `1400dc15` 남은 발견·매뉴얼·생성 명령 · `5786126c` 남은 항목과 합친 뒤 결함 · `7ef8d0b4` 재리뷰 기록 · `bbe944bd` 재리뷰 결함 · `ecc74b7d` 2차 재리뷰 기록·이 안내 · `1885bf8d` 2차 재리뷰 결함 · `339cf8fd` 3차 확인 리뷰 기록 · `f40c03c6` 3차 확인 리뷰 Minor · `c2e55510` 마지막 확인 리뷰 기록 · - `2678955c` 테스트 코드 정적 분석(B-40) · `70fb80bf` 소유자가 다시 정한 기본값 3가지(늦은 멱등 완료 기록, `failure-retention` 기동 검사, workflow `cd`) · B4 성능 lane 단언 상시화(2026-11-06, B-43) · `paths` 필터 trigger를 단계 실행으로 세지 않음(2026-11-06 소유자 결정, B-36) · r8-f1 전송 오류 처리(2026-11-07, B-45~B-48) · r9-g1 GraphQL 판정 순서와 인자 변환 단계(2026-11-07 소유자 결정, B-45·B-46) · 태그 push·`release` workflow는 `releaseCheck`에만 셈(2026-11-07 소유자 결정, B-36) · 실패한 동시 인덱스 drop의 복구 절차(2026-11-07, 재리뷰 RR8-03-01, 5절) · STOMP channel interceptor를 사용자 전송으로 셈(2026-11-07, B-16) · 멱등 저장소의 markFailed 재전송 인자와 renew 뒤 start(2026-11-07 소유자 결정, 5절) — `docs(...)` 커밋은 문서만 바꾼다 + `2678955c` 테스트 코드 정적 분석(B-40) · `70fb80bf` 소유자가 다시 정한 기본값 3가지(늦은 멱등 완료 기록, `failure-retention` 기동 검사, workflow `cd`) · B4 성능 lane 단언 상시화(2026-11-06, B-43) · `paths` 필터 trigger를 단계 실행으로 세지 않음(2026-11-06 소유자 결정, B-36) · r8-f1 전송 오류 처리(2026-11-07, B-45~B-48) · r9-g1 GraphQL 판정 순서와 인자 변환 단계(2026-11-07 소유자 결정, B-45·B-46) · 태그 push·`release` workflow는 `releaseCheck`에만 셈(2026-11-07 소유자 결정, B-36) · 실패한 동시 인덱스 drop의 복구 절차(2026-11-07, 재리뷰 RR8-03-01, 5절) · STOMP channel interceptor를 사용자 전송으로 셈(2026-11-07, B-16) · 멱등 저장소의 markFailed 재전송 인자와 renew 뒤 start(2026-11-07 소유자 결정, 5절) · 저장소 구조 정리(2026-11-07 소유자 결정, 3.6절 B-49~) — `docs(...)` 커밋은 문서만 바꾼다 - 근거 문서: `docs/reviews/2026-11-01-maturity-review/README.md` 13~16절, `docs/reviews/2026-11-03-rereview/README.md` 4·6·8~13절, 각 커밋의 `BREAKING CHANGE:` 꼬리말 - 아래 표의 각 줄은 위 범위의 diff와 코드로 확인했다. 확인하지 못한 것은 그 자리에 "확인 못 함"으로 적었고 9절에 @@ -60,7 +60,7 @@ | B-05 | 알림: `ReconciliationJobStorePort.claimDue(int, Instant)` → `claimDue(int limit, Instant now, Duration lease)`. `ReconciliationJob`에 `long claimFence` 필드 추가. `reschedule`·`complete`는 fence가 다르면 아무것도 안 바꾼다 | 직접 구현한 store·job 생성 코드 컴파일 오류 | lease 인자를 받고, claim마다 fence를 올리고, 쓰기에 fence 조건을 건다. 계약은 `application-notification` testFixtures의 공유 계약 테스트로 확인 | `34565130`, `bbe944bd` · `src/application-notification/.../dispatch/ReconciliationJobStorePort.java` | | B-06 | 파일 서버: `CleanupQueuePort.claimDue(Instant, int)` → `claimDue(Instant, int, Duration lease)`, `markAbandoned(CleanupItem, String reasonCode)` 추가. `CleanupItem`에 `UUID claimToken` 필드 추가. `FileQuotaPort.usedBytes(QuotaScope)` 추가. `UploadContentPort.releaseLease(UploadSession, RequestContext)` 삭제 | 직접 구현한 포트·`CleanupItem` 생성 코드 컴파일 오류 | 새 메서드 구현, `releaseLease` 호출 제거 | `1400dc15`(cleanup), `5786126c`(quota·upload) · `src/application-fileserver/.../cleanup/CleanupQueuePort.java`, `.../api/metadata/FileQuotaPort.java`, `.../upload/UploadContentPort.java` | | B-07 | 패키지 이동: `dev.caskeleton.application.outbound.SecretSourcePort`·`SecretReference` → `dev.caskeleton.application.secret.*`. `dev.caskeleton.application.outbound.CallBudget` → `dev.caskeleton.application.objectstorage.content.CallBudget`(leaf `application-objectstorage`). `application.outbound` 패키지 삭제 | `package dev.caskeleton.application.outbound does not exist` | import를 바꾼다. `CallBudget`을 쓰는 leaf가 `application-objectstorage`에 의존해도 되는지 `modules.json` 간선을 확인 | `5786126c` · `src/application-core/.../secret/`, `src/application-objectstorage/.../content/CallBudget.java` | -| B-08 | `shared-contract`에서 `dev.caskeleton.shared.operation.Operation`·`OperationStatus` 삭제. sample-portfolio(`...sample.portfolio.adapter.inbound.web.operation`)로 옮겨졌다 | import 실패 | 쓰고 있었다면 자기 inbound adapter로 복사한다 | `1400dc15` · `src/shared-contract/src/main/java/dev/caskeleton/shared/operation/`(삭제) | +| B-08 | `shared-contract`에서 `dev.caskeleton.shared.operation.Operation`·`OperationStatus` 삭제. 샘플 모듈로 옮겼다가 샘플과 함께 지웠다(B-49) | import 실패 | 쓰고 있었다면 자기 inbound adapter로 복사한다 | `1400dc15` · `src/shared-contract/src/main/java/dev/caskeleton/shared/operation/`(삭제) | | B-09 | `SecuritySettings`(adapter:inbound:web): `audience`가 `String` → `List`. `@ConfigurationProperties` 제거, `SecuritySettings.bind(Environment)`로 strict 바인딩. 생성자 `(String, String, List)` → `(String, List, List)`. `bootstrap.security.AuthenticationModeSettings` 삭제 | `audience()`를 문자열로 쓰는 코드, 직접 생성하는 테스트 컴파일 오류 | `List`으로 바꾼다. 인증 모드는 `SecuritySettings.authMode()`에서 읽는다 | `34565130`(List), `5786126c`(strict·삭제) · `src/adapter/inbound/web/.../settings/SecuritySettings.java` | | B-10 | adapter 공개 타입 삭제·이동: graphql `execution.GraphQlTimeoutPolicy`·`dataloader.GraphQlDataLoaderRequestRegistry` 삭제(`runtime.GraphQlDeadlineInstrumentation`·`GraphQlPerParentFetchInstrumentation` 추가). jpa `experimental.tenant.TenantId` 삭제 → `dev.caskeleton.application.tenant.TenantId`. persistence-notification의 엔티티는 `...platform.entity`, 저장소는 `...platform.repository`로 이동, `inbox` 하위 클래스는 `platform`으로 올라옴, `PreferenceJpaRepository`·`SuppressionJpaRepository` 삭제, `JpaNotificationSideEffect` → application-notification `dispatch.SuppressionSideEffect`. graphql `GraphQlClientPolicy.effectivePageSize(Integer, Integer)` 삭제 → `pagination.GraphQlConnectionPolicy.effectivePageSize`(상한 검사 포함, 재리뷰 RR-01-14). grpc(optional-platforms) `GrpcOperationLedger.release(identity)` → `boolean release(identity, GrpcClaimToken)`: 진행 중이고 그 token이 가진 claim만 지운다(RR-01-15) | import 실패, 호출부·직접 구현한 ledger 컴파일 오류. leaf `check`의 API surface 비교가 스냅샷과 달라 실패(자기 공개 타입을 더했다면 merge 충돌) | import를 바꾼다. 스냅샷 파일은 upstream 것을 받고 자기 추가분을 다시 승인한다 | `1400dc15`·`5786126c` · `docs/architecture/graphql-api-surface.txt`, `docs/architecture/jpa-api-surface.txt`(166→165), `docs/notification/api-surface-snapshot.txt`(362→364) | | B-11 | 조립·지원 타입: `bootstrap.autoconfigure.operation.DurableOperationConfig` → `composition:durable-operation`의 `composition.operation.DurableOperationAutoConfiguration`. `bootstrap.settings.LoggingSettings` 삭제. `composition.outbox.OutboxLeaderElectionToken` 삭제. `TracingSamplingEnvironmentPostProcessor` → `TracingEnvironmentPostProcessor`, `StartupOrder.TRACING_SAMPLING` → `TRACING_PROPERTIES`. `StartupRuleRunner(Environment, List)` → `StartupRuleRunner(Environment)`. `SecretSourceValidator(ConfigurableEnvironment, SecretSourcePort, List)` → `SecretSourceValidator(Supplier>)` | 이 타입을 참조하는 코드·테스트 컴파일 오류 | 새 이름으로 바꾼다 | `1400dc15`, `34565130`, `bbe944bd` · `src/composition/durable-operation/`, `src/adapter/outbound/support/.../startup/` | @@ -86,7 +86,7 @@ | B-24 | `APP_IDEMPOTENCY_PROCESSING_LEASE`는 2초(`IdempotencyExecutor.IN_FLIGHT_RETRY_AFTER`)보다 길어야 한다. `APP_IDEMPOTENCY_TTL`(replay TTL)은 그 lease보다 짧으면 안 된다(재리뷰 RR-03-11). `APP_IDEMPOTENCY_FAILURE_RETENTION`은 replay TTL보다 짧으면 안 된다(RR3-03-02) | 2초 이하면, replay TTL < lease면, 또는 failure retention < replay TTL이면 기동 실패(exit 78). 마지막은 메시지에 `failure-retention`·`replay-ttl` 두 키와 값이 나온다 | lease를 2초보다 길게(기본 30s), replay TTL을 lease 이상으로(기본 24h), failure retention을 replay TTL 이상으로(기본 24h — 기본값끼리는 그대로 뜬다) | `5786126c`, `bbe944bd`, 3차 수정, `70fb80bf`(2026-11-04 소유자 결정) · `src/composition/idempotency/.../IdempotencySettings.java` | | B-25 | 알림 콜백 본문 상한 65508 → 65251(바인딩에서 상한 검사) | `.env`에 옛 예제 값 `APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES=65508`이 있으면 기동 실패 `max-body-bytes must be 1..65251` | 값을 지우거나 65251 이하로 | `5786126c` · `src/adapter/outbound/notification/.../autoconfigure/NotificationPlatformSettings.java` | | B-26 | `config/module-defaults/`에 같은 이름 파일이 둘이거나, 두 파일이 같은 키를 실으면 기동 실패 | 기동 실패 `two capability modules ship config/module-defaults/` 또는 `... both ship `(exit 78) | 자기 leaf의 module-defaults 파일 이름·키가 템플릿 모듈과 겹치지 않게 한다 | `1400dc15` · `src/adapter/outbound/support/.../startup/ModuleDefaultsEnvironmentPostProcessor.java` | -| B-27 | (sample-portfolio를 남겨 둔 경우) 데모 계정은 활성 프로필이 모두 `local`·`test`·`demo` 중 하나일 때만. 프로필이 없어도 거부 | 기동 실패 `the sample's demo accounts authenticate only under the local, test or demo profile` | `SPRING_PROFILES_ACTIVE=demo`(이미지·jar), `local`(bootRun)로 띄우거나 sample 보안 설정을 지운다. 세 프로필 모두 sample `application.yml`이 object storage를 끈다(RR2-04-02) | `5786126c`, `bbe944bd` · `src/sample-portfolio/.../security/SampleDemoAccountsProductionGuard.java` | +| B-27 | **샘플 삭제(B-49)로 템플릿에서 사라졌다. 받을 변경이 없다.** (sample-portfolio를 남겨 둔 경우) 데모 계정은 활성 프로필이 모두 `local`·`test`·`demo` 중 하나일 때만. 프로필이 없어도 거부 | 기동 실패 `the sample's demo accounts authenticate only under the local, test or demo profile` | `SPRING_PROFILES_ACTIVE=demo`(이미지·jar), `local`(bootRun)로 띄우거나 sample 보안 설정을 지운다. 세 프로필 모두 sample `application.yml`이 object storage를 끈다(RR2-04-02) | `5786126c`, `bbe944bd` · `src/sample-portfolio/.../security/SampleDemoAccountsProductionGuard.java` | ### 3.3 HTTP wire — 응답이 달라진다 @@ -111,7 +111,7 @@ |---|---|---|---|---| | B-34 | 템플릿 패키지 규칙(ArchUnit): `FEATURE_PACKAGES_DO_NOT_REUSE_TEMPLATE_PACKAGE_NAMES`, `TEMPLATE_PACKAGES_DO_NOT_DEPEND_ON_FEATURE_PACKAGES`. 템플릿 이름: application `usecase command query capability transaction security tenant observability secret messaging outbox idempotency operation lease lock cache realtime notification fileserver objectstorage`, domain `identifier stereotype` | 기능 패키지 이름이 이 목록과 겹치거나(예: `domain.lock`), 업무 코드를 템플릿 패키지(예: `application.usecase.*`)에 두고 기능 패키지를 import하면 `:app-bootstrap:architectureTest` 실패 | 기능 패키지 이름을 바꾸고, 업무 코드를 `dev.caskeleton.application.`로 옮긴다. 규칙 정본은 `src/application-core/CLAUDE.md` "Package ownership" | `5786126c`, r9 · `src/app-bootstrap/src/test/.../TemplatePackageOwnership.java`(표와 대조: `TemplatePackageOwnershipDocumentTest`) | | B-35 | JPA 규칙: 양방향 연관은 한쪽에서만 매핑(`mappedBy`), notification·fileserver 저장소 엔티티는 그 leaf 안에서만, `@Version` 엔티티의 bulk update는 version을 올려야 함 | 위반 엔티티·쿼리가 있으면 architectureTest 실패 | 매핑·쿼리를 고친다 | `34565130`, `1400dc15`, `bbe944bd` · `src/app-bootstrap/src/architectureTest/.../JpaProductionArchitectureTest.java` | -| B-36 | 빌드 검사 강화: `modules.json`에 없는 `build.gradle`이 있으면 `verifyCleanArchitectureDependencies` 실패. `verifyStrictLaneStages --dry-run`은 모든 strict lane이 workflow가 실행하는 단계(`:ci` `:sample-portfolio:check` `:mainCheck` `:integrationCheck` `:performanceCheck` `:releaseCheck`)에 속해야 하고 `.github/workflows`를 읽는다. 명령의 빌드는 `working-directory`(단계·job·workflow `defaults`)에서 시작해 같은 `run:` 셸이 그 앞에서 실행한 `cd <상대 경로>`(`cd src && ./gradlew …`, `cd src; ./gradlew …`, 앞 줄의 `cd src`)를 따라간 뒤 `-p`를 붙인 디렉터리로 정하고(`70fb80bf`(2026-11-04 소유자 결정)), `workflow_dispatch`로만 시작하는 workflow의 명령은 세지 않으며, 축약한 `-x`도 Gradle처럼 맞춰 본다(RR2-04-04). 붙여 쓴 `-x`·`-p`도 Gradle처럼 읽는다(RR3-04-02). `run:` 스크립트를 bash 문법으로 읽고(heredoc·여러 줄 문자열·함수 본문 안의 `cd`는 따라가지 않음), 세지 않는 명령은 이유를 셋으로 나눠 적는다(r10). (1) 실패해도 단계가 실패하지 않을 수 있음: `\|\| exit <0 아닌 값>` 밖의 `\|\|`(`\|\| true` 등), pipefail 없는 파이프 왼쪽, `!`, `&`, `if`·`while` 조건, 스크립트 마지막이 아닌 `&&` 목록의 앞쪽, `set +e` 뒤, `exit 0` 하는 `EXIT`·`ERR` trap 뒤. (2) 돌지 않을 수 있음: `\|\|` 뒤, 마지막이 아닌 `&&` 목록의 뒤쪽, `if`·`while`·`for`·`case`·함수 본문 안, 최상위 `exit`·`exec <명령>`·`set -n` 뒤, 조건부이거나 부른 함수 안의 `exit 0`·인자 없는 `exit`·값을 모르는 `exit`·`exec`·`set -n` 뒤, 요청으로만 시작하는 workflow(`workflow_dispatch`·`repository_dispatch`·`issue_comment`·`types: [labeled]`인 `pull_request`·`workflow_run` 등; `push`·`pull_request`·`pull_request_target`·`merge_group`·`schedule`·`release`는 센다), change trigger가 모두 `paths`·`paths-ignore` 필터를 단 workflow(그 경로 밖 변경에는 돌지 않는다, 2026-11-06 소유자 결정), `releaseCheck` 밖의 단계에서는 태그 push(`branches` 없는 `tags`·`tags-ignore`)나 `release`로만 시작하는 workflow(2026-11-07 소유자 결정), 세는 job이 `uses: ./.github/workflows/<파일>`로 부르지 않는 `workflow_call` 재사용 workflow, 조건부이거나 `continue-on-error`인 job을 `needs`로 기다리는 job(자기 `if:`가 `always()`·`!cancelled()`면 센다). (3) 실패하면 단계도 실패하지만 검사가 읽지 않음: `\|\| exit 1`·`\|\| { …; exit 1; }`, `{ }`·`( )`·`$( )`·`bash -c` 안, 다른 명령의 인자인 `gradlew`(`timeout 60 ./gradlew`), `bash`·`sh`가 아닌 `shell:`, `shell:` 없이 Windows일 수 있는 runner(Windows 라벨, `${{ matrix.os }}` 같은 식, `linux`·`macos` 라벨 없는 self-hosted)에서 도는 단계 — 기본 셸이 `pwsh`다(Linux·macOS runner의 기본은 `bash -e`, `container:` job은 `sh -e`이고 둘은 같게 읽는다). Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-m`·`-v`·`--version`·`-h`·`-?`·`--help`·`--status`·`--stop`·`--foreground`, 묶음 `-qm`·`-qv` 포함)과 Gradle이 거부하는 짧은 옵션 묶음(`-mx`)·값을 받지 않는 옵션에 붙인 값(`-m=yes`)도 세지 않는다. 판독기의 Gradle 옵션 표는 `GradleCommandLineTest`가 build-logic을 돌리는 Gradle의 `--help`와 대조하므로, Gradle을 올려 옵션이 늘면(9.2의 `--task-graph`) 그 테스트가 실패한다. 단계를 부르지만 세지 않은 명령은 다른 빌드로 읽힌 것까지 실패 메시지에 이유와 함께 적는다(r9). `verifyEnvKeys`: lane 계약 json의 `APP_` 밖 키는 `SPRING_`·`MANAGEMENT_`·`SERVER_`이거나 `secret://…/`가 가리키는 변수여야 하고, 레지스트리 `property:` 행은 그 property가 설정 metadata에 있어야 읽히는 것으로 친다(`@ConditionalOnProperty`로만 읽는 스위치는 `META-INF/additional-spring-configuration-metadata.json`에 선언, RR2-04-05). SpotBugs 신뢰도 HIGH → MEDIUM | 등록 안 한 leaf, 단계에 안 걸린 자기 lane, 자기 코드의 MEDIUM 발견이 `ci`·`qualityCheck`를 막는다. `working-directory: src`도 `cd src`도 없이 `./gradlew`를 부르는 자기 workflow 단계는 실행으로 세지 않는다. 확실히 따라갈 수 없는 디렉터리 이동(`cd "$VAR"`, `cd -`, `cd ~`, 절대 경로, `pushd`, `if`/`for`/`case`·`{ }`·서브셸 안의 `cd`, `||`·`|`로 이은 `cd`, 다른 명령과 `&&`로 묶인 `cd` 다음 줄) 뒤의 명령도 세지 않고, 실패 메시지에 그 명령과 이유를 적는다. 단계를 `./gradlew ci \| tee log`(기본 셸), `./gradlew ci \|\| true`, `./gradlew ci \|\| exit 1`, `if ./gradlew ci; then` 같은 모양으로만 부르거나, 조건부 `exit 0` 뒤, `-v`·`--help`를 붙여, 요청형 trigger·`paths` 필터 trigger로만 시작하는 workflow·`releaseCheck`가 아닌 단계를 태그 push·`release`로만 시작하는 workflow·호출되지 않는 `workflow_call` workflow·조건부 job을 `needs`로 기다리는 job·`shell:` 없는 Windows runner에서만 부르는 자기 workflow도 실패한다 | leaf를 등록하거나 지운다. 자기 lane은 단계에 건다. 단계를 부르는 workflow 명령에 `working-directory`를 두거나 같은 셸에서 `cd <상대 경로>`로 옮긴 뒤 부른다. 단계 명령은 혼자 한 줄로 두고, 로그를 파이프로 남기려면 `shell: bash`나 앞 줄 `set -o pipefail`을 둔다. Windows runner에서는 `shell: bash`를 둔다. 단계는 매 push·pull request·schedule에 도는(`paths`·`paths-ignore` 필터 없는) workflow와 job에서(`releaseCheck`만 태그 push·`release` workflow에서), 재사용 workflow라면 그런 job이 조건 없이 부르게 한다. Gradle을 올려 `GradleCommandLineTest`가 실패하면 새 옵션을 값 옵션·플래그·작업 없이 끝나는 옵션 중 하나로 판독기 표에 넣는다. SpotBugs 발견은 고치거나 이유를 단 제외로 | `1400dc15`, `34565130`, `bbe944bd`, `5786126c`, `70fb80bf`(2026-11-04 소유자 결정), r9, r10(RR6-04-01~06), RR7-05-01(2026-11-06 소유자 결정), 태그·릴리스 workflow(2026-11-07 소유자 결정) · `src/build-logic/.../ModuleRegistry.java`, `.../strictlane/StrictLaneStagesPlugin.java`, `.../strictlane/WorkflowGradleInvocations.java`, `.../strictlane/ShellScript.java`, `.../strictlane/GradleCommandLineTest.java`(test), `.../quality/QualityConventionsPlugin.java`, `src/build.gradle` | +| B-36 | 빌드 검사 강화: `modules.json`에 없는 `build.gradle`이 있으면 `verifyCleanArchitectureDependencies` 실패. `verifyStrictLaneStages --dry-run`은 모든 strict lane이 workflow가 실행하는 단계(`:ci` `:mainCheck` `:integrationCheck` `:performanceCheck` `:releaseCheck`)에 속해야 하고 `.github/workflows`를 읽는다. 명령의 빌드는 `working-directory`(단계·job·workflow `defaults`)에서 시작해 같은 `run:` 셸이 그 앞에서 실행한 `cd <상대 경로>`(`cd src && ./gradlew …`, `cd src; ./gradlew …`, 앞 줄의 `cd src`)를 따라간 뒤 `-p`를 붙인 디렉터리로 정하고(`70fb80bf`(2026-11-04 소유자 결정)), `workflow_dispatch`로만 시작하는 workflow의 명령은 세지 않으며, 축약한 `-x`도 Gradle처럼 맞춰 본다(RR2-04-04). 붙여 쓴 `-x`·`-p`도 Gradle처럼 읽는다(RR3-04-02). `run:` 스크립트를 bash 문법으로 읽고(heredoc·여러 줄 문자열·함수 본문 안의 `cd`는 따라가지 않음), 세지 않는 명령은 이유를 셋으로 나눠 적는다(r10). (1) 실패해도 단계가 실패하지 않을 수 있음: `\|\| exit <0 아닌 값>` 밖의 `\|\|`(`\|\| true` 등), pipefail 없는 파이프 왼쪽, `!`, `&`, `if`·`while` 조건, 스크립트 마지막이 아닌 `&&` 목록의 앞쪽, `set +e` 뒤, `exit 0` 하는 `EXIT`·`ERR` trap 뒤. (2) 돌지 않을 수 있음: `\|\|` 뒤, 마지막이 아닌 `&&` 목록의 뒤쪽, `if`·`while`·`for`·`case`·함수 본문 안, 최상위 `exit`·`exec <명령>`·`set -n` 뒤, 조건부이거나 부른 함수 안의 `exit 0`·인자 없는 `exit`·값을 모르는 `exit`·`exec`·`set -n` 뒤, 요청으로만 시작하는 workflow(`workflow_dispatch`·`repository_dispatch`·`issue_comment`·`types: [labeled]`인 `pull_request`·`workflow_run` 등; `push`·`pull_request`·`pull_request_target`·`merge_group`·`schedule`·`release`는 센다), change trigger가 모두 `paths`·`paths-ignore` 필터를 단 workflow(그 경로 밖 변경에는 돌지 않는다, 2026-11-06 소유자 결정), `releaseCheck` 밖의 단계에서는 태그 push(`branches` 없는 `tags`·`tags-ignore`)나 `release`로만 시작하는 workflow(2026-11-07 소유자 결정), 세는 job이 `uses: ./.github/workflows/<파일>`로 부르지 않는 `workflow_call` 재사용 workflow, 조건부이거나 `continue-on-error`인 job을 `needs`로 기다리는 job(자기 `if:`가 `always()`·`!cancelled()`면 센다). (3) 실패하면 단계도 실패하지만 검사가 읽지 않음: `\|\| exit 1`·`\|\| { …; exit 1; }`, `{ }`·`( )`·`$( )`·`bash -c` 안, 다른 명령의 인자인 `gradlew`(`timeout 60 ./gradlew`), `bash`·`sh`가 아닌 `shell:`, `shell:` 없이 Windows일 수 있는 runner(Windows 라벨, `${{ matrix.os }}` 같은 식, `linux`·`macos` 라벨 없는 self-hosted)에서 도는 단계 — 기본 셸이 `pwsh`다(Linux·macOS runner의 기본은 `bash -e`, `container:` job은 `sh -e`이고 둘은 같게 읽는다). Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-m`·`-v`·`--version`·`-h`·`-?`·`--help`·`--status`·`--stop`·`--foreground`, 묶음 `-qm`·`-qv` 포함)과 Gradle이 거부하는 짧은 옵션 묶음(`-mx`)·값을 받지 않는 옵션에 붙인 값(`-m=yes`)도 세지 않는다. 판독기의 Gradle 옵션 표는 `GradleCommandLineTest`가 build-logic을 돌리는 Gradle의 `--help`와 대조하므로, Gradle을 올려 옵션이 늘면(9.2의 `--task-graph`) 그 테스트가 실패한다. 단계를 부르지만 세지 않은 명령은 다른 빌드로 읽힌 것까지 실패 메시지에 이유와 함께 적는다(r9). `verifyEnvKeys`: lane 계약 json의 `APP_` 밖 키는 `SPRING_`·`MANAGEMENT_`·`SERVER_`이거나 `secret://…/`가 가리키는 변수여야 하고, 레지스트리 `property:` 행은 그 property가 설정 metadata에 있어야 읽히는 것으로 친다(`@ConditionalOnProperty`로만 읽는 스위치는 `META-INF/additional-spring-configuration-metadata.json`에 선언, RR2-04-05). SpotBugs 신뢰도 HIGH → MEDIUM | 등록 안 한 leaf, 단계에 안 걸린 자기 lane, 자기 코드의 MEDIUM 발견이 `ci`·`qualityCheck`를 막는다. `working-directory: src`도 `cd src`도 없이 `./gradlew`를 부르는 자기 workflow 단계는 실행으로 세지 않는다. 확실히 따라갈 수 없는 디렉터리 이동(`cd "$VAR"`, `cd -`, `cd ~`, 절대 경로, `pushd`, `if`/`for`/`case`·`{ }`·서브셸 안의 `cd`, `||`·`|`로 이은 `cd`, 다른 명령과 `&&`로 묶인 `cd` 다음 줄) 뒤의 명령도 세지 않고, 실패 메시지에 그 명령과 이유를 적는다. 단계를 `./gradlew ci \| tee log`(기본 셸), `./gradlew ci \|\| true`, `./gradlew ci \|\| exit 1`, `if ./gradlew ci; then` 같은 모양으로만 부르거나, 조건부 `exit 0` 뒤, `-v`·`--help`를 붙여, 요청형 trigger·`paths` 필터 trigger로만 시작하는 workflow·`releaseCheck`가 아닌 단계를 태그 push·`release`로만 시작하는 workflow·호출되지 않는 `workflow_call` workflow·조건부 job을 `needs`로 기다리는 job·`shell:` 없는 Windows runner에서만 부르는 자기 workflow도 실패한다 | leaf를 등록하거나 지운다. 자기 lane은 단계에 건다. 단계를 부르는 workflow 명령에 `working-directory`를 두거나 같은 셸에서 `cd <상대 경로>`로 옮긴 뒤 부른다. 단계 명령은 혼자 한 줄로 두고, 로그를 파이프로 남기려면 `shell: bash`나 앞 줄 `set -o pipefail`을 둔다. Windows runner에서는 `shell: bash`를 둔다. 단계는 매 push·pull request·schedule에 도는(`paths`·`paths-ignore` 필터 없는) workflow와 job에서(`releaseCheck`만 태그 push·`release` workflow에서), 재사용 workflow라면 그런 job이 조건 없이 부르게 한다. Gradle을 올려 `GradleCommandLineTest`가 실패하면 새 옵션을 값 옵션·플래그·작업 없이 끝나는 옵션 중 하나로 판독기 표에 넣는다. SpotBugs 발견은 고치거나 이유를 단 제외로 | `1400dc15`, `34565130`, `bbe944bd`, `5786126c`, `70fb80bf`(2026-11-04 소유자 결정), r9, r10(RR6-04-01~06), RR7-05-01(2026-11-06 소유자 결정), 태그·릴리스 workflow(2026-11-07 소유자 결정) · `src/build-logic/.../ModuleRegistry.java`, `.../strictlane/StrictLaneStagesPlugin.java`, `.../strictlane/WorkflowGradleInvocations.java`, `.../strictlane/ShellScript.java`, `.../strictlane/GradleCommandLineTest.java`(test), `.../quality/QualityConventionsPlugin.java`, `src/build.gradle` | | B-37 | app-bootstrap 테스트 lane 분리: 저장소 파일을 읽는 테스트는 태그 `document-contract`(main 단계) 또는 `repository-contract`(`check`)여야 하고, 일반 `test` lane에는 `ca.repository.root`가 없다 | app-bootstrap에 둔 자기 테스트가 저장소 파일을 읽으면 `test`에서 실패 | 태그를 단다 | `1400dc15` · `src/app-bootstrap/build.gradle` | | B-40 | 테스트 코드 정적 분석 `testQualityCheck`: SpotBugs·FindSecBugs를 main 밖 모든 source set(test, testFixtures, integrationTest, systemTest 등)에 돌린다. 테스트용 제외 목록은 `config/spotbugs/exclude-test.xml`(보안 범주·내부 상태 노출·생성자 예외·반환값 null 역참조·아키텍처 위반 fixture). 분석 classpath가 그 source set의 runtime classpath로 넓어졌고, 분석이 불완전하면(빠진 클래스) 실패한다. main 빌드는 `mainCheck`(`qualificationCheck`), optional 빌드는 `ci` | 자기 테스트 코드의 SpotBugs 발견(예: `CountDownLatch.await` 반환값 무시, 공유 변수 비원자 쓰기, 닫지 않은 `Statement`)이 main 단계를 막는다. 테스트 classpath에 없는 타입을 참조하면 `SpotBugs analysis incomplete` | 고치거나, 클래스·메서드로 좁힌 Match를 이유와 함께 `exclude-test.xml`에 더한다. 빠진 타입은 그 테스트 suite 의존성에 넣는다 | `2678955c` · `src/build-logic/.../quality/QualityConventionsPlugin.java`, `src/config/spotbugs/exclude-test.xml`, `src/build.gradle` | | B-42 | shared-contract 패키지 규칙 `SHARED_CONTRACT_CONTAINS_ONLY_OPERATIONAL_CONTRACT_PACKAGES`가 실제로 검사한다. 대상은 `dev.caskeleton.shared..`뿐이고, 허용은 목록의 패키지(`concurrency digest error metrics observability ratelimit request response retry runtime security tracing`)와 그 아래, 뿌리 패키지에는 `package-info`만이다. 전에는 뿌리를 허용 목록에 넣고 접두어로 비교해서 모듈 안은 아무것도 잡지 못했고, 다른 leaf의 `..shared..` 패키지를 잡았다 | `dev.caskeleton.shared`에 목록에 없는 패키지나 뿌리 클래스를 둔 파생 서비스는 architectureTest 실패. 다른 leaf의 `shared` 패키지는 더는 걸리지 않는다 | 업무 개념이면 그것을 소유하는 모듈로 옮긴다. 운영 계약이면 `ForbiddenApiArchitectureTest.SHARED_CONTRACT_PACKAGES`와 shared-contract CLAUDE.md 「Responsibility」에 함께 더한다 | r10 · `src/app-bootstrap/src/architectureTest/.../ForbiddenApiArchitectureTest.java`, `SharedContractPackageRuleTest.java` | @@ -124,6 +124,15 @@ |---|---|---|---|---| | B-38 | 새 leaf: `adapter-inbound-messaging`(`:adapter:inbound:messaging`, 이벤트 소비+inbox, 기본 조립에 없음), `composition-durable-operation`(`:composition:durable-operation`, `/operations`). 새 간선: `application-objectstorage`·`adapter-outbound-persistence-mongo`·`adapter-outbound-identifier`·`adapter-outbound-redis-sdk` → `shared-contract`, `adapter-inbound-web` → `adapter-outbound-support`, `sample-portfolio` → `adapter-outbound-support`, `app-bootstrap` → 두 새 leaf. 지운 간선: `composition-fileserver-platform` → `adapter-outbound-identifier`. `app-bootstrap/build.gradle`에 `runtimeOnly project(':composition:durable-operation')` 추가 | 자기 leaf를 더한 서비스는 `modules.json`·`app-bootstrap/build.gradle`에서 merge 충돌. 충돌을 풀다 durable-operation 줄을 빠뜨리면 `/operations` 조립이 없다(`DurableOperationConfig`가 app-bootstrap에서 빠졌기 때문) | 두 파일을 손으로 합친다. 합친 뒤 `architectureCheck`로 간선을 확인 | `1400dc15`, `5786126c` · `src/config/architecture/modules.json`, `src/app-bootstrap/build.gradle` | +### 3.6 저장소 배치 — 폴더·파일이 지워지거나 옮겨졌다 + +소유자 결정(2026-11-07, design-docs `repo-structure/README.md` 3.1절)으로 저장소 배치를 정리했다. 파생 서비스가 +고치지 않은 파일이면 병합이 그대로 지우거나 옮긴다. 고친 파일이면 "수정 대 삭제"나 이름 바뀜 충돌이 난다. + +| # | 무엇이 바뀌었나 | 파생 서비스 증상 | 할 일 | 근거 | +|---|---|---|---|---| +| B-49 | 샘플 모듈 삭제: `src/sample-portfolio`, `src/Dockerfile.sample`, registry `sample-portfolio` 행, 루트 `build.gradle`의 샘플 태스크·단계(`sampleWebContractCheck`, `:sample-portfolio:*` 의존, strict lane 단계 `:sample-portfolio:check`), `ci-quality-gates.yml`의 `sample-portfolio` job, `SampleRuntimeDefaultsContractTest`, spotbugs 제외의 샘플 클래스. 샘플에만 있던 검사(OpenAPI 스냅숏 `openapiCheckSnapshot`, Date 헤더, 가상 스레드 MDC 전파)도 함께 없어졌다 | 샘플을 고쳐 쓰던 서비스: 병합 때 "수정 대 삭제" 충돌. 샘플을 이미 지운 서비스: 충돌 없음 | 샘플을 이미 지웠으면 할 일 없음. 고쳐 쓰고 있으면 자기 leaf로 옮기고 registry 행·빌드 줄을 자기 것으로 둔다. 위 검사가 필요하면 자기 기능 leaf에 둔다 | 커밋 「샘플 모듈을 지운다」 | + ## 4. DB 마이그레이션 ### 4.1 새 버전과 영향 @@ -136,7 +145,7 @@ | notification (`flyway_jpa_notification_history`, notification-platform 선택 시) | V11 | `notification_reconciliation_job.claimed_until timestamptz`, `claim_fence bigint NOT NULL DEFAULT 0` + CHECK | 기존 job은 fence 0, lease 없음 | 그 표를 건드린 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V10에 남음(exit 70) | `34565130`, 3차 수정(RR-02-09) | | 〃 | V12 | `notification_suppression`의 `(tenant_id, normalized_target_hmac, reason)` 중복 행을 **삭제**(만료 없는 것 > 늦은 만료 > 이른 `effective_at` > 이른 `created_at` > 작은 id 순으로 하나 남김) 후 UNIQUE `uk_notification_suppression_target` | 지운 행의 `SuppressionId`는 더 이상 조회되지 않는다. 되돌리려면 백업 필요 | 그 표를 건드린 트랜잭션이 열려 있어 5초 안에 잠금(행 잠금 포함)을 못 잡으면 실패·롤백(삭제도 롤백), V11에 남음(exit 70) | `1400dc15`, 3차 수정(RR-02-09) | | 〃 | V13 | `notification_request.acceptance varchar(40) NOT NULL DEFAULT 'ACCEPTED'` + CHECK(`ACCEPTED`, `DROPPED_AS_DUPLICATE`) | 기존 요청은 모두 `ACCEPTED` | 그 표를 건드린 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V12에 남음(exit 70) | `5786126c`, 3차 수정(RR-02-09) | -| sample (`flyway_sample_schema_history`, sample-portfolio를 남긴 경우) | V8_1 | 유일 인덱스 `uq_poster_title_ci ON poster (upper(title))` | 없음 | 대소문자만 다른 제목이 있으면 `poster has titles that differ only by case or repeat: ...`로 실패. `poster`에 쓴 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V8에 남음 | `34565130`, 3차 수정(RR-02-09) | +| sample (`flyway_sample_schema_history`, sample-portfolio를 남긴 경우. **샘플 삭제(B-49)로 템플릿에서 사라졌다**) | V8_1 | 유일 인덱스 `uq_poster_title_ci ON poster (upper(title))` | 없음 | 대소문자만 다른 제목이 있으면 `poster has titles that differ only by case or repeat: ...`로 실패. `poster`에 쓴 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V8에 남음 | `34565130`, 3차 수정(RR-02-09) | | grpc-ledger (optional-platforms, history 표 확인 못 함) | V002 | 부분 인덱스 `ix_grpc_operation_ledger_finished_completed_at` (일반 `CREATE INDEX`) | 없음 | 큰 ledger면 만드는 동안 쓰기가 멈춘다. 파일 주석은 손으로 `CONCURRENTLY`를 먼저 돌리라고 한다. ledger에 쓴 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V001에 남음 | `1400dc15`, 3차 수정(RR-02-09) | | 〃 | V003 | `grpc_operation_ledger.claim_attempt BIGINT NOT NULL DEFAULT 1` + CHECK > 0 | 기존 행은 첫 시도(1) | ledger를 건드린 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V002에 남음 | `bbe944bd`, 3차 수정(RR-02-09) | @@ -162,7 +171,7 @@ 재리뷰 round7(RR7-03-05) 수정부터는 `.sql.conf`가 `executeInTransaction=true`를 정한 파일의 `VACUUM FULL`·비동시 `REINDEX SCHEMA|DATABASE|SYSTEM`도 앞의 `SET LOCAL`과 상관없이 같은 이유로 거부한다. 그런 파일은 PostgreSQL이 배포 때 `25001`로 거부하므로 배포된 적이 없다. 새로 걸리면 그 문장을 마이그레이션에서 빼 운영 절차로 옮긴다. -- **번호 충돌**: 템플릿이 이제 postgresql V20~V22, notification V11~V13, sample V8_1, grpc V002·V003을 쓴다. 파생 서비스가 같은 +- **번호 충돌**: 템플릿이 이제 postgresql V20~V22, notification V11~V13, grpc V002·V003을 쓴다(sample V8_1은 샘플과 함께 사라졌다, B-49). 파생 서비스가 같은 위치에 같은 번호를 두었다면 Flyway가 같은 버전 두 개로 실패한다. 자기 마이그레이션은 템플릿과 떨어진 번호대로 옮긴다 (이미 적용된 파일 이름을 바꾸면 checksum·history가 어긋나므로 운영 DB에 적용된 것이면 DB 담당과 정한다). - **migration-on-startup=false로 운영하는 서비스**: `infra/postgres/apply-capability-streams.sh`가 바뀌었다(stream을 @@ -252,7 +261,7 @@ V21 실패의 분류는 `docs/runbooks/migration-failed.md` "Classify the failur | 빌드 단계(HTTP client) | `httpClientFailureInjectionTest`(Toxiproxy 장애 주입)가 `mainCheck`에서 빠졌다. `integrationCheck`에만 있고, main push·nightly의 `integration-main.yml` `integration-check` job이 돌린다 | main push마다 같은 lane이 `main-check`·`integration-check` 두 job에서 두 번 돌던 것이 한 번이 된다. 로컬에서 `mainCheck`만 돌리면 이 lane은 돌지 않는다(`integrationCheck`로 돌린다) | r9 · `src/adapter/outbound/httpclient/build.gradle` | | 서버 로그(GraphQL·gRPC·STOMP) | carrier로 답한 실패를 web과 같은 줄(shared-contract `ServerFailureLog`)로 ERROR에 남긴다: persistence 실패는 분류만, 5xx carrier는 예외와 함께, 4xx carrier는 남기지 않는다. gRPC는 ` (method=…)`, GraphQL은 ` (executionId=…)`를 붙인다. gRPC는 인식 못 한 실패(`INTERNAL_ERROR`)도 `unhandled failure on …`로 남긴다. 클라이언트가 취소한 호출은 남기지 않고, 서비스가 `CANCELLED` status로 끝낸 살아 있는 호출은 남긴다. raw status는 넘겼든 던졌든 설명을 남기지 않는다(원인 예외가 있으면 그것만 붙인다). `IllegalArgumentException`(`BAD_PARAMETER`)은 web과 같은 WARN 한 줄 `request refused as BAD_PARAMETER by <예외 타입>`(메시지 없음)으로 남긴다. STOMP `@MessageMapping` 실패는 Spring의 `Unhandled exception from message handler method`(예외 전체) 대신 같은 줄로 남는다 | ERROR 로그가 늘어난다(전에는 gRPC가 아무것도 남기지 않았다). GraphQL·gRPC·STOMP는 잘못된 입력마다 WARN 한 줄이 생긴다. STOMP에서 Spring 문구로 경보를 걸었다면 고친다. `IDEMPOTENCY_RECOVERY_REQUIRED`의 scope digest를 모든 전송에서 찾을 수 있다(`docs/runbooks/idempotency-unavailable.md`) | r9 · `src/shared-contract/.../error/ServerFailureLog.java`, `GrpcExceptionHandlingInterceptor.java`, `GraphQlWireErrorMapper.java`, `StompHandlerFailureLog.java` | | 서버 로그(STOMP 거부·감싼 carrier, 2026-11-07) | `@MessageMapping` 앞에서 Spring이 거부한 메시지를 WARN 한 줄 `request refused as by <예외 타입>`으로 남긴다: 읽지 못한 payload(`MessageConversionException`)·비었거나 검증에 걸린 payload(`MethodArgumentNotValidException`)는 `VALIDATION_FAILED`, 변환되지 않는 `@DestinationVariable`·`@Header`(`ConversionFailedException`)는 `BAD_PARAMETER`. 전에는 ERROR에 예외 메시지(받은 JSON 조각·값)까지 남겼다. 응답을 쓰지 못한 변환 실패는 그대로 ERROR. 네 전송 모두 감싼 carrier를 그 carrier 줄로 남긴다(감싼 persistence 실패는 분류만, SQL 원인 없음) | ERROR 경보가 클라이언트의 잘못된 메시지에 울리지 않는다. 그 실패를 찾던 로그 검색은 WARN으로 바꾼다 | r8-f1(재리뷰 RR7-01-06·RR7-01-05) · `src/adapter/inbound/websocket/.../stomp/StompHandlerFailureLog.java`, `src/shared-contract/.../error/ServerFailureLog.java` `refused` | -| sample-portfolio | 익명 쓰기 401, 포스터 제목 대소문자 무시 유일(409 `POSTER_ALREADY_EXISTS`), 관리자도 남의 work log 수정 불가, 샘플 이벤트 tenant `global` | sample을 남긴 서비스만 | `34565130`, `1400dc15` | +| sample-portfolio | **샘플 삭제(B-49)로 템플릿에서 사라졌다.** 익명 쓰기 401, 포스터 제목 대소문자 무시 유일(409 `POSTER_ALREADY_EXISTS`), 관리자도 남의 work log 수정 불가, 샘플 이벤트 tenant `global` | sample을 남긴 서비스만 | `34565130`, `1400dc15` | | Flyway 잠금 | Flyway의 PostgreSQL 마이그레이션 잠금을 트랜잭션 대신 세션에 둔다. Spring Boot의 Flyway는 module-defaults `spring.flyway.postgresql.transactional-lock: false`, 템플릿이 직접 만드는 Flyway(멱등성·알림·sample stream, schema-per-tenant, testkit `MigrationContractRunner`)는 `FlywaySchemaPolicy.configure()`, messaging inbox stream은 같은 값을 직접 넣는다. 운영 코드의 `Flyway.configure()` 직접 호출과 설정 객체 직접 생성(`new FluentConfiguration()`·`new ClassicConfiguration()`·그 하위 클래스, round7 RR7-03-06)은 `JpaProductionArchitectureTest`가 거부한다 | Flyway 기본값에서는 동시 인덱스 마이그레이션이 Flyway 자신의 열린 트랜잭션을 기다려 끝나지 않았다. 이제 끝난다. 마이그레이션은 잠금을 잡은 연결 하나로 돈다. transaction 모드 PgBouncer 뒤에서는 잠금 해제가 다른 서버 연결로 가 다음 배포가 기다릴 수 있으니 마이그레이션은 직접 연결이나 session 모드 pool로 돌린다. 배포 도구는 이 repo 밖이라 2절 15번으로 맞춘다 | 재리뷰 round6 RR6-03-01 · `persistence-jpa.yml`, `.../migration/FlywaySchemaPolicy.java`, `docs/jpa/migration-guide.md` "Who may change the schema"·"Concurrent index builds" | | 실패한 동시 인덱스 마이그레이션 복구 | `docs/runbooks/migration-failed.md`에 「Recover a failed concurrent index migration」을 더했다: 진행 중인 빌드가 없는지 보고, 원인(중복 행, 문장을 붙잡던 열린 트랜잭션)을 정리하고, 실패한 빌드·재빌드가 남긴 무효 인덱스를 `DROP INDEX CONCURRENTLY`로 지우고, 그 버전의 실패 이력 행(`success = false`)만 지운 뒤 다시 배포한다. 실패한 문장이 `DROP INDEX CONCURRENTLY`면 남은 무효 인덱스는 지우지 않는다. 그 마이그레이션이 지우려던 인덱스라 다시 배포한 같은 문장이 지운다. 「Do not」의 이력 수정 금지에 이 한 가지 예외를 적었다. `flyway repair`는 계속 쓰지 않는다 | 전에는 안내가 "`DROP INDEX` 하나"였고, 그대로 하면 남은 실패 이력 때문에 다음 배포가 validate에서 다시 멈췄다. 실패한 drop의 인덱스를 손으로 지우면 다시 배포한 문장이 `42704`(없는 인덱스)로 또 실패한다. 동시 인덱스 마이그레이션을 쓰는 서비스의 운영자는 이 절차로 복구한다 | 재리뷰 round7 RR7-03-03, round8 RR8-03-01, 소유자 결정 2026-11-06 · `docs/jpa/migration-guide.md` "Concurrent index builds", `PostgreSqlConcurrentIndexMigrationIntegrationTest` | | 성능 lane(HTTP client·Mongo) | httpclient `LargeBodyResourceTest`의 힙 상한(32 MiB 스트리밍 중 힙 증가 16 MiB 미만)을 매번 단언한다. 전에는 `-Pperformance.assertions.enabled=true`일 때만 단언하고 아니면 건너뛴다는 줄만 찍었다. Mongo `MongoResourceBudgetLaneTest`는 표준 gate 전체(p99 500ms, pool 대기 250ms, 힙 512 MiB, examined/returned 10, spill 금지)를 Gradle 밖 실행에서도 단언한다(B-43) | 손으로 돌린 `performanceCheck`가 상한을 실제로 재므로, 전에는 통과하던 느린 기계에서 실패할 수 있다 | B4(2026-11-06) · `LargeBodyResourceTest`, `MongoResourceBudgetLaneTest` | @@ -264,7 +273,7 @@ V21 실패의 분류는 `docs/runbooks/migration-failed.md` "Classify the failur | 단계 | 할 일 | 게이트 | |---|---|---| -| 0. 준비 | 운영·스테이징 DB 백업. 작업 브랜치를 따로 만든다. 자기 마이그레이션 번호가 4.1절 번호와 겹치는지 본다. 운영 DB 사본에 4.3절 Step 1 쿼리(필요하면 V8_1 중복 제목 확인)를 돌려 둔다 | — | +| 0. 준비 | 운영·스테이징 DB 백업. 작업 브랜치를 따로 만든다. 자기 마이그레이션 번호가 4.1절 번호와 겹치는지 본다. 운영 DB 사본에 4.3절 Step 1 쿼리를 돌려 둔다 | — | | 1. merge·의존성 | `git fetch upstream` 후 merge. 충돌 예상 파일: `config/architecture/modules.json`, `app-bootstrap/build.gradle`, `docs/registries/env-keys.yaml`, `.env.example`, `application*.yml`, API surface 스냅샷, `gradle.lockfile`. 자기 의존성을 바꿨으면 `./gradlew ::resolveAndLockAll --write-locks` | `./gradlew verifyDependencyLocks` | | 2. 컴파일·아키텍처 | 3.1절(B-01~B-11) 고치기. 3.4절 규칙 위반 고치기 | `./gradlew architectureCheck`, `./gradlew :app-bootstrap:architectureTest`, 고친 leaf마다 `./gradlew :check` | | 3. PR 게이트 전체 | 자기 strict lane을 단계에 건다. SpotBugs MEDIUM 발견 처리 | `./gradlew ci`, `./gradlew verifyStrictLaneStages --dry-run` | diff --git a/docs/web/advanced-capabilities.md b/docs/web/advanced-capabilities.md index 96da4536..da72f415 100644 --- a/docs/web/advanced-capabilities.md +++ b/docs/web/advanced-capabilities.md @@ -2,7 +2,7 @@ The Advanced capabilities live in their own leaf, `adapter:inbound:web-advanced` (`src/adapter/inbound/web-advanced`, package `dev.caskeleton.adapter.inbound.web.advanced`). No -default composition carries it: `app-bootstrap` and `sample-portfolio` do not depend on it. A +default composition carries it: `app-bootstrap`은 이 leaf에 의존하지 않는다. A service that wants one of these capabilities adds the leaf as `implementation` in its own adapter leaf and calls the types directly. diff --git a/docs/web/repository-adaptation.md b/docs/web/repository-adaptation.md index c3b43f84..18458797 100644 --- a/docs/web/repository-adaptation.md +++ b/docs/web/repository-adaptation.md @@ -69,8 +69,9 @@ than silently absorbed. ## 5. Sample application -The design's `examples/web-platform-sample` is the existing `sample-portfolio` leaf, which already -carries the OpenAPI drift gate and the contract lanes the design's sample is specified to provide. +설계의 `examples/web-platform-sample`에 해당하는 모듈은 없다. 그 역할을 하던 샘플 leaf는 2026-11-07에 +지웠고, 그 안의 OpenAPI 드리프트 검사와 실서버 계약 lane도 함께 사라졌다. 예시는 `docs/manual/`과 +`scripts/new-feature.sh` 출력이 맡는다. ## 6. Idempotency: the design's store SPI is already owned by `application-core` diff --git a/docs/work/delegate.md b/docs/work/delegate.md index 045ec260..4a83e6ca 100644 --- a/docs/work/delegate.md +++ b/docs/work/delegate.md @@ -55,7 +55,7 @@ design-docs `conventions/delegation-loop.md` 3절 순서대로 한다: 크기 | messaging | `src/messaging/*`, `src/adapter/outbound/messaging` | | bootstrap·build·CI | `src/app-bootstrap`, `src/composition/*`, `src/build-logic`, `src/build.gradle`, `.github/` | | 보안(영역을 가로질러) | 인증·인가 체인, 비밀, 공개 경로 | -| 샘플·문서 | `src/sample-portfolio`, `docs/` | +| 문서 | `docs/` | 두 세션이 동시에 만지면 손으로 풀어야 하는 파일이다. 한 세션만 맡기거나, 총괄이 합칠 때 직접 고친다. diff --git a/docs/work/new-feature.md b/docs/work/new-feature.md index 73007fff..de926738 100644 --- a/docs/work/new-feature.md +++ b/docs/work/new-feature.md @@ -23,7 +23,7 @@ - 업무 기능 하나는 보통 중간이다: 계층 leaf 여러 곳에 파일이 생기지만 판단은 매뉴얼이 정해 둔 범위 안이다. - 큼: 새 capability 모듈, 새 leaf, 새 공개 계약, 파생 서비스가 따라 고쳐야 하는 변경. 큰 일은 설계와 소유자 검토가 먼저다([research-design.md](research-design.md)). -- 선행 사례는 생성 명령의 출력 하나다. `src/sample-portfolio`는 개별 기법(조건부 PATCH, 페이지, outbox, DB 유일 제약)의 참고일 뿐 배치를 따라 하지 않는다. +- 선행 사례는 생성 명령의 출력 하나다. 개별 기법의 예시는 `docs/manual/`이 실제 코드(fileserver, durable operation)로 가리킨다. - 스킬: 설계가 바뀌면 `superpowers:brainstorming`, 여러 단계면 `superpowers:writing-plans`, 구현은 `superpowers:test-driven-development`. ## 4. 절차 @@ -51,7 +51,7 @@ ## 6. 하지 말 것 - `AGENTS.md` HARD-STOP을 어기지 않는다. 특히 controller가 repository를 부르거나, inbound DTO가 application으로 들어가거나, 업무 규칙이 mapper·filter·설정에 들어가는 것. -- `src/sample-portfolio`의 배치(한 leaf에 모든 계층)를 따라 하지 않는다. onboarding 테스트 fixture도 따라 하지 않는다. +- 한 leaf에 모든 계층을 두지 않는다. onboarding 테스트 fixture도 따라 하지 않는다. - 업무 코드를 템플릿 패키지에 넣지 않는다. - 저장 adapter를 `persistence-jpa` leaf 안에 만들지 않는다. 서비스 전용 persistence leaf에 둔다. - 한 단계가 다른 leaf나 계층을 고쳐야 하면 범위를 조용히 넓히지 않는다. 거기서 멈추고 설계를 다시 본다(7절). @@ -74,6 +74,6 @@ ## 9. 자주 하는 실수 -- 샘플을 베껴 한 leaf에 모든 계층을 둔다. 생성 명령의 출력을 따른다. +- 한 leaf에 모든 계층을 둔다. 생성 명령의 출력을 따른다. - 생성 명령을 노트북에서 기본 옵션으로 돌려 Gradle이 노트북에서 돈다. `--no-format`을 쓴다. - 역할 → 권한 매핑을 빠뜨려 쓰기 API가 모든 요청에 403이다. `docs/manual/07-authorization.md`를 본다. diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index 76ae945c..1eb07b45 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -74,6 +74,7 @@ | 생성 명령 | JPA adapter를 만들지 않음(서비스 전용 persistence leaf가 기본), 생성된 쓰기 API는 역할 매핑 전 403 | 위임 | `1101` 15절(r2-10) | | `@SystemInvoked` | bean으로 등록돼 있으면 기동 실패, inbound adapter가 직접 부르지 못하게 ArchUnit | 위임 | `1103` 4절(RR-01-02) | | 시스템 호출 경로 | 사용자가 닿는 전송(web·GraphQL·gRPC·WebSocket)만 `@SystemInvoked`에 닿지 못한다. 메시지 소비자·스케줄러는 `@SystemCaller(reason)` 표시로 허용 | 위임 | `1103` 9.1절(RR-01-12), 10절 r5-b | +| 샘플 모듈 | `src/sample-portfolio`와 `src/Dockerfile.sample`을 폴더째 지운다. 역할은 옮기지 않는다. 샘플 안에만 있던 템플릿 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC)도 함께 지운다. 예시는 매뉴얼과 생성 명령 출력이 맡는다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.2절 | ### 2.3 계약·오류 @@ -126,7 +127,7 @@ | --- | --- | --- | --- | | JPA 기본값 | 트랜잭션 제한 30초, JDBC batch 50, H2 운영 jar 제거, 격리 수준 Hikari 고정, upsert `DO NOTHING` 후 갱신 | 위임 | `1101` 15절(04) | | 포트 시그니처 | claim에 lease·`claimFence`, fileserver `claimDue`·`markAbandoned`·`claimToken` | 위임 | `1101` 15절 | -| 마이그레이션 번호 | 스트림별 순번. 샘플은 운영 스트림과 합쳐 도는 테스트가 있어 `V8_1`. notification은 `V13` | 위임 | `1101` 15절 | +| 마이그레이션 번호 | 스트림별 순번. ~~샘플은 운영 스트림과 합쳐 도는 테스트가 있어 `V8_1`.~~(샘플과 함께 사라짐, 2026-11-07) notification은 `V13` | 위임 | `1101` 15절 | | V21 유일 인덱스 | 기존 중복이 있으면 마이그레이션 실패. runbook에 확인 쿼리 | 위임 | `1101` 15절 | | 순서 번호 seed | counter가 없으면 전역 floor부터 | 위임 | `1103` 4절(RR-03-02) | | 마이그레이션 잠금 | 강한 잠금을 거는 마이그레이션은 `SET LOCAL lock_timeout`, 같은 모양의 lane 테스트 | 위임 | `1103` 9.1절(RR-02-09) | @@ -139,9 +140,9 @@ | 주제 | 결정 | 누가 | 출처 | | --- | --- | --- | --- | -| 포스터 업로드 abort·reconcile 경합 | 먼저 끝난 쪽이 이김(이미 게시됐으면 abort는 409) | 소유자 | 결정 22 | -| work log 권한·batch | 관리자도 남의 work log 수정 불가, `batchCreate` 상한 1000·한 트랜잭션 | 위임 | `1101` 15절(09) | -| 이벤트 tenant·오류 코드 | 이벤트 tenant 범위 `global`, `WORKLOG_INVALID`·`OPERATION_NOT_FOUND` | 위임 | `1101` 15절(01) | +| 포스터 업로드 abort·reconcile 경합 | ~~먼저 끝난 쪽이 이김(이미 게시됐으면 abort는 409)~~ 샘플과 함께 사라짐(2026-11-07) | 소유자 | 결정 22 | +| work log 권한·batch | ~~관리자도 남의 work log 수정 불가, `batchCreate` 상한 1000·한 트랜잭션~~ 샘플과 함께 사라짐(2026-11-07) | 위임 | `1101` 15절(09) | +| 이벤트 tenant·오류 코드 | ~~이벤트 tenant 범위 `global`, `WORKLOG_INVALID`~~ 샘플과 함께 사라짐(2026-11-07). `OPERATION_NOT_FOUND`는 남는다 | 위임 | `1101` 15절(01) | | outbox append 모델 | canonical(`OutboxAppendPort`)로 통일, legacy 포트·legacy Kafka 발행 경로 삭제 | 소유자 | 결정 7 | | Kafka 소비 | 지원. `MessageHandler` 하나 + starter-kafka가 consumer 조립 | 소유자 | 결정 10 | | decode 타입 등록 | handler bean이 선언한 타입으로 decode 목록을 만든다 | 위임 | `1101` 15절(06-08 후속) | @@ -149,7 +150,7 @@ | 끝나지 않는 재시도 | bridge가 원인 코드를 행에 남기고, 오래 재시도 중인 행 수·나이를 지표로, runbook에 park·재개 절차와 테스트된 SQL | 위임 | `1103` 4절(RR-05-03) | | 카드 검증기 YAML | messaging leaf 테스트에서만 snakeyaml(main 금지) | 소유자 | 결정 29 | | JWT audience·role | audience 필수, 자기 client role만(기존 배포는 env 하나를 채움) | 소유자 | `1101` 5절(02-03), 15절 | -| 데모 계정 | `local`·`test`·`demo` 프로필이 명시적으로 켜졌을 때만(허용 목록). 각 프로필은 sample이 실제로 뜨는 프로필 | 위임 | `1103` 4절(RR-07-02), 9.1절(RR2-04-02) | +| 데모 계정 | ~~`local`·`test`·`demo` 프로필이 명시적으로 켜졌을 때만(허용 목록). 각 프로필은 sample이 실제로 뜨는 프로필~~ 샘플과 함께 사라짐(2026-11-07) | 위임 | `1103` 4절(RR-07-02), 9.1절(RR2-04-02) | | `fixture-` 값 거부 | 비밀로 분류된 키(`docs/registries/secrets-classification.yaml`)만 검사 | 위임 | `1103` 9.1절(RR2-04-01) | | 파일 서버 인가 | 역할 검사(`file:*` 권한)와 소유자·tenant 검사(`ownerPrincipalId`)를 둘 다 | 소유자 | 결정 14, 결정 32 | | cross-origin redirect | 호출자 헤더 전부 제거, 안전한 헤더만 유지 | 소유자 | 결정 23 | diff --git a/docs/work/reference/defect-patterns.md b/docs/work/reference/defect-patterns.md index e559218b..1382c2d2 100644 --- a/docs/work/reference/defect-patterns.md +++ b/docs/work/reference/defect-patterns.md @@ -39,7 +39,7 @@ - **모양**: 조회 후 insert, 찾고 없으면 넣기, 트랜잭션 없는 `SKIP LOCKED`, lease 없는 claim, 프로세스 메모리에 둔 소유권. - **막는 기준**: 유일성은 DB 유일 제약이 막고, adapter는 그 제약 위반만 기능 예외로 바꾼다. 여러 인스턴스가 집는 작업은 트랜잭션 안의 claim + lease로 소유권을 정한다. - **볼 것**: 존재 확인 뒤 쓰기, 트랜잭션 밖 잠금, 메모리 안 소유권. -- **장치**: `CallerTransaction`(store는 호출자 트랜잭션을 요구), 동시 요청 통합 테스트(`CreatePosterConcurrencyIntegrationTest`). 정본: `docs/manual/04-persistence.md`. +- **장치**: `CallerTransaction`(store는 호출자 트랜잭션을 요구), 동시 요청 통합 테스트(실 DB lane에서 동시 요청 N개 → 행 1개). 정본: `docs/manual/04-persistence.md`. ### A6. 주장하는 것을 보지 않는 테스트 @@ -76,10 +76,10 @@ ### A11. 샘플·fixture가 운영과 다르게 조립된다 -- **모양**: 샘플이 자동 설정을 빼거나 런타임 기본값이 다르다. "따라 할 모양"으로 둔 fixture가 기동하지 않는다. -- **막는 기준**: 샘플은 운영과 같은 자동 설정과 런타임 기본값을 쓴다. 무엇을 빼면 이유와 대체 장치를 같은 곳에 적는다. 새 기능의 모양으로 둔 fixture는 실제로 기동되는 모양이어야 한다. -- **볼 것**: 샘플 `@SpringBootApplication(exclude=…)`, 샘플 `application.yml`과 기본 조합의 차이. -- **장치**: 샘플 전체 기동 lane(`:sample-portfolio:systemTest`, `mainCheck`), 샘플 실서버 계약(`sampleWebContractCheck`). +- **모양**: 따로 조립한 앱(fixture·데모)이 자동 설정을 빼거나 런타임 기본값이 다르다. "따라 할 모양"으로 둔 fixture가 기동하지 않는다. +- **막는 기준**: 따로 조립한 앱은 운영과 같은 자동 설정과 런타임 기본값을 쓴다. 무엇을 빼면 이유와 대체 장치를 같은 곳에 적는다. 새 기능의 모양으로 둔 fixture는 실제로 기동되는 모양이어야 한다. +- **볼 것**: 그 앱의 `@SpringBootApplication(exclude=…)`, 그 앱의 `application.yml`과 기본 조합의 차이. +- **장치**: 기본 조합 전체 기동 lane(app-bootstrap `systemTest`, PR `check`). 이 모양이 처음 나온 샘플 모듈은 2026-11-07에 지웠다. ### A12. 수정이 새 결함을 만든다 diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index c1367595..151dadcc 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -21,10 +21,9 @@ | `testQualityCheck` | 같은 분석을 모든 테스트 source set에(`config/spotbugs/exclude-test.xml` 기준) | main(`mainCheck` 안), optional 빌드는 `ci` | `src/build.gradle` | | `ci` | leaf `check`(API surface 포함) + `architectureCheck` + `qualityCheck` | PR | `ci-quality-gates.yml`: `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` | | `verifyStrictLaneStages --dry-run` | `explicitOnly`가 아닌 strict lane이 workflow가 실행하는 단계에 속하는가 | PR(두 빌드 각각) | `ci-quality-gates.yml`, optional 빌드는 `-p optional-platforms` | -| `:sample-portfolio:check :sample-portfolio:qualityCheck` | 샘플(`ci` 밖) | PR | `ci-quality-gates.yml` | | `-p optional-platforms ci` | gRPC 플랫폼 빌드 | PR | `ci-quality-gates.yml` | | `bash scripts/verify-compose-profile-contracts.sh` | compose lane이 선언대로 렌더링되는가(저장소 루트에서) | PR | `ci-quality-gates.yml` | -| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 샘플 실서버 계약 + 샘플 전체 기동(`:sample-portfolio:systemTest`) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `integration-main.yml`: `./gradlew :mainCheck --continue --warning-mode=fail` | +| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `integration-main.yml`: `./gradlew :mainCheck --continue --warning-mode=fail` | | `integrationCheck` | 선언된 strict integration lane 전체(실 컨테이너). 입력이 없는 lane은 빼고 이름을 댄다 | main·nightly | `integration-main.yml`, optional 빌드도 | | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | main·nightly | `integration-main.yml`, optional 빌드도. 5절 | | `releaseCheck -PgitRevision=` | 릴리스 provenance + 공개 경로 스냅숏. sha 없이 돌리면 설계대로 실패한다 | 태그 | `release.yml` | @@ -99,7 +98,6 @@ cd src # PR: ci-quality-gates.yml ./gradlew :ci :verifyDependencyLocks --warning-mode=fail --no-build-cache --console=plain ./gradlew :verifyStrictLaneStages --dry-run --console=plain -./gradlew :sample-portfolio:check :sample-portfolio:qualityCheck --no-build-cache --console=plain ./gradlew -p optional-platforms ci --no-build-cache --console=plain ./gradlew -p optional-platforms :verifyStrictLaneStages --dry-run --console=plain # main push: integration-main.yml @@ -184,7 +182,6 @@ for k in tests skipped failures errors; do cat $(find "$x" -name 'TEST-*.xml') | | 장치 | 고정하는 것 | 단계 | | --- | --- | --- | -| 요청당 SQL 수 단언(`WorkLogStatementCostSystemTest`) | 목록 20건과 100건의 문장 수가 같음, 제목만 바꾸는 PATCH가 컬렉션 행을 건드리지 않음, batch 생성이 JDBC batch로 감 | sample `systemTest`(`mainCheck`) | | 자원 한계 lane | Tomcat·Jetty 부하·느린 클라이언트·종료, HTTP client 풀·스트리밍·재시도, Hikari 풀 | `performanceCheck` | | JMH 벤치마크 | `src/messaging/messaging-kafka/src/jmh`, `src/messaging/messaging-testkit/src/jmh`, `src/adapter/outbound/httpclient/src/jmh` | 명시 실행 | diff --git a/docs/work/reference/review-criteria.md b/docs/work/reference/review-criteria.md index 495d3089..2d9af720 100644 --- a/docs/work/reference/review-criteria.md +++ b/docs/work/reference/review-criteria.md @@ -126,22 +126,22 @@ | 24 | 네이밍·의미 | `src/application-core/CLAUDE.md` 「Naming convention」, `NamingConventionTest` | 이름과 내용이 다름 | | 25 | 조직 확장성 | 파생 서비스가 upstream을 받을 때 겹치는 곳 | 기능 패키지가 템플릿 패키지와 섞임 | | 26 | Ownership | leaf마다 가까운 `CLAUDE.md`·README | 안내 문서 없음, 패키지가 평평해 소유가 안 보임 | -| 27 | 삭제 가능성 | capability `runtimeOnly` 한 줄 제거, sample 제거 | 한 줄 지워도 흔적이 남음, bootstrap이 capability 이름을 앎 | +| 27 | 삭제 가능성 | capability `runtimeOnly` 한 줄 제거 | 한 줄 지워도 흔적이 남음, bootstrap이 capability 이름을 앎 | | 28 | 회복 가능성 | runbook SQL, DEAD·park, ledger 회수 | 영구히 막히는 key, 복구가 행마다 수작업 | **따라갈 시나리오** (가이드 31절). 전체 리뷰는 시나리오마다 요청 하나를 끝까지 따라가며 입력 신뢰 수준, 권한 판단 위치, 규칙 소유자, 트랜잭션 시작과 끝, 외부 부작용, 오류 변환을 적는다. 해당 기능이 없으면 적용 제외 사유를 한 줄 적는다. | 시나리오 | 따라갈 경로 | | --- | --- | -| 정상 쓰기 요청 | sample `POST /api/worklogs`, 생성 명령으로 만든 기능 | -| 중복·동시 요청 | 같은 제목 동시 `POST /api/posters`, 멱등 키(`docs/manual/05-idempotency.md`) | +| 정상 쓰기 요청 | 생성 명령으로 만든 기능, durable operation `POST /operations` | +| 중복·동시 요청 | 같은 호출자가 같은 작업을 동시에 `POST /operations`(payload fingerprint로 하나만 받는다), 멱등 키(`docs/manual/05-idempotency.md`) | | 외부 응답 지연·유실 | httpclient 시간 예산·breaker, 알림 발송 attempt | | DB 오류·경쟁 | `PersistenceExceptionTranslator`, `@Version`, 트랜잭션 마감 | | 메시지 중복·역순 | outbox relay, inbox 재전달, aggregate 순서 번호 | | 신·구 버전 공존 | 마이그레이션 잠금, 배포 중 섞인 인스턴스 | | 여러 서버의 작업 실행 | 알림 정산 job claim, gRPC ledger claim | -| 다른 사용자 리소스 접근 | 파일 서버 소유자 검사, sample 소유자 검사 | -| 큰 입력·목록 조회 | `GET /api/worklogs?size=100`, GraphQL 복잡도, JSON 아닌 본문 | +| 다른 사용자 리소스 접근 | 파일 서버 소유자 검사, durable operation 소유자·tenant 검사 | +| 큰 입력·목록 조회 | 파일 서버 업로드 크기 한도, GraphQL 복잡도, JSON 아닌 본문 | | 종료·재시작 | relay·platform 종료 순서, 종료 시간 예산 | | 선택 어댑터 제거 | `src/app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄 제거 | diff --git a/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl b/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl index e19f4f53..42f383ed 100644 --- a/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl +++ b/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl @@ -8,7 +8,7 @@ import java.util.UUID; * Mints {@link __Feature__Id}s as random (version 4) UUIDs from the JDK's secure generator. * *

Random UUIDs scatter inserts across a B-tree primary key. When __Feature__ rows are written - * often, switch to a time-ordered UUIDv7 as the sample's {@code UuidWorkLogIdFactory} does; the + * often, switch to a time-ordered UUIDv7 as {@code UuidV7DurableOperationIdFactory} does; the * domain contract (canonical UUID text) does not change. */ public final class Uuid__Feature__IdFactory implements __Feature__IdFactory { diff --git a/src/Dockerfile.sample b/src/Dockerfile.sample deleted file mode 100644 index 064714f5..00000000 --- a/src/Dockerfile.sample +++ /dev/null @@ -1,159 +0,0 @@ -# syntax=docker/dockerfile:1.7-labs@sha256:b99fecfe00268a8b556fad7d9c37ee25d716ae08a5d7320e6d51c4dd83246894 -# ============================================================================= -# sample-portfolio standalone demo image — twin of src/Dockerfile. -# -# Builds and runs the REFERENCE app (SamplePortfolioApplication), not the -# production composition root (CaSkeletonApplication) that src/Dockerfile builds. -# The sample is the demo-friendly entrypoint: its application.yml self-provides -# defaults for every env placeholder, so what it needs to boot is a demo profile -# and a reachable PostgreSQL (datasource + Flyway sample migrations). -# -# The profile is not baked in. The demo accounts (a published admin password) start only under an -# explicitly active `demo`, `local` or `test` profile (SampleDemoAccountsProductionGuard), and an -# image that defaulted to one would carry them into any deployment that ran it as is. Without -# SPRING_PROFILES_ACTIVE the container stops with exit code 71 and says so. -# -# Build (no build-args required — this is a disposable demo, not a release artifact): -# docker build -f src/Dockerfile.sample src/ -t ca-sample:local -# -# Run (point APP_DATASOURCE_URL at a reachable Postgres; localhost default shown): -# docker run --rm -p 8080:8080 -p 9001:9001 \ -# -e SPRING_PROFILES_ACTIVE=demo \ -# -e APP_DATASOURCE_URL=jdbc:postgresql://host.docker.internal:5432/ca_skeleton \ -# ca-sample:local -# -# The multi-stage build, --parents descriptor glob, STRICT lock verification, -# non-root user, read-only-root-fs writable mounts, and JVM container ergonomics -# are all identical to src/Dockerfile — only the bootJar target differs. -# -# Two files rather than one with a COMPOSITION=sample argument: the release image refuses to build -# without version and source metadata, and folding a zero-argument demo into it would make that -# refusal conditional. The part that must not drift — the dependency stage's COPY lines — is held -# equal by DeveloperExperienceContractTest. -# ============================================================================= - -# Demo defaults so the image builds with zero build-args. Two format constraints from the root -# build.gradle configuration guard (feature-build-release-supply-chain-contract D1/D9): -# - RELEASE_VERSION must be bare MAJOR.MINOR.PATCH — no pre-release/build suffix (build.gradle L21). -# The "-sample" marker therefore lives only on BUILD_VERSION, which is a label, not a gradle prop. -# - GIT_SHA must be 7-40 hex chars (build.gradle L35); 0000000 is the placeholder. -ARG RELEASE_VERSION=0.0.0 -ARG BUILD_VERSION=0.0.0-sample -ARG GIT_SHA=0000000 -ARG SOURCE_URL=https://example.invalid/ca-tmpl-sample - -# ---- Stage 1: builder ------------------------------------------------------- -# Uses the full JDK only in the build stage, never in the final image. -FROM eclipse-temurin:21-jdk-jammy@sha256:801b7e1a9c4befaf82bf9a2a58025ef43a7694bbc84779187ad0524d84742772 AS builder - -ARG RELEASE_VERSION -ARG GIT_SHA - -WORKDIR /build/src - -# Copy the Gradle wrapper and every module's build descriptor + dependency lockfile FIRST, -# so the expensive dependency-resolution layer is cached and only re-runs when a build.gradle -# or gradle.lockfile changes (D8). `--parents` preserves each file's directory structure, so a -# single structure-preserving glob replaces a per-module COPY list: new modules are picked up -# automatically and this stage never drifts out of sync with settings.gradle. -# (Requires the labs Dockerfile frontend — see the `# syntax` directive at the top of this file.) -COPY gradlew ./ -COPY gradle/ gradle/ -COPY gradle.properties ./ -COPY config/ ./config/ -COPY --parents settings.gradle build.gradle **/build.gradle **/gradle.lockfile ./ -# The convention plugins, whole — see src/Dockerfile. Without them settings.gradle's -# includeBuild('build-logic') has no version catalog and no plugins, and this stage failed before -# resolving anything (07-04). DeveloperExperienceContractTest holds these COPY lines equal to the -# release image's. -COPY build-logic/ ./build-logic/ - -# Resolve every module configuration in STRICT mode (no --write-locks in a demo build either). -RUN test -n "${RELEASE_VERSION}" \ - && test -n "${GIT_SHA}" \ - && ./gradlew verifyDependencyLocks --no-daemon --quiet \ - -PreleaseVersion="${RELEASE_VERSION}" -PgitRevision="${GIT_SHA}" - -# Copy full source and stage the executable sample JAR at Gradle's declared Docker output path. -COPY . . -RUN ./gradlew :sample-portfolio:stageDockerJar --no-daemon -x test \ - -PreleaseVersion="${RELEASE_VERSION}" -PgitRevision="${GIT_SHA}" - -# ---- Layer extraction ------------------------------------------------------- -# Identical to src/Dockerfile — see the long note there. Kept in sync because the header of this -# file says the builder stages are, and a demo image whose layout has drifted from the release image -# stops being a demo of the release image. Absolute paths for the same contract-test reason. -RUN java -Djarmode=tools \ - -jar /build/src/sample-portfolio/build/docker/application.jar \ - extract --layers --destination /build/src/sample-portfolio/build/docker/extracted - -# ---- Stage 2: runtime image ------------------------------------------------- -# JRE-only slim image (no full JDK in the demo image either). -FROM eclipse-temurin:21-jre-jammy@sha256:199aebeb3adcde4910695cdebfe782ada38dadb6cc8013159b58d3724451befd AS runtime - -ARG BUILD_VERSION -ARG GIT_SHA -ARG SOURCE_URL - -# OCI image labels. Unlike the release image (src/Dockerfile), the demo image does NOT hard-fail -# on missing metadata — the ARG defaults above keep it buildable with no build-args. -LABEL org.opencontainers.image.title="caskeleton-sample" \ - org.opencontainers.image.description="ca-tmpl sample-portfolio reference/demo application" \ - org.opencontainers.image.source="${SOURCE_URL}" \ - org.opencontainers.image.revision="${GIT_SHA}" \ - org.opencontainers.image.version="${BUILD_VERSION}" - -# ---- Locale / timezone ------------------------------------------------------ -ENV TZ=UTC \ - LANG=C.UTF-8 \ - LC_ALL=C.UTF-8 - -# ---- Writable HOME under read-only root fs ---------------------------------- -ENV HOME=/tmp - -# ---- JVM ergonomics --------------------------------------------------------- -# Identical to src/Dockerfile: container-aware heap, fail-fast on OOM, heap dump to a -# writable mount, and Tomcat temp redirected to /tmp for a read-only root filesystem. -ENV JAVA_TOOL_OPTIONS="\ - -XX:MaxRAMPercentage=75 \ - -XX:+UseContainerSupport \ - -XX:+ExitOnOutOfMemoryError \ - -XX:+HeapDumpOnOutOfMemoryError \ - -XX:HeapDumpPath=/var/tmp/heap \ - -Dserver.tomcat.basedir=/tmp" - -# ---- Filesystem layout (read-only root filesystem) -------------------------- -# At runtime /var/tmp/heap and /tmp MUST be writable mounts (tmpfs/emptyDir). -RUN mkdir -p /var/tmp/heap && chmod 1777 /var/tmp/heap - -# ---- Non-root user ---------------------------------------------------------- -RUN groupadd --system --gid 1000 app \ - && useradd --system --uid 1000 --gid app --no-create-home --shell /usr/sbin/nologin app - -WORKDIR /app - -# ---- Application layers ----------------------------------------------------- -# One COPY per Spring Boot layer, least- to most-frequently-changed, matching src/Dockerfile. -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/dependencies/ ./ -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/spring-boot-loader/ ./ -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/snapshot-dependencies/ ./ -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/application/ ./ - -USER app - -# ---- Ports ------------------------------------------------------------------ -# 8080 — application HTTP port -# 9001 — management / actuator port -EXPOSE 8080 9001 - -# ---- Health check ----------------------------------------------------------- -# Actuator readiness probe on the management port (9001). Ignored by Kubernetes, -# which uses its own probes — kept for docker/compose parity with src/Dockerfile. -HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \ - CMD wget --no-verbose --tries=1 --spider \ - http://localhost:9001/actuator/health/readiness || exit 1 - -# ---- Entrypoint ------------------------------------------------------------- -# mainClass (SamplePortfolioApplication) is baked into the bootJar manifest and survives the -# extraction into the thin application.jar. -ENTRYPOINT ["java", "-jar", "application.jar"] diff --git a/src/README.md b/src/README.md index 77e93d41..8d063639 100644 --- a/src/README.md +++ b/src/README.md @@ -26,11 +26,11 @@ Checkstyle은 **포매터가 표현할 수 없는 것만** — 네이밍과 몇 | `qualityCheck` | 모든 leaf의 SpotBugs + FindSecBugs를 실행 | | `configContractCheck` | `:app-bootstrap:verifyEnvKeys`로 환경 설정 계약을 검사 | | `qualificationCheck` | 전체 기동(system) 레인과 보조 source set Checkstyle을 실행 | -| `integrationCheck` | 선언된 strict integration lane(sample 포함)을 실행. 대부분 container runtime이 필요. 입력이 필요한 lane(Redis topology: `-Predis.topology.mode`, AWS: 보호 자격 증명 env)은 입력이 없으면 빠지고 집계가 그 이유를 출력 | +| `integrationCheck` | 선언된 strict integration lane을 실행. 대부분 container runtime이 필요. 입력이 필요한 lane(Redis topology: `-Predis.topology.mode`, AWS: 보호 자격 증명 env)은 입력이 없으면 빠지고 집계가 그 이유를 출력 | | `performanceCheck` | 선언된 strict performance lane(부하·종료·pool·자원 상한)을 실행. 실서버·container가 필요. 상한은 매번 단언하고 끄는 속성이 없다(`-Pperformance.assertions.enabled`가 `true`가 아니면 실패, skip된 테스트가 있어도 실패). `integration-main.yml` `performance-check`가 main·nightly에 같은 명령으로 돌림 | -| `verifyStrictLaneStages` | `--dry-run` 전용. `explicitOnly`가 아닌 strict lane이 workflow가 실제 실행하는 단계(`ci`·`:sample-portfolio:check`·`mainCheck`·`integrationCheck`·`performanceCheck`·`releaseCheck`) 중 하나의 계획에 있는지, 각 단계를 workflow가 `--dry-run` 없이 실행하는지 검사. Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-v`·`--help` 등)과, 실패해도 단계가 실패하지 않을 수 있거나(`\|\| true`, pipefail 없는 파이프, `if` 조건 등) 돌지 않을 수 있거나(조건부 `exit 0` 뒤, 요청으로만 시작하는 workflow, `paths` 필터로만 시작하는 workflow, `releaseCheck` 밖의 단계를 태그 push·`release`로만 시작하는 workflow 등) 검사가 읽지 않는(`\|\| exit 1`, `{ }` 안 등) 명령은 실행으로 세지 않는다. 자세한 목록은 `build-logic/README.md`. PR 게이트가 돌림 | +| `verifyStrictLaneStages` | `--dry-run` 전용. `explicitOnly`가 아닌 strict lane이 workflow가 실제 실행하는 단계(`ci`·`mainCheck`·`integrationCheck`·`performanceCheck`·`releaseCheck`) 중 하나의 계획에 있는지, 각 단계를 workflow가 `--dry-run` 없이 실행하는지 검사. Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-v`·`--help` 등)과, 실패해도 단계가 실패하지 않을 수 있거나(`\|\| true`, pipefail 없는 파이프, `if` 조건 등) 돌지 않을 수 있거나(조건부 `exit 0` 뒤, 요청으로만 시작하는 workflow, `paths` 필터로만 시작하는 workflow, `releaseCheck` 밖의 단계를 태그 push·`release`로만 시작하는 workflow 등) 검사가 읽지 않는(`\|\| exit 1`, `{ }` 안 등) 명령은 실행으로 세지 않는다. 자세한 목록은 `build-logic/README.md`. PR 게이트가 돌림 | | `ci` | PR 게이트: 모든 leaf `check`(API surface 검사 포함, 소유자 결정 20) + `architectureCheck` + `qualityCheck` | -| `mainCheck` | main 단계: `configContractCheck` + `qualificationCheck` + sample web 계약 + sample 전체 기동(`:sample-portfolio:systemTest`) + `verifyPublicPathSnapshot` + 전송·메시징 qualification 레인 + 각 leaf의 `mainCheck`(문서 대조 레인 `*DocumentContractTest`, objectstorage MinIO 레인) | +| `mainCheck` | main 단계: `configContractCheck` + `qualificationCheck` + `verifyPublicPathSnapshot` + 전송·메시징 qualification 레인 + 각 leaf의 `mainCheck`(문서 대조 레인 `*DocumentContractTest`, objectstorage MinIO 레인) | | `releaseCheck` | tag 전용 검사: `verifyReleaseProvenance` + `verifyPublicPathSnapshot`(`ci`를 다시 돌리지 않음) | 따라서 로컬에서 한 모듈만 수정했다면 `./gradlew :domain-core:check`처럼 focused task를 @@ -317,7 +317,7 @@ Kafka 없이 기동합니다. 나머지 기능은 `app-bootstrap/build.gradle` Kafka·Redis는 위 "기능 추가 = 한 줄 + env" 표의 한 줄로 고릅니다. 모듈이 있으면 켜지고, 없으면 그 포트를 구현하는 bean이 아예 없습니다. 아래는 모듈을 고른 뒤 동작을 고르는 키입니다. -- **`APP_CACHE_REDIS_ENABLED`** — deprecated(2026-11-30 제거 예정). 읽는 곳은 `sample-portfolio`뿐이고, +- **`APP_CACHE_REDIS_ENABLED`** — deprecated(2026-11-30 제거 예정). 읽는 곳이 없고, 기본 조립에서 Redis를 켜고 끄는 것은 `APP_REDIS_ENABLED`입니다. - **`APP_CACHE_CANONICAL_DEFAULT_PROVIDER`** — canonical default semantic region 선택. `disabled`(기본) | `redis`. `redis`는 canonical Redis CACHE role binding을 함께 요구합니다. @@ -359,10 +359,7 @@ app: - 기존 `APP_OUTBOUND_HTTP_*`와 `app.outbound.http.*`는 canonical 설정이 아닙니다. 루트 `src/.env`, `app-bootstrap`의 application YAML, env-key registry에서 제거됐으며 canonical composition에 입력하면 상태와 무관하게 기동을 거부합니다. -- 다만 `sample-portfolio`의 application YAML에는 legacy facade를 시연하기 위해 15개 키가 남아 - 있습니다. 이 모듈은 fixture/reference consumer이고 production 의존성이 아니며, 그 YAML은 - `:app-bootstrap:verifyEnvKeys`가 검사하는 세 파일에 포함되지 않습니다. "제거됐다"는 문장이 저장소 전체를 - 가리킨다고 읽히지 않도록 범위를 명시합니다. +- 그 키를 시연하던 샘플 모듈의 YAML은 2026-11-07 샘플과 함께 지웠습니다. 이제 저장소 어디에도 남아 있지 않습니다. - legacy JDK facade가 필요한 fork만 canonical composition 밖에서 `OutboundHttpSettings.bindLegacy(Binder)`와 legacy configuration을 명시적으로 import합니다. timeout/retry/CB/response-size 설정은 그 migration API 내부 계약일 뿐 canonical provider diff --git a/src/adapter/inbound/graphql/CLAUDE.md b/src/adapter/inbound/graphql/CLAUDE.md index 069ebbf2..89dd89bf 100644 --- a/src/adapter/inbound/graphql/CLAUDE.md +++ b/src/adapter/inbound/graphql/CLAUDE.md @@ -114,7 +114,7 @@ application/platform namespace split. `INBOUND_ADAPTERS_DO_NOT_DEPEND_ON_OUTBOUND_ADAPTERS`, 일반 `..adapter.inbound..` 규칙이 이 모듈을 자동 커버 — per-module 규칙 추가 불필요). - 프로덕션 feature 쿼리/뮤테이션을 스켈레톤에 두는 것 — health 표면만 (web 의 - `HealthcheckController` 와 동일 원칙). feature 스키마/컨트롤러/매퍼는 sample 모듈이 소유한다. + `HealthcheckController` 와 동일 원칙). feature 스키마/컨트롤러/매퍼는 그 기능을 가진 서비스가 소유한다. - 모듈별 `yml` — 설정은 프레임워크 `spring.graphql.*` 로 composition-root `application.yml` 에 산다. ## Error mapping (`Category → ErrorType`) @@ -139,7 +139,7 @@ DataLoader 키 실패는 등록된 `ApiErrorCode` 만 싣는다(`GraphQlBatchLoa - **도메인 예외 매핑**: adopter 는 자신의 `DataFetcherExceptionResolver` 를 추가하거나 `ApiErrorCarrier` 를 사용해 안정적 코드로 매핑할 수 있다. -현재 sample 에 feature GraphQL schema/controller/resolver 가 있다고 가정하지 않는다. 이 leaf 는 +템플릿에는 feature GraphQL schema/controller/resolver 가 없다. 이 leaf 는 health 스키마만 소유한다. ## 구현된 플랫폼 범위 — 등급으로 말한다 diff --git a/src/adapter/inbound/graphql/README.md b/src/adapter/inbound/graphql/README.md index 5462d7aa..ff9c7c63 100644 --- a/src/adapter/inbound/graphql/README.md +++ b/src/adapter/inbound/graphql/README.md @@ -22,8 +22,8 @@ Spring for GraphQL 은 schema-first 다. 빈 스키마로는 부팅이 실패하 스켈레톤은 **WorkLog 를 이름으로 알지 못한다.** 향후 composition root 가 이 모듈을 classpath 에 명시적으로 채택하고 feature 를 추가하면 Spring for GraphQL 이 다음 두 축으로 합성할 수 있다: -- **스키마**: `classpath:graphql/**/*.graphqls` 를 전부 병합한다. sample 모듈의 - 향후 `worklog.graphqls` 같은 feature 스키마는 스켈레톤의 `skeleton.graphqls` 와 합쳐진다. +- **스키마**: `classpath:graphql/**/*.graphqls` 를 전부 병합한다. 서비스가 더하는 + `order.graphqls` 같은 feature 스키마는 스켈레톤의 `skeleton.graphqls` 와 합쳐진다. - **resolver(핸들러)**: 컨텍스트의 모든 `@Controller` 의 `@QueryMapping`/`@MutationMapping` 메서드를 바인딩한다. 향후 feature 의 GraphQL controller 는 스켈레톤을 수정하지 않고 등록할 수 있다. @@ -48,7 +48,7 @@ Spring for GraphQL 은 schema-first 다. 빈 스키마로는 부팅이 실패하 맞는 값: local→`LOCAL`, dev→`DEV`, prod→`PRODUCTION_INTERNAL`|`PRODUCTION_PUBLIC`). production mode는 `GraphQlAuthorizationPolicy` bean도 필요하다. 나머지 `APP_GRAPHQL_*`는 기본값으로 동작한다. -`sample-portfolio` 에 feature GraphQL 스키마/controller 가 있다는 뜻은 아니며, leaf 자체는 최소 +템플릿에 feature GraphQL 스키마/controller 가 있다는 뜻은 아니며, leaf 자체는 최소 health 스키마로 독립 기동할 수 있다. ## 에러 매핑 — web `GlobalExceptionHandler` / gRPC 인터셉터의 GraphQL 형제 @@ -303,7 +303,7 @@ trivial fetcher 는 세지 않는다. 기본 10 은 기본 page 크기 20 보다 `ObservationRegistry` 로 나가며(Actuator 가 있으면 timer 로 집계), 없으면 WARN 만 남는다. 버린 대안: 카탈로그에 등록되지 않은 list 자식 필드를 기동 때 경고 — 모든 list 필드를 adopter 가 -카탈로그에 등록해야 의미가 생겨 비용에 비해 효과가 작다. 재검토 조건: sample 에 GraphQL feature 가 +카탈로그에 등록해야 의미가 생겨 비용에 비해 효과가 작다. 재검토 조건: 템플릿에 GraphQL feature 가 들어오면 그 코드가 위 예시를 대신한다. ## 요청 deadline — 무엇이 끊기고 무엇이 안 끊기나 diff --git a/src/adapter/inbound/grpc/CLAUDE.md b/src/adapter/inbound/grpc/CLAUDE.md index 4f431f17..5c4dff1a 100644 --- a/src/adapter/inbound/grpc/CLAUDE.md +++ b/src/adapter/inbound/grpc/CLAUDE.md @@ -90,7 +90,7 @@ credential path and a separately qualified non-loopback bind. ## Feature 기여 방법 -현재 저장소에는 production feature RPC나 sample gRPC service가 없다. 향후 feature를 도입할 +현재 저장소에는 feature RPC가 없다. 향후 feature를 도입할 때는 `.proto`/generated stub/`BindableService`를 해당 feature가 소유하고, 서비스 빈과 정확히 한 개의 caller-supplied `GrpcAuthenticationPolicy` 빈을 함께 제공한다. 정책이 없거나 여러 개면 listener 시작이 실패한다. 정책은 `Optional authenticate(Metadata)`이고, 돌려준 diff --git a/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java b/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java index e808c723..cb926654 100644 --- a/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java +++ b/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java @@ -6,7 +6,7 @@ import dev.caskeleton.shared.error.ApiErrorCode; /** * Adapter-level throwable a feature gRPC service throws after mapping a domain exception to a * stable {@link ApiErrorCode} (typically a feature code such as {@code - * PortfolioErrorCode.WORKLOG_NOT_FOUND} or a skeleton {@code OperationalError}). It implements the + * OrderErrorCode.ORDER_NOT_FOUND} or a skeleton {@code OperationalError}). It implements the * shared-contract {@link ApiErrorCarrier} hook so the {@link GrpcExceptionHandlingInterceptor} * translates it to the matching gRPC {@code Status} plus {@code code} / {@code category} trailers * through the same single carrier branch that handles the shared-contract infra exceptions. diff --git a/src/adapter/inbound/web-advanced/CLAUDE.md b/src/adapter/inbound/web-advanced/CLAUDE.md index 538dfff0..18d3212d 100644 --- a/src/adapter/inbound/web-advanced/CLAUDE.md +++ b/src/adapter/inbound/web-advanced/CLAUDE.md @@ -21,11 +21,11 @@ service adds and the settings are in [README.md](README.md). ## Rules -- Not in any default composition. `app-bootstrap` and `sample-portfolio` main must not depend on it; +- Not in any default composition. `app-bootstrap` main은 이 leaf에 의존하지 않는다; `app-bootstrap` takes it `testRuntimeOnly` so the whole-repository ArchUnit import reads it. - It depends on `adapter:inbound:web` (the `core` vocabulary), never the reverse. - No component-scannable stereotype. A consuming application may scan the adapter packages - (`sample-portfolio` scans `dev.caskeleton.adapter.inbound.web`), so a + (서비스가 `dev.caskeleton.adapter.inbound.web`을 scan할 수 있다), so a `@Configuration`/`@Component` here would be created whatever its switch says. Switched wiring is `@AutoConfiguration` + an imports line; imported helpers carry no stereotype (`MvcStreamingSupportConfiguration`). diff --git a/src/adapter/inbound/web-advanced/README.md b/src/adapter/inbound/web-advanced/README.md index 56e396a5..e7d8efac 100644 --- a/src/adapter/inbound/web-advanced/README.md +++ b/src/adapter/inbound/web-advanced/README.md @@ -3,7 +3,7 @@ **라이브러리 API — 서비스의 어댑터 leaf에서 `implementation`으로 받아 직접 호출; 기본 조립에 없음.** `adapter:inbound:web` 에 있던 코드 중 servlet 운영 경로가 닿지 않는 것만 모은 opt-in leaf 다. -`app-bootstrap`·`sample-portfolio` 는 이 leaf 에 의존하지 않는다. 패키지 루트는 +`app-bootstrap` 은 이 leaf 에 의존하지 않는다. 패키지 루트는 `dev.caskeleton.adapter.inbound.web.advanced` (web 과 겹치는 패키지 없음). ## 추가할 한 줄 diff --git a/src/adapter/inbound/web/CLAUDE.md b/src/adapter/inbound/web/CLAUDE.md index c3013563..35c66ca8 100644 --- a/src/adapter/inbound/web/CLAUDE.md +++ b/src/adapter/inbound/web/CLAUDE.md @@ -28,7 +28,7 @@ health and rate-limit beans; `WebSecurityAutoConfiguration` imports the JWT chai with its own posture excludes only that root; `WebMethodSecurityAutoConfiguration` imports method security and the permission port and stays when the chain is replaced; nobody scans this leaf), and the types -`app-bootstrap`, `sample-portfolio`, `web-fileserver` and `composition:fileserver-platform` name — +`app-bootstrap`, `web-fileserver` and `composition:fileserver-platform` name — plus their transitive references. Library code that no production path reaches (streaming, virtual threads, patch, codecs, OpenAPI 3.2, URI/method policy, versioning, operation, budget, contract, security-context bridge, `JsonIdempotentResponseCodec`, route inventory) lives in the opt-in leaf @@ -76,8 +76,7 @@ also drives the runtime patterns reference implementations must follow. `Optional` wrappers on request records. - **B3 — Mapper-internal failures.** Map record canonical-constructor `IllegalArgumentException`, MapStruct generated NPE, ACL normalization - failures, etc. by throwing `MappingException` (sample implementation in - `sample-portfolio`); the global handler routes it to `MAPPING_FAILED` (HTTP 400), + failures, etc. by throwing `MappingException`; the global handler routes it to `MAPPING_FAILED` (HTTP 400), never to `BAD_PARAMETER` or `INTERNAL_ERROR`. Plain `IllegalArgumentException` remains `BAD_PARAMETER` for non-mapper callers. - **B4 — Validation layering.** Class-level Bean Validation constraints belong @@ -111,16 +110,13 @@ Domain `@RestControllerAdvice` in a consuming module must be annotated `@Order(Ordered.HIGHEST_PRECEDENCE)` (or otherwise ordered ahead of this module's base `GlobalExceptionHandler`), because the base handler's catch-all `@ExceptionHandler(Exception.class)` would otherwise resolve domain exceptions -to `INTERNAL_ERROR`. See `sample-portfolio`'s `DomainExceptionHandler` for the -pattern. +to `INTERNAL_ERROR`. The base operational handler (`error/GlobalExceptionHandler`), the error-code contract (`dev.caskeleton.shared.error.ApiErrorCode` + `OperationalError`), the `error/ErrorResponseFactory`, and the `envelope/EnvelopeBodyAdvice` now live in production modules (`adapter:inbound:web` / `shared-contract`), so the running application -provides them without depending on `sample-portfolio`. Domain-specific exception -handlers and error codes live in the consuming module (see sample's -`DomainExceptionHandler` / `PortfolioErrorCode`). +provides them. 기능 전용 예외 handler와 오류 코드는 그 기능을 가진 모듈에 둔다(`docs/manual/06-errors.md`). ## Schema / serialization contract diff --git a/src/adapter/inbound/web/README.md b/src/adapter/inbound/web/README.md index b09e83d4..2fdd88d3 100644 --- a/src/adapter/inbound/web/README.md +++ b/src/adapter/inbound/web/README.md @@ -143,7 +143,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML `WebSecurityAutoConfiguration`(JWT/session 체인)이 아니라 이 auto-configuration이 들여온다. - 이유: 인증 방식(체인)을 바꾸는 애플리케이션은 `WebSecurityAutoConfiguration`만 뺀다. 둘이 한 root에 있을 때는 체인을 빼면 advisor도 같이 빠져서, 그 애플리케이션의 `@RequiresPermission`이 아무 경고 없이 - 주석이 됐다(샘플이 그랬다 — 익명 삭제 가능). 이제 체인을 바꿔도 권한 검사는 남는다. + 주석이 됐다(지운 샘플 모듈이 그랬다 — 익명 삭제 가능). 이제 체인을 바꿔도 권한 검사는 남는다. - 메서드 보안까지 끄려면 이 클래스를 따로 exclude 해야 한다. 그 결정은 exclude 목록에 이름으로 드러난다. ### MethodSecurityConfig @@ -229,8 +229,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - **등록은 한 곳이다.** `WebMvcPlatformAutoConfiguration` 의 `@ConditionalOnMissingBean` bean 하나뿐이다. `app.web.mvc.enabled=false` 면 이 핸들러·요청 id 필터·JSON 본문 상한·중복 키 거부가 함께 빠지고, 서비스가 셋을 직접 준다. 같은 타입 bean 을 주면 그것만 쓰인다(리뷰 02-10, `WebMvcPlatformAutoConfigurationTest`). -- `adapter-web` 에 위치하는 이유: 실행 앱이 어떤 sample 모듈에도 의존하지 않고 envelope 형식 에러 응답을 - 제공하도록. +- `adapter-web` 에 위치하는 이유: 실행 앱이 기능 모듈 없이도 envelope 형식 에러 응답을 제공하도록. - **`spanErrorRecorder`.** 프로덕션 코드를 특정 트레이서 라이브러리에 결합하지 않고 span 에러를 기록하기 위한 이음새. 기본값 `SpanErrorRecorder.NOOP`. `@Autowired` 생성자가 `ObjectProvider` 로 self-default 하므로 전체 컨텍스트 / `@WebMvcTest` 슬라이스 / 순수 단위 테스트 @@ -292,7 +291,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - **이미 직렬화된 `byte[]` 본문은 감싸지 않는다.** 그 본문을 쓰는 converter 는 받은 값을 그대로 복사하므로 envelope 객체를 받으면 500 으로 끝난다. springdoc 이 OpenAPI 문서를 `byte[]` 로 돌려주어, 감싸던 시절에는 실행 중인 앱의 `/api/v3/api-docs` 가 항상 500 이었다(리뷰 09-04). `String` 반환은 감싸되 JSON 문자열로 - 직렬화해 넘긴다(리뷰 02-06). 단언은 `EnvelopeBodyAdviceTest`, 샘플 전체 조합의 `SampleApiDocsSystemTest`. + 직렬화해 넘긴다(리뷰 02-06). 단언은 `EnvelopeBodyAdviceTest`. - **`String` 반환도 JSON 클라이언트에게는 Envelope 다.** `String` 은 `StringHttpMessageConverter` 가 Jackson 보다 먼저 고른다. 예전에는 그 컨버터에 `Envelope` 객체를 넘겨 `Accept: application/json` 이면 `ClassCastException` 500, `*/*` 면 200 text 였다(리뷰 02-06). 지금은 String 컨버터가 JSON 을 쓰게 될 때 @@ -301,8 +300,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML 용도를 막고, 규칙을 돌리지 않는 서비스에는 함정이 그대로 남는다. - **4xx·5xx 본문은 감싸지 않는다.** `success` 는 클라이언트가 가르는 판별자라, 오류 status 본문을 `success:true` 로 감싸면 성공으로 읽힌다. Boot `/error` 의 map 이 그렇게 나갔다(재리뷰 RR-02-02). -- 위치: sample 모듈이 아니라 adapter-web. 실행 앱은 adapter-web 에 의존하지만 sample-portfolio 에는 의존하지 - 않으므로, 응답 래핑이 실제로 동작하려면 여기 있어야 한다. +- 위치: adapter-web. 실행 앱이 늘 싣는 leaf 라, 응답 래핑이 실제로 동작하려면 여기 있어야 한다. ### EnvelopeErrorController - 컨트롤러에 닿기 전에 생긴 오류(보안 방화벽의 `RequestRejectedException`, 필터의 `sendError`, 필터가 @@ -323,7 +321,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - `SecurityConfig` 는 오류 **디스패치**만 허용한다(`DispatcherType.ERROR`). 예전에는 `/error` 가 공개 경로가 아니라서 익명 요청의 400 이 401 로 바뀌었다. `/error` 를 직접 부른 요청은 여전히 인증이 필요하다. 단언은 실제 Tomcat 의 `TomcatWebContractIT`(공유 `WebContractAssertions`)와 `JwtChainErrorDispatchIT`. -- 앱이 보안 체인을 직접 정의하면(예: sample 의 데모 체인) 같은 한 줄 +- 앱이 보안 체인을 직접 정의하면(예: 데모용 체인) 같은 한 줄 (`dispatcherTypeMatchers(DispatcherType.ERROR).permitAll()`)을 그 체인에도 둬야 원래 status 가 나간다. ### CacheControlFilter @@ -474,7 +472,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML ### JacksonNullableConfig - `JsonNullableModule` 을 Spring 관리 `ObjectMapper` 에 등록. 없으면 PATCH 요청 DTO 의 `JsonNullable`(B2)를 Jackson 이 역직렬화하지 못해 absent / explicit-null 구분이 조용히 붕괴된다. -- 스켈레톤 전역 web 관심사(공유 `Patch` 타입과 짝)라 도메인 샘플 모듈이 아니라 adapter-web 에 위치. +- 스켈레톤 전역 web 관심사(공유 `Patch` 타입과 짝)라 기능 모듈이 아니라 adapter-web 에 위치. ### IdempotencyKeyHeader - KEYED 엔드포인트가 헤더를 키로 바꾸는 유일한 지점(리뷰 02-12). 문법: 보이는 ASCII(`0x21`–`0x7E`) @@ -508,7 +506,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML ### MdcCorrelationIdPortAdapter - `WebMvcRequestIdFilter`가 무해화하고 MDC `correlation_id`에 넣은 값을 application-core의 `CorrelationIdPort`로 투영한다. -- absent/blank는 `Optional.empty()`로 반환한다. application/sample 계층은 SLF4J/MDC를 직접 +- absent/blank는 `Optional.empty()`로 반환한다. application 계층은 SLF4J/MDC를 직접 참조하지 않고 event-id fallback 정책만 소유한다. ### HeaderSanitizer @@ -587,11 +585,10 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - web leaf에는 별도 DB replay 엔진을 두지 않는다. 같은 요청 의미를 web/application 두 계층이 서로 다른 fingerprint로 판정하면 동일 key의 의미가 endpoint마다 달라지기 때문이다. - 헤더 → 키 변환은 `IdempotencyKeyHeader` 하나로 한다(위 settings / config / http 절). -- production 예시는 sample의 poster image publication 경로다. controller는 key를 받기만 하고, - `PublishPosterImageUseCase`가 application `IdempotencyExecutor`를 사용한다. +- controller는 key를 받기만 하고, 유스케이스가 application `IdempotencyExecutor`를 쓴다. 템플릿에는 이 + 경로를 HTTP부터 끝까지 이은 업무 기능 예가 없다(`docs/manual/05-idempotency.md`). - response-loss system fixture도 동일한 application executor를 사용해, 연결이 끊긴 뒤 같은 key 재시도에서 첫 committed 결과가 복구되고 side effect가 한 번만 실행되는지 검증한다. ### JsonIdempotentResponseCodec -- `adapter:inbound:web-advanced` 로 옮겼다(운영 경로 호출자 0). sample 은 자기 codec - (`PosterImagePublicationReservationCodec`)을 쓰고, response-loss fixture 는 fixture 안의 익명 codec 을 쓴다. +- `adapter:inbound:web-advanced` 로 옮겼다(운영 경로 호출자 0). response-loss fixture 는 fixture 안의 익명 codec 을 쓴다. diff --git a/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java b/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java index 34decefd..9c9ff482 100644 --- a/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java +++ b/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java @@ -17,13 +17,13 @@ import org.springframework.core.Ordered; * envelope entry point and access-denied handler, CORS and their settings. * *

Separate from {@link WebAdapterAutoConfiguration} so an application that brings its own - * posture — the demo sample, a contract fixture — excludes exactly this class and still gets the - * error envelope, filters, health endpoint and rate limiting from the web root. Excluding it does - * not switch off {@code @RequiresPermission}: that is {@link WebMethodSecurityAutoConfiguration}, - * which an application keeps while it replaces the chain. Before this root was split from the web - * root, the only way to drop the security chain was to drop the whole root and component-scan the - * leaf back in minus two classes, and every new controller in the leaf then arrived in that scan - * whether it was meant to or not. + * posture — a demo, a contract fixture — excludes exactly this class and still gets the error + * envelope, filters, health endpoint and rate limiting from the web root. Excluding it does not + * switch off {@code @RequiresPermission}: that is {@link WebMethodSecurityAutoConfiguration}, which + * an application keeps while it replaces the chain. Before this root was split from the web root, + * the only way to drop the security chain was to drop the whole root and component-scan the leaf + * back in minus two classes, and every new controller in the leaf then arrived in that scan whether + * it was meant to or not. * *

First among auto-configurations for the same reason as the web root: the filter chain and the * JWT decoder have to exist before Spring Boot's own security auto-configurations decide whether to diff --git a/src/adapter/inbound/websocket/CLAUDE.md b/src/adapter/inbound/websocket/CLAUDE.md index 93d1bd06..4b54b060 100644 --- a/src/adapter/inbound/websocket/CLAUDE.md +++ b/src/adapter/inbound/websocket/CLAUDE.md @@ -111,7 +111,7 @@ envelope contains only `type`, bounded string `fields`, and `occurredAt`. The br own bounded executor, so the simple broker's fan-out to subscribers never runs on the thread that published the domain event; a full broker queue drops the event (best-effort, R1). -No current `sample-portfolio` feature publishes a WebSocket event or contributes a projector. +템플릿에는 WebSocket 이벤트를 발행하거나 projector를 기여하는 기능이 없다. ## Evidence and limits diff --git a/src/adapter/outbound/fileserver/CLAUDE.md b/src/adapter/outbound/fileserver/CLAUDE.md index 996be8b8..2f89dd43 100644 --- a/src/adapter/outbound/fileserver/CLAUDE.md +++ b/src/adapter/outbound/fileserver/CLAUDE.md @@ -30,7 +30,7 @@ verification, identifiers, audit, metrics). Design rationale lives in [README.md ## Forbidden -- Inbound adapters, persistence, `app-bootstrap`, `sample-portfolio` (ArchUnit +- Inbound adapters, persistence, `app-bootstrap` (ArchUnit `OUTBOUND_ADAPTERS_*` family rules). - Leaking filesystem, stream, framework, or provider types across the application ports. - Advertising a platform feature as implemented unless `docs/fileserver/support-matrix.md` lists it. diff --git a/src/adapter/outbound/identifier/CLAUDE.md b/src/adapter/outbound/identifier/CLAUDE.md index 12ee7c98..bd2ac640 100644 --- a/src/adapter/outbound/identifier/CLAUDE.md +++ b/src/adapter/outbound/identifier/CLAUDE.md @@ -35,15 +35,14 @@ Declared in [build.gradle](build.gradle); the registry entry is the SSOT. - `:domain-core` — a feature's server-assigned id adapter implements its domain `*IdFactory` port here (registry edge `adapter:outbound:identifier -> domain-core`; `docs/manual/02-new-feature.md`). - `com.github.f4b6a3:uuid-creator` (`libs.uuid.creator`) — UUIDv7 for - `UuidV7DurableOperationIdFactory`, the generator the sample's id adapters use. + `UuidV7DurableOperationIdFactory`. ## Forbidden - Persistence or web technology (JPA/Hibernate/Spring Data/Spring Web) — ArchUnit `identifier_adapter_does_not_depend_on_other_adapters_or_bootstrap`; `.claude/hooks/ca_import_gate.py` G4 가 쓰기 시점에 차단. -- inbound adapters, persistence adapters, other outbound leaves, `app-bootstrap`, - `sample-portfolio`. +- inbound adapters, persistence adapters, other outbound leaves, `app-bootstrap`. - External IO (HTTP / messaging / cache / DB) — that belongs in `adapter-outbound`. ## Test diff --git a/src/adapter/outbound/identifier/README.md b/src/adapter/outbound/identifier/README.md index f740eb57..95acbb3d 100644 --- a/src/adapter/outbound/identifier/README.md +++ b/src/adapter/outbound/identifier/README.md @@ -11,7 +11,7 @@ leaf 이름은 `identifier`지만 범용 식별자 생성기·clock·random 소스는 여기 없다. 식별자 생성은 durable operation id(UUIDv7) 하나뿐이고(아래), 기능이 서버에서 id를 정하면 그 기능의 domain `*IdFactory` 구현도 여기 둔다(`:domain-core` 의존이 그 때문이다). 예전 문서가 범용 생성기 계획을 현재 내용처럼 적었다. 이름은 바꾸지 않았다: Gradle 경로·registry id·소비자 -(`composition:service-runtime`, `app-bootstrap`, `sample-portfolio`)의 의존 선언이 모두 이 이름을 +(`composition:service-runtime`, `app-bootstrap`)의 의존 선언이 모두 이 이름을 쓰고, 바꿔서 얻는 것은 이름 하나뿐이다. 외부 연동이 없는 crypto 능력을 새로 둘 곳이 필요하면 이 leaf에 둔다. 그때 이 절을 고친다. @@ -34,7 +34,7 @@ leaf에 둔다. 그때 이 절을 고친다. ## UuidV7DurableOperationIdFactory `DurableOperationIdFactory`(application-core) 구현. `UuidCreator.getTimeOrderedEpochPlus1()`로 UUIDv7을 -만든다(샘플 id adapter와 같은 방식). operation id는 제출 이벤트의 event id가 되고, messaging platform +만든다. operation id는 제출 이벤트의 event id가 되고, messaging platform `MessageId`는 UUIDv7만 받는다. 예전에는 web controller가 `UUID.randomUUID()`(v4)로 만들어 모든 제출 이벤트가 발행 시점에 거부되어 DEAD가 됐다(리뷰 2026-11-01 06-06, Kafka relay lane이 발견). `composition:durable-operation`이 bean으로 조립한다. diff --git a/src/adapter/outbound/identifier/build.gradle b/src/adapter/outbound/identifier/build.gradle index 577351c6..d037ecb0 100644 --- a/src/adapter/outbound/identifier/build.gradle +++ b/src/adapter/outbound/identifier/build.gradle @@ -12,6 +12,6 @@ dependencies { // A feature's server-assigned id adapter implements its domain `*IdFactory` port here // (registry edge `adapter:outbound:identifier -> domain-core`); docs/manual/02-new-feature.md. implementation project(':domain-core') - // UUIDv7 ids (UuidV7DurableOperationIdFactory), the generator the sample's id adapters use. + // UUIDv7 ids (UuidV7DurableOperationIdFactory). implementation libs.uuid.creator } diff --git a/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java b/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java index 7e317892..472cbb94 100644 --- a/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java +++ b/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java @@ -5,9 +5,9 @@ import dev.caskeleton.application.operation.DurableOperationId; import dev.caskeleton.application.operation.DurableOperationIdFactory; /** - * {@link DurableOperationIdFactory} minting time-ordered UUIDv7 ids, the same mechanism ({@code - * UuidCreator.getTimeOrderedEpochPlus1()}) the sample's identifier adapters use. The id is also the - * submission event's id, and the messaging platform's message id accepts only UUIDv7. + * {@link DurableOperationIdFactory} minting time-ordered UUIDv7 ids ({@code + * UuidCreator.getTimeOrderedEpochPlus1()}). The id is also the submission event's id, and the + * messaging platform's message id accepts only UUIDv7. */ public final class UuidV7DurableOperationIdFactory implements DurableOperationIdFactory { diff --git a/src/adapter/outbound/messaging/README.md b/src/adapter/outbound/messaging/README.md index 10323d26..433775e0 100644 --- a/src/adapter/outbound/messaging/README.md +++ b/src/adapter/outbound/messaging/README.md @@ -107,7 +107,7 @@ payload/envelope/exception-derived field는 받거나 렌더링하지 않는다. 있다. integration event 계약 검증은 루트 `verifyMessagingContracts`(`src/build.gradle`)가 한다. application-core· -shared-contract·sample-portfolio의 qualification lane 셋을 묶은 task다. 이 leaf는 그 검증에 관여하지 않는다. +shared-contract의 qualification lane 둘을 묶은 task다. 이 leaf는 그 검증에 관여하지 않는다. canonical path는 platform `PublishResult`의 confirmation/transmission evidence를 application `OutboxPublishOutcome`으로 명시적으로 변환하고, 실패 code를 `OutboxPublishAttempt`에 함께 싣는다. diff --git a/src/adapter/outbound/notification/build.gradle b/src/adapter/outbound/notification/build.gradle index 0d21c40b..b252150f 100644 --- a/src/adapter/outbound/notification/build.gradle +++ b/src/adapter/outbound/notification/build.gradle @@ -10,7 +10,7 @@ dependencies { implementation project(':application-notification') implementation project(':shared-contract') implementation project(':adapter:outbound:support') - // UUIDv7 for notification ids: the generator the sample's identifier adapters already use. + // UUIDv7 for notification ids: the generator adapter:outbound:identifier already uses. implementation libs.uuid.creator implementation 'org.springframework.boot:spring-boot-autoconfigure' diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java index 5ae5747c..24afb2bd 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java @@ -7,8 +7,8 @@ import java.util.Objects; import java.util.UUID; /** - * RFC 9562 UUIDv7, minted by uuid-creator — the same generator the sample's identifier adapters use - * (review S1-lead-2), rather than a second hand-written bit layout. + * RFC 9562 UUIDv7, minted by uuid-creator — the same generator the identifier adapter uses (review + * S1-lead-2), rather than a second hand-written bit layout. * *

Time-ordered rather than random because these identifiers are primary keys: a random UUID * scatters inserts across the whole index, and a notification table takes the highest insert rate diff --git a/src/adapter/outbound/objectstorage/CLAUDE.md b/src/adapter/outbound/objectstorage/CLAUDE.md index 973d3a8f..f7306d2f 100644 --- a/src/adapter/outbound/objectstorage/CLAUDE.md +++ b/src/adapter/outbound/objectstorage/CLAUDE.md @@ -36,8 +36,7 @@ readiness live in [README.md](README.md) and ## Forbidden -- Inbound adapters, sibling outbound adapters, persistence, app-bootstrap, or sample-portfolio - dependencies. +- Inbound adapters, sibling outbound adapters, persistence, or app-bootstrap dependencies. - Provider keys, paths, locators, SDK types, Spring types, or control-record types leaking into application-core. - A default provider/destination/namespace, local-dev in production, or startup mutation when the diff --git a/src/adapter/outbound/persistence-jpa/CLAUDE.md b/src/adapter/outbound/persistence-jpa/CLAUDE.md index 7aebdf5d..2508abee 100644 --- a/src/adapter/outbound/persistence-jpa/CLAUDE.md +++ b/src/adapter/outbound/persistence-jpa/CLAUDE.md @@ -192,8 +192,8 @@ module. The `fileserver` package is the current case: every `Jpa*` adapter there `@ConditionalOnProperty(prefix = "app.fileserver-platform", name = "enabled", havingValue = "true")`. Without the gate a composition root that merely includes this module builds those beans, and each of -them needs collaborators only the Fileserver configuration supplies — which is how `sample-portfolio` -came to fail on a Fileserver collaborator it has no use for. A store for a capability nobody enabled +them needs collaborators only the Fileserver configuration supplies. 지운 샘플 모듈이 쓰지도 않는 +Fileserver 협력 객체 때문에 기동에 실패한 일이 그 예다. A store for a capability nobody enabled should not exist. ## Allowed @@ -340,7 +340,7 @@ PostgreSQL `57P01`, `57P02`) or a transport break with no SQLState becomes Audit metadata (`created_at` / `updated_at` / `created_by` / `updated_by`) is an infrastructure concern that must never reach `domain-core`. It lives only on the `audit/AuditableEntity` `@MappedSuperclass`; a domain aggregate persistence entity opts in -by extending it (e.g. the sample `WorkLogEntity`). The domain aggregate itself carries +by extending it (생성 명령이 만드는 서비스 persistence leaf의 엔티티가 그렇게 한다). The domain aggregate itself carries zero audit fields, enforced by ArchUnit `domain_is_pure` (no `jakarta.persistence..`) plus `domain_entities_do_not_carry_audit_fields` (no `createdAt`/`updatedAt`/`createdBy`/`updatedBy` fields under `..domain..`). diff --git a/src/adapter/outbound/persistence-jpa/README.md b/src/adapter/outbound/persistence-jpa/README.md index 065b17a0..fcc260cf 100644 --- a/src/adapter/outbound/persistence-jpa/README.md +++ b/src/adapter/outbound/persistence-jpa/README.md @@ -50,8 +50,7 @@ durable operation HTTP 엔드포인트(`POST /operations`·`GET`·`DELETE /opera append 포트(`APP_OUTBOX_ENABLED=true`)가 모두 있을 때만 켜진다. submit·cancel에는 `operation-submit` 역할(`operation:submit`, `operation:cancel`)이 필요하다. -애플리케이션이 제공해야 하는 bean: `Clock`, `DomainContextPropagator`(app-bootstrap과 -sample-portfolio가 제공). +애플리케이션이 제공해야 하는 bean: `Clock`, `DomainContextPropagator`(app-bootstrap이 제공). **필요한 env 키** (`src/.env.example`, 레지스트리 `docs/registries/env-keys.yaml`) @@ -173,10 +172,10 @@ Spring Boot 메인 클래스는 `dev.caskeleton.bootstrap` 에 있어서, `@Auto 소유한 모듈에 둬서 와이어링을 그 자리에 유지한다. ### 왜 이름이 `JpaConfig` 가 아닌가 -sample 모듈에 이미 `...sample.portfolio.adapter.persistence.config.JpaConfig` 가 있다. IDE 의 -"Run main class" 가 테스트 스코프 sample 모듈을 클래스패스에 올리면, simple name `JpaConfig` 를 +서비스가 자기 설정 클래스에 `JpaConfig` 라는 이름을 쓰기 쉽다. 그러면 simple name `JpaConfig` 를 공유하는 두 `@Configuration` 이 기본 빈 이름 `jpaConfig` 에서 충돌한다 -(`ConflictingBeanDefinitionException`). 다른 simple name 으로 이를 피한다. +(`ConflictingBeanDefinitionException`). 다른 simple name 으로 이를 피한다. 처음 충돌한 곳은 지운 +샘플 모듈의 `JpaConfig` 였다. ## failure — 퍼시스턴스 실패 변환 SPI @@ -589,7 +588,7 @@ holder 가 락을 잡을 수 있다. 아래)이 아래 가드를 등록한다. 전부 `adapter:outbound:support`의 `StartupFailures`로 실패하므로 exit 코드(78/70/71)와 구조화 로그 필드(`startup.phase`/`error.code`/`error.category`)는 옮기기 전과 같다. `migrationStartupRunner`는 `@ConditionalOnMissingBean(FlywayMigrationStrategy)`라, 자기 전략을 둔 -애플리케이션(sample-portfolio의 두 번째 마이그레이션 스트림)에는 끼어들지 않는다. +애플리케이션(예: 두 번째 마이그레이션 스트림을 돌리는 서비스)에는 끼어들지 않는다. ### FlywayProdSafetyValidator - **`prod` 프로파일에서 Flyway 안전장치가 꺼지지 못하도록 런타임에서 강제한다.** Flyway 옵션은 diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java index b26c8b41..a40f9cd4 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java @@ -8,7 +8,7 @@ import org.springframework.data.jpa.repository.config.EnableJpaRepositories; * Registers this module's always-installed JPA entities and Spring Data repositories. * *

The explicit scans are required because the Boot main class lives in another package; the - * simple name avoids {@code JpaConfig} to dodge a bean-name collision with the sample module. See + * simple name avoids {@code JpaConfig}, a name a service's own configuration is likely to take. See * README "config". * *

The package list is enumerated rather than given as the persistence root. {@code diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java index 3a933778..e23e34ca 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java @@ -125,7 +125,7 @@ public class JpaOutboxStore * and increments the committed counter instead (review RR-03-01). * *

Statements rather than one {@code INSERT … ON CONFLICT DO UPDATE … RETURNING} like {@code - * JpaLiveEventReplay}'s position allocator: the sample appends events on the H2 developer run + * JpaLiveEventReplay}'s position allocator: a service appends events on the H2 developer run * ({@code bootRunH2}), and H2 accepts {@code ON CONFLICT DO NOTHING} but not {@code DO UPDATE}. * The common case — the counter exists — is still one {@code UPDATE} and one read. */ diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java index 64816cff..d77279fd 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java @@ -60,7 +60,7 @@ class JpaStartupAutoConfiguration { * Runs Flyway during refresh, before readiness, and turns a failure into exit 70. * *

The bean name is what Flyway auto-configuration looks up. An application that supplies its - * own strategy — the sample runs a second migration stream — keeps it. + * own strategy — to run a second migration stream, say — keeps it. */ @Bean @ConditionalOnMissingBean(FlywayMigrationStrategy.class) diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java index 57e0d4a6..fad7c2cd 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java @@ -10,12 +10,11 @@ import org.springframework.stereotype.Repository; * A candidate implementation nobody selected must not be composed. * *

{@code CaSkeletonApplication} excludes {@code dev.caskeleton.adapter.outbound.persistence..*} - * from its component scan, but {@code SamplePortfolioApplication} scans all of {@code - * dev.caskeleton}. So a {@code @Repository} on a PostgreSQL-only adapter becomes a bean there — - * including under H2, which has no migration tree at all, and in a database that never applied the - * optional stream the adapter reads. The bean exists and its tables do not: the failure surfaces as - * vendor-specific SQL against a missing relation, or as a boot failure under {@code - * ddl-auto=validate}. + * from its component scan, but a service application may scan all of {@code dev.caskeleton}. So a + * {@code @Repository} on a PostgreSQL-only adapter becomes a bean there — including under H2, which + * has no migration tree at all, and in a database that never applied the optional stream the + * adapter reads. The bean exists and its tables do not: the failure surfaces as vendor-specific SQL + * against a missing relation, or as a boot failure under {@code ddl-auto=validate}. */ class CandidateAdapterCompositionTest { diff --git a/src/adapter/outbound/persistence-mongo/CLAUDE.md b/src/adapter/outbound/persistence-mongo/CLAUDE.md index 78581cee..71ce0ab9 100644 --- a/src/adapter/outbound/persistence-mongo/CLAUDE.md +++ b/src/adapter/outbound/persistence-mongo/CLAUDE.md @@ -64,15 +64,14 @@ design package's assumed module layout onto this leaf lives in carry it. The leaf is imperative only: the reactive twin (`reactive/**`, reactive transactions/sessions), the change-stream consumer and the change-stream-to-messaging bridge were removed on 2026-09-25 (see `docs/capability-status.md`), so the leaf carries neither the reactive - starter nor the reactive-streams driver (`MongoReactiveDriverAbsenceTest`). `sample-portfolio` - does not carry it. + starter nor the reactive-streams driver (`MongoReactiveDriverAbsenceTest`). - External includes the (sync) Mongo starter, spring-boot-autoconfigure, spring-boot-health, micrometer-core, slf4j-api, and the configuration processor. Jackson annotations are compile-only because Boot Health carries Jackson annotations while runtime JSON serialization remains application-owned. Versions come from the shared Spring Boot BOM; never pin the driver directly. - Test-only: ArchUnit, Testcontainers (`mongodb`, `toxiproxy`). ## Forbidden -- Inbound adapters, sibling outbound adapters, `app-bootstrap`, `sample-portfolio` (ArchUnit +- Inbound adapters, sibling outbound adapters, `app-bootstrap` (ArchUnit `OUTBOUND_ADAPTERS_*` family rules). - Shipping placeholder `Example*` document, repository, record, or adapter types in production. - Adding idempotency/outbox/lock on Mongo without a separately approved contract. diff --git a/src/app-bootstrap/CLAUDE.md b/src/app-bootstrap/CLAUDE.md index 4b669b38..e12f76f1 100644 --- a/src/app-bootstrap/CLAUDE.md +++ b/src/app-bootstrap/CLAUDE.md @@ -65,12 +65,10 @@ configurations, Redis as one 376-line class. composition every application needs: `common` (the clock). The outbox relay, the idempotency executor and the durable operations (use cases and `/operations` endpoints, 07-08) are `composition:outbox-relay`, `composition:idempotency` and `composition:durable-operation`, selected - by one `runtimeOnly` line each and building nothing until their ports exist (the sample takes the - idempotency one too). A capability's role→permission mapping ships in its own - `config/module-defaults` file, not in `config/security.yml`. The runtime wiring both composition roots need — + by one `runtimeOnly` line each and building nothing until their ports exist. A capability's role→permission mapping ships in its own + `config/module-defaults` file, not in `config/security.yml`. The runtime wiring every composition root needs — tracing, the metrics contract filters, domain-context propagation, user-principal pseudonymization - (`PrivacySettings`) and the actuator chain — is `composition:service-runtime`, which the sample - takes by the same line instead of carrying copies. + (`PrivacySettings`) and the actuator chain — is `composition:service-runtime`. - **`Settings` lives beside its capability**, not in `settings/`. The `settings/` package holds only settings that belong to no capability — `BootstrapSettings`, `RuntimeSafetySettings` — bound strictly with `StrictSettingsBinder`, never scanned. Logging has no settings record: diff --git a/src/app-bootstrap/README.md b/src/app-bootstrap/README.md index 91b2b7ee..1be5fd00 100644 --- a/src/app-bootstrap/README.md +++ b/src/app-bootstrap/README.md @@ -302,8 +302,7 @@ DB 연결이 꼭 필요한 persistence-jpa의 datasource 버전 검사는 bean executor 조립(`IdempotencyAutoConfiguration`)과 수명 정책(`IdempotencySettings`, strict 바인딩), 설정 기본값(`config/module-defaults/idempotency.yml`, 예전 `config/capabilities.yml`)은 -`composition:idempotency`로 옮겼다(소유자 결정 3). 이 leaf는 `runtimeOnly` 한 줄로 받고, -sample-portfolio도 같은 줄을 쓴다. 근거는 [그 모듈의 README](../composition/idempotency/README.md). +`composition:idempotency`로 옮겼다(소유자 결정 3). 이 leaf는 `runtimeOnly` 한 줄로 받는다. 근거는 [그 모듈의 README](../composition/idempotency/README.md). ## outbox — 트랜잭셔널 아웃박스 릴레이 (composition:outbox-relay로 이동) @@ -509,9 +508,6 @@ ArchUnit 규칙이 **금지**하는 타입을 fixture 가 일부러 import 해 - `spring-cloud-context` — `@RefreshScope` 금지(no-refresh-scope) fixture 용. Spring Cloud 는 production 에 없고 규칙은 애너테이션을 FQN 문자열로 참조한다. BOM 이 spring-cloud 좌표를 관리하지 않아 버전을 명시 고정한다. -- **`testImplementation project(':sample-portfolio')`** — ArchUnit 이 템플릿 reference 구현을 분석하려고 - test 경로에만 둔다. **production 은 절대 sample-portfolio 에 의존 금지** — - `production_code_does_not_depend_on_sample_portfolio` 규칙이 강제한다. ### 빌드 설정 - **test JVM UTC 고정(`-Duser.timezone=UTC`)** — `RuntimeHealthLifecycleContractTest`가 diff --git a/src/app-bootstrap/build.gradle b/src/app-bootstrap/build.gradle index 6aea0486..e98e280c 100644 --- a/src/app-bootstrap/build.gradle +++ b/src/app-bootstrap/build.gradle @@ -124,7 +124,7 @@ sourceSets { // Every capability a service can select — the commented runtimeOnly lines below — listed once. // Three consumers read it — the environment contract's metadata classpath (verifyEnvKeys, below) // and these two: the whole-repository ArchUnit import (spec §7: the architecture suite sees -// every module of this build and the sample, the shipped runtime only the selected ones; the +// every module of this build, the shipped runtime only the selected ones; the // optional-platforms build is held by its own Gradle direction gate instead) and the qualification artifact the // Compose lanes boot (qualificationBootJar, below). None of them reaches `bootJar`, `test` or // `systemTest`, because a capability on a classpath is switched on there by its mere presence. @@ -169,26 +169,22 @@ dependencies { // runtimeOnly project(':composition:notification-platform') // 알림 (persistence-jpa·persistence-notification을 함께 가져온다) // 기본 조립에 있는 application composition. 셋 다 포트만 보고, 필요한 것(outbox store, 멱등성 - // provider)이 없으면 아무것도 만들지 않는다. sample-portfolio도 같은 멱등성 모듈을 쓴다. + // provider)이 없으면 아무것도 만들지 않는다. runtimeOnly project(':composition:outbox-relay') // outbox relay (store·발행 포트가 있을 때만) runtimeOnly project(':composition:idempotency') // 요청 멱등성 executor (provider≠disabled) runtimeOnly project(':composition:durable-operation') // /operations (operation store·outbox가 있을 때만) // 모든 서비스가 받는 runtime 배선: tracing, metrics 계약 filter, domain context, user principal - // 가명화, actuator 보안 chain. sample-portfolio도 같은 줄을 쓴다. + // 가명화, actuator 보안 chain. runtimeOnly project(':composition:service-runtime') // Contract tests pin those pieces by type (tracing gauge, metrics filters, actuator chain). testImplementation project(':composition:service-runtime') integrationTestImplementation project(':composition:service-runtime') capabilityProjects.each { architectureTestRuntimeOnly project(it) } - // The sample is the reference adopters copy, so the whole-repository rules read it too (review - // BUILD-중복-8). Architecture-test runtime only: no production configuration reaches it. - // // What this import does NOT see: the optional-platforms build (`grpc:*`, `grpc-advanced:*`). // It is a separate Gradle build, so its classes cannot be on this classpath; its registered // leaves are held by the Gradle direction gate (`-p optional-platforms ci` runs // verifyCleanArchitectureDependencies), which is the whole of what the owner decided it needs. - architectureTestRuntimeOnly project(':sample-portfolio') // The capability integration lane selects Fileserver and object storage together, as a service // would, and turns off whichever one a test is not about. @@ -351,8 +347,6 @@ def repositoryContractInputs = files( }, fileTree(rootProject.projectDir) { include 'config/**', '**/*.gradle', 'gradle/*.toml', 'Dockerfile*', '.env*', '**/src/main/**' - // SampleRuntimeDefaultsContractTest compares the sample's runtime defaults with these. - include 'sample-portfolio/src/main/resources/application.yml' exclude '**/*.md' exclude repositoryContractExcludes }) diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java index f32f513e..f47f24c6 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java @@ -46,7 +46,7 @@ class RuntimeProfileAccessArchitectureTest { .that() .resideInAPackage("dev.caskeleton..") .and() - .resideOutsideOfPackages("dev.caskeleton.messaging..", "dev.caskeleton.sample..") + .resideOutsideOfPackage("dev.caskeleton.messaging..") .and(DescribedPredicate.not(A_NAMED_PROFILE_READER)) .should() .callMethod(Environment.class, "getActiveProfiles") diff --git a/src/app-bootstrap/src/main/resources/config/security.yml b/src/app-bootstrap/src/main/resources/config/security.yml index 4ed3b8a6..5037d38a 100644 --- a/src/app-bootstrap/src/main/resources/config/security.yml +++ b/src/app-bootstrap/src/main/resources/config/security.yml @@ -35,8 +35,7 @@ app: # wildcards — least-privilege, OWASP-AUTHZ-C4). A capability's own permissions arrive with it, in # that module's config/module-defaults file (notification, fileserver, durable-operation), and # leave with its build line (07-08). Map entries from every source merge, so a deployment adds its - # own roles in its profile file or environment beside them. Sample-domain permissions live in - # sample-portfolio. + # own roles in its profile file or environment beside them. cors: # true | false enabled: ${APP_SECURITY_CORS_ENABLED:false} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java index 546ec57d..1d1fa39d 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java @@ -383,25 +383,6 @@ class DeveloperExperienceContractTest { .contains("./gradlew -p optional-platforms integrationCheck"); } - @Test - @Tag("repository-contract") - @DisplayName("샘플 이미지의 의존성 단계는 릴리스 이미지와 같은 파일을 같은 순서로 복사한다") - void theSampleImageDependencyStageCopiesWhatTheReleaseImageCopies() throws IOException { - // given - String release = read("src/Dockerfile"); - String sample = read("src/Dockerfile.sample"); - - // when - List releaseCopies = dependencyStageCopies(release); - List sampleCopies = dependencyStageCopies(sample); - - // then - // The sample's copy of this stage once missed gradle.properties and build-logic/, so settings - // could not resolve the convention plugins and the image did not build at all (07-04). - assertThat(sampleCopies).isNotEmpty().isEqualTo(releaseCopies); - assertDockerDependencyCacheContract("src/Dockerfile.sample", sample); - } - @Test @Tag("repository-contract") @DisplayName("compose 종료 유예 시간은 웹 drain, async 대기, preStop, 여유를 모두 더한 값 이상이다") @@ -491,11 +472,6 @@ class DeveloperExperienceContractTest { return mappings; } - private static List dependencyStageCopies(String dockerfile) { - String prefix = dockerfile.substring(0, dockerfile.indexOf("./gradlew")); - return prefix.lines().filter(line -> line.startsWith("COPY ")).toList(); - } - @Test @Tag("repository-contract") void dockerBuildConsumesOnlyTheGradleStagedExecutableJar() throws IOException { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java deleted file mode 100644 index 805a300f..00000000 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java +++ /dev/null @@ -1,214 +0,0 @@ -package dev.caskeleton.bootstrap.contract; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.bootstrap.contract.support.RepositoryContractResources; -import java.io.IOException; -import java.io.UncheckedIOException; -import java.nio.file.Files; -import java.nio.file.Path; -import java.util.ArrayDeque; -import java.util.ArrayList; -import java.util.Deque; -import java.util.LinkedHashMap; -import java.util.LinkedHashSet; -import java.util.List; -import java.util.Map; -import java.util.Set; -import java.util.TreeSet; -import java.util.regex.Matcher; -import java.util.regex.Pattern; -import java.util.stream.Stream; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Tag; -import org.junit.jupiter.api.Test; -import org.yaml.snakeyaml.LoaderOptions; -import org.yaml.snakeyaml.Yaml; -import org.yaml.snakeyaml.constructor.SafeConstructor; - -/** - * The sample keeps the default composition's runtime defaults, so a number measured on the sample — - * thread count, pool wait — says something about the composition a service ships (09-08), and it - * carries only settings something on its classpath reads. It reads configuration files, build - * scripts and production sources, so it runs in the pull-request {@code repository-contract} lane - * (08-03). - */ -@Tag("repository-contract") -class SampleRuntimeDefaultsContractTest { - - private static final Path REPOSITORY_ROOT = repositoryRoot(); - private static final Pattern DEFAULT = Pattern.compile("^\\$\\{[A-Z0-9_]+:(.*)}$"); - - @Test - @DisplayName("샘플은 가상 스레드와 앱 로그 레벨 기본값을 기본 조합과 같게 둔다") - void theSampleKeepsTheDefaultCompositionRuntimeDefaults() throws IOException { - // given - Map bootstrap = new LinkedHashMap<>(); - flatten("", load("src/app-bootstrap/src/main/resources/application.yml"), bootstrap); - flatten("", load("src/app-bootstrap/src/main/resources/config/observability.yml"), bootstrap); - Map sample = new LinkedHashMap<>(); - flatten("", load("src/sample-portfolio/src/main/resources/application.yml"), sample); - - // when - Map differing = new LinkedHashMap<>(); - for (String key : - new String[] {"spring.threads.virtual.enabled", "logging.level.dev.caskeleton"}) { - String expected = defaultOf(bootstrap.get(key)); - String actual = defaultOf(sample.get(key)); - if (actual != null && !actual.equals(expected)) { - differing.put(key, actual + " (default composition: " + expected + ")"); - } - } - - // then - assertThat(differing).isEmpty(); - } - - @Test - @DisplayName("샘플은 persistence-jpa 모듈의 풀 대기 시간 기본값을 덮어쓰지 않는다") - void theSampleDoesNotOverrideTheModulePoolWait() throws IOException { - // given - Map sample = new LinkedHashMap<>(); - flatten("", load("src/sample-portfolio/src/main/resources/application.yml"), sample); - - // when - Object connectionTimeout = sample.get("spring.datasource.hikari.connection-timeout"); - - // then - // The module's 5000 ms is a fail-fast decision; the sample's 30000 made a dry pool wait six - // times longer there than in the default composition. - assertThat(connectionTimeout).isNull(); - } - - @Test - @DisplayName("샘플 application.yml의 app.* 설정 묶음은 샘플 classpath에 있는 모듈 코드가 읽는다") - void everySampleAppSettingGroupIsReadByAModuleOnTheSampleClasspath() throws IOException { - // given - Set groups = new TreeSet<>(); - for (Object document : loadAll("src/sample-portfolio/src/main/resources/application.yml")) { - if (document instanceof Map map && map.get("app") instanceof Map app) { - app.keySet().forEach(key -> groups.add(String.valueOf(key))); - } - } - Set classpath = sampleRuntimeModules(); - - // when - Set unread = new TreeSet<>(); - for (String group : groups) { - Pattern reader = Pattern.compile("app\\." + Pattern.quote(group) + "[\".}]"); - if (classpath.stream().noneMatch(module -> anyMainSourceMatches(module, reader))) { - unread.add("app." + group); - } - } - - // then - // The sample is copied first. A block nothing on its classpath reads — the HTTP client's - // timeouts with no HTTP client module, a messaging broker with no messaging module — is a - // setting the copier believes is in force and is not (review 2026-11-03 RR-06-06, 09-08). - assertThat(unread) - .as("app.* groups in the sample's application.yml that nothing reads") - .isEmpty(); - } - - /** The source directories of the sample and every project its production configurations reach. */ - private static Set sampleRuntimeModules() throws IOException { - String registry = - Files.readString(REPOSITORY_ROOT.resolve("src/config/architecture/modules.json")); - Map sourceOf = new LinkedHashMap<>(); - Matcher module = - Pattern.compile("\"gradle_path\":\\s*\"([^\"]+)\",\\s*\"source_path\":\\s*\"([^\"]+)\"") - .matcher(registry); - while (module.find()) { - sourceOf.put(module.group(1), module.group(2)); - } - sourceOf.put(":sample-portfolio", "src/sample-portfolio"); - Pattern edge = - Pattern.compile( - "(?m)^\\s*(?:api|implementation|runtimeOnly)\\s*\\(?\\s*project\\(\\s*['\"](:[^'\"]+)['\"]"); - Set reached = new LinkedHashSet<>(); - Deque pending = new ArrayDeque<>(List.of(":sample-portfolio")); - Set seen = new LinkedHashSet<>(); - while (!pending.isEmpty()) { - String path = pending.pop(); - String source = sourceOf.get(path); - if (!seen.add(path) || source == null) { - continue; - } - Path directory = REPOSITORY_ROOT.resolve(source); - reached.add(directory); - Matcher dependency = edge.matcher(Files.readString(directory.resolve("build.gradle"))); - while (dependency.find()) { - pending.add(dependency.group(1)); - } - } - return reached; - } - - private static boolean anyMainSourceMatches(Path module, Pattern reader) { - Path sources = module.resolve("src/main/java"); - if (!Files.isDirectory(sources)) { - return false; - } - try (Stream files = Files.walk(sources)) { - return files - .filter(file -> file.toString().endsWith(".java")) - .anyMatch( - file -> { - try { - return reader.matcher(Files.readString(file)).find(); - } catch (IOException failure) { - throw new UncheckedIOException(failure); - } - }); - } catch (IOException failure) { - throw new UncheckedIOException(failure); - } - } - - private static List loadAll(String relative) throws IOException { - LoaderOptions options = new LoaderOptions(); - options.setMaxAliasesForCollections(0); - List documents = new ArrayList<>(); - new Yaml(new SafeConstructor(options)) - .loadAll(Files.readString(REPOSITORY_ROOT.resolve(relative))) - .forEach(documents::add); - return documents; - } - - private static String defaultOf(Object value) { - if (value == null) { - return null; - } - String text = String.valueOf(value).trim(); - Matcher matcher = DEFAULT.matcher(text); - return matcher.matches() ? matcher.group(1) : text; - } - - private static Map load(String relative) throws IOException { - LoaderOptions options = new LoaderOptions(); - options.setMaxAliasesForCollections(0); - Object first = - new Yaml(new SafeConstructor(options)) - .loadAll(Files.readString(REPOSITORY_ROOT.resolve(relative))) - .iterator() - .next(); - assertThat(first).as(relative).isInstanceOf(Map.class); - return (Map) first; - } - - private static void flatten(String prefix, Map map, Map into) { - map.forEach( - (key, value) -> { - String name = prefix.isEmpty() ? String.valueOf(key) : prefix + "." + key; - if (value instanceof Map child) { - flatten(name, child, into); - } else { - into.put(name, value); - } - }); - } - - private static Path repositoryRoot() { - return RepositoryContractResources.fromSystemProperty().repositoryRoot(); - } -} diff --git a/src/application-core/CLAUDE.md b/src/application-core/CLAUDE.md index 64110b78..0d8b3171 100644 --- a/src/application-core/CLAUDE.md +++ b/src/application-core/CLAUDE.md @@ -274,7 +274,7 @@ generation; the V1 `IdempotencyScope`/`tryBegin` API is gone. - **Executor**: built once by `composition:idempotency` `IdempotencyAutoConfiguration` from `IdempotencySettings` (processing lease 30s, replay TTL `APP_IDEMPOTENCY_TTL` 24h ≤72h and not shorter than the lease, failure retention 24h and not shorter than the replay TTL). Do not - construct it in a use case or a sample config. + construct it in a use case or a service's own config. - The action returns `IdempotentAction.Outcome` (`Success` / `RetryableNoEffect` / `EffectUnknown`); a thrown exception counts as effect-unknown. In progress → 409 `IDEMPOTENT_IN_FLIGHT`, fingerprint mismatch (SHA-256) → 422 `IDEMPOTENT_REQUEST_MISMATCH`; @@ -310,15 +310,14 @@ The read side has two equally-valid shapes; pick per read, do not force one: | Shape | Returns | When | How | |---|---|---|---| -| **Through-aggregate** (default for simple reads) | domain aggregate via a `*Repository` port | read shape == write aggregate **and** the aggregate is the minimal invariant boundary (no lazy collections needed) | `QueryUseCase` → repository port → `WorkLog` | -| **Projection (CQRS-lite)** | application-layer projection DTO via a `*QueryPort` | read shape ≠ write, or to skip aggregate hydration / lazy-collection joins | `QueryUseCase` → `*QueryPort` → `WorkLogSummary` (record); query via JPQL `SELECT new` / JdbcTemplate | +| **Through-aggregate** (default for simple reads) | domain aggregate via a `*Repository` port | read shape == write aggregate **and** the aggregate is the minimal invariant boundary (no lazy collections needed) | `QueryUseCase` → repository port → `Order` | +| **Projection (CQRS-lite)** | application-layer projection DTO via a `*QueryPort` | read shape ≠ write, or to skip aggregate hydration / lazy-collection joins | `QueryUseCase` → `*QueryPort` → `OrderSummary` (record); query via JPQL `SELECT new` / JdbcTemplate | - **Purity guardrail (core, machine-enforced):** a read port whose simple name ends with `QueryPort` MUST return application-layer projection DTOs only — never a domain aggregate, JPA entity, or web type, **including through generic type arguments** (`List`). Enforced by ArchUnit `query_ports_do_not_leak_domain_jpa_or_web_types`. - Projection usage itself is **opt-in**, not a forced default; the demo lives in - `sample-portfolio` (`WorkLogSummaryQueryPort` / `WorkLogSummary`). + Projection usage itself is **opt-in**, not a forced default. - **Strict ceremony:** every read goes through a `QueryUseCase` bean. There is no thin web→read-port path — that would bypass the mandatory `@UseCaseCapability` fitness function. - **Transaction:** reads default to `TransactionPort.inRead`. A no-tx (autocommit) read diff --git a/src/application-core/README.md b/src/application-core/README.md index 639d067f..cce525f4 100644 --- a/src/application-core/README.md +++ b/src/application-core/README.md @@ -286,7 +286,7 @@ application 계층이 claim·replay·복구 **정책** 을 소유하고, 저장 실행 중이면 주인은 여전히 `complete`·`markFailed` 할 수 있다(RR5-01-02). - 생성은 app-bootstrap `IdempotencyProviderSelectionConfig` 가 한 번 한다(`IdempotencySettings`: processing lease 30s, replay TTL 24h(최대 72h), failure retention 24h(replay TTL 이상), codec id `json-v2`, - policy revision 2). 유스케이스나 샘플 설정이 직접 만들지 않는다. + policy revision 2). 유스케이스나 서비스 설정이 직접 만들지 않는다. - 이 계약은 요청 재생(replay) 근거를 남길 뿐이다. store 와 비즈니스 DB 사이의 exactly-once 를 보장하지 않는다. @@ -307,8 +307,7 @@ application 계층이 claim·replay·복구 **정책** 을 소유하고, 저장 HMAC-SHA-256 으로 digest** 한 값이다(`digest`, `keyDigestVersion`, `operationCode`). - raw 클라이언트 key 와 principal 은 executor·store·로그·메트릭 어디에도 닿지 않는다. 예외 메시지의 진단 문자열도 이 digest 로만 만든다. -- digest 를 만드는 쪽(키 링, 버전 교체)은 adapter 나 유스케이스 소유다. 예: sample 의 - `HmacPosterImageIdempotencyScopeDigester`. +- digest 를 만드는 쪽(키 링, 버전 교체)은 adapter 나 유스케이스 소유다. ### RequestFingerprint @@ -607,7 +606,7 @@ leaf의 코드 Javadoc과 `docs/notification/`이 정본이다. R1 오케스트 ### CorrelationIdPort - 현재 application invocation의 correlation id를 `Optional`으로 읽는 framework-free - 경계다. application/sample use case는 MDC나 SLF4J를 직접 알지 않는다. + 경계다. application use case는 MDC나 SLF4J를 직접 알지 않는다. - inbound web adapter가 sanitized `correlation_id` MDC 슬롯을 구현 세부로 읽는다. - 값이 없거나 blank이면 event publisher는 생성한 event id를 correlation id로 재사용해 기존 self-correlation 동작을 유지한다. diff --git a/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java b/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java index 24f219ab..80fe518e 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java @@ -133,7 +133,7 @@ class IntegrationEventContractContributionTest { void descriptorContainsOnlyBoundedProviderNeutralContractMetadata() { ContractDescriptor descriptor = descriptor(); - assertThat(descriptor.ownerModule()).isEqualTo("sample-portfolio"); + assertThat(descriptor.ownerModule()).isEqualTo("example-feature"); assertThat(descriptor.logicalDestination()) .isEqualTo(new LogicalDestinationId("portfolio-domain-events")); assertThat(descriptor.maximumPayloadBytes()).isEqualTo(64 * 1024); @@ -152,7 +152,7 @@ class IntegrationEventContractContributionTest { assertThatThrownBy( () -> new ContractDescriptor( - "sample-portfolio", + "example-feature", new LogicalDestinationId("portfolio-domain-events"), "json-envelope-v1", true, @@ -165,7 +165,7 @@ class IntegrationEventContractContributionTest { private static ContractDescriptor descriptor() { return new ContractDescriptor( - "sample-portfolio", + "example-feature", new LogicalDestinationId("portfolio-domain-events"), "json-envelope-v1", true, diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java index 6a135273..a91b3602 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java @@ -38,7 +38,7 @@ class ModuleRegistryTest { read( registry( entry("app-bootstrap", ":app-bootstrap", "src/alpha"), - entry("sample-portfolio", ":sample-portfolio", "src/beta"), + entry("example-app", ":example-app", "src/beta"), entry("app-bootstrap", ":other", "src/alpha")))); assertTrue(failure.getMessage().contains("duplicate module id"), failure.getMessage()); } @@ -52,7 +52,7 @@ class ModuleRegistryTest { read( registry( entry("app-bootstrap", ":app-bootstrap", "src/alpha"), - entry("sample-portfolio", ":sample-portfolio", "src/beta"), + entry("example-app", ":example-app", "src/beta"), entry("aliased", ":aliased", "src/beta/../alpha")))); assertTrue(failure.getMessage().contains("duplicate or aliased"), failure.getMessage()); } @@ -66,10 +66,10 @@ class ModuleRegistryTest { "app-bootstrap", ":app-bootstrap", "src/alpha", - "[\"sample-portfolio\",\"unknown\",\"app-bootstrap\"]"), - entry("sample-portfolio", ":sample-portfolio", "src/beta"))); + "[\"example-app\",\"unknown\",\"app-bootstrap\"]"), + entry("example-app", ":example-app", "src/beta"))); assertEquals( - List.of("sample-portfolio", "unknown", "app-bootstrap"), + List.of("example-app", "unknown", "app-bootstrap"), parsed.byId("app-bootstrap").allowedDependencies()); } @@ -81,7 +81,7 @@ class ModuleRegistryTest { {"id":"app-bootstrap","gradle_path":":app-bootstrap","source_path":"src/alpha"}, %s]} """ - .formatted(entry("sample-portfolio", ":sample-portfolio", "src/beta")); + .formatted(entry("example-app", ":example-app", "src/beta")); IllegalStateException failure = assertThrows(IllegalStateException.class, () -> read(json)); assertTrue(failure.getMessage().contains("allowed_dependencies"), failure.getMessage()); } @@ -158,7 +158,7 @@ class ModuleRegistryTest { private String valid() { return registry( entry("app-bootstrap", ":app-bootstrap", "src/alpha"), - entry("sample-portfolio", ":sample-portfolio", "src/beta")); + entry("example-app", ":example-app", "src/beta")); } private static String entry(String id, String path, String source) { diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java index 6936c661..2543a1ac 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java @@ -28,19 +28,19 @@ class CleanArchitectureResolvedClasspathFunctionalTest { } @Test - void samplePortfolioCompositionRootIsGovernedByTheSameDependencyPolicy( + void aSecondCompositionRootIsGovernedByTheSameDependencyPolicy( @TempDir Path temporaryRoot) throws IOException { Path repository = temporaryRoot.resolve("repository"); Path project = repository.resolve("src"); Files.createDirectories(project.resolve("config/architecture")); Files.createDirectories(project.resolve("a")); - Files.createDirectories(project.resolve("sample-portfolio")); + Files.createDirectories(project.resolve("example-app")); Files.writeString( project.resolve("settings.gradle"), """ rootProject.name = 'main' - include 'a', 'sample-portfolio' + include 'a', 'example-app' """, UTF_8); Files.writeString( @@ -48,7 +48,7 @@ class CleanArchitectureResolvedClasspathFunctionalTest { """ plugins { id 'ca.architecture' } subprojects { apply plugin: 'java-library' } - project(':sample-portfolio') { + project(':example-app') { dependencies { implementation project(':a') } } """, @@ -65,9 +65,9 @@ class CleanArchitectureResolvedClasspathFunctionalTest { "allowed_dependencies": [] }, { - "id": "sample-portfolio", - "gradle_path": ":sample-portfolio", - "source_path": "src/sample-portfolio", + "id": "example-app", + "gradle_path": ":example-app", + "source_path": "src/example-app", "allowed_dependencies": [] } ] @@ -78,7 +78,7 @@ class CleanArchitectureResolvedClasspathFunctionalTest { BuildResult result = runner(project, "verifyCleanArchitectureDependencies").buildAndFail(); assertThat(result.getOutput()) - .contains("Module ':sample-portfolio' has forbidden project dependencies [a]"); + .contains("Module ':example-app' has forbidden project dependencies [a]"); } @Test diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java index c81c00bd..3d974e64 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java @@ -30,12 +30,12 @@ class VerifyNoIgnoredSourcePackagesFunctionalTest { } @Test - void sourceInAnIgnoredPackageOfTheSamplePortfolioFailsTheGate(@TempDir Path temporaryRoot) + void sourceInAnIgnoredPackageOfAnyLeafFailsTheGate(@TempDir Path temporaryRoot) throws IOException { // given - Path project = fixture(temporaryRoot, "sample-portfolio"); - source(project, "sample-portfolio/src/main/java/example/Ok.java"); - source(project, "sample-portfolio/src/main/java/example/build/Ignored.java"); + Path project = fixture(temporaryRoot, "example-app"); + source(project, "example-app/src/main/java/example/Ok.java"); + source(project, "example-app/src/main/java/example/build/Ignored.java"); // when BuildResult result = runner(project).buildAndFail(); diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java index ff933dcb..ab24e44b 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java @@ -134,7 +134,7 @@ class WorkflowGradleInvocationsTest { // given String workflow = """ - - run: ./gradlew integrationCheck sample-portfolio:check --tests '*Contract*' + - run: ./gradlew integrationCheck example-app:check --tests '*Contract*' """; // when @@ -144,7 +144,7 @@ class WorkflowGradleInvocationsTest { assertThat(invocations).singleElement().satisfies( invocation -> { assertThat(invocation.executes(":integrationCheck", ".")).isTrue(); - assertThat(invocation.executes(":sample-portfolio:check", ".")).isTrue(); + assertThat(invocation.executes(":example-app:check", ".")).isTrue(); assertThat(invocation.tasks()).doesNotContain("*Contract*"); }); } diff --git a/src/build.gradle b/src/build.gradle index 06cc4633..8e15f199 100644 --- a/src/build.gradle +++ b/src/build.gradle @@ -1,6 +1,6 @@ plugins { - // Spring Boot stays on the root build script classpath because two leaves apply it by id - // (`app-bootstrap`, `sample-portfolio`) and a leaf resolves plugin classes from the root. + // Spring Boot stays on the root build script classpath because a leaf applies it by id + // (`app-bootstrap`) and a leaf resolves plugin classes from the root. // // Spotless, SpotBugs, Error Prone and Spring's dependency-management are NOT here any more. They // were declared `apply false` for a `configure(subprojects)` block that applied them to every @@ -52,9 +52,7 @@ tasks.register('resolveAndLockAll') { tasks.register('verifyDependencyLocks') { group = 'verification' description = 'Verifies strict dependency lock state for production CI subprojects.' - dependsOn subprojects.findAll { - it.childProjects.isEmpty() && it.path != ':sample-portfolio' - }.collect { "${it.path}:verifyDependencyLocks" } + dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:verifyDependencyLocks" } } // feature-developer-experience-contract D3 — the ordered local bootstrap lifecycle is @@ -69,9 +67,9 @@ tasks.register('verifyDependencyLocks') { // qualityCheck SpotBugs + FindSecBugs across every leaf (ca.quality-conventions) // ci the pull-request gate: leaf checks + architectureCheck + qualityCheck // mainCheck the main-branch stage: environment contract, full-boot qualification, -// sample web contract, public-path baseline, transport and messaging -// qualification lanes, each leaf's document-contract lanes, and the -// feature generator round trip (verifyFeatureScaffold) +// public-path baseline, transport and messaging qualification lanes, each +// leaf's document-contract lanes, and the feature generator round trip +// (verifyFeatureScaffold) // integrationCheck the declared strict integration lanes (several need a container runtime) // performanceCheck the declared strict performance lanes (load, shutdown, pool and resource // bounds; real servers and containers) @@ -82,9 +80,7 @@ tasks.register('verifyDependencyLocks') { // Task PATHS, not TaskProviders: a leaf's tasks are created by convention plugins after the root is // evaluated, and a path is resolved when the task graph is built. // --------------------------------------------------------------------------------------------- -List leafPaths = subprojects.findAll { - it.childProjects.isEmpty() && it.path != ':sample-portfolio' -}.collect { it.path }.toSorted() +List leafPaths = subprojects.findAll { it.childProjects.isEmpty() }.collect { it.path }.toSorted() tasks.register('qualityCheck') { group = 'verification' @@ -100,13 +96,11 @@ tasks.register('configContractCheck') { // A lane that needs an input this build was not given (the Redis topology coordinates, the protected // AWS sandbox authority) is explicit-only: the aggregate leaves it out and names it when it runs -// (review NEW-16). The sample's integration lanes are here although the sample is not a production -// leaf, because nothing else ran its strict PostgreSQL lanes (review NEW-13e). +// (review NEW-16). tasks.register('integrationCheck') { group = 'verification' - description = "Runs every production CI leaf's and the sample's integration-category test lanes. Several need a container runtime." + description = "Runs every production CI leaf's integration-category test lanes. Several need a container runtime." dependsOn leafPaths.collect { "${it}:integrationTestLaneCheck" } - dependsOn ':sample-portfolio:integrationTestLaneCheck' } // Performance lanes are not the pull request's or the main stage's: their bounds need a machine that @@ -145,13 +139,6 @@ tasks.register('testQualityCheck') { group = 'verification' description = 'Runs SpotBugs and FindSecBugs over every leaf\'s test source sets.' dependsOn leafPaths.collect { "${it}:testQualityCheck" } - dependsOn ':sample-portfolio:testQualityCheck' -} - -tasks.register('sampleWebContractCheck') { - group = 'verification' - description = 'Runs the real-server sample HTTP/OpenAPI contract source set without pulling every sample lane into CI.' - dependsOn ':sample-portfolio:webSystemTest' } // The feature generator's round trip (review 2026-11-01 개선 순서 4): scripts/new-feature.sh writes @@ -179,8 +166,7 @@ tasks.register('verifyMessagingContracts') { group = 'verification' description = 'Qualifies the application integration-event contract and the shared envelope schema.' dependsOn ':application-core:messagingApplicationContractQualificationTest', - ':shared-contract:messagingSharedSchemaQualificationTest', - ':sample-portfolio:messagingSampleContractQualificationTest' + ':shared-contract:messagingSharedSchemaQualificationTest' } tasks.register('ci') { @@ -197,10 +183,6 @@ tasks.register('mainCheck') { dependsOn leafPaths.collect { "${it}:mainCheck" } dependsOn tasks.named('configContractCheck') dependsOn tasks.named('qualificationCheck') - dependsOn tasks.named('sampleWebContractCheck') - // The standalone sample booted whole against real PostgreSQL. The sample is outside `leafPaths`, - // so systemTestCheck does not reach it, and no stage ran it (review 2026-11-01 08-01). - dependsOn ':sample-portfolio:systemTest' dependsOn tasks.named('verifyPublicPathSnapshot') dependsOn tasks.named('conditionalTransportQualification') dependsOn tasks.named('verifyMessagingContracts') @@ -214,8 +196,7 @@ tasks.register('mainCheck') { // one failed closed (review 2026-11-01 08-01). A new lane joins a stage through its category // aggregate; no workflow line names it. strictLaneStages { - stage ':ci', ':sample-portfolio:check', ':mainCheck', ':integrationCheck', ':performanceCheck', - ':releaseCheck' + stage ':ci', ':mainCheck', ':integrationCheck', ':performanceCheck', ':releaseCheck' workflowDirectory = layout.projectDirectory.dir('../.github/workflows') } diff --git a/src/composition/idempotency/README.md b/src/composition/idempotency/README.md index 547cac62..379b0459 100644 --- a/src/composition/idempotency/README.md +++ b/src/composition/idempotency/README.md @@ -25,13 +25,13 @@ composition:idempotency - 설정 바인딩은 `StrictSettingsBinder`다. 같은 prefix 아래 Redis 저장소가 자기 키(`key-version`, `command-timeout`)를 두므로 그 두 키만 빼고 엄격하게 본다. 수명 정책 키를 잘못 쓰면 기본값이 조용히 쓰이는 대신 기동이 실패한다. -- app-bootstrap과 sample-portfolio가 같은 한 줄을 쓴다. 예전의 sample 복사본 +- app-bootstrap이 이 한 줄을 쓴다. 예전의 샘플 모듈 복사본 (`SampleIdempotencyConfig`, 상한 검증 없이 `Binder`로 읽고 저장소를 하나로 가정)은 삭제했다. ## 추가할 한 줄 ```groovy -// app-bootstrap/build.gradle (sample-portfolio/build.gradle 도 같다) +// app-bootstrap/build.gradle runtimeOnly project(':composition:idempotency') // 요청 멱등성 executor ``` diff --git a/src/composition/idempotency/build.gradle b/src/composition/idempotency/build.gradle index 17053ed3..69730efb 100644 --- a/src/composition/idempotency/build.gradle +++ b/src/composition/idempotency/build.gradle @@ -10,7 +10,7 @@ plugins { // It builds the one IdempotencyExecutor over whichever IdempotencyStorePort the selected provider // contributes (Redis from cache-redis, PostgreSQL from persistence-jpa), and ships the lifecycle // settings (config/module-defaults/idempotency.yml). It names no provider module: the store is a -// port. app-bootstrap and sample-portfolio take the same line, so the executor is built one way. +// port. // // Not a composition root: it composes one capability and does not run. Same shape as // :composition:notification-platform. diff --git a/src/composition/service-runtime/README.md b/src/composition/service-runtime/README.md index d6ae10d0..0fcd9479 100644 --- a/src/composition/service-runtime/README.md +++ b/src/composition/service-runtime/README.md @@ -7,8 +7,8 @@ ## 제공하는 것 -capability와 무관하게 서비스 구성 루트 둘(app-bootstrap, sample-portfolio)이 모두 필요로 하는 -runtime 배선이다. 예전에는 app-bootstrap에 있었고 sample이 그 복사본을 들고 있었다. +capability와 무관하게 서비스 구성 루트가 필요로 하는 runtime 배선이다. 예전에는 app-bootstrap에 +있었고, 지금은 지운 샘플 모듈이 그 복사본을 들고 있었다. ``` composition:service-runtime @@ -43,16 +43,15 @@ composition:service-runtime `app.tracing.*` 값을 Boot 키로 옮기고 끄는 스위치만 둔다(아래 "tracing" 절). - 설정 키는 옮기지 않았다: `app.tracing.*`, `app.privacy.*`. 값은 각 구성 루트의 `application.yml`/`config/observability.yml`에 있다. - actuator chain은 servlet 웹 애플리케이션에서만 만들어지고, 구성 루트가 같은 이름 - `actuatorSecurityFilterChain`의 bean을 두면 물러난다. sample-portfolio는 공개 데모라 그렇게 - 모든 요청을 허용하는 자기 chain을 둔다. -- sample 복사본과의 차이 중 원본을 따른 것: 샘플 레이트는 `RuntimeEnvironment` 어휘(prod 0.01, + `actuatorSecurityFilterChain`의 bean을 두면 물러난다. +- 옛 샘플 복사본과의 차이 중 원본을 따른 것: 샘플 레이트는 `RuntimeEnvironment` 어휘(prod 0.01, 그 밖 1.0)이고 `staging=0.10` 분기는 없다. 설정 검증 실패는 `IllegalStateException`이 아니라 `StartupFailures.envValidation`이다. ## 추가할 한 줄 ```groovy -// app-bootstrap/build.gradle (sample-portfolio/build.gradle 도 같다) +// app-bootstrap/build.gradle runtimeOnly project(':composition:service-runtime') ``` diff --git a/src/composition/service-runtime/build.gradle b/src/composition/service-runtime/build.gradle index cacd1ff2..f6bdb43e 100644 --- a/src/composition/service-runtime/build.gradle +++ b/src/composition/service-runtime/build.gradle @@ -9,10 +9,6 @@ plugins { // // runtimeOnly project(':composition:service-runtime') // -// app-bootstrap and sample-portfolio take the same line. Before this module the sample carried a -// copy of each piece, and the copies had already drifted (a `staging` sampling rate the runtime -// vocabulary does not have, IllegalStateException where the original raised typed startup failures). -// // Not a composition root: it assembles shared runtime infrastructure and does not run. dependencies { implementation project(':application-core') diff --git a/src/config/architecture/modules.json b/src/config/architecture/modules.json index e26259d2..9c284f5b 100644 --- a/src/config/architecture/modules.json +++ b/src/config/architecture/modules.json @@ -383,24 +383,6 @@ "composition-durable-operation" ] }, - { - "id": "sample-portfolio", - "gradle_path": ":sample-portfolio", - "source_path": "src/sample-portfolio", - "allowed_dependencies": [ - "domain-core", - "application-core", - "adapter-outbound-persistence-jpa", - "adapter-outbound-identifier", - "adapter-outbound-objectstorage", - "adapter-outbound-support", - "adapter-inbound-web", - "shared-contract", - "application-objectstorage", - "composition-idempotency", - "composition-service-runtime" - ] - }, { "id": "messaging-core-api", "gradle_path": ":messaging:messaging-core-api", diff --git a/src/config/spotbugs/exclude-test.xml b/src/config/spotbugs/exclude-test.xml index 0e823942..cd9764ff 100644 --- a/src/config/spotbugs/exclude-test.xml +++ b/src/config/spotbugs/exclude-test.xml @@ -143,15 +143,6 @@ - - - - - - - diff --git a/src/config/spotbugs/exclude.xml b/src/config/spotbugs/exclude.xml index d1a4707a..23795b3b 100644 --- a/src/config/spotbugs/exclude.xml +++ b/src/config/spotbugs/exclude.xml @@ -20,9 +20,9 @@ and the actuator chain authenticate a stateless JWT bearer token (no session cookies, no ambient credential a browser would attach), so CSRF protection has nothing to protect. FindSecBugs flags it for classic cookie-session web apps; it is a false positive here. - Named classes, not `~.*SecurityConfig`: that pattern also matched the sample's HTTP Basic - chain, for which this reason is false — a browser re-sends Basic credentials on its own — - and would have hidden a copied Basic chain's CSRF exposure (review 2026-11-03 RR-07-05). --> + Named classes, not `~.*SecurityConfig`: that pattern would also match an HTTP Basic chain, + for which this reason is false — a browser re-sends Basic credentials on its own — and would + hide a Basic chain's CSRF exposure (review 2026-11-03 RR-07-05). --> @@ -31,24 +31,6 @@ - - - - - - - - - - - -