chore(repo): checkpoint current capakraken implementation state

This commit is contained in:
2026-03-29 12:47:12 +02:00
parent beae1a5d6e
commit 47e4d701ff
94 changed files with 4283 additions and 1710 deletions
+15 -13
View File
@@ -1,8 +1,8 @@
# Planarchy CI/CD Manual
# CapaKraken CI/CD Manual
## Overview
Planarchy uses GitHub Actions for continuous integration and Docker for deployment. This document covers the full pipeline from code push to production.
CapaKraken uses GitHub Actions for continuous integration and Docker for deployment. This document covers the full pipeline from code push to production.
---
@@ -120,7 +120,7 @@ Checks PostgreSQL and Redis connectivity. Returns 200 if all services are reacha
```bash
# Build the image
docker build -f Dockerfile.prod -t planarchy:latest .
docker build -f Dockerfile.prod -t capakraken:latest .
# Test it locally
docker compose -f docker-compose.prod.yml up -d
@@ -142,9 +142,9 @@ The production image requires these environment variables:
```env
# Required
DATABASE_URL=postgresql://user:pass@host:5432/planarchy
DATABASE_URL=postgresql://user:pass@host:5432/capakraken
REDIS_URL=redis://host:6379
NEXTAUTH_URL=https://planarchy.your-domain.com
NEXTAUTH_URL=https://capakraken.your-domain.com
NEXTAUTH_SECRET=<random-32-char-string>
# Optional
@@ -153,7 +153,7 @@ SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=notifications@example.com
SMTP_PASSWORD=<password>
SMTP_FROM=Planarchy <notifications@example.com>
SMTP_FROM=CapaKraken <notifications@example.com>
```
Generate a secure `NEXTAUTH_SECRET`:
@@ -175,11 +175,11 @@ docker compose -f docker-compose.prod.yml up -d --build
# Run database migrations
docker compose -f docker-compose.prod.yml exec app \
npx prisma db push --skip-generate
pnpm db:push
# Seed initial data (first deployment only)
docker compose -f docker-compose.prod.yml exec app \
npx prisma db seed
pnpm db:seed
```
### Manual deployment (current setup)
@@ -188,10 +188,11 @@ Since `capakraken.hartmut-noerenberg.com` runs behind nginx:
```bash
# On the server
cd /home/hartmut/Documents/Copilot/planarchy
cd /home/hartmut/Documents/Copilot/capakraken
git pull origin main
pnpm install
pnpm --filter @capakraken/db exec prisma generate
pnpm db:generate
pnpm db:validate
pnpm --filter @capakraken/web exec next build
rm -rf apps/web/.next/cache # clear stale cache
@@ -283,7 +284,7 @@ Playwright test failure. Check the HTML report artifact in the GitHub Actions ru
The Next.js process isn't running. Check:
```bash
ss -tlnp | grep 3100 # Is anything listening?
tail -50 /tmp/planarchy-dev.log # Check app logs
tail -50 /tmp/capakraken-dev.log # Check app logs
```
Restart:
@@ -296,7 +297,8 @@ pnpm dev & # or pnpm start for production mode
Usually a stale Prisma client after schema changes:
```bash
pnpm --filter @capakraken/db exec prisma generate
pnpm db:generate
pnpm db:validate
rm -rf apps/web/.next
pnpm --filter @capakraken/web exec next build
# Restart the server
@@ -312,5 +314,5 @@ curl -s https://capakraken.hartmut-noerenberg.com/api/ready | jq .
If `postgres: "error"`, verify:
```bash
docker ps | grep postgres # Is container running?
psql -h localhost -p 5433 -U planarchy -d planarchy # Can you connect?
psql -h localhost -p 5433 -U capakraken -d capakraken # Can you connect?
```