1"""
 2[Title/Звание]
 3MarketMock
 4
 5[Description/Обрисовка]
 6MarketMock е софтуерна среда за симулация на финансови пазари, която работи с реални исторически данни.
 7Позволява зареждане на ценова информация от външни CSV източници и автоматично проиграва търговски сесии стъпка по стъпка.
 8Управлява виртуален портфейл, като следи наличностите в реално време, изчислява транзакционни разходи и прилага логически
 9правила за вход и изход от позиции, зададени от потребителя. В края на симулацията анализира представянето на избраната
10стратегия и извежда отчет за постигнатия финансов резултат.
11
12[Functionalities/Надарености]
13Потребителят задава първоначален виртуален капитал и посочва файл с исторически данни за даден актив.
14Програмата симулира движението на пазара ден по ден, подавайки данните итеративно чрез генератори.
15Приложението позволява избор и прилагане на различни дефинирани стратегии за покупка и продажба.
16Системата валидира всяка заявка за транзакция спрямо наличния баланс и автоматично удържа симулирани борсови такси.
17В случай на липса на средства или некоректни входни данни, системата генерира специфични изключения, които се логватза преглед.
18Генериране на подробен текстов отчет с ключови показатели: обща печалба/загуба (ROI), максимален спад на капитала и история на изпълнените поръчки.
19
20[Milestones/Възлови точки]
21Модул за обработка на данни – имплементация на генератори за построчно четене на масиви от CSV файлове.
22Ядро за симулация (Market Engine) – управлява времевата линия и синхронизацията между данните и портфейла.
23Мениджър на портфейла (Portfolio Manager) – ООП структура за следене на баланса, текущите активи и хронологията на сделките.
24Модул за търговски стратегии – базов клас и декоратори за лесно добавяне и тестване на нови логически правила.
25Система за отчетност и логване 
26Автоматизирано тестване
27
28[Estimate in man-hours/Времеоценка в човекочасове]
2935 часа
30
31[Usage of technologies/Потребление на технологии]
32Стандартна библиотека: csv, json, datetime, logging, unittest, unittest.mock.
33Външни библиотеки: requests (за опционално извличане на данни от финансови API-та).
34"""