1"""
 2[Title/Звание]
 3Travel around the world
 4
 5[Description/Обрисовка]
 6Travel around the world е идея за платформа, която има за цел да улесни всички приключенци и любители на пътуванията (нещо, което аз самата
 7от години бих желала да намеря като приложение и да го използвам за личните си екскурзии по света и в България). Основната идея е потребителят
 8да може изключително лесно да открие големите/туристически градове в избрана от него държава/американски щат, след което да се запознае с най-известните 
 9туристически забележителности в определен радиус до избрания град, които да отговарят на предварително посочени от него интереси. Идеята 
10се породи благодарение на честите ми пътувания в чужбина и желанието ми да видя всички основни забележителности в даден регион без да се 
11налага да скролвам с часове в приложения като "Trip Advisor". 
12
13[Functionalities/Надарености]
14Функционалности, които Travel around the world ще поддържа:
15    - вход, изход и регистрация в платформата;
16    - всеки потребител ще може да избере от предварителен списък категориите, които го интересуват (zoos, aquariums, museums, art galleries,
17libraries, amusement parks, mosques, churches, night clubs, cafes, restaurants, bars, parks, shopping malls, tourist attractions/landmarks.);
18    - всеки потребител ще може да намира най-големите/най-популярните градове в дадена държава или американски щат;
19    - всеки потребител ще може да вижда забележителностите в избраните от него категории в определен радиус до избран от него град (ще има
20някакво ограничение за този радиус, което се налага от Google maps Api);
21    - потребителят ще вижда само "проверени" забележителности, тоест такива които имат рейтинг, а сортирането им ще бъде от най-високия
22рейтинг към най-ниския. Рейтингът ще бъде видим за потребителите;
23    - потребителят ще може да избере колко забележителности да вижда (топ 5, топ 10, топ 20...). В случай, че те са по-малко, ще види всичките 
24(optional, ако остане време:));
25    - потребителят ще може да селектира забележителностите, които е посетил;
26    - в случай на повторно търсене на забележителности би могъл да избере опцията да не вижда резултати, които вече е посещавал
27(optional, ако остане време:));
28    - за всеки потребител ще се пази вътрешна база от данни с посетените дестинации/забележителности;
29    - приложението ще изчислява какъв процент от даден град / дадена държава потребителите са посетили на принципа брой посетени забележителности
30с рейтинг по-висок от 3.0;
31    - всеки потребител ще може сам да избере даден град или държава за посетени, ако му е втръснало от тях или не представляват интерес за него/нея;
32    - би било добре потребителят да може да експортира в ексел своята таблица с посетени забележителности/градове (все още не съм проучила
33как точно мога да направя това);
34    - на базата на данните от посетените места от всички потребители може да се изготвят списъци с най-посещавани дестинации в света или 
35даден континент;
36    - за всяка една от дестинациите потребителят ще може да види детайли;
37    - всеки потребител ще може да поддържа свой списък с мечтани дестинации;
38    - за допълнителна мотивация да харчи пари за екскурзии потребителят ще вижда снимки от неговите мечтани дестинации;
39    - за всеки един град при търсене ще се показва най-посещаваната дестинация от потребителите на сайта, или ако такава не съществува - 
40тази с най-висок рейтинг;
41    - за всяка държава ще се изписва кратка информация относно населението, валутата, континента и др.
42
43[Milestones/Възлови точки]
44    - модул за вход, изход и регистрация на потребители;
45    - модул за създаване на необходимите класове, техните методи и връзките между тях;
46    - модул за работа с Google maps Places API;
47    - модул за работа с geopy;
48    - модул за работа с countryinfo;
49    - модул за работа с вътрешната база от данни;
50    - модул за оформление на графичния интерфейс;
51    - модул за експортиране в екселска таблица;
52    - модул за добавяне на допълнителна информация към дестинациите чрез Google maps Places API - Place Details;
53    - модул за добавяне на изображения на мечтаните дестинации чрез Google maps Places API - Place photos;
54    - модул за тестване на кода и създаване на unit tests;
55     
56[Estimate in man-hours/Времеоценка в човекочасове]
57Честно казано изобщо не съм сигурна :Д Предполагам, че доста време ще ми отнеме тестването и преглеждането на кода, така че бих казала
58около 80-85 часа.
59
60[Usage of technologies/Потребление на технологии]
61    - за по-голямата част от проекта ще използвам Django;
62    - ще използвам Google maps Places API за подбор на градовете и дестинациите, като категориите дестинации са избрани според 
63https://developers.google.com/maps/documentation/places/web-service/supported_types
64    - ще използвам Пайтън пакета geopy за географските координати на градовете, предполагам, че ще мога да използвам и някои 
65вградени функции в него;
66    - ще използвам Пайтън пакета countryinfo, за да извлека допълнителни данни за различните държави;
67    - ще използвам Google maps Places API - Place Details, за да покажа детайли за конкретна дестинация;
68    - ще използвам Google maps Places API - Place Photos, за да добавя снимки на мечтаните и най-посещаваните дестинации;
69    - за Excel-ската таблица мисля да използвам Пайтън пакета openpyxl;
70    - със сигурност ще се наложи да използвам малко HTML, CSS и вероятно JS;
71(Приемам всякакви предложения, препоръки и корекции какво бих могла да добавя или премахна, какви технологии биха били по-удачни в моя
72случай...всичко ще е полезно да избистря нещата :Д)
73
74"""