first commit
This commit is contained in:
191
docs/implementation-plan/phase-01-infrastructure-and-monorepo.md
Normal file
191
docs/implementation-plan/phase-01-infrastructure-and-monorepo.md
Normal file
@@ -0,0 +1,191 @@
|
||||
# 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/*`.
|
||||
|
||||
Reference in New Issue
Block a user