fix(deploy): data sources, cors and other settings

Author: raisedadead

.env.example

@@ -1,17 +1,17 @@
 # Server Configuration
 PORT=4000
 
-# Data Path (relative to server package)
-# Default points to repository root data folder
-DATA_PATH=../../data/structure
+# Data Path (relative to project root)
+# Default points to data folder in project root
+DATA_PATH=./data/structure
 
 # CORS Configuration
-# In production, set to your frontend domain(s)
+# This API is publicly accessible and defaults to allowing all origins (*)
+# Optionally restrict to specific domain(s) if needed
 # Example: https://www.freecodecamp.org
 # Multiple origins: https://app1.example.com,https://app2.example.com
 CORS_ORIGIN=*
 
 # Environment
 # Set to 'production' in production environments
-# CORS_ORIGIN must be explicitly set when NODE_ENV=production
 NODE_ENV=development

.github/workflows/node.js-tests.yml

@@ -196,11 +196,47 @@ jobs:
 
       - name: Run tests with coverage
         run: pnpm test:coverage
+        env:
+          CI: true
+
+      - name: Generate coverage summary
+        if: always()
+        run: |
+          echo "## Test Coverage Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+
+          # Extract coverage summary from packages/server
+          if [ -f packages/server/coverage/coverage-summary.json ]; then
+            node -e "
+              const fs = require('fs');
+              const coverage = JSON.parse(fs.readFileSync('packages/server/coverage/coverage-summary.json', 'utf8'));
+              const total = coverage.total;
+
+              const formatPercent = (pct) => {
+                const color = pct >= 90 ? '🟢' : pct >= 80 ? '🟡' : '🔴';
+                return \`\${color} \${pct.toFixed(2)}%\`;
+              };
+
+              console.log('Coverage Summary:');
+              console.log('');
+              console.log('Statements  :', formatPercent(total.statements.pct));
+              console.log('Branches    :', formatPercent(total.branches.pct));
+              console.log('Functions   :', formatPercent(total.functions.pct));
+              console.log('Lines       :', formatPercent(total.lines.pct));
+              console.log('');
+              console.log('Files tested:', Object.keys(coverage).length - 1);
+            " >> $GITHUB_STEP_SUMMARY
+          else
+            echo "Coverage report not found" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
 
       - name: Upload coverage reports
         uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
         if: always()
         with:
-          files: ./coverage/coverage-final.json
+          files: ./packages/server/coverage/coverage-final.json
           flags: unittests
           name: codecov-curriculum-db

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint-staged

.husky/pre-push

@@ -0,0 +1 @@
+pnpm pre-push

Dockerfile

@@ -23,7 +23,7 @@ COPY --chown=node:node scripts/ scripts/
 # Install all dependencies (including dev dependencies for build)
 RUN pnpm install --frozen-lockfile
 
-# Fetch curriculum data using git sparse-checkout
+# Fetch curriculum data using giget
 RUN node scripts/fetch-curriculum-data.mjs
 
 # Build the TypeScript project

README.md

@@ -14,3 +14,34 @@ pnpm fetch-data
 # Start development server (hot reload)
 pnpm develop
 ```
+
+## Build
+
+Build and push locally:
+
+```bash
+# 1. Install dependencies
+pnpm install
+
+# 2. Fetch curriculum data
+pnpm fetch-data
+
+# 3. Build TypeScript
+pnpm build
+
+# 4. Build Docker image (fetches data again inside container)
+docker build -t curriculum-db .
+
+# 5. Tag for DOCR
+docker tag curriculum-db registry.digitalocean.com/{DOCR_NAME}/dev/curriculum-db:latest
+
+# 6. Push to DOCR
+docker push registry.digitalocean.com/{DOCR_NAME}/dev/curriculum-db:latest
+
+```
+
+OR with CI:
+
+```bash
+gh workflow run docker-docr.yml -f site_tld={SITE_TLD}
+```

package.json

@@ -18,7 +18,9 @@
     "test:ui": "turbo run test:ui",
     "test:coverage": "turbo run test:coverage",
     "fetch-data": "node scripts/fetch-curriculum-data.mjs",
-    "start": "node packages/server/dist/index.js"
+    "start": "node packages/server/dist/index.js",
+    "prepare": "husky",
+    "pre-push": "pnpm lint && pnpm format:check && pnpm type-check && pnpm test"
   },
   "keywords": [
     "freecodecamp",
@@ -30,14 +32,28 @@
   "license": "BSD-3-Clause",
   "packageManager": "[email protected]",
   "devDependencies": {
-  "@types/node": "^24.8.1",
-  "@vitest/coverage-v8": "^3.2.4",
-  "@vitest/ui": "^3.2.4",
-    "oxlint": "^0.18.0",
-    "prettier": "^3.3.3",
-    "tsx": "^4.19.2",
+    "@types/node": "^24.9.1",
+    "@vitest/coverage-v8": "^4.0.4",
+    "@vitest/ui": "^4.0.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "oxlint": "^1.24.0",
+    "prettier": "^3.6.2",
+    "tsx": "^4.20.6",
     "turbo": "^2.5.8",
-    "typescript": "^5.7.2",
-    "vitest": "^3.2.4"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.4"
+  },
+  "dependencies": {
+    "giget": "^2.0.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,mjs,cjs}": [
+      "oxlint",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
   }
 }

packages/server/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm test

packages/server/package.json

@@ -7,7 +7,7 @@
   "types": "./dist/index.d.ts",
   "scripts": {
     "develop": "tsx --watch src/index.ts",
-    "build": "tsc --build",
+    "build": "tsc --build && cp src/schema/schema.graphql dist/schema/",
     "type-check": "tsc --noEmit",
     "lint": "oxlint src",
     "format": "prettier --write src/",
@@ -27,10 +27,10 @@
   "author": "freeCodeCamp",
   "license": "BSD-3-Clause",
   "devDependencies": {
-  "@graphql-codegen/cli": "^6.0.0",
-  "@graphql-codegen/typescript": "^5.0.2",
-  "@graphql-codegen/typescript-resolvers": "^5.1.0",
-  "@graphql-tools/executor-http": "^1.3.3"
+    "@graphql-codegen/cli": "^6.0.1",
+    "@graphql-codegen/typescript": "^5.0.2",
+    "@graphql-codegen/typescript-resolvers": "^5.1.0",
+    "@graphql-tools/executor-http": "^3.0.4"
   },
   "dependencies": {
     "graphql": "^16.11.0",