About this site¶
This is a pilot rebuild of IUOE 399's PRIZM training content, tracked under
IUOE-2895 (Milestone 10 in
training-docs/PLAN.md). It replaces a feature-inventory table of contents ("every tab on
every screen") with a role + goal table of contents: specific users tackling the goals
they actually came to PRIZM to accomplish, with the things to watch out for that come up along
the way folded into that same goal's page instead of split off into a separate troubleshooting
section.
Where this content comes from¶
Every page here is assembled from material this project already produced and validated — this site does not introduce new, unverified claims about how PRIZM behaves:
- Golden-path steps —
e2e/crawl/docs/workflows-and-quirks.md, written from live, Playwright-driven walkthroughs of the actual UAT app (not guessed from a spec). - Who's allowed to do this — the signed Roles & Security Matrix
(
fdd-docs/assets/04.Final/IUOE 399 FDD Common 16.2.1 Roles and Security Matrix 4-2-2025.xlsx), corroborated against live per-role crawls of all 8 PRIZM roles (e2e/crawl/docs/*.md's "Per-role tab visibility" tables). - Things to watch out for — real closed/completed ClickUp cases, clustered by underlying
mechanism rather than treated as one-off bug reports
(
task-management/cases/closed/ACCOUNTING-CLUSTERS.md,ACCOUNTING-INVOICES-CLUSTERS.md), so a training objective teaches the mechanism a new hire needs to reason about, not "ticket #2745 was fixed." - User-story framing — the project's own signed BLR documents
(
blr-docs/assets/<fund>/*.md), which use "As a [role], I want to..." phrasing — the explicit anchor this restructuring is checked against, per the 2026-11-21 framing intraining-docs/PLAN.mdMilestone 10.
What's still open¶
This is a 2-role pilot (Accounting Functions and Business Agent), not the full 8-role
rollout — see training-docs/PLAN.md Milestone 10 for the remaining roles (Management,
Membership Staff, Contract, H&W Staff, ETF Staff) and for two known matrix-vs-app
discrepancies this content deliberately does not paper over:
- Members > Roles tab is hidden from every role the signed matrix says should see it
(
View Only) — filed as IUOE-2900. - Utilities has 20 of 25 tabs hidden from every role, including Super User — undocumented legacy/unassigned functionality, not yet filed.
Nothing here has been reviewed by JayStar or IUOE staff yet. Treat every page as a draft until
that review happens (same caveat the previous reference//activities/ trees carried — see
training-docs/HIERARCHY.md for that earlier structure, which this site draws from as raw
material rather than replacing it outright).
Running this site locally¶
cd training-docs/site
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/mkdocs serve # http://127.0.0.1:8000
mkdocs build produces static HTML in _build/ — the publishing target (GitHub Pages via
mkdocs gh-deploy, a shared drive, ClickUp, something else) is an open question, same as the
docx publishing-format question PLAN.md Milestone 8 left open for the activity docs.