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>
This commit is contained in:
co-authored by
Claude Opus 5
parent
43bccd08a8
commit
b2963105a8
+95
@@ -0,0 +1,95 @@
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user