game-village-politics-backend/docs/roadmap.md

69 lines
4.3 KiB
Markdown
Raw Normal View History

# 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
- [x] Spawn placement: a ring around the centre that grows with the number of players, never next to another village
- [x] Barbarian villages: seeding around the centre with random levels, once per world
- [x] 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
- [x] `config/game/units.php`: spear, sword, archer, light cav, heavy cav, ram, catapult, nobleman, with food upkeep
- [x] Barracks, stable, workshop, academy as building instances (several barracks run parallel recruit queues); only these advanced buildings get requirements, e.g. academy needs headquarters + barracks
- [x] 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