commit 556c5c5abf2629eddd29c6c42b877eacf677c031 Author: sokol Date: Fri Feb 20 20:37:43 2026 +0300 Initial commit: Add TZ.md (technical specification draft) diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..ac93b02 --- /dev/null +++ b/.gitignore @@ -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/ diff --git a/docs/TZ.md b/docs/TZ.md new file mode 100644 index 0000000..19f7142 --- /dev/null +++ b/docs/TZ.md @@ -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