== Документација за P5 – Апликативна Инсталација и Покренување на Проектот ==

Оваа секција го документира техничкиот процес за стартување на апликацијата (AgencyOS), со цел да се потврди дека фазата P5 е успешно извршена.

=== 1. Предуслови

Инсталиран Node.js (препорачано v16.x или v18.x)

Yarn или npm (за управување со пакети)

Пристап до PostgreSQL база преку SSH

Google Cloud сервисен акаунт JSON

=== 2. Клонирање и Инсталација на Зависности

{{{
git clone <repo-url>
cd agencyos
yarn install

или

npm install --legacy-peer-deps
}}}

=== 3. Конекција со Базата на Податоци

Отворете нов терминал и стартувајте SSH тунел до базата:

{{{
ssh -L 5432:localhost:5432 t_agency_os@194.149.135.130 -N
}}}

Терминалот мора да остане отворен додека работи апликацијата.

=== 4. Конфигурација на Околина (Environment)

Креирај .env фајл во root и постави пат до Google Cloud service account:

{{{
GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account.json"
}}}

=== 5. Генерирање на Prisma Клиент

{{{
yarn prisma:generate
}}}

=== 6. Почетно Полнење на Базата (Seed)

Само при прво инсталирање:

{{{
yarn db:seed
}}}

Ова креира почетен tenant и администратор.

=== 7. Стартување на Девелопмент Сервер

{{{
yarn dev
}}}

Системот е достапен на http://localhost:3000

=== 8. Логирање (автентикација)

Апликацијата користи Firebase Authentication.

Демо логин креденцијали:

Email: naum@mvpmasters.com

Password: BnP2025~

=== 9. Достапни Скрипти

||= Скрипта =||= Опис =||
|| yarn dev || Стартување во девелопмент режим ||
|| yarn prisma:generate || Генерира Prisma клиент од моделот ||
|| yarn build || Продукциско билдување ||
|| yarn start || Стартување на билдот во продукција ||
|| yarn db:seed || Почетно полнење на базата ||