# Roadmap Each milestone ends with tests green, `ConfigLint` green, and something playable in the UI. ## M1: Village, economy, buildings - [x] Backend scaffold: Laravel 13, Docker Compose with Traefik, MySQL, Redis, Pest, Sanctum, laravel-websockets - [x] Frontend scaffold: Nuxt 4, TS, `ssr: false`, WS client, i18n (en), email + password login/register - [x] `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 - [x] `ConfigLint` with the lock checks from architecture.md - [x] Migrations and models: worlds, players, villages, buildings, build_orders, game_events - [x] Seeders: default world (speed 1) and dev world (speed 100) - [x] `Production` + `Settle` (base trickle, staffing curve, storage caps) with unit tests - [x] `Population` (food budget, villagers, worker assignment by priority) with unit tests - [x] `BuildingRules` (cost, time, workers, output, instance_cost_factor, levels from 0) with unit tests - [x] Building space (per-type space, village budget, reserved for queued builds, unique types) with unit tests (replaced the first tile grid) - [x] `BuildQueue` (builders by HQ level, next unblocked order) with unit tests - [x] Event engine: `game_events`, `game:events` worker, per-village catch-up, idempotent handlers - [x] Actions: join world (HQ 0, storage 0, farm 0), build, upgrade, demolish with refund, cancel with refund, set priority. Feature tests with time travel - [x] WS controllers `village.show|build|upgrade|demolish|cancel|staff` and a `village:updated` push - [x] UI: resource bar with projected values, population and food budget, building table with staffing, village as a low-poly isometric diorama (full width), build queue with builders and countdowns ## M2: Map and barbarian villages - [ ] Map generation and spawn placement (for now: rings of every second field around the centre) - [x] Barbarian villages: seeding around the centre with random levels, once per world - [ ] Barbarian growth over time (world config) - [x] `map.view {world_id, x, y, w, h}` with village owner, points and continent; village points from building levels - [x] UI: Die Stämme-style coordinate map with rulers, continent lines, 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 and Steam - [ ] Richer diorama: more detail per building type and level tier, animations (the basic diorama shipped with M1) - [ ] Steam build check: static output wrapped in Electron or Tauri