Assetize

Learning Lab · Documentation

Run a new developer through the Learning Lab.

How the Learning Lab works: the levels, the quizzes, the Maximo sim missions, the feedback, the report the learner sends, and a four-week plan for onboarding someone new with it.

Built now

What the Learning Lab is

A graded path for a developer joining the team: 15 levels, about 19 hours of lessons and practice, from "what is an API" to shipping a Maximo change through mxR.

It is written for someone fresh from college: new to Maximo, new to what Assetize does, new to mxH, mxR and the Data Workbench, and new to how software is built and shipped for real. Each level leans on the one before, so nobody hits a wall.

StageLevelsCovers
Foundations0 to 3The big picture, HTTP and APIs, Maximo for beginners, Git and good habits
Practitioner4 to 8The Maximo data model, the REST API, versions and MAS, how Maximo software is built, scripts and integrations
Builder9 to 13Testing, CI/CD/CT and mxR, Assetize from the inside, mxH, the Data Workbench
Final check14One upgrade story start to finish, and a 30-question check at 80%

Built now

Every level at a glance

Each level has two to four short lessons, a quiz, often a set of sim missions, links to try the real tools, and a feedback box.

LevelTitleMinutesLessonsQuestionsPicture cardsTerminal missions
0Start here4571714—
1How software talks70718132
2Maximo for beginners85718143
3Habits of a good developer6571814—
4How Maximo stores data75617133
5The Maximo REST API85718143
6Versions and MAS75718123
7How Maximo software is built8061613—
8Scripts and integrations85618141
9Testing you can trust85618133
10CI/CD/CT and mxR9571814—
11Assetize from the inside9071814—
12mxH: upgrade intelligence7571814—
13The Data Workbench7571813—
14Put it together7063012—

Built now

Pictures, picture questions and picture cards

People remember pictures far better than paragraphs. The lab has 59 animated, interactive pictures, and every lesson teaches with at least one.

  • Each picture plays when it scrolls into view and has a Replay button. Many can be clicked: try a status move, pick a failing pipeline stage, toggle a safe or unsafe request.
  • Picture questions show a picture with its labels hidden and ask what it shows or what happens next. The labels come back once you check your answers.
  • Every level has a deck of picture cards: the picture on the front, the term and one teaching line on the back. "Test me" shuffles them and keeps score; known cards are remembered.
  • The picture library shows every picture in one place, and the picture cards page puts every level's cards in one deck for revision.
  • Readers who prefer less motion see each picture in its finished state.

Built now

Real practice on the Maximo SIM

The Maximo SIM is the training Maximo. DEV is https://dev.assetize.com.au/maximo and UAT is https://uat.assetize.com.au/maximo. The sim page shows those screens. 20 tasks take the learner from a first login to a small release moved from DEV to UAT.

  1. The trainer gives the learner their SIM addresses, a user name and password, and an API key, privately.
  2. The learner pastes the addresses into the lab once. They stay in that browser and never go into the report.
  3. Each task says why it matters, gives exact steps (and commands to copy where the task uses the API), and asks for proof: a record number, a reason code, a count or a short note.
  4. The proof goes into the 360 report. The trainer checks it in the same SIM.
  5. The SIM can be reset by its administrator, so learners are free to break things and learn from it.

Remember: Keep logins and API keys out of the evidence box, out of screenshots and out of chats. The lab never asks for them.

Built now

Quizzes, scores and pass marks

Every level ends with a multiple-choice quiz. The answers are shuffled on each try, and every question explains why the right answer is right once you check.

  • The pass mark is 70% for levels 0 to 13 and 80% for the final check.
  • The lab keeps your best score, your last score and how many tries you took. Trying again never lowers your best.
  • A level counts as passed the first time you reach its pass mark.
  • The final check has 30 questions drawn from every level, many of them pictures.

Remember: For a trainer, the number of tries tells as much as the score. Three tries to 90% means the explanations did their job.

Built now

Terminal missions on a level

From Level 1, a level can include terminal missions for the API. They use the same stub as the live API lessons. 18 missions ask the learner to do real things with it. The Maximo SIM, the screens on DEV and UAT, is a different page.

It answers curl requests the way Maximo does: REST and OSLC, the Integration Framework and SOAP, status rules, login rules per version (lens 761, mas811, mas90, mas91, mas92), and bad weather such as 429 storms. It runs on sample data inside the page, so nothing a learner types reaches a real system.

Every request the sim answers is written to a log. After each request the page checks the log against each mission. A mission ticks itself off when the log proves it was done, for example a POST that returned 201, or a maxauth call refused on MAS 9.2.

  • Hint gives a nudge without the answer.
  • Show me types the answer into the terminal. A mission completed after Show me is marked "answer shown first" in the report.
  • New session starts a fresh sim with clean sample data.
  • Each level shows its own terminal missions. The Maximo SIM page is the screens on DEV and UAT.

Commands the sim understands

curl [-i] [-X METHOD] [-H "k: v"] [-d BODY] URL
lens [761|mas811|mas90|mas91|mas92]
stub chaos [storm|slow|expire|off]
stub explain METHOD PATH
stub requests
help

Built now

Feedback both ways, and the 360 report

The team tests the learner with quizzes and missions. The learner tests the lab with a rating and four questions on every level and on the lab as a whole.

QuestionWhy it is asked
What worked for you?Keep it, and do more of it
What did not work?Fix or rewrite it first
What did you like?Tells us the tone that lands
What did you not like?The blunt answer that makes the next version better

The report page puts it all together: name, levels passed, every quiz score and try count, every mission (and whether the answer was shown first), and all the feedback. Send to the team stores it with Assetize and emails it to the team. The learner can also download it as JSON or print it.

Each level also has its own send button for quick feedback while the level is fresh.

Built now

A four-week onboarding plan

One level a day leaves time for questions and pairing. The plan below mixes the lab with real work from week two.

WeekLabAlongside
1Levels 0 to 4Set up the repo, run the site locally, read the code around one page
2Levels 5 to 8Pair on a small fix with tests; open the first pull request
3Levels 9 to 13Add a quiz question or a sim mission to this lab; a test or job-plan task for mxR
4Level 14 and the final checkOwn a small change end to end: branch, tests, review, merge, deploy
  1. At the end of each week the learner sends the report.
  2. Read the "did not work" answers first, and talk them through.
  3. Pair on any mission marked "answer shown first".
  4. Fix the lab where it confused them. Their feedback is the best test the lab will get.

Built now

Where progress lives

Progress, scores and feedback stay in the learner's browser until they press send.

  • Everything is saved in this browser only, so a different browser or device starts fresh. Download the report to keep a copy.
  • Nothing leaves the page until the learner presses a send button. What is sent is exactly the report shown on the report page.
  • Terminal missions run in the page. Commands typed into that terminal stay in the browser. The Maximo SIM is the screens on DEV and UAT.
  • Start over clears this browser's progress after a confirmation.

Built now

Add a lesson, a question or a mission

The lab is data. Edit one file, run one test, and the pages and the server-rendered copy follow.

To changeEditChecked by
Levels, lessons and quiz questionsartifacts/assetize/src/lib/learning-lab/curriculum.tslearning-lab.test.ts: order, unique ids, valid answers, real diagram files and routes
Sim missionsartifacts/assetize/src/lib/learning-lab/missions.tslearning-lab.test.ts runs every solution in the real stub, and near misses must fail
This pageartifacts/assetize/src/lib/learning-lab/docs.tsdocs-template.test.ts and the Worker's page tests

Run the checks

pnpm --filter @workspace/assetize test:lib
cd artifacts/cf-worker && node --test tests/one-page-one-intent.test.ts tests/homepage-editorial.test.ts

What is next

What is next

The feedback decides the order. These are the first candidates.

  • A cohort view for the trainer: every learner's report side by side.
  • Missions on your own DEV Maximo, through the same connection the Data Workbench uses.
  • Levels for functional consultants: planners, storeroom and purchasing journeys.