Files
Suman/docs/implementation-plan/phase-07-testing-verification-and-deployment.md
Nermin Karic f5e2fcbf98 first commit
2026-11-22 21:49:17 +01:00

4.8 KiB

Faza 7: Testiranje, Sigurnosna Verifikacija i Produkcijski Deployment

7.1. Svrha i Ciljevi Faze

Završna faza obuhvata rigoroznu verifikaciju svih sistema prije puštanja u rad, provjeru sigurnosnih pravila izolacije podataka, build validaciju monorepoa i pripremu za produkcijski deployment.


7.2. Detaljna QA Matrica Testiranja

# Scenarij Testiranja Koraci za Testiranje Očekivani Rezultat Status
1 Multi-Storefront Izolacija Kataloga Pozvati GET /store/products sa pk_de ključem i uporediti sa pozivom preko pk_at ključa. Svaki ključ vraća samo proizvode objavljene na njegovom kanalu i u pripadajućoj valuti. [ ]
2 Provjera Zaliha (Stock Availability) Dodati suncobran u korpu na Storefrontu DE i proći korak dostave. Artikal ima status "In Stock" jer je skladište Minhen povezano sa kanalom DE. [ ]
3 Admin Izolacija Narudžbi (Klaus - DE Admin) Prijaviti se u Admin sa admin.de@suncobrani.com i otvoriti /admin/orders. Prikazuju se isključivo narudžbe napravljene na njemačkom webshopu. [ ]
4 Zabrana Pristupa Tuđim Narudžbama Klaus pokušava otvoriti GET /admin/orders/{id_austrijske_narudzbe}. Backend vraća HTTP status 403 NOT_ALLOWED uz zabranu pristupa. [ ]
5 Super Admin Pristup Prijaviti se sa nalogom super admina (bez sales_channel_id u metadata). Prikazuju se narudžbe iz obje države bez restrikcija. [ ]
6 CRM Widget na Stranici Kupca Otvoriti bilo kojeg kupca u Medusa Adminu, unijeti PIB i bilješku agenta, kliknuti Sačuvaj. Podaci se perzistiraju u customer.metadata bez grešaka, prikazuje se success toast. [ ]
7 B2B Webhook Sinkronizacija Kreirati narudžbu sa nalogom koji ima popunjen PIB. Event subscriber reaguje na order.placed i uspješno prosljeđuje JSON payload na eksterni CRM webhook. [ ]
8 Multi-Language Rute (next-intl) Otvoriti /de/products/gastro-master-suncobran, zatim promijeniti URL na /en/.... Prikazuju se prevedene oznake specifikacija bez gubitka stanja korpe. [ ]
9 B2B Veleprodajni Cjenovnik Prijaviti se sa kupcem iz grupe HoReCa B2B Partneri. Cijene suncobrana se automatski prikazuju sa uračunatim veleprodajnim popustom. [ ]

7.3. Build Validacija Monorepoa

Prije postavljanja na server, cjelokupni monorepo se mora kompajlirati bez ijedne TypeScript ili ESLint greške.

Iz korijena monorepoa pokrenite:

# 1. Pokretanje lintera za backend i storefrontove
pnpm lint

# 2. Kompajliranje svih aplikacija kroz Turborepo
pnpm build

Tip

Turborepo će keširati stabilne dijelove aplikacije. Svi paketi u apps/* moraju završiti sa statusom SUCCESS.


7.4. Produkcijski Docker Multi-Stage Build

Za produkciju, Medusa backend se pakuje u optimizovani Docker image.

Kreirajte datoteku apps/backend/Dockerfile:

# 1. Faza izgradnje (Build stage)
FROM node:22-alpine AS builder

WORKDIR /app

# Instalacija alata za kompajliranje nativnih modula
RUN apk add --no-cache libc6-compat python3 make g++

COPY package.json pnpm-lock.yaml* ./
RUN npm install -g pnpm && pnpm install --frozen-lockfile

COPY . .
RUN pnpm build

# 2. Faza izvršavanja (Production runner stage)
FROM node:22-alpine AS runner

WORKDIR /app

ENV NODE_ENV=production
ENV PORT=9000

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 medusa

COPY --from=builder /app/package.json ./
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/.medusa ./.medusa
COPY --from=builder /app/medusa-config.ts ./medusa-config.ts

USER medusa

EXPOSE 9000

CMD ["npx", "medusa", "start"]

7.5. Preporuke za Produkcijski Deployment

  1. Baza Podataka i Keš:
    • Preporučuje se korištenje upravljanih servisa (Managed Database): AWS RDS PostgreSQL 16 ili DigitalOcean Managed PostgreSQL.
    • Za Redis: AWS ElastiCache ili Upstash Redis.
  2. Backend Hosting:
    • Medusa Cloud, Railway, AWS ECS ili Kubernetes kontejner.
    • Obavezno podesiti automatsko pokretanje migracija: npx medusa db:migrate prije pokretanja servisa.
  3. Storefront Hosting:
    • Vercel ili Cloudflare Pages za oba Next.js storefronta (storefront-de i storefront-at).
    • Na Vercelu se svaki storefront postavlja kao zaseban projekat povezan sa odgovarajućim root direktorijumom u monorepou (apps/storefront-de i apps/storefront-at) sa sopstvenim environment varijablama.

7.6. Kriterijumi Prihvatljivosti za Produkcijski Release

  • Sve stavke iz QA matrice (1-9) su uspješno verifikovane i označene.
  • Komanda pnpm build prolazi sa izlaznim kodom 0.
  • Svi tajni ključevi (JWT_SECRET, COOKIE_SECRET, CRM_API_KEY) su zamijenjeni kriptografski sigurnim vrijednostima.
  • SSL/TLS certifikati su aktivni na svim domenima.