Changes between Initial Version and Version 1 of Prototype

Timestamp:

09/08/25 18:16:35 (19 hours ago)

Author:

163080

Comment:

--

Prototype

@@ +1 @@
+== Документација за 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 || Почетно полнење на базата ||