# 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: ```bash # 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`: ```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.