Initial commit: Add TZ.md (technical specification draft)

This commit is contained in:
sokol
2026-02-20 20:37:43 +03:00
commit 556c5c5abf
2 changed files with 206 additions and 0 deletions

36
.gitignore vendored Normal file
View File

@@ -0,0 +1,36 @@
# Godot
.godot/
export.cfg
export_presets.cfg
# Mono/Godot C#
mono/
*.csproj
*.sln
obj/
bin/
*.pidb
*.userprefs
# Build outputs
build/
dist/
# IDE
.vs/
.vscode/
.idea/
*.swp
*.swo
*~
# OS
.DS_Store
Thumbs.db
# Logs
*.log
# Temporary files
tmp/
temp/

170
docs/TZ.md Normal file
View File

@@ -0,0 +1,170 @@
# Техническое задание: Экономический симулятор
## 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