Экономика, этапы 1 и 3: склады и лимиты, добыча через рабочих

Docs/Modules/Population.md

@@ -9,11 +9,13 @@
 ## Как устроено
 
 - **Люди города = жители + воины.** Жителей хранит этот модуль, воинов — Армия. Так один человек не записан в двух местах.
-- **Жители:** рабочие (`Workers`) и остальные (`Idle`). Распределение рабочих по зданиям — этап 3, пока рабочих 120.
+- **Жители:** способные работать (`Workforce` — 120 из 270 в стартовом городе, доля сохраняется при росте) и остальные. Способные работать стоят на профессиях (`WorkJob`: лесорубы, фермеры, каменотёсы, шахтёры металла и золота) или свободны (`FreeWorkers`).
+- **Рабочих ставят** окно здания (`SetWorkers`) и `App/CitySync` (новые места заполняются свободными сами). Больше, чем мест в зданиях (`IProduction.Slots`) и свободных, не поставить.
 - **Еда в час:** 0.1 на жителя, 0.2 на воина. Стартовый город (270 жителей + 30 воинов) ест 33 еды в час.
 - **Прирост:** +2.5 человека в час, только если еды хватило и население ниже предела жилья.
 - **Голод:** еды не хватило — остатки доедаются, прирост останавливается, `IsStarving = true`. Что ещё происходит при голоде, команда пока не решила.
-- **Предел жилья:** `HousingBase + HousingPerTownHallLevel × (уровень Ратуши − 1)`. Числа не утверждены.
+- **Предел жилья:** `HousingBase + HousingPerTownHallLevel × (уровень Ратуши − 1) + HousingPerHouseLevel × уровни Домов` = 300 + 50 + 50. По решению команды от 19.10 стартовый город (300) упирается в предел: прирост пойдёт после постройки Дома. Прибавки не утверждены.
+- **Добыча** идёт внутри расчёта населения: в каждом куске сначала `IProduction.Produce`, потом еда, потом прирост. Иначе офлайн город «голодал» бы, хотя фермы работали.
 - **Время** — только из `GameClock`. Расчёт идёт кусками по 10 минут, и в игре, и офлайн, и при перемотке — правила одни. Офлайн досчитывается не больше чем за `MaxOfflineHours`. Если часы ушли назад, расчёт просто продолжается с «сейчас».
 - **Еда списывается целыми единицами,** доли копятся в модуле: склад хранит `float`, и частые мелкие списания давали бы ошибку округления.
 
@@ -22,7 +24,9 @@
 | Член | Что это |
 | --- | --- |
 | `Total` | Все люди: жители + воины (в городе и в походах). |
-| `Civilians`, `Workers`, `Idle` | Жители, из них рабочие и остальные. |
+| `Civilians`, `Workers`, `Idle` | Жители, из них на работе и остальные. |
+| `Workforce`, `FreeWorkers` | Сколько могут работать; сколько из них без работы. |
+| `GetWorkers(job)`, `SetWorkers(job, n)` | Рабочие профессии; поставить n (в пределах мест и свободных). |
 | `Soldiers` | Воины — из модуля Армии. |
 | `HousingCap` | Предел населения. |
 | `FoodPerHour`, `GrowthPerHour` | Расход еды и прирост в час сейчас. |
@@ -35,6 +39,7 @@
 
 - **Публикует:**
     - `PopulationChangedEvent` — изменилось число людей;
+    - `WorkersChangedEvent` — переставили рабочих;
     - `StarvationChangedEvent` — голод начался или закончился.
 - **Слушает** (через `App/GameModules`):
     - `GameLoadedEvent` — офлайн-прогресс;
@@ -43,7 +48,7 @@
 
 ## Сохранение
 
-Секция `"population"`, простые строки: `civilians=`, `workers=`, `growth=`, `food=`, `lastTick=`, `starving=`, `kit=`.
+Секция `"population"`, простые строки: `civilians=`, `jobs=` (рабочие по профессиям), `jobsInit=`, `houses=`, `growth=`, `food=`, `lastTick=`, `starving=`, `kit=`.
 
 Сброс (`ResetState`): стартовый город, 270 жителей. Стартовое войско (30 пехоты) и стартовые ресурсы выдаёт `App/GameModules` после сброса и при первой игре (`NewGameStartedEvent`) — один раз (`kit=1`). Старым сохранениям без секции населения стартовый набор не выдаётся.
 
@@ -80,12 +85,13 @@
 ## Решения и план
 
 - **Голод:** дебаффы (в том числе у защитников) и правило снятия — решение команды от 19.10.2026, числа не утверждены. Модуль уже сообщает `StarvationChangedEvent`.
-- **Предел жилья:** по решению команды растёт с постройкой Дома. Пока Дома нет — предел от уровня Ратуши.
-- **Этап 3:** рабочие распределяются по зданиям, свободные — `Idle`.
+- **Предел жилья:** по решению команды растёт с постройкой Дома — сделано (здание «Население»).
+- **Этап 3:** сделано 27.10.2026 — рабочие по профессиям, Дома, добыча в общем расчёте.
 - **Этап 5:** найм воина забирает человека из жителей (гражданский резерв — решение от 19.10.2026).
 
 ## Журнал изменений
 
 | Дата | Кто | Что |
 | --- | --- | --- |
+| 27.10.2026 | Claude | Рабочие по профессиям (`Workforce`, `FreeWorkers`, `GetWorkers`, `SetWorkers`, автозаполнение), Дома в пределе жилья, базовый предел 300 (решение 19.10), добыча в общем расчёте. |
 | 26.10.2026 | Claude | Создан модуль: жители, еда, прирост, голод, предел жилья, офлайн-прогресс, секция `population`, тесты. |