# Техническое задание: Экономический симулятор

## 1. Общее описание

**Название проекта:** [TBD]

**Жанр:** Экономический симулятор с элементами стратегии

**Референсы:** Capitalism 2, Capitalism Lab

**Краткое описание:** Игрок управляет бизнес-империей, начиная с небольшого предприятия в прошлом (несколько десятилетий назад) и развиваясь до современной корпорации. Продукция и услуги открываются постепенно через исследования в лабораториях.

---

## 2. Техническая архитектура

### 2.1. Стек технологий

| Компонент | Технология |
|-----------|------------|
| Бэкенд | C# + Akka.net |
| Фронтенд | Godot 4+ (C#) |
| База данных | SQLite (с возможностью миграции на PostgreSQL/MySQL) |
| Тестирование | xUnit (бэкенд) |

### 2.2. Архитектурные решения

- **Архитектура:** Модульная с событийной моделью
- **Коммуникация:** События (signals) + центральный менеджер состояния
- **Игровой цикл:** Real-time с настраиваемым тиком расчётов
- **Поддержка модов:** Требуется
- **Мультиплеер:** Заложить возможность расширения
- **Графика:** Изометрическая псевдо-3D

### 2.3. Структура проекта (предварительно)

```
project/
├── backend/           # C# + Akka.net
│   ├── src/
│   ├── tests/         # xUnit тесты
│   └── ...
├── frontend/          # Godot 4+
│   ├── scenes/
│   ├── scripts/
│   └── ...
├── shared/            # Общие модели/контракты
├── docs/              # Документация
└── tools/             # Утилиты, моддинг
```

---

### 3.1. Временная шкала

- **Стартовая эпоха:** Настраивается (рекомендуется 1950-1980-е)
- **Конечная эпоха:** До наших дней (~2020-е) или далее
- **Прогрессия:** Постепенное открытие продуктов и услуг через исследования
- **Привязка к году:** Доступные технологии и продукты зависят от выбранного года старта

### 3.2. Отрасли (MVP)

- [x] **Розничная торговля** — магазины, торговые сети
- [x] **Производство** — заводы, фабрики, цепочки производства
- [x] **Импорт/экспорт** — закупка у местных поставщиков, международная торговля
- [ ] Сельское хозяйство (будущие версии)
- [ ] Недвижимость (будущие версии)
- [ ] Финансы (будущие версии)
- [ ] Технологии (будущие версии)

### 3.3. Система исследований

- Дерево технологий (tech tree)
- Лаборатории для разработки новых продуктов
- Зависимость доступных технологий от игрового года
- Настройка скорости исследований

### 3.4. Конкуренция

- **MVP:** Одиночная игра
- **Перспектива:** AI-противники + мультиплеер
- AI-противники: настраиваемая сложность, агрессивность

### 3.5. Карта/локация

- **Масштаб:** Мир (глобальная карта)
- **Города:** Настраиваемое количество
- **Размер городов:** Настраиваемый (малый, средний, крупный)
- **Рынки:** Каждый город/регион — отдельный рынок со спросом

---

## 4. Требования

### 4.1. Функциональные

1. **Экономика:**
   - Система спроса/предложения
   - Динамическое ценообразование
   - Цепочки производства

2. **Бизнес:**
   - Покупка/строительство зданий
   - Наём/управление персоналом
   - Закупка сырья
   - Производство товаров
   - Продажа через магазины

3. **Исследования:**
   - Дерево технологий
   - Лаборатории
   - Открытие новых продуктов

4. **Финансы:**
   - Бухгалтерия (прибыль/убытки)
   - Кредиты/займы
   - [TBD]

5. **Сохранения:**
   - Сохранение/загрузка игры
   - Автосохранение

### 4.2. Нефункциональные

- **Производительность:** [TBD]
- **Масштабируемость:** Поддержка расширения
- **Моддинг:** API для модов
- **Локализация:** [TBD]

---

## 5. Вопросы для уточнения (TBD)

| Раздел | Вопрос |
|--------|--------|
| Отрасли | Какие товары/продукты включить в MVP? |
| Производство | Какие цепочки производства? |
| Экономика | Баланс цен, спроса/предложения? |
| Контент | Сценарии или песочница? |
| Локализация | Какие языки? |
| Производительность | Целевые FPS, масштаб карты? |

---

## 6. План разработки (предварительно)

| Этап | Описание | Срок |
|------|----------|------|
| 1 | Прототип ядра экономики | [TBD] |
| 2 | Базовый UI | [TBD] |
| 3 | Система исследований | [TBD] |
| 4 | Контент (отрасли, товары) | [TBD] |
| 5 | AI конкуренты | [TBD] |
| 6 | Полировка, тесты | [TBD] |

---

## 7. Глоссарий

| Термин | Определение |
|--------|-------------|
| Тик | Единица игрового времени для расчётов |
| Tech Tree | Дерево технологий/исследований |
| [TBD] | To Be Determined — требует уточнения |

---

**Статус документа:** Черновик v0.1  
**Дата создания:** 20.02.2026  
**Последнее обновление:** 20.02.2026