first commit
This commit is contained in:
@@ -0,0 +1,110 @@
|
||||
# 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.
|
||||
|
||||
Reference in New Issue
Block a user