Changes between Initial Version and Version 1 of BuildInstructions

Timestamp:

09/19/26 00:24:44 (12 days ago)

Author:

183164

Comment:

--

BuildInstructions

@@ +1 @@
+= Упатство за преведување и стартување =
+
+== Опис на развојната околина ==
+
+ * Програмски јазик: Python 3.10 или понова верзија
+ * Библиотека за пристап до базата: psycopg 3 (се инсталира автоматски, види подолу)
+ * База на податоци: PostgreSQL, шема project, креирана со скриптите од фазата P2
+ * Оперативен систем: Windows, Linux или macOS
+ * Изворниот код е во git репозиториумот на проектот
+
+== Упатство за инсталација ==
+
+1. Преземи го изворниот код од git репозиториумот на проектот.
+
+2. Во папката на проектот креирај виртуелна околина и инсталирај ги потребните библиотеки:
+{{{
+python -m venv .venv
+.venv\Scripts\activate
+pip install -r requirements.txt
+}}}
+На Linux и macOS, наместо втората команда се користи: source .venv/bin/activate
+
+3. Ако базата е празна, изврши ги скриптите од папката sql, по овој редослед: schema_creation.sql, па data_load.sql.
+
+4. Копирај ја датотеката config.example.ini во config.ini и внеси ги податоците за поврзување од EPRMS (host, port, име на базата, корисник и лозинка).
+
+5. Стартувај ја апликацијата:
+{{{
+python -m cityfix
+}}}
+
+Ако кирилицата не се прикажува правилно во старата конзола на Windows, пред стартување изврши chcp 65001 или користи Windows Terminal.
+
+== Упатство за тестирање ==
+
+Прототипот нема лозинки: корисникот се најавува со избор на улога и избор на корисник од листата вчитана од базата. Сите избори во апликацијата се прават со внесување на бројот пред понудената опција, а со 0 се враќа назад.
+
+'''Граѓанин''' (на пример Ана Димитриевска):
+ * „Поднеси нова пријава“ - избор на категорија, внес на опис, адреса и/или координати и имиња на фотографии. За проверка на слични пријави во близина, внеси координати 42.0006 и 21.4165 со категорија „Патишта и тротоари“.
+ * „Мои пријави“ - листа на пријавите, а по избор на пријава: историја на статусот, коментари и фотографии.
+
+'''Администратор''' (на пример Александар Петровски):
+ * Листа на недоделени пријави, избор на пријава, избор на работник според бројот на активни пријави и внес на забелешка.
+
+'''Општински работник''' (на пример Дејан Јовановски):
+ * Листа на доделени активни пријави, избор на пријава, додавање коментар, промена на статус и промена на приоритет.
+
+За да се вратат почетните податоци по тестирањето, повторно изврши ја скриптата data_load.sql.