feat: enhance documentation for leave planning concepts and solver recommendations

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

No files matched your search

@@ -1,3 +1,5 @@
# Ordered Heuristic Optimization
Superseded by [ADR 0003](0003-constraint-first-lexicographic-planning.md).
VacOptimizer applies enabled planning rules in user-defined order and then uses a deterministic heuristic to choose placements; it does not backtrack or promise a globally optimal plan. This keeps results predictable and fast for the personal planner while leaving room to improve the heuristic later.
@@ -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.