192 lines
5.0 KiB
Markdown
192 lines
5.0 KiB
Markdown
# Faza 1: Infrastruktura, Monorepo i Baza Podataka
|
|
|
|
## 1.1. Svrha i Ciljevi Faze
|
|
|
|
Cilj prve faze je postavljanje stabilnog, lokalnog i produkcijski orijentisanog razvojnog okruženja. Uspostavlja se baza podataka PostgreSQL 16 i Redis 7 kroz Docker Compose, te konfiguriše Turborepo monorepo koji orkestrira Medusa v2 backend i dva odvojena Next.js storefronta.
|
|
|
|
---
|
|
|
|
## 1.2. Zvanični Paketi i Alati
|
|
|
|
Sistem se oslanja isključivo na provjereni softverski stek:
|
|
- **Node.js**: verzija `>= 22.0.0`
|
|
- **Package Manager**: `pnpm` (preporučeno) ili `npm` (verzija `>= 10.0.0`)
|
|
- **Docker & Docker Compose**: za pokretanje PostgreSQL 16 i Redis 7
|
|
- **Turborepo**: verzija `^2.0.0` za orkestraciju monorepo taskova (`dev`, `build`, `lint`)
|
|
|
|
---
|
|
|
|
## 1.3. Konfiguracija Baze i Keša (`docker-compose.yml`)
|
|
|
|
Kreirajte ili ažurirajte datoteku `docker-compose.yml` u korijenu repozitorijuma (`suman-doo/docker-compose.yml`):
|
|
|
|
```yaml
|
|
version: "3.8"
|
|
|
|
services:
|
|
postgres:
|
|
image: postgres:16-alpine
|
|
container_name: umbrella_postgres
|
|
restart: always
|
|
environment:
|
|
POSTGRES_USER: ${POSTGRES_USER:-medusa_user}
|
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-medusa_password}
|
|
POSTGRES_DB: ${POSTGRES_DB:-medusa_umbrella}
|
|
ports:
|
|
- "5432:5432"
|
|
volumes:
|
|
- pgdata:/var/lib/postgresql/data
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "pg_isready -U medusa_user -d medusa_umbrella"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
redis:
|
|
image: redis:7-alpine
|
|
container_name: umbrella_redis
|
|
restart: always
|
|
ports:
|
|
- "6379:6379"
|
|
volumes:
|
|
- redisdata:/data
|
|
healthcheck:
|
|
test: ["CMD", "redis-cli", "ping"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
volumes:
|
|
pgdata:
|
|
redisdata:
|
|
```
|
|
|
|
---
|
|
|
|
## 1.4. Turborepo Konfiguracija
|
|
|
|
### Root `package.json`
|
|
U korijenu monorepoa definisani su radni prostori (`workspaces`) i skripte za simultano pokretanje servisa:
|
|
|
|
```json
|
|
{
|
|
"name": "umbrella-platform",
|
|
"private": true,
|
|
"packageManager": "pnpm@9.15.0",
|
|
"engines": {
|
|
"node": ">=22.0.0"
|
|
},
|
|
"scripts": {
|
|
"dev": "turbo dev",
|
|
"build": "turbo build",
|
|
"lint": "turbo lint",
|
|
"backend:dev": "turbo dev --filter=@dtc/backend",
|
|
"backend:seed": "turbo seed --filter=@dtc/backend",
|
|
"store-de:dev": "turbo dev --filter=@umbrella/storefront-de",
|
|
"store-at:dev": "turbo dev --filter=@umbrella/storefront-at"
|
|
},
|
|
"devDependencies": {
|
|
"prettier": "^3.3.0",
|
|
"turbo": "^2.0.14"
|
|
},
|
|
"workspaces": [
|
|
"apps/*"
|
|
]
|
|
}
|
|
```
|
|
|
|
### Root `turbo.json`
|
|
Optimizovana definicija taskova sa cachingom i varijablama okruženja:
|
|
|
|
```json
|
|
{
|
|
"$schema": "https://turbo.build/schema.json",
|
|
"tasks": {
|
|
"build": {
|
|
"dependsOn": ["^build"],
|
|
"outputs": [".next/**", "!.next/cache/**", ".medusa/**", "dist/**"],
|
|
"env": [
|
|
"DATABASE_URL",
|
|
"REDIS_URL",
|
|
"MEDUSA_BACKEND_URL",
|
|
"NEXT_PUBLIC_MEDUSA_BACKEND_URL",
|
|
"NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY"
|
|
]
|
|
},
|
|
"dev": {
|
|
"cache": false,
|
|
"persistent": true
|
|
},
|
|
"lint": {
|
|
"dependsOn": ["^lint"]
|
|
},
|
|
"seed": {
|
|
"cache": false
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 1.5. Konfiguracija Backend Okruženja (`apps/backend/.env`)
|
|
|
|
U datoteci `apps/backend/.env` definisani su konekcioni stringovi i sigurnosni tokeni:
|
|
|
|
```env
|
|
# Port na kojem se izvršava Medusa v2 Backend i Admin
|
|
PORT=9000
|
|
|
|
# Baza podataka (PostgreSQL 16)
|
|
DATABASE_URL=postgres://medusa_user:medusa_password@localhost:5432/medusa_umbrella
|
|
|
|
# Redis za Event Bus i Keširanje sesija
|
|
REDIS_URL=redis://localhost:6379
|
|
|
|
# JWT i Cookie Tajne (Za produkciju generisati jake ključeve sa: openssl rand -base64 32)
|
|
JWT_SECRET=super_secret_jwt_key_suncobrani_2026_production_grade
|
|
COOKIE_SECRET=super_secret_cookie_key_suncobrani_2026_production_grade
|
|
|
|
# CORS Konfiguracija - dozvola pristupa za Admin i oba Storefronta
|
|
STORE_CORS=http://localhost:8000,http://localhost:8001
|
|
ADMIN_CORS=http://localhost:9000,http://localhost:7001
|
|
AUTH_CORS=http://localhost:9000,http://localhost:8000,http://localhost:8001
|
|
|
|
# Eksterni CRM Webhook (HubSpot / Brevo)
|
|
CRM_WEBHOOK_URL=https://api.hubspot.com/v1/webhook/umbrella-orders
|
|
CRM_API_KEY=pat-eu1-dummy-key-for-crm-sync
|
|
```
|
|
|
|
---
|
|
|
|
## 1.6. Korak-po-Korak Instrukcije za Izvršavanje
|
|
|
|
1. **Pokretanje Docker kontejnera:**
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
2. **Provjera statusa kontejnera:**
|
|
```bash
|
|
docker compose ps
|
|
```
|
|
*Oba servisa (`umbrella_postgres` i `umbrella_redis`) moraju imati status `healthy` ili `running`.*
|
|
3. **Instalacija zavisnosti u monorepou:**
|
|
```bash
|
|
pnpm install
|
|
```
|
|
4. **Pokretanje migracija na backendu:**
|
|
```bash
|
|
cd apps/backend
|
|
npx medusa db:migrate
|
|
```
|
|
|
|
---
|
|
|
|
## 1.7. Kriterijumi Prihvatljivosti (Acceptance Criteria)
|
|
|
|
- [ ] PostgreSQL kontejner uspješno odgovara na portu `5432` i baza `medusa_umbrella` je kreirana.
|
|
- [ ] Redis kontejner uspješno odgovara na komandu `redis-cli ping` sa `PONG`.
|
|
- [ ] Medusa v2 migracije (`npx medusa db:migrate`) prolaze sa izlaznim kodom `0` bez grešaka.
|
|
- [ ] Turborepo komanda `pnpm dev` uspješno detektuje radne prostore u `apps/*`.
|
|
|