nessar/vac-optimizer
1
0 Fork 0
Code Issues 7 Pull Requests 4 Actions 1 Packages Projects 1 Releases Wiki Activity

feat: enhance documentation for leave planning concepts and solver recommendations

Browse Source
This commit is contained in:
nessar committed 2026-08-28 17:00:12 +02:00
1 parent dfb25b249b
commit ba8dbe92d9
4 files changed
+147 -11
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/adr/0003-constraint-first-lexicographic-planning.md
+3
View File
@@ -0,0 +1,3 @@
# Constraint-First Lexicographic Planning Without a Solver Dependency
VacOptimizer resolves obligation rules exactly and jointly, then applies deterministic heuristic stages for at-risk loss, ordered preferences, calendar gain, work-sequence quality, supporting placements, balance expiry, and dates in that order; a completed plan does not claim mathematical global optimality. The dependency-free planner targets five seconds, returns `PlanningIncomplete` if those stages are interrupted, and stops after ten seconds. A HiGHS WebAssembly spike missed that hard limit on representative inputs even on the development machine, so no solver dependency is accepted. This supersedes ADR 0001.