# Roadmap Each milestone ends with tests green, `ConfigLint` green, and something playable in the plain UI. ## M1: Village, economy, buildings - [ ] Backend scaffold: Laravel 13, Docker Compose with Traefik, MySQL, Redis, Pest, Sanctum, laravel-websockets - [ ] Frontend scaffold: Nuxt 4, TS, `ssr: false`, WS client, i18n (en), email + password login/register - [ ] `WorldConfig` plus `config/game/world.php`, `economy.php`, `buildings.php`. Core set: headquarters, storage, farm, timber camp, clay pit, iron mine, hiding place, wall, rally point - [ ] `ConfigLint` with the lock checks from architecture.md - [ ] Migrations and models: worlds, players, villages, buildings, build_orders, game_events - [ ] Seeders: default world (speed 1) and dev world (speed 100) - [ ] `Production` + `Settle` (base trickle, staffing curve, storage caps) with unit tests - [ ] `Population` (food budget, villagers, worker assignment by priority) with unit tests - [ ] `BuildingRules` (cost, time, workers, output, instance_cost_factor, levels from 0) with unit tests - [ ] `VillageGrid` (per-type footprints, bounds, overlap, auto-place, unique types) with unit tests - [ ] `BuildQueue` (builders by HQ level, next unblocked order) with unit tests - [ ] Event engine: `game_events`, `game:events` worker, per-village catch-up, idempotent handlers - [ ] Actions: join world (HQ 0, storage 0, farm 0), build, upgrade, demolish with refund, cancel with refund, set priority. Feature tests with time travel - [ ] WS controllers `village.show|build|upgrade|demolish|cancel|staff` and a `village:updated` push - [ ] UI: resource bar with projected values, population and food budget, building table with staffing, grid as a plain table of cells, build queue with builders and countdowns ## M2: Map and barbarian villages - [ ] Map generation and spawn placement - [ ] Barbarian villages: seeding, optional growth over time (world config) - [ ] `map.view {x, y, w, h}` with village owner and points - [ ] UI: coordinate table map with jump-to and village info ## M3: Units, upkeep, starvation - [ ] `config/game/units.php`: spear, sword, archer, light cav, heavy cav, ram, catapult, nobleman, with food upkeep - [ ] Barracks, stable, workshop, academy as building instances (several barracks run parallel recruit queues) - [ ] Recruiting turns villagers into soldiers; lazy per-unit completion - [ ] Levy: draft workers as militia, automatic return - [ ] Starvation: zero-crossing event, grace timer, desertion order - [ ] UI: recruit forms, troops overview, food balance warnings ## M4: Attacks, combat, looting - [ ] `TravelTime` (slowest unit, distance, unit speed, travel mode) with unit tests - [ ] Travel modes from `movement.php`; warning time from visibility and detection radius; watchtower - [ ] Send attack or support (host pays upkeep), send support home, recall, return trips - [ ] `CombatResolver` and `LootCalculator` (wall, morale, luck, hiding place, rams, catapults) with unit tests - [ ] Reports - [ ] Incoming-attack push and UI ## M5: Trade and encounters - [ ] Market and merchants: caravans with optional escort and travel mode, `food_deliveries` and the 24h import average - [ ] `EncounterFinder` (closest approach of two linear paths) with unit tests - [ ] Encounter events: field battles, caravan looting, skipping destroyed groups - [ ] Barbarian ambushes with seeded RNG - [ ] UI: trade form, caravan tracking, encounter reports ## M6: Conquering, tribes, multiple villages - [ ] Loyalty (lazy regeneration), noble drop per hit, conquest transfers the village - [ ] Coins at the academy, rising noble cost per world config - [ ] Tribes with ally/NAP/enemy relations, applied at encounter time - [ ] Village switcher and overviews across villages - [ ] Inactive villages turn barbarian; restart on the same world after losing every village ## M7: City view - [ ] Rendered village grid with sprites per building type and level (level 0 = tent, open storage, gatherers) - [ ] Drag to place new buildings and move existing ones (server validates) - [ ] Steam build check: static output wrapped in Electron or Tauri