diff --git a/Makefile b/Makefile index b6de832..9605e62 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -.PHONY: help docs-index docs-build docs-serve docs-check slides +.PHONY: help docs-index docs-build docs-serve docs-check slides test help: @echo "Targets:" @@ -7,10 +7,12 @@ help: @echo " docs-serve Run a live-reload local preview server" @echo " docs-check Drift-check: regenerate indices, fail if they differ from the committed copies" @echo " slides Run build-slides.sh (Marp slides)" + @echo " test Run the Python unit tests (pytest)" docs-index: python3 scripts/gen_overview.py --category hardware python3 scripts/gen_overview.py --category services + python3 scripts/gen_rack.py docs-build: mkdocs build --strict @@ -21,7 +23,11 @@ docs-serve: docs-check: python3 scripts/gen_overview.py --category hardware python3 scripts/gen_overview.py --category services - git diff --exit-code docs/hardware/index.md docs/services/index.md + python3 scripts/gen_rack.py + git diff --exit-code docs/hardware/index.md docs/services/index.md docs/infrastructure/racks/ slides: ./build-slides.sh + +test: + pytest -q diff --git a/docs/hardware/mf00.md b/docs/hardware/mf00.md index 2ce196d..17bf553 100644 --- a/docs/hardware/mf00.md +++ b/docs/hardware/mf00.md @@ -9,6 +9,10 @@ cpu_threads: "?" ram_gb: "?" storage: "?" nic_gbps: "?" +rack: rack01 +rack_u: 1 +u_height: 1 +rack_face: front --- ## Notes diff --git a/docs/hardware/mf01.md b/docs/hardware/mf01.md index b1a52cc..11e2be6 100644 --- a/docs/hardware/mf01.md +++ b/docs/hardware/mf01.md @@ -11,6 +11,10 @@ ram_type: DDR4-2666 non-ECC UDIMM storage_gb: 40 storage_type: nvme nic_gbps: 1 +rack: rack01 +rack_u: 2 +u_height: 1 +rack_face: front --- ## Notes diff --git a/docs/hardware/mf02.md b/docs/hardware/mf02.md index 1d1704f..cfe56db 100644 --- a/docs/hardware/mf02.md +++ b/docs/hardware/mf02.md @@ -11,6 +11,10 @@ ram_type: DDR4-2666 non-ECC UDIMM storage_gb: 40 storage_type: nvme nic_gbps: 1 +rack: rack01 +rack_u: 3 +u_height: 1 +rack_face: front --- ## Notes diff --git a/docs/hardware/mf03.md b/docs/hardware/mf03.md index 19626c9..fef2782 100644 --- a/docs/hardware/mf03.md +++ b/docs/hardware/mf03.md @@ -10,6 +10,10 @@ ram_gb: 8 storage_gb: 500 storage_type: hdd nic_gbps: 1 +rack: rack01 +rack_u: 5 +u_height: 2 +rack_face: front --- ## Notes diff --git a/docs/hardware/mf04.md b/docs/hardware/mf04.md index 562ba38..aa8cc41 100644 --- a/docs/hardware/mf04.md +++ b/docs/hardware/mf04.md @@ -10,6 +10,10 @@ ram_gb: 8 storage_gb: 500 storage_type: hdd nic_gbps: 1 +rack: rack01 +rack_u: 5 +u_height: 2 +rack_face: rear --- ## Notes diff --git a/docs/infrastructure/racks/rack01-elevation.svg b/docs/infrastructure/racks/rack01-elevation.svg new file mode 100644 index 0000000..d002066 --- /dev/null +++ b/docs/infrastructure/racks/rack01-elevation.svg @@ -0,0 +1,160 @@ + + +Rack rack01 +front + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +rear + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 + +mf00 (U1) + +mf01 (U2) + +mf02 (U3) + +mf03 (U5–U6) + +mf04 (U5–U6) + diff --git a/docs/infrastructure/racks/rack01.md b/docs/infrastructure/racks/rack01.md new file mode 100644 index 0000000..fd89954 --- /dev/null +++ b/docs/infrastructure/racks/rack01.md @@ -0,0 +1,17 @@ +# Rack rack01 + +_Auto-generated from `docs/hardware/*.md` (items with `rack: rack01`) — do not edit by hand. Run `make docs-index` after changing a source file._ + +## Elevation + +![Rack rack01 elevation](rack01-elevation.svg) + +## Occupancy + +| U | Device | Kind | Face | Status | +|---|---|---|---|---| +| U1 | [mf00](../../hardware/mf00.md) | server | front | staging | +| U2 | [mf01](../../hardware/mf01.md) | server | front | staging | +| U3 | [mf02](../../hardware/mf02.md) | server | front | staging | +| U5–U6 | [mf03](../../hardware/mf03.md) | server | front | staging | +| U5–U6 | [mf04](../../hardware/mf04.md) | server | rear | staging | diff --git a/docs/services/coursemanagement.md b/docs/services/coursemanagement.md index 15d45bd..db05fa0 100644 --- a/docs/services/coursemanagement.md +++ b/docs/services/coursemanagement.md @@ -1,6 +1,7 @@ --- -name: event management -status: proposal +name: coursemanagement +kind: web-app +status: planned --- # Problem statement