Files
document-haness/docs/clean-architecture-backend-template/final/evidence/raw/203-composition-root-scan-boundary.txt
T
DongHyeonkaandClaude Opus 5 b2963105a8 docs(keycloak-session-store): import the session-storage lab as a new project
The keycloak project ended with four open questions that design could not
settle. A two-VM lab was built to answer them by measurement, and this is
that material: 26 experiments, 125 raw command outputs, 22 browser captures.

Follows the import procedure in README.md.

  source/     the originating repository verbatim — 78 documents, 28 SVGs,
              8 manifests, plus .source-revision recording the commit
  final/      the SSOT
    document.md   729 lines written from the 29 experiment documents, not
                  concatenated: what was predicted, what was measured, and
                  where the measurement itself was wrong
    evidence/raw    125 outputs, flattened to <experiment>__<file> because
                    the originals collided (01-baseline.txt appeared three
                    times) and the audit only globs the top level
    evidence/meta   one per raw file; command and exitCode are null and the
                    README says why rather than inventing them
    evidence/browser  22 captures
    assets/       three diagrams through techviz
    .techviz/     their VizSpecs

A separate project rather than an addition to keycloak: the B-layer answers
that project's four questions, but the A, C and D layers are about cluster
failure, SSO and operations, and one document.md should hold one subject.
The four question records there can point here through 관계.

Recorded rather than papered over: only three of the 28 diagrams were
remade. The repository forbids hand-drawn SVG and forbids titles inside the
canvas; all 28 originals carry both, so converting them is redrawing, not
reformatting. They stay in source/ and the gap is written into the document.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 22:51:59 +09:00

96 lines
4.6 KiB
Plaintext

Composition-root scan boundary: which inbound-web packages are excluded from the component scan, and who registers them
revision=a24ece9cf797f7ea647e33bf846b115208ed1ba5
generatedAt=2026-08-30T08:13:36+00:00
=== AUTO_CONFIGURED_PACKAGES (component-scan exclusion regex) ===
$ sed -n '100,115p' app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java
static final String AUTO_CONFIGURED_PACKAGES =
"dev\\.caskeleton\\.bootstrap\\.autoconfigure\\..*"
+ "|dev\\.caskeleton\\.bootstrap\\.notification\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.fileserver\\.admin\\..*"
+ "|dev\\.caskeleton\\.adapter\\.outbound\\.mongo\\..*"
+ "|dev\\.caskeleton\\.adapter\\.outbound\\.messaging\\..*"
+ "|dev\\.caskeleton\\.adapter\\.outbound\\.notification\\..*"
+ "|dev\\.caskeleton\\.adapter\\.outbound\\.persistence\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.graphql\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.mvc\\.error\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.mvc\\.budget\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.mvc\\.operation\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.webflux\\.error\\..*"
+ "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.webflux\\.operation\\..*"
+ "|dev\\.caskeleton\\.messaging\\..*";
exit=0
=== 그 이유 (javadoc) ===
$ sed -n '89,99p' app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java
* <p>The Fileserver admin package is here for a different reason: those routes belong to the
* management context, and a component scan that also found them would publish the management
* plane on the public connector — the exposure the separate context exists to remove.
*
* <p>The web platform's error, budget and operation packages are here for a third reason. Their
* advices and controllers need beans that only exist when the corresponding platform
* auto-configuration is active, and a component scan finds them regardless — so an all-off or
* partially configured deployment failed to start on an unsatisfied dependency rather than simply
* not installing the control. Ownership by auto-configuration is what ties a control's presence
* to its dependency's.
*/
exit=0
=== 제외된 다섯 web 패키지가 담고 있는 타입 ===
$ ls adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/error adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/budget adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/operation adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/webflux/error adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/webflux/operation
adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/budget:
BoundedHttpServletRequest.java
BoundedHttpServletResponse.java
WebMvcBudgetExceptionHandler.java
WebMvcBudgetFilter.java
adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/error:
WebMvcProblemExceptionHandler.java
adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/operation:
OperationHttpController.java
adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/webflux/error:
WebFluxProblemExceptionHandler.java
adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/webflux/operation:
ReactiveOperationHttpController.java
exit=0
=== 등록자가 있는가 ===
$ grep -rn 'WebMvcProblemExceptionHandler\|WebFluxProblemExceptionHandler\|WebMvcBudgetExceptionHandler\|OperationHttpController\|ReactiveOperationHttpController' --include=*.java app-bootstrap/src/main | wc -l
0
exit=0
$ cat adapter/inbound/web/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
dev.caskeleton.adapter.inbound.web.mvc.autoconfigure.WebMvcPlatformAutoConfiguration
dev.caskeleton.adapter.inbound.web.webflux.autoconfigure.WebFluxPlatformAutoConfiguration
exit=0
$ grep -n '@Import\|@Bean' adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebMvcPlatformAutoConfiguration.java | head -20
57: @Bean
64: @Bean
73: @Bean
87: @Bean
94: @Bean
101: @Bean
108: @Bean
115: @Bean
122: @Bean
129: @Bean
142: @Bean
151: @Bean
158: @Bean
exit=0
$ grep -rn 'mvc.error\|webflux.error\|mvc.budget\|mvc.operation\|webflux.operation' --include=*.imports --include=*.factories adapter app-bootstrap | wc -l
0
exit=0
=== 결과: 제외되었고 아무도 등록하지 않는다 ===
$ grep -rln 'WebProblemFactory' --include=*.java app-bootstrap/src/main | wc -l
0
exit=0