feat(platform): add Drizzle schema, seed pipeline, CI, Docker and OSS docs

Author: VORTEX

.env.example

@@ -0,0 +1 @@
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/spanish

.github/workflows/ci.yml

@@ -0,0 +1,14 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run test
+      - run: npm run build
+      - run: docker build -t spanish-open-source .

.gitignore

@@ -0,0 +1,43 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+!.env.example

ATTRIBUTION.md

@@ -0,0 +1,2 @@
+# Attribution
+This project includes inspired mechanics from language-learning patterns (XP, streak, SRS) and uses open-source libraries listed in LICENSES.md.

Dockerfile

@@ -0,0 +1,18 @@
+FROM node:22-alpine AS deps
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+FROM node:22-alpine AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+FROM node:22-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+COPY --from=builder /app/.next ./.next
+COPY --from=builder /app/public ./public
+COPY --from=builder /app/package*.json ./
+COPY --from=builder /app/node_modules ./node_modules
+EXPOSE 3000
+CMD ["npm","run","start"]

LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

LICENSES.md

@@ -0,0 +1,6 @@
+# Third-party Licenses
+- Next.js (MIT)
+- React (MIT)
+- Tailwind CSS (MIT)
+- Drizzle ORM (Apache-2.0)
+- PostgreSQL client `pg` (MIT)

README.md

@@ -0,0 +1,35 @@
+# HablaFlow (spanish-open-source)
+
+Open-source Spaanse leerapp met Duolingo-achtige mechanics, gebouwd met Next.js App Router + TypeScript + Tailwind + Drizzle + PostgreSQL + Docker.
+
+## Features
+- 120 lessen (A1/A2)
+- 2640 zinnen (offline seedbaar)
+- 10 exercise types
+- XP + streak + SM-2 SRS
+- Admin panel (`/admin`)
+- Vocabulary browser (`/vocab`)
+- API endpoints voor progress en admin
+
+## Local run
+```bash
+npm install
+npm run lint
+npm run test
+npm run build
+docker build -t spanish-open-source .
+docker compose up --build
+```
+
+## Database
+```bash
+cp .env.example .env
+npm run db:generate
+npm run db:migrate
+npm run db:seed
+```
+
+## Offline curriculum artifact
+```bash
+npm run seed:offline
+```

docker-compose.yml

@@ -0,0 +1,17 @@
+services:
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_DB: spanish
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+    ports: ["5432:5432"]
+    volumes: ["pgdata:/var/lib/postgresql/data"]
+  app:
+    build: .
+    environment:
+      DATABASE_URL: postgres://postgres:postgres@db:5432/spanish
+    ports: ["3000:3000"]
+    depends_on: [db]
+volumes:
+  pgdata:

drizzle.config.ts

@@ -0,0 +1,3 @@
+import "dotenv/config";
+import { defineConfig } from "drizzle-kit";
+export default defineConfig({ schema: "./src/db/schema.ts", out: "./drizzle", dialect: "postgresql", dbCredentials: { url: process.env.DATABASE_URL || "postgres://postgres:postgres@localhost:5432/spanish" } });