clear and add comments

Author: dylanflandpro

Dockerfile

@@ -1,59 +1,66 @@
-# Stage 1: builder
+
+# Builder Stage
 FROM node:22-alpine AS builder
 
 WORKDIR /app
 
-# install pnpm & git
-RUN npm install -g pnpm
-RUN apk update && \
-    apk upgrade && \
-    apk add --no-cache git
-
-RUN git init
+# install tools
+RUN npm install -g pnpm && \
+    apk add --no-cache git && \
+    git init
 
-
-# copy lock, package files and configs
+# copy files needed for installing dependencies
 COPY package.json pnpm-lock.yaml ./
-COPY run-jiti.js ./
-COPY src/features/build-info/script-to-generate-json.ts src/features/build-info/build-info.gen.json ./src/features/build-info/
 COPY prisma/schema.prisma ./prisma/
+COPY run-jiti.js ./
+COPY src/features/build-info/script-to-generate-json.ts ./src/features/build-info/
 
+# install dependencies
 RUN pnpm install --frozen-lockfile
 
-# copy source
+# copy source code
 COPY . .
 
+# build the application
 ENV NODE_OPTIONS=--max-old-space-size=4096
-
-# build app
 RUN pnpm build
 
 
-# Stage 2: runtime
-FROM node:22-alpine AS runtime
-
+# Runtime Stage
+FROM node:22-alpine
 
 WORKDIR /app
 
-# ENV
-ENV NODE_ENV=production
-ENV HOST=0.0.0.0
-ENV PORT=3000
+# Environnement variables
+ENV NODE_ENV=production \
+    HOST=0.0.0.0 \
+    PORT=3000
 
-# install pnpm
-RUN npm install -g pnpm npm-run-all
+# install tools
+RUN npm install -g pnpm npm-run-all && \
+    apk add --no-cache git && \
+    git init
 
-COPY .env ./
+# copy files needed for installing dependencies
 
 
+COPY --from=builder /app/package.json ./
+COPY --from=builder /app/pnpm-lock.yaml ./
+COPY --from=builder /app/run-jiti.js ./
+COPY --from=builder /app/prisma ./prisma
+COPY --from=builder /app/src/features/build-info ./src/features/build-info
 
-## copy output build and package.json from builder
-COPY --from=builder /app/.output ./.output
-COPY --from=builder /app/package.json ./package.json
-COPY --from=builder /app/pnpm-lock.yaml ./pnpm-lock.yaml
+# copy environment configuration
+# TODO: Replace with environment variables or secrets in production
+COPY .env ./
+
+# install production dependencies (this will run prisma generate)
 RUN pnpm install --frozen-lockfile
 
+# copy build artifacts after installation
+COPY --from=builder /app/.output ./.output
+
 EXPOSE 3000
 
-# start
+# start the application
 CMD ["pnpm", "start"]