Enhance Prisma schema and documentation for dashboard features

- Added new models for DashboardAccessRule and DashboardAuditLog to the Prisma schema, improving access control and logging capabilities.
- Updated GuildSettings model to include timezone support.
- Revised PHASE-TRACKING.md to reflect the completion of Phase 5 and outline upcoming Phase 6 features, including dashboard layout and settings framework.
- Exported new phase 6 features in shared index for better modularity.

apps/bot/prisma/migrations/20260722180000_phase6_webui/migration.sql

@@ -0,0 +1,46 @@
+-- AlterTable
+ALTER TABLE "GuildSettings" ADD COLUMN "timezone" TEXT NOT NULL DEFAULT 'Europe/Berlin';
+
+-- CreateTable
+CREATE TABLE "DashboardAccessRule" (
+    "id" TEXT NOT NULL,
+    "guildId" TEXT NOT NULL,
+    "roleId" TEXT NOT NULL,
+    "modules" JSONB NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "DashboardAccessRule_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "DashboardAuditLog" (
+    "id" TEXT NOT NULL,
+    "guildId" TEXT,
+    "actorUserId" TEXT NOT NULL,
+    "action" TEXT NOT NULL,
+    "path" TEXT,
+    "before" JSONB,
+    "after" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "DashboardAuditLog_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "DashboardAccessRule_guildId_idx" ON "DashboardAccessRule"("guildId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "DashboardAccessRule_guildId_roleId_key" ON "DashboardAccessRule"("guildId", "roleId");
+
+-- CreateIndex
+CREATE INDEX "DashboardAuditLog_guildId_createdAt_idx" ON "DashboardAuditLog"("guildId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "DashboardAuditLog_actorUserId_createdAt_idx" ON "DashboardAuditLog"("actorUserId", "createdAt");
+
+-- AddForeignKey
+ALTER TABLE "DashboardAccessRule" ADD CONSTRAINT "DashboardAccessRule_guildId_fkey" FOREIGN KEY ("guildId") REFERENCES "Guild"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "DashboardAuditLog" ADD CONSTRAINT "DashboardAuditLog_guildId_fkey" FOREIGN KEY ("guildId") REFERENCES "Guild"("id") ON DELETE CASCADE ON UPDATE CASCADE;

apps/bot/prisma/schema.prisma

@@ -51,16 +51,47 @@ model Guild {
   socialFeeds SocialFeed[]
   scheduledMessages ScheduledMessage[]
   guildBackups GuildBackup[]
+  dashboardAccessRules DashboardAccessRule[]
+  dashboardAuditLogs DashboardAuditLog[]
 }
 
 model GuildSettings {
   id                String   @id @default(cuid())
   guildId           String   @unique
   locale            String   @default("de")
+  timezone          String   @default("Europe/Berlin")
   moderationEnabled Boolean  @default(true)
   guild             Guild    @relation(fields: [guildId], references: [id], onDelete: Cascade)
 }
 
+model DashboardAccessRule {
+  id        String   @id @default(cuid())
+  guildId   String
+  roleId    String
+  modules   Json
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  guild     Guild    @relation(fields: [guildId], references: [id], onDelete: Cascade)
+
+  @@unique([guildId, roleId])
+  @@index([guildId])
+}
+
+model DashboardAuditLog {
+  id          String   @id @default(cuid())
+  guildId     String?
+  actorUserId String
+  action      String
+  path        String?
+  before      Json?
+  after       Json?
+  createdAt   DateTime @default(now())
+  guild       Guild?   @relation(fields: [guildId], references: [id], onDelete: Cascade)
+
+  @@index([guildId, createdAt])
+  @@index([actorUserId, createdAt])
+}
+
 model User {
   id        String    @id
   createdAt DateTime  @default(now())

apps/webui/.gitignore

@@ -0,0 +1,41 @@
+# 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

apps/webui/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

apps/webui/eslint.config.mjs

@@ -0,0 +1,25 @@
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends("next/core-web-vitals", "next/typescript"),
+  {
+    ignores: [
+      "node_modules/**",
+      ".next/**",
+      "out/**",
+      "build/**",
+      "next-env.d.ts",
+    ],
+  },
+];
+
+export default eslintConfig;

apps/webui/next.config.ts

@@ -0,0 +1,10 @@
+import path from 'path';
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  output: 'standalone',
+  transpilePackages: ['@nexumi/shared'],
+  outputFileTracingRoot: path.join(__dirname, '../..')
+};
+
+export default nextConfig;

apps/webui/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@nexumi/webui",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint src --max-warnings=0",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prisma:generate": "prisma generate --schema=../bot/prisma/schema.prisma"
+  },
+  "dependencies": {
+    "@nexumi/shared": "workspace:^",
+    "@prisma/client": "^5.22.0",
+    "@radix-ui/react-avatar": "^1.2.3",
+    "@radix-ui/react-dropdown-menu": "^2.1.21",
+    "@radix-ui/react-label": "^2.1.12",
+    "@radix-ui/react-select": "^2.3.4",
+    "@radix-ui/react-separator": "^1.1.12",
+    "@radix-ui/react-slot": "^1.3.0",
+    "@radix-ui/react-switch": "^1.3.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "dotenv": "^16.4.7",
+    "ioredis": "^5.4.2",
+    "lucide-react": "^1.25.0",
+    "next": "15.5.21",
+    "next-themes": "^0.4.6",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.6.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "15.5.21",
+    "prisma": "^5.22.0",
+    "tailwindcss": "^4",
+    "typescript": "^5",
+    "vitest": "^2.1.8"
+  }
+}

apps/webui/postcss.config.mjs

@@ -0,0 +1,5 @@
+const config = {
+  plugins: ["@tailwindcss/postcss"],
+};
+
+export default config;

apps/webui/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

apps/webui/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

apps/webui/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

apps/webui/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

apps/webui/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

apps/webui/src/app/globals.css

@@ -0,0 +1,26 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

apps/webui/src/app/layout.tsx

@@ -0,0 +1,34 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "Create Next App",
+  description: "Generated by create next app",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}

apps/webui/src/app/page.tsx

@@ -0,0 +1,103 @@
+import Image from "next/image";
+
+export default function Home() {
+  return (
+    <div className="font-sans grid grid-rows-[20px_1fr_20px] items-center justify-items-center min-h-screen p-8 pb-20 gap-16 sm:p-20">
+      <main className="flex flex-col gap-[32px] row-start-2 items-center sm:items-start">
+        <Image
+          className="dark:invert"
+          src="/next.svg"
+          alt="Next.js logo"
+          width={180}
+          height={38}
+          priority
+        />
+        <ol className="font-mono list-inside list-decimal text-sm/6 text-center sm:text-left">
+          <li className="mb-2 tracking-[-.01em]">
+            Get started by editing{" "}
+            <code className="bg-black/[.05] dark:bg-white/[.06] font-mono font-semibold px-1 py-0.5 rounded">
+              src/app/page.tsx
+            </code>
+            .
+          </li>
+          <li className="tracking-[-.01em]">
+            Save and see your changes instantly.
+          </li>
+        </ol>
+
+        <div className="flex gap-4 items-center flex-col sm:flex-row">
+          <a
+            className="rounded-full border border-solid border-transparent transition-colors flex items-center justify-center bg-foreground text-background gap-2 hover:bg-[#383838] dark:hover:bg-[#ccc] font-medium text-sm sm:text-base h-10 sm:h-12 px-4 sm:px-5 sm:w-auto"
+            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            <Image
+              className="dark:invert"
+              src="/vercel.svg"
+              alt="Vercel logomark"
+              width={20}
+              height={20}
+            />
+            Deploy now
+          </a>
+          <a
+            className="rounded-full border border-solid border-black/[.08] dark:border-white/[.145] transition-colors flex items-center justify-center hover:bg-[#f2f2f2] dark:hover:bg-[#1a1a1a] hover:border-transparent font-medium text-sm sm:text-base h-10 sm:h-12 px-4 sm:px-5 w-full sm:w-auto md:w-[158px]"
+            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            Read our docs
+          </a>
+        </div>
+      </main>
+      <footer className="row-start-3 flex gap-[24px] flex-wrap items-center justify-center">
+        <a
+          className="flex items-center gap-2 hover:underline hover:underline-offset-4"
+          href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <Image
+            aria-hidden
+            src="/file.svg"
+            alt="File icon"
+            width={16}
+            height={16}
+          />
+          Learn
+        </a>
+        <a
+          className="flex items-center gap-2 hover:underline hover:underline-offset-4"
+          href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <Image
+            aria-hidden
+            src="/window.svg"
+            alt="Window icon"
+            width={16}
+            height={16}
+          />
+          Examples
+        </a>
+        <a
+          className="flex items-center gap-2 hover:underline hover:underline-offset-4"
+          href="https://nextjs.org?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <Image
+            aria-hidden
+            src="/globe.svg"
+            alt="Globe icon"
+            width={16}
+            height={16}
+          />
+          Go to nextjs.org →
+        </a>
+      </footer>
+    </div>
+  );
+}

apps/webui/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

docs/PHASE-TRACKING.md

@@ -181,7 +181,7 @@ Dieses Dokument hält den aktuellen Implementierungsstand fest. Es wird bei jede
 
 - Manuell auf Test-Server bestätigt (User-Freigabe).
 
-## Phase 5 – Stats/Invites, Feeds, Scheduler, Guild-Backup (Status: implementiert + deployed, manuelle Discord-Tests ausstehend)
+## Phase 5 – Stats/Invites, Feeds, Scheduler, Guild-Backup (Status: abgeschlossen, manuell bestätigt)
 
 ### Abgeschlossen
 
@@ -191,24 +191,20 @@ Dieses Dokument hält den aktuellen Implementierungsstand fest. Es wird bei jede
 - Queues/Worker: `stats`, `feeds`, `schedules`, `guild-backups`
 - Optional: `TWITCH_CLIENT_ID` / `TWITCH_CLIENT_SECRET`
 - E2E: `docker compose up -d --build bot` OK; Bot ready; 74 Guild-Commands registriert
+- Manuell auf Test-Server bestätigt (User-Freigabe)
+- Temp-Voice Control-Panel postet in den Voice-Kanal-Chat (statt DM)
 
-### Module
+## Phase 6 – WebUI-Fundament (Status: in Arbeit)
 
-| Modul | Features |
+### Geplant
-|--------|----------|
-| **Stats/Invites** | `/stats setup\|refresh`, `/invites view\|leaderboard`, Invite-Tracking, ActivityStat, 10-Min-Kanal-Update |
-| **Feeds** | `/feeds add\|remove\|list\|test` (Twitch/YouTube/RSS/Reddit), Poll alle 5 Min |
-| **Scheduler** | `/schedule create\|list\|delete`, `/announce`, BullMQ once/cron |
-| **Guild-Backup** | `/backup create\|list\|info\|delete\|restore` (Owner + Doppelbestätigung) |
 
-### Manuelle Discord-Tests (offen)
+- Next.js App Router (`apps/webui`), Discord OAuth2, Redis-Sessions
-
+- Dashboard-Layout (Sidebar, Server-Switcher, Dark/Light)
-- `/stats setup` + Kanal-Update; Invite-Join → `/invites view|leaderboard`
+- Settings-Framework mit Sticky-Save-Bar
-- `/feeds add` (RSS/Reddit) + `/feeds test`
+- Shared Zod-API-Schemas; Guild-Settings- und Module-Toggle-API
-- `/schedule create` (once) + `/announce`
+- Dashboard-Audit + Access-Rules (Prisma)
-- `/backup create|list|info` und Delete/Restore-Bestätigung (Owner)
 
 ## Nächster geplanter Schritt
 
-- Manuelle Phase-5-Tests, dann nach Freigabe Phase 6 (WebUI-Fundament: OAuth, Layout, Settings-Framework, API).
+- Phase 6 fertigstellen, dann nach Freigabe Phase 7 (Modul-Seiten + Owner-Panel).
 

packages/shared/src/index.ts

@@ -7,6 +7,7 @@ export * from './phase2.js';
 export * from './phase3.js';
 export * from './phase4.js';
 export * from './phase5.js';
+export * from './phase6.js';
 
 export const LocaleSchema = z.enum(['de', 'en']);
 export type Locale = z.infer<typeof LocaleSchema>;
@@ -14,6 +15,7 @@ export type Locale = z.infer<typeof LocaleSchema>;
 export const GuildSettingsSchema = z.object({
   guildId: z.string(),
   locale: LocaleSchema.default('de'),
+  timezone: z.string().default('Europe/Berlin'),
   moderationEnabled: z.boolean().default(true)
 });
 

packages/shared/src/phase6.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest';
+import {
+  GuildGeneralSettingsPatchSchema,
+  ModulesUpdateSchema,
+  hasManageGuildPermission,
+  DashboardAccessRulesUpdateSchema
+} from './phase6.js';
+
+describe('phase6 schemas', () => {
+  it('accepts general settings patches', () => {
+    const parsed = GuildGeneralSettingsPatchSchema.parse({
+      locale: 'en',
+      timezone: 'UTC'
+    });
+    expect(parsed.locale).toBe('en');
+    expect(parsed.timezone).toBe('UTC');
+  });
+
+  it('rejects empty general settings patches', () => {
+    expect(() => GuildGeneralSettingsPatchSchema.parse({})).toThrow();
+  });
+
+  it('validates module updates', () => {
+    const parsed = ModulesUpdateSchema.parse({
+      modules: { moderation: true, automod: false }
+    });
+    expect(parsed.modules.moderation).toBe(true);
+    expect(parsed.modules.automod).toBe(false);
+  });
+
+  it('detects manage guild permission', () => {
+    expect(hasManageGuildPermission('32')).toBe(true);
+    expect(hasManageGuildPermission('0')).toBe(false);
+    expect(hasManageGuildPermission(String(32n | 8n))).toBe(true);
+  });
+
+  it('validates access rules', () => {
+    const parsed = DashboardAccessRulesUpdateSchema.parse({
+      rules: [{ roleId: '123456789012345678', modules: 'all' }]
+    });
+    expect(parsed.rules).toHaveLength(1);
+  });
+});

packages/shared/src/phase6.ts

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+
+const LocaleSchema = z.enum(['de', 'en']);
+
+export const DashboardModuleIdSchema = z.enum([
+  'moderation',
+  'automod',
+  'logging',
+  'welcome',
+  'verification',
+  'leveling',
+  'economy',
+  'fun',
+  'giveaways',
+  'tickets',
+  'selfroles',
+  'tags',
+  'starboard',
+  'suggestions',
+  'birthdays',
+  'tempvoice',
+  'stats',
+  'feeds',
+  'scheduler',
+  'guildbackup'
+]);
+
+export type DashboardModuleId = z.infer<typeof DashboardModuleIdSchema>;
+
+export const DashboardModuleGroupSchema = z.enum([
+  'moderation',
+  'engagement',
+  'utility',
+  'community',
+  'integrations'
+]);
+
+export type DashboardModuleGroup = z.infer<typeof DashboardModuleGroupSchema>;
+
+export const DASHBOARD_MODULES = [
+  { id: 'moderation', group: 'moderation', href: 'moderation' },
+  { id: 'automod', group: 'moderation', href: 'automod' },
+  { id: 'logging', group: 'moderation', href: 'logging' },
+  { id: 'welcome', group: 'engagement', href: 'welcome' },
+  { id: 'verification', group: 'engagement', href: 'verification' },
+  { id: 'leveling', group: 'engagement', href: 'leveling' },
+  { id: 'economy', group: 'engagement', href: 'economy' },
+  { id: 'fun', group: 'engagement', href: 'fun' },
+  { id: 'giveaways', group: 'community', href: 'giveaways' },
+  { id: 'tickets', group: 'community', href: 'tickets' },
+  { id: 'selfroles', group: 'community', href: 'selfroles' },
+  { id: 'tags', group: 'utility', href: 'tags' },
+  { id: 'starboard', group: 'community', href: 'starboard' },
+  { id: 'suggestions', group: 'community', href: 'suggestions' },
+  { id: 'birthdays', group: 'community', href: 'birthdays' },
+  { id: 'tempvoice', group: 'utility', href: 'tempvoice' },
+  { id: 'stats', group: 'integrations', href: 'stats' },
+  { id: 'feeds', group: 'integrations', href: 'feeds' },
+  { id: 'scheduler', group: 'integrations', href: 'scheduler' },
+  { id: 'guildbackup', group: 'integrations', href: 'backup' }
+] as const satisfies ReadonlyArray<{
+  id: DashboardModuleId;
+  group: DashboardModuleGroup;
+  href: string;
+}>;
+
+export const SessionUserSchema = z.object({
+  id: z.string().min(1),
+  username: z.string().min(1),
+  globalName: z.string().nullable(),
+  avatar: z.string().nullable(),
+  locale: LocaleSchema.optional()
+});
+
+export type SessionUser = z.infer<typeof SessionUserSchema>;
+
+export const DashboardGuildSchema = z.object({
+  id: z.string().min(1),
+  name: z.string().min(1),
+  icon: z.string().nullable(),
+  botPresent: z.boolean(),
+  permissions: z.string()
+});
+
+export type DashboardGuild = z.infer<typeof DashboardGuildSchema>;
+
+export const GuildGeneralSettingsSchema = z.object({
+  locale: LocaleSchema,
+  timezone: z.string().min(1).max(64),
+  moderationEnabled: z.boolean()
+});
+
+export type GuildGeneralSettings = z.infer<typeof GuildGeneralSettingsSchema>;
+
+export const GuildGeneralSettingsPatchSchema = GuildGeneralSettingsSchema.partial().refine(
+  (value) => Object.keys(value).length > 0,
+  { message: 'At least one field is required' }
+);
+
+export type GuildGeneralSettingsPatch = z.infer<typeof GuildGeneralSettingsPatchSchema>;
+
+export const ModuleStatusSchema = z.object({
+  id: DashboardModuleIdSchema,
+  enabled: z.boolean(),
+  group: DashboardModuleGroupSchema,
+  href: z.string()
+});
+
+export type ModuleStatus = z.infer<typeof ModuleStatusSchema>;
+
+export const ModulesUpdateSchema = z.object({
+  modules: z.record(DashboardModuleIdSchema, z.boolean()).refine((value) => Object.keys(value).length > 0, {
+    message: 'At least one module toggle is required'
+  })
+});
+
+export type ModulesUpdate = z.infer<typeof ModulesUpdateSchema>;
+
+export const DashboardAccessRuleSchema = z.object({
+  id: z.string().optional(),
+  roleId: z.string().regex(/^\d{17,20}$/),
+  modules: z.union([z.literal('all'), z.array(DashboardModuleIdSchema).min(1)])
+});
+
+export type DashboardAccessRule = z.infer<typeof DashboardAccessRuleSchema>;
+
+export const DashboardAccessRulesUpdateSchema = z.object({
+  rules: z.array(DashboardAccessRuleSchema)
+});
+
+export type DashboardAccessRulesUpdate = z.infer<typeof DashboardAccessRulesUpdateSchema>;
+
+export const DashboardAuditEntrySchema = z.object({
+  id: z.string(),
+  guildId: z.string().nullable(),
+  actorUserId: z.string(),
+  action: z.string(),
+  path: z.string().nullable(),
+  createdAt: z.string()
+});
+
+export type DashboardAuditEntry = z.infer<typeof DashboardAuditEntrySchema>;
+
+export const DISCORD_PERMISSION_MANAGE_GUILD = 1n << 5n;
+
+export function hasManageGuildPermission(permissions: string | bigint): boolean {
+  const value = typeof permissions === 'bigint' ? permissions : BigInt(permissions);
+  return (value & DISCORD_PERMISSION_MANAGE_GUILD) === DISCORD_PERMISSION_MANAGE_GUILD;
+}