Add full-stack e-commerce discount demo application (#1)

Author: spoenemann

.devcontainer/devcontainer.json

@@ -0,0 +1,57 @@
+// Dev Container configuration for full-stack TypeScript development
+// Optimized for Node.js, React, Express.js, and TypeScript
+//
+// See https://aka.ms/devcontainer.json for more information.
+{
+	"name": "Full-Stack TypeScript (Node.js 20)",
+	"image": "mcr.microsoft.com/devcontainers/typescript-node:20",
+	
+	// Configure tool-specific properties
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"dbaeumer.vscode-eslint",
+				"esbenp.prettier-vscode",
+				"ms-vscode.vscode-typescript-next",
+				"bradlc.vscode-tailwindcss"
+			],
+			"settings": {
+				"editor.defaultFormatter": "esbenp.prettier-vscode",
+				"editor.formatOnSave": true,
+				"editor.codeActionsOnSave": {
+					"source.fixAll.eslint": "explicit"
+				},
+				"typescript.tsdk": "node_modules/typescript/lib",
+				"typescript.enablePromptUseWorkspaceTsdk": true
+			}
+		}
+	},
+
+	// Forward ports for backend and frontend
+	"forwardPorts": [3000, 3001],
+	"portsAttributes": {
+		"3000": {
+			"label": "Frontend (React)",
+			"onAutoForward": "notify"
+		},
+		"3001": {
+			"label": "Backend (Express)",
+			"onAutoForward": "notify"
+		}
+	},
+
+	// Install dependencies on container creation
+	"postCreateCommand": "cd app && npm install",
+
+	// Set environment variables
+	"remoteEnv": {
+		"NODE_ENV": "development"
+	},
+
+	// Use 'features' to add additional tools
+	"features": {
+		"ghcr.io/devcontainers/features/git:1": {
+			"version": "latest"
+		}
+	}
+}

.github/workflows/README.md

@@ -0,0 +1,86 @@
+# GitHub Actions Workflows
+
+## CI Workflow
+
+The CI workflow (`ci.yml`) ensures the application builds successfully before merging.
+
+### Triggers
+
+- **Push** to `main` branch only
+- **Pull requests** targeting `main`
+
+### Node.js Version
+
+- Node.js 20.x (Current LTS)
+
+### Steps
+
+1. **Checkout code** - Clone the repository
+2. **Setup Node.js** - Install Node.js 20.x with npm cache
+3. **Install dependencies** - Run `npm ci` in app directory (uses workspace)
+4. **Build backend** - Compile TypeScript backend to JavaScript
+5. **Build frontend** - Build React frontend with Vite
+6. **Verify artifacts** - Check that all expected build files exist
+7. **Upload artifacts** - Store build outputs for inspection (7 days retention)
+
+### Why Only One Node.js Version?
+
+The workflow uses Node.js 20.x (Current LTS) to:
+- Reduce CI runtime and resource usage
+- Avoid duplicate runs (push + PR would create 4 jobs with matrix)
+- Focus on the primary supported version
+- Keep feedback fast for developers
+
+The devcontainer also uses Node.js 20, ensuring consistency between local development and CI.
+
+### Build Verification
+
+The workflow verifies these artifacts are created:
+
+**Backend:**
+- `backend/dist/server.js`
+- `backend/dist/discount-rules.js`
+- `backend/dist/types.js`
+
+**Frontend:**
+- `frontend/dist/index.html`
+- `frontend/dist/assets/` (CSS and JS bundles)
+
+### Status Badge
+
+Add to README.md:
+```markdown
+![CI](https://github.com/TypeFox/oct-playground-demo/workflows/CI/badge.svg)
+```
+
+### Local Testing
+
+To test the same build process locally:
+
+```bash
+cd app
+npm ci
+npm run build --workspace=backend
+npm run build --workspace=frontend
+```
+
+Ensure you're using Node.js 20.x:
+```bash
+node --version  # Should show v20.x.x
+```
+
+### Troubleshooting
+
+**If CI fails:**
+
+1. Check the workflow run logs on GitHub Actions tab
+2. Look for TypeScript compilation errors
+3. Verify all dependencies are in package.json
+4. Test the build locally with Node.js 20.x
+5. Ensure package-lock.json is committed
+
+**Common issues:**
+
+- Missing dependencies: Run `npm install` and commit updated package-lock.json
+- TypeScript errors: Fix type issues in source code
+- Build configuration: Check tsconfig.json and vite.config.ts

.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    name: Build and Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+          cache-dependency-path: app/package-lock.json
+
+      - name: Install dependencies
+        working-directory: ./app
+        run: npm ci
+
+      - name: Build backend
+        working-directory: ./app
+        run: npm run build --workspace=backend
+
+      - name: Build frontend
+        working-directory: ./app
+        run: npm run build --workspace=frontend
+
+      - name: Verify build artifacts
+        working-directory: ./app
+        run: |
+          echo "Checking backend build artifacts..."
+          test -d backend/dist || (echo "Backend dist directory not found" && exit 1)
+          test -f backend/dist/server.js || (echo "Backend server.js not found" && exit 1)
+          test -f backend/dist/discount-rules.js || (echo "Backend discount-rules.js not found" && exit 1)
+          
+          echo "Checking frontend build artifacts..."
+          test -d frontend/dist || (echo "Frontend dist directory not found" && exit 1)
+          test -f frontend/dist/index.html || (echo "Frontend index.html not found" && exit 1)
+          
+          echo "✅ All build artifacts verified successfully"
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts
+          path: |
+            app/backend/dist/
+            app/frontend/dist/
+          retention-days: 7