diff --git a/README.md b/README.md index a0f513b..becb8da 100644 --- a/README.md +++ b/README.md @@ -29,14 +29,18 @@ and Times Newer Roman (fonts are installed into `~/.local/share/fonts/` by the s ```sh # render a single diagram -mmdc -i figures/diagrams/system-context.mmd -o figures/diagrams/system-context.pdf +mmdc -f -i figures/diagrams/system-context.mmd -o figures/diagrams/system-context.pdf # render all diagrams at once for f in figures/diagrams/*.mmd; do - mmdc -i "$f" -o "${f%.mmd}.pdf" + mmdc -f -i "$f" -o "${f%.mmd}.pdf" done ``` +`-f` (`--pdfFit`) is mandatory: without it `mmdc` writes the chart onto a full US-Letter +page, so `\includegraphics[width=\textwidth]` scales all that surrounding whitespace up +and a small diagram eats a whole A4 page. + Render before calling `latexmk` whenever a `.mmd` file changes. The generated `.pdf` files are gitignored via `out` (only `out/` is ignored, so diagrams in `figures/` are **not** ignored — commit them). diff --git a/TODO.md b/TODO.md index 6cd52b8..cf6a756 100644 --- a/TODO.md +++ b/TODO.md @@ -39,7 +39,7 @@ screenshots habe ich in figures/screenshots gelegt. - [x] allegemin sowas wie: "Im Review fragte Robin Noack, ob die Einschränkungen ausreichen. Eine zu schwache Norma lisierung führt zu Schlüsseln, die der Speicher zurückweist — das wäre erst bei einem Kunden mit ungewöhnlichem Firmenna men aufgefallen. Die Antwort verwies auf die Herstellerdokumentation (IBM 2026; Amazon Web Services 2026c)." das ist vie lzuviel text einfach nur um zu sagen "laut der IBM doku passt das so" - [x] "Timo Walter merkte an, dass reale Kundennamen in den Tests verwendet wurden, und schlug Platzhalter vor. Der Hinweis ist klein, in der Sache aber richtig: Testdaten liegen in der Versionsverwaltung und bleiben dauerhaft lesbar; ein realer Kundenname ist eine unnötige Offenlegung, da der Test mit Platzhaltern denselben Zweck erfüllt. Die Daten wur den ersetzt." unnötige details schon wieder... // ist das noch kaputt? - [ ] Ein paar der bibreferences sehen komisch aus und zeigen nicht richtig auf den korrekten bib eintrag, sollte gefixed werden. -- [ ] Die Abbildungen nehmen vertikal sehr viel white space ein, das sollte nicht so sein. +- [x] Die Abbildungen nehmen vertikal sehr viel white space ein, das sollte nicht so sein. - [ ] ähnlich wie ich es in ~/repos/itc.componentware/ gemacht habe, eine flake und ein build output haben. # Review diff --git a/appendix/appendix-diagrams.tex b/appendix/appendix-diagrams.tex deleted file mode 100644 index 15ab173..0000000 --- a/appendix/appendix-diagrams.tex +++ /dev/null @@ -1 +0,0 @@ -% TODO: eingebundene Diagramme (falls nicht inline in Kapiteln) diff --git a/appendix/appendix.tex b/appendix/appendix.tex index acd38d0..2ca3606 100644 --- a/appendix/appendix.tex +++ b/appendix/appendix.tex @@ -3,11 +3,6 @@ \clearpage -\section{Diagramme} -\input{appendix/appendix-diagrams} - -\clearpage - \section{Screenshots} \input{appendix/appendix-screenshots} diff --git a/figures/diagrams/auth-sequence.pdf b/figures/diagrams/auth-sequence.pdf index f086dc4..6bc48a9 100644 Binary files a/figures/diagrams/auth-sequence.pdf and b/figures/diagrams/auth-sequence.pdf differ diff --git a/figures/diagrams/gantt-plan.pdf b/figures/diagrams/gantt-plan.pdf index 5c06144..3610216 100644 --- a/figures/diagrams/gantt-plan.pdf +++ b/figures/diagrams/gantt-plan.pdf @@ -4,8 +4,8 @@ <> +/CreationDate (D:20260907214435+00'00') +/ModDate (D:20260907214435+00'00')>> endobj 3 0 obj <> stream -x]]o\G}HXl9 aw&|{%`f<`ބ;e^_~F{g#>}%>^y#ֈ#^XF5#^*::y:Z#q:{aЅe0>ZLS# -.Tf2J ީ ۨ4E23;̦gf8geh5s-#("ѓKu[Qe -Cl&p2 -'H(sv9f̃ѡ|E̬x +8:q 'FʑAsٳصsևE>KI$6Ww~WpMS>1Ua[.Rú`mͰ-j jKPiRl "l5Bz/=3MۂvzPIkڥ 6LK~6q&^.º·P`E|&x-l`] C֝ ۺ?,/!\&, -a$V6Fk4 ~s &s hºmÃ]`NWYe˾e߆3y=A#Eax= #!hP{YNLo5(R5%M7U++ד Si@iB+ٙ*m(}aֺU*m%`(ld0vټj#,e{F8R],{Yq!dZwÖC)7d dzqͿV mqUXj`mu;]3TV焯ՖZ95,vZE#Sm|tªN "{iOV]|Kk} khDqClv>1Յdv{;L+TSʉՒ -=⿾<V).tT<;gXHJ/R[ E'FVN9QoQp-^Ϣ(֧n-a(fcfQmXEs9R?dJ4YY|8^mHι63 2&3=%ر2 PR0 aZxڰGYO̱T>{c,5Jk/|;*57N)kil>lP(ic$4Ph(ɇ{?JR_w"k1%qf|bpC>1{c41tZhT - \=?CVhZaU]pr_0|I sx'}j6IiOv u㍽h3yP|00֎<܎30SehiBhS͋78k8%KIf%RRyiCIv9BKvB:EuRr6y8c3{vC j!{f6дbh{UY^L?(T4of`|0 -5ܕ$jH>y'<:?#2׹QqCa0M>RQMt&OuMҊ=EM$SԤqLU.W%< f>P4s -bɍYn!nb0prls:ĝ,w?Cʌ/Wv]ߍ'O> u -Q3GS?<w nx=13̞[棱1ZȞ׆)04^Rչ7oʿ)P+[.njӦ-TkM"CE9YvVٸ*I‚m-ZRæ[$ʆYɲl,m6ݞU[`J{cexm=]]PN)3-n^:[Lj\(M%ni$}؎֢KM#)]wqjlt7N25eltHU,=ST3XG*ʵO!Ձs5#l8cM9f.-cm FSe1Z -SQח5րom [S>gezR7YL~M`x滋k!Ⱦ.pu+ݝ7ŶVǾ[}R-o~7J_S_;_j>4c,#Rb=:bu~_~X~C?ǏI/rnn43ƚą5߿|1ƹ~*.µՄϹٞtwe&>E/x.ƚS.12\ͫ;('Now/Ix p>TGw%<>crRܚ8tF^}@}JgKif )3'fy)?-s*?7?=ϰwlc{r^+wc&)s<=>nvb#YJ:}#l1~wI?[|'X}/ ۗrZ3BNmYVLa4;K\~u}Ιu>ȷ_00Qݗ2N[{dk[1HUOp`؁^ }Ubȴ("rohD"-kE_ :E -ˏƹ¶܌ je%PT '/eM+z*^늀 +/Length 4721>> stream +x]]o\G}HXl9 aw&S{A7Q_ҏX^1]uLcۋ:5tWH/خ:WI1K:^&Q/xśTnVtFO|US 9=?US %>?US ] ^0uk/s㒯t~ǗtL9Œ̛0_|kh }çO|8G«>/}{#a  ȵcKZG5XgCQb$]g= PLGRbjD҅꜃в̣VF)1;4afYgʣP%,!&ZLs@DSh=<֦u؆jYݜmhijũo\?-&odR#|:̸xW-̡Y2 V$h@6 <Ϻ"f*G0-ϩt,jm@T9ݐԊnD2fW7q $E9&"1ƽ +X`*}'mK0xIÑ1:԰PΏ"ch9R"su25 :CjLG bqUIlȔLõs,tFcS~c䴱tREl&X,w&ۥ/nm9-ra@)OGp%J)CW@֢gJ+`cD(lH6JRVrAQ OWfɭQ~3SңRԫ^'vudlv;;L#SU2e +u9MT>և/>g)i_= +ίjigs"*l EjXl[x>Au *M`[ʃm]AmFH4`ƶq`[W + ar\ti&QEXW +lsO aۺ2a[Vu#dęe\a1^(cmw&qondm>PXW-x~x`ݣ #Z]l=*+Q#~ٷpƒ=9hij(!c7Mj"ˉͲEf$j|zA{* (Mx%;Sb!ZJeT-2 0U.Wme]`AB¸+2p/812D0;>3Pnز~(lY?VtӷL/JpAM8NjUT65`}2ڪ zA+EγC+"hc*񗵑NXI;Zd/휀b*koi-spֹ3p (nH5.|iŁj2OT9ZRgQחV֊յ5Հ㼟g KI酚[jJ)'*- +Y~m@5l~גլr6߬z?1cz#'[L &+ǫ9`&7{fyOdf硤7;pCCA}CJ +!LOC6H;k^`9gopQioGE#I<3e-G4 +%}̔ + %pGIҔnrBw ;>$qs\9O>:@_w'fol6N+퓪v^vXW 7S7xָGc'V\}٣c{CѪY+lP +CXkfo: dOrX݆=i:Iӎ>a}Cnwm!ʜoIIZɜ}t<8c$rg̹cnZZ,1-M N arZa}<岖gHEnߵZIG7sq42>Q`FhpgG2bn-/=3&xs|4Z V ڰ1CKb:~_SM7#Xt6< vBT,eR+ʇoz|wq-ٷeBU pSvժ`w}OqVuG<Dz2Gt-%i5}6ٱk'lSl8SfN=`]=f@nȗF;y8>EPx]V;h."¡ߟU+Koeq.upEzJtM*=^̠̰ʖ6:۱9 #4@dsA T;)ǹk,\5ef +nM7qyIdx0SK֞K(V+@NKsK=" _>"OFk +QkK ?ǘfeXJXG.\CO1ֻk#6>V fXЗfbo98O- v(&{.6)?}w1l~(>OƟr!j^݉GIߌ!Evv|f,/GZeNnm 3|/ZKtNs{ v$s;sgNl"|S|>Ki]~Z@b$|~-F3?g+~ ճo{_NyvRɱ-ˊ)fG~t˂ޯ9<_,n*؉INPOC5^xz' &3Jr^ rkOҖ y;px+ +9s;0_Ӌ8؁p ?JS E"Um4͝}\Cbk=AG"H/Wy8WؖS ,\"ݒ +DpOOe ]?: endstream endobj 2 0 obj @@ -566,7 +569,7 @@ endobj /X33 33 0 R>> /Font <>>> -/MediaBox [0 0 612 792] +/MediaBox [0 0 600 303.12] /Contents 36 0 R /StructParents 0 /Tabs /S @@ -1180,10 +1183,10 @@ xref 0 115 0000000000 65535 f 0000000015 00000 n -0000014955 00000 n +0000014956 00000 n 0000000280 00000 n 0000000317 00000 n -0000033622 00000 n +0000033626 00000 n 0000000397 00000 n 0000000435 00000 n 0000000883 00000 n @@ -1213,90 +1216,90 @@ xref 0000009461 00000 n 0000009777 00000 n 0000010086 00000 n -0000040157 00000 n +0000040161 00000 n 0000010163 00000 n -0000015527 00000 n -0000020989 00000 n -0000020602 00000 n -0000020530 00000 n -0000020232 00000 n -0000015660 00000 n -0000015583 00000 n -0000015809 00000 n -0000015732 00000 n -0000015958 00000 n -0000015881 00000 n -0000016107 00000 n -0000016030 00000 n -0000016256 00000 n -0000016179 00000 n -0000016405 00000 n -0000016328 00000 n -0000016554 00000 n -0000016477 00000 n -0000016703 00000 n -0000016626 00000 n -0000016852 00000 n -0000016775 00000 n -0000017002 00000 n -0000016924 00000 n -0000017152 00000 n -0000017074 00000 n -0000017302 00000 n -0000017224 00000 n -0000017452 00000 n -0000017374 00000 n -0000017602 00000 n -0000017524 00000 n -0000017752 00000 n -0000017674 00000 n -0000017902 00000 n -0000017824 00000 n -0000018052 00000 n -0000017974 00000 n -0000018202 00000 n -0000018124 00000 n -0000018352 00000 n -0000018274 00000 n -0000018502 00000 n -0000018424 00000 n -0000018652 00000 n -0000018574 00000 n -0000018802 00000 n -0000018724 00000 n -0000018952 00000 n -0000018874 00000 n -0000019102 00000 n -0000019024 00000 n -0000019252 00000 n -0000019174 00000 n -0000019402 00000 n -0000019324 00000 n -0000019552 00000 n -0000019474 00000 n -0000019702 00000 n -0000019624 00000 n -0000019852 00000 n -0000019774 00000 n -0000020004 00000 n -0000019924 00000 n -0000020158 00000 n -0000020078 00000 n -0000020687 00000 n -0000020932 00000 n -0000021082 00000 n -0000021282 00000 n -0000032286 00000 n -0000032537 00000 n -0000033201 00000 n -0000033770 00000 n -0000039197 00000 n -0000039459 00000 n -0000039797 00000 n +0000015531 00000 n +0000020993 00000 n +0000020606 00000 n +0000020534 00000 n +0000020236 00000 n +0000015664 00000 n +0000015587 00000 n +0000015813 00000 n +0000015736 00000 n +0000015962 00000 n +0000015885 00000 n +0000016111 00000 n +0000016034 00000 n +0000016260 00000 n +0000016183 00000 n +0000016409 00000 n +0000016332 00000 n +0000016558 00000 n +0000016481 00000 n +0000016707 00000 n +0000016630 00000 n +0000016856 00000 n +0000016779 00000 n +0000017006 00000 n +0000016928 00000 n +0000017156 00000 n +0000017078 00000 n +0000017306 00000 n +0000017228 00000 n +0000017456 00000 n +0000017378 00000 n +0000017606 00000 n +0000017528 00000 n +0000017756 00000 n +0000017678 00000 n +0000017906 00000 n +0000017828 00000 n +0000018056 00000 n +0000017978 00000 n +0000018206 00000 n +0000018128 00000 n +0000018356 00000 n +0000018278 00000 n +0000018506 00000 n +0000018428 00000 n +0000018656 00000 n +0000018578 00000 n +0000018806 00000 n +0000018728 00000 n +0000018956 00000 n +0000018878 00000 n +0000019106 00000 n +0000019028 00000 n +0000019256 00000 n +0000019178 00000 n +0000019406 00000 n +0000019328 00000 n +0000019556 00000 n +0000019478 00000 n +0000019706 00000 n +0000019628 00000 n +0000019856 00000 n +0000019778 00000 n +0000020008 00000 n +0000019928 00000 n +0000020162 00000 n +0000020082 00000 n +0000020691 00000 n +0000020936 00000 n +0000021086 00000 n +0000021286 00000 n +0000032290 00000 n +0000032541 00000 n +0000033205 00000 n +0000033774 00000 n +0000039201 00000 n +0000039463 00000 n +0000039801 00000 n trailer <> startxref -40313 +40317 %%EOF diff --git a/figures/diagrams/lookup-flow.pdf b/figures/diagrams/lookup-flow.pdf index fc30458..26e7923 100644 Binary files a/figures/diagrams/lookup-flow.pdf and b/figures/diagrams/lookup-flow.pdf differ diff --git a/figures/diagrams/module-components.pdf b/figures/diagrams/module-components.pdf index ba1f343..84b0b84 100644 Binary files a/figures/diagrams/module-components.pdf and b/figures/diagrams/module-components.pdf differ diff --git a/figures/diagrams/race-condition-a.pdf b/figures/diagrams/race-condition-a.pdf index 4b74561..1e56f23 100644 Binary files a/figures/diagrams/race-condition-a.pdf and b/figures/diagrams/race-condition-a.pdf differ diff --git a/figures/diagrams/s3-layout.pdf b/figures/diagrams/s3-layout.pdf index ee37a38..fafca16 100644 Binary files a/figures/diagrams/s3-layout.pdf and b/figures/diagrams/s3-layout.pdf differ diff --git a/figures/diagrams/system-context.pdf b/figures/diagrams/system-context.pdf index b273634..f94286c 100644 Binary files a/figures/diagrams/system-context.pdf and b/figures/diagrams/system-context.pdf differ diff --git a/figures/diagrams/timeline-infra.pdf b/figures/diagrams/timeline-infra.pdf index 3abfee4..859d771 100644 Binary files a/figures/diagrams/timeline-infra.pdf and b/figures/diagrams/timeline-infra.pdf differ diff --git a/figures/diagrams/zip-stream.pdf b/figures/diagrams/zip-stream.pdf index c8efe7a..f076988 100644 Binary files a/figures/diagrams/zip-stream.pdf and b/figures/diagrams/zip-stream.pdf differ