1"""
  2[Title/Звание]
  3
  4Escape Python – интерактивна escape room игра
  5
  6
  7[Description/Обрисовка]
  8
  9Escape Python е текстова/графична игра, в която играчът попада в заключена стая
 10и трябва да намери начин да избяга чрез решаване на логически загадки,
 11събиране на предмети и взаимодействие с околната среда.
 12
 13Играта симулира escape room преживяване, като предлага различни стаи,
 14скрити улики и multiple endings в зависимост от решенията на играча.
 15Целта е да се демонстрира използване на структури от данни, класове,
 16модули и логика за управление на състояние, както и използване на
 17графична визуализация чрез подходяща Python библиотека.
 18
 19
 20[Functionalities/Надарености]
 21
 22* Играчът може да се движи между различни стаи
 23  -> използване на класове Room и Player
 24
 25* Играчът може да разглежда предмети и да ги добавя в инвентара си
 26  -> използване на класове Item и Inventory система
 27
 28* Система за инвентар (взимане, използване на предмети)
 29  -> използване на list, dictionaries и OOP логика
 30
 31* Пъзели (кодове, загадки, комбинации)
 32  -> използване на условни конструкции, функции и проверки
 33
 34* Взаимодействие чрез команди и графичен интерфейс
 35  -> използване на pygame или tkinter
 36
 37* Таймер (по желание – ограничено време за бягство)
 38  -> използване на модула time
 39
 40* Save/Load система
 41  -> използване на json модул
 42
 43* Multiple endings (успех/провал)
 44  -> използване на game state логика и проверки
 45
 46* Скритa логика за отключване на нови зони
 47  -> използване на flags, conditions и inventory checks
 48
 49* Визуализация на стаите, предметите и действията на играча
 50  -> използване на pygame за графична реализация
 51
 52
 53[Milestones/Възлови точки]
 54
 551. Основен game engine
 56
 57   * обработка на вход от потребителя
 58   * управление на game loop
 59
 602. Модел на играта
 61
 62   * класове за Room, Item, Player
 63   * връзки между стаите
 64
 653. Инвентар система
 66
 67   * добавяне и премахване на предмети
 68   * използване на предмети
 69
 704. Puzzle система
 71
 72   * кодови загадки
 73   * проверки за условия
 74
 755. Навигация и визуализация
 76
 77   * движение между стаи
 78   * описание и визуализиране на стаите
 79   * графичен интерфейс за взаимодействие
 80
 816. Persistence
 82
 83   * save/load чрез JSON
 84
 857. Графична реализация
 86
 87   * използване на библиотека като pygame или tkinter
 88   * визуализиране на интерфейс, менюта и игрови елементи
 89
 90
 91[Estimate in man-hours/Времеоценка]
 92
 93Общо: ~70 часа
 94
 95* Game engine: 10 часа
 96* Модел (класове): 10 часа
 97* Пъзели: 15 часа
 98* Инвентар: 10 часа
 99* Save/Load: 5 часа
100* Графична визуализация: 20 часа
101
102
103[Usage of technologies/Потребление на технологии]
104
105* Python - основен език
106* pygame или tkinter - за графична визуализация
107* json - за запазване на състояние
108* random - за генериране на елементи
109* time - за таймер
110* unittest - за тестове
111
112"""