Initial parlo-styring skill - dev/deploy/ops for Mikkel's app

SKILL.md

@@ -0,0 +1,127 @@
+---
+name: parlo-styring
+description: Parlo Styring app for Parlobyg - Next.js job management system. Use for development, deployment, and working with Mikkel's scheduling app. Triggers on parlo-styring, scheduling app, or Coolify deployment tasks.
+---
+
+# Parlo Styring Skill
+
+Next.js job management and scheduling application for Parlobyg construction company.
+
+## Live App
+
+- **URL:** https://parlo.machinemachine.ai
+- **Status:** ✅ Running healthy
+
+## Repository
+
+- **Git:** http://git.machinemachine.ai/machine.machine/parlo-styring.git
+- **Forgejo UI:** http://git.machinemachine.ai/machine.machine/parlo-styring
+
+## Deployment (Coolify)
+
+- **App UUID:** xht4hfyngaimnf0mjmrc93vx
+- **Stack:** Next.js 14.2.5 (standalone)
+- **Port:** 3000 (internal)
+- **Domain:** parlo.machinemachine.ai (via Traefik)
+
+### Environment Variables
+```
+ORDRESTYRING_API_KEY=q3mjVDR6wAdPCvZT
+ENABLE_WRITES=false
+OPENROUTER_API_KEY=sk-or-v1-...
+NEXTAUTH_URL=https://parlo.machinemachine.ai
+```
+
+## Development
+
+### Clone & Run Locally
+```bash
+# Clone
+git clone http://git.machinemachine.ai/machine.machine/parlo-styring.git
+cd parlo-styring
+
+# Install & run
+npm install
+npm run dev
+```
+
+### Push Changes
+```bash
+git add -A
+git commit -m "feat: description"
+git push origin main
+# Coolify auto-deploys on push
+```
+
+## Architecture
+
+```
+src/
+├── app/              # Next.js App Router pages
+│   ├── api/          # API routes
+│   │   ├── cases/    # Ordrestyring cases
+│   │   ├── customers/
+│   │   ├── workers/
+│   │   └── ai/       # AI chat endpoint
+│   ├── dashboard/    # Main dashboard
+│   ├── sager/        # Cases (Sager) pages
+│   ├── kunder/       # Customers pages
+│   └── medarbejdere/ # Workers pages
+├── components/       # React components
+│   ├── GanttChart/   # Scheduling Gantt view
+│   ├── CaseDetail/   # Case detail panel
+│   └── Chat/         # AI chat interface
+└── lib/
+    └── ordrestyring.ts  # GraphQL client
+```
+
+## Features
+
+- 📋 **Dashboard** — Overview of cases, workers, schedule
+- 📅 **Gantt Chart** — Visual scheduling with AI suggestions
+- 👥 **Customers** — Customer list with detail views
+- 👷 **Workers** — Worker management and daily views
+- 💬 **AI Chat** — OpenRouter-powered assistant
+- 📱 **PWA** — Mobile-friendly, installable
+
+## API Integration
+
+### Ordrestyring
+The app fetches live data from Ordrestyring GraphQL:
+- Cases, customers, workers, hours
+- Read-only by default (`ENABLE_WRITES=false`)
+
+### AI Chat
+Uses OpenRouter API with context from:
+- Qdrant vector memory (memory-qdrant:6333)
+- BGE-M3 embeddings (memory-embeddings:8000)
+
+## Work Packages
+
+The repo contains WORKPACKAGE-*.md files documenting features to build.
+Current count: ~39 work packages
+
+## Quick Commands
+
+```bash
+# Check deployment status
+curl -s https://parlo.machinemachine.ai/api/health
+
+# View recent commits
+curl -s -H "Authorization: token $FORGEJO_TOKEN" \
+  "http://git.machinemachine.ai/api/v1/repos/machine.machine/parlo-styring/commits?limit=5"
+
+# Trigger rebuild (via Forgejo webhook)
+# Push any change → Coolify auto-deploys
+```
+
+## Related Skills
+
+- **ordrestyring** — GraphQL API for job data
+- **parlobyg-email** — Email integration
+- **microsoft-graph** — Mikkel's Outlook/OneDrive
+
+## References
+
+- [App Architecture](references/architecture.md)
+- [Deployment Guide](references/deployment.md)

references/architecture.md

@@ -0,0 +1,94 @@
+# Parlo Styring Architecture
+
+## Stack
+
+- **Framework:** Next.js 14.2.5 (App Router)
+- **Styling:** Tailwind CSS
+- **Language:** TypeScript
+- **Deployment:** Docker → Coolify → Traefik
+
+## Data Flow
+
+```
+┌─────────────────┐     ┌──────────────────┐
+│  Browser/PWA    │────▶│  Next.js Server  │
+└─────────────────┘     └────────┬─────────┘
+                                 │
+         ┌───────────────────────┼───────────────────────┐
+         │                       │                       │
+         ▼                       ▼                       ▼
+┌─────────────────┐   ┌──────────────────┐   ┌──────────────────┐
+│  Ordrestyring   │   │  OpenRouter AI   │   │  Vector Memory   │
+│  GraphQL API    │   │  (claude-haiku)  │   │  (Qdrant+BGE-M3) │
+└─────────────────┘   └──────────────────┘   └──────────────────┘
+```
+
+## Key Components
+
+### Pages (App Router)
+- `/` — Redirect to dashboard
+- `/dashboard` — Main overview
+- `/sager` — Cases list
+- `/sager/[id]` — Case detail
+- `/kunder` — Customers list
+- `/medarbejdere` — Workers list
+- `/tidsplan` — Gantt schedule
+
+### API Routes
+- `/api/cases` — Proxy to Ordrestyring cases
+- `/api/customers` — Proxy to Ordrestyring customers
+- `/api/workers` — Proxy to Ordrestyring workers
+- `/api/hours` — Time entries
+- `/api/ai/chat` — AI chat with RAG
+
+### Ordrestyring Client
+`src/lib/ordrestyring.ts` — TypeScript GraphQL client
+
+```typescript
+// Read operations (always enabled)
+getCases(limit, page)
+getCase(id)
+getCustomers(limit, page)
+getWorkers(limit, page)
+getHours(limit, page)
+
+// Write operations (gated by ENABLE_WRITES)
+createCase(data)
+updateCase(id, data)
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ORDRESTYRING_API_KEY` | Yes | Ordrestyring GraphQL API key |
+| `ENABLE_WRITES` | No | Enable write mutations (default: false) |
+| `OPENROUTER_API_KEY` | No | AI chat functionality |
+| `NEXTAUTH_URL` | Yes | Auth callback URL |
+| `NEXTAUTH_SECRET` | Yes | Session encryption |
+
+## Docker
+
+```dockerfile
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine AS runner
+WORKDIR /app
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
+COPY --from=builder /app/public ./public
+EXPOSE 3000
+CMD ["node", "server.js"]
+```
+
+## Coolify Config
+
+- **Build:** Dockerfile
+- **Port:** 3000
+- **Health:** `/api/health`
+- **Volume:** `parlo-styring-data:/app/data` (for uploads)

references/deployment.md

@@ -0,0 +1,76 @@
+# Parlo Styring Deployment Guide
+
+## Coolify Dashboard
+
+The app is deployed via Coolify at the machinemachine.ai infrastructure.
+
+## Auto-Deploy
+
+Pushes to `main` branch trigger automatic deployment via Forgejo webhook.
+
+```bash
+# Make changes
+git add -A
+git commit -m "feat: new feature"
+git push origin main
+# → Coolify builds and deploys automatically
+```
+
+## Manual Deploy
+
+If webhook fails, deploy manually via Coolify UI:
+1. Go to Coolify dashboard
+2. Find `parlo-styring` app
+3. Click "Redeploy"
+
+## Environment Updates
+
+To update environment variables:
+1. Coolify dashboard → parlo-styring → Environment
+2. Edit variables
+3. Save & Redeploy
+
+## Monitoring
+
+### Health Check
+```bash
+curl https://parlo.machinemachine.ai/api/health
+```
+
+### Logs
+View in Coolify dashboard → parlo-styring → Logs
+
+### Container Status
+```bash
+# Via Coolify API or dashboard
+# Status should show: running:healthy
+```
+
+## Rollback
+
+1. Coolify dashboard → parlo-styring → Deployments
+2. Find previous successful deployment
+3. Click "Rollback"
+
+## DNS / SSL
+
+- Domain: parlo.machinemachine.ai
+- SSL: Auto-managed by Traefik (Let's Encrypt)
+- Proxy: Traefik routes traffic to container port 3000
+
+## Troubleshooting
+
+### 502 Bad Gateway
+- Container crashed or not started
+- Check Coolify logs
+- Verify health check passes
+
+### Build Failures
+- Check build logs in Coolify
+- Common: dependency issues, TypeScript errors
+- Fix locally, push again
+
+### Auth Issues
+- Verify `NEXTAUTH_URL` matches domain
+- Check `NEXTAUTH_SECRET` is set
+- Clear cookies and retry

scripts/deploy.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Parlo Styring deployment helper
+
+REPO_URL="http://git.machinemachine.ai/machine.machine/parlo-styring.git"
+APP_URL="https://parlo.machinemachine.ai"
+FORGEJO_TOKEN="${FORGEJO_TOKEN:-853477e0b57dea951c8c46c6c24b0ddffa5393dc}"
+
+case "$1" in
+  status)
+    echo "Checking app health..."
+    curl -s "$APP_URL/api/health" 2>/dev/null || echo "App not responding"
+    ;;
+  
+  commits)
+    echo "Recent commits:"
+    curl -s -H "Authorization: token $FORGEJO_TOKEN" \
+      "http://git.machinemachine.ai/api/v1/repos/machine.machine/parlo-styring/commits?limit=${2:-5}" \
+      | jq -r '.[] | "\(.sha[0:7]) \(.commit.message | split("\n")[0]) - \(.commit.author.name)"'
+    ;;
+  
+  clone)
+    echo "Cloning parlo-styring..."
+    git clone "$REPO_URL" "${2:-parlo-styring}"
+    ;;
+  
+  push)
+    echo "Pushing changes (triggers Coolify deploy)..."
+    git push origin main
+    ;;
+  
+  *)
+    echo "Usage: $0 {status|commits|clone|push}"
+    echo ""
+    echo "Commands:"
+    echo "  status         Check app health"
+    echo "  commits [n]    Show recent n commits (default 5)"
+    echo "  clone [dir]    Clone repo to directory"
+    echo "  push           Push changes to trigger deploy"
+    ;;
+esac