= Упатство за инсталација и стартување (Build instructions) =

Оваа страница содржи детален преглед на развојната околина, чекорите за инсталација, градење и стартување на апликацијата !StockMaster, како и упатство за нејзино тестирање.

== Развојна околина ==
За успешно компајлирање и извршување на проектот, потребни се следните алатки:
 * '''Framework:''' .NET 8.0 SDK (ASP.NET Core MVC 8.0)
 * '''База на податоци:''' PostgreSQL (верзија 15 или понова)
 * '''IDE:''' Visual Studio 2022 (или соодветна верзија со поддршка за .NET 8.0)

== Инструкции за градење и стартување ==

1. '''Клонирајте го изворниот код од GitHub:'''
{{{
git clone https://github.com/ceydahuseini/StockMaster.git
cd StockMaster
}}}

2. '''Конфигурација на конекциската низа:'''
Отворете го фајлот `appsettings.json` и внесете ги вашите локални параметри за пристап до PostgreSQL базата (користејќи ја шемата `stock_management`):
{{{
"ConnectionStrings": {
  "DefaultConnection": "Host=localhost;Database=stock_management;Username=your_user;Password=your_password"
}
}}}

3. '''Креирање на базата и внесување податоци (Преку SQL скрипти):'''
 * Креирајте празна база во PostgreSQL со име `stock_management`.
 * Извршете ја најпрво [https://develop.finki.ukim.mk/projects/stk-mstr/attachment/wiki/RelationalDesign/schema_creation.sql schema_creation.sql] скриптата за автоматски да се генерираат сите потребни табели, клучови и релации.
 * Извршете ја [https://develop.finki.ukim.mk/projects/stk-mstr/attachment/wiki/RelationalDesign/data_load.sql data_load.sql] скриптата за да се наполнат табелите со почетните податоци.

4. '''Стартување на прототипот:'''
* '''Преку Visual Studio:''' Отворете го проектот преку `.sln` датотеката и притиснете го зеленото копче '''Start'''.
По стартувањето, апликацијата ќе биде достапна локално на адресата: `http://localhost:5000` (или соодветниот локален порт прикажан во терминалот на ASP.NET Core).

== Инструкции за тестирање ==
По успешното отворање на веб-апликацијата во web-browser, можете да ги тестирате дефинираните кориснички сценарија.

За најава во системот со целосни администраторски привилегии, користете ги следните податоци:

|| '''Корисничко име (Username)''' || '''Лозинка (Password)''' || '''Улога (Role)''' ||
|| ceyda_admin || test123 || Admin ||