ci: optimize Docker cache usage

.dockerignore

@@ -4,3 +4,4 @@
 .npm
 dist
 node_modules
+.git

Dockerfile

@@ -8,10 +8,14 @@ ARG CI=true
 RUN mkdir /app
 WORKDIR /app
 
-COPY . .* ./
-
+# Install dependencies before copying the full source code to take advantage of Docker layer caching
+COPY package*.json ./
+# Needed for postinstall (build:models) during npm ci
+COPY src/build-spec.ts ./src/build-spec.ts
+COPY src/openapi ./src/openapi
 RUN npm ci
 
+COPY . .* ./
 RUN npm run build
 RUN npm run lint
 RUN npm run test

README.md

@@ -71,6 +71,10 @@ npm run build:spec   # Build OpenAPI specification
 | `src/openapi/`       | OpenAPI specifications              |
 | `src/middleware/`    | JWT, session, authz middleware      |
 
+### Operational Docs
+
+- [Docs](docs/)
+
 ## Authentication & Authorization
 
 ### Authentication