4.8 KiB
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 statusomSUCCESS.
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
- 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.
- Backend Hosting:
- Medusa Cloud, Railway, AWS ECS ili Kubernetes kontejner.
- Obavezno podesiti automatsko pokretanje migracija:
npx medusa db:migrateprije pokretanja servisa.
- Storefront Hosting:
- Vercel ili Cloudflare Pages za oba Next.js storefronta (
storefront-deistorefront-at). - Na Vercelu se svaki storefront postavlja kao zaseban projekat povezan sa odgovarajućim root direktorijumom u monorepou (
apps/storefront-deiapps/storefront-at) sa sopstvenim environment varijablama.
- Vercel ili Cloudflare Pages za oba Next.js storefronta (
7.6. Kriterijumi Prihvatljivosti za Produkcijski Release
- Sve stavke iz QA matrice (1-9) su uspješno verifikovane i označene.
- Komanda
pnpm buildprolazi sa izlaznim kodom0. - Svi tajni ključevi (
JWT_SECRET,COOKIE_SECRET,CRM_API_KEY) su zamijenjeni kriptografski sigurnim vrijednostima. - SSL/TLS certifikati su aktivni na svim domenima.