Покренување и стартување на Проектот

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

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:

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

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