Документација за 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@…

Password: BnP2025~

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

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