PowerSolver Docs
Back to Wizard
This page belongs to the full documentation. You don't need it to plan: back to the essentials.

PowerSolver documentation

Version: PowerSolver 2.0 — engine on Timefold Solver 2.0 (Java 21, Spring Boot 4), planning wizard in 5 languages (English, French, German, Spanish, Dutch).

PowerSolver makes plans: for each item to plan (a lesson, an operation, a shift position, a job…) it decides one to four things (who, when, where, with whom) or the order of items on a resource (a route), under must-follow rules and wishes. A plan is described by one Excel workbook or one JSON problem file; the wizard checks the data before planning (Can this work?), makes the plan, explains what to fix, and compares successive plans.


Start here

DocumentForWhat's in it
PowerSolver in plain words · Concepts in plain languageplanners, managersthe essentials: building blocks, Must and Should, the score, the 7 steps, reading results, quick fixes (also the default Essentials view of this site)
Concepts Guideeveryoneitems, decisions (basic / list), option lists, reference lists, pins, rules, scores, the sequence model
Quick Startnew usersa plan from an Excel workbook in 5 minutes, then hands-on tutorials
Quick Referenceall userscheat sheet: wizard steps, JSON shape, rules, scores, limits

Use the wizard

DocumentForWhat's in it
Wizard User Guideplannersevery step: Excel workbook, imports, rules, pins, time limit, Can this work?, Results
User Guideplannerssaving and loading plans, reading a solution, common surprises, tips
Customer Handover · FRcustomersrunning PowerSolver on your own: workbook upkeep, checks, planning, replanning, versions
Pilot Guide · FRconsultantscustomer interview, data collection per problem type, workbook, validation, acceptance gates

Use the API

DocumentWhat's in it
API ReferencePOST /api/solve, /api/validate, /api/check (with the quick plan), /api/version; JSON schema; envelope; errors; limits
Rule Referencethe 19 rules: settings, how violations are counted (generated from the engine's catalogue)

Build, test and operate

DocumentWhat's in it
Developer Guidecode structure, engine subsystems, feasibility check, wizard modules, adding a rule
Layout Guidethe PowerXXXX design system: two themes, colour tokens, typography, logo, layout, components, accessibility, adoption checklist
Tests User Guideengine tests, independent checker, wizard tests, demo kits, corpus against a deployed server
Administrator Guidecontainers, configuration, limits, health, integration with PowerAdmin / PowerAI / PowerOrchestrator
Timefold upgradeswhat PowerSolver depends on in Timefold, and the procedure to upgrade safely
Installation (Hetzner)server installation and proxy settings

Sell and position

DocumentWhat's in it
Demo pitches · FRthe 21 demos as customer stories; how the plan is made; where AI helps
Competitive Analysisplanning capabilities vs Quinyx, Planday, Legion, Workday Scheduling, Blackbaud; positioning; proof required
Demosevery demo with its Excel workbook; each demo's scenario, expected results and demo script are in its folder powersolver-demos/<demo>/

Problem types the wizard offers

TypeTypical itemsTypical decisionsDemos
School timetablinglessonstime slot, room (teacher fixed or decided)01, 12
Job shopoperationsmachine, time slot09, 18
Maintenance schedulingjobstechnician, half-day07, 13
Employee rosteringshift positions, shiftsstaff member, start hour from the hourly demand05, 15, 21
Conference schedulingsessionstime slot, room14
Task assignmenttasks, work packagesperson or team, week04, 11, 16
Cloud optimisationworkloads, VMsserver08, 17
Vehicle routingvisitsorder of visits on each vehicle (sequence)06
Genericanything else1-4 decisions19 (exams, 3 decisions), 20 (operating theatre, 4 decisions)

Decisions are of kind basic (choose a value: resource or time) or list (order the items on a resource). The type only changes the wizard's form fields; the engine and the 19 rules are the same for all.

Scores

0hard / -1250soft
│       └── wishes: penalties, lower magnitude = better
└────────── must-follow rules broken: must be 0 for a usable plan

A plan with 0hard is valid. The Results page shows each rule's count of violations and says, in plain words, what to fix and where.


Support

  • Documentation: this folder. The HTML version (html/) is generated from these Markdown files: python -I documentation/tools/build_html.py (never edit the HTML by hand; --check reports pages out of date).
  • Email: support@planningpowertools.com

License

Proprietary — Arcondo © 2025-2026