Skip to content

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 in training-docs/PLAN.md Milestone 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.