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.
This commit is contained in:
smueller
2026-07-22 13:50:14 +02:00
parent 6f3da6bb15
commit 7bc1684566
22 changed files with 645 additions and 15 deletions

View File

@@ -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;

View File

@@ -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())

41
apps/webui/.gitignore vendored Normal file
View File

@@ -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

36
apps/webui/README.md Normal file
View File

@@ -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.

View File

@@ -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;

10
apps/webui/next.config.ts Normal file
View File

@@ -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;

50
apps/webui/package.json Normal file
View File

@@ -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"
}
}

View File

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

View File

@@ -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>

After

Width:  |  Height:  |  Size: 391 B

View File

@@ -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>

After

Width:  |  Height:  |  Size: 1.0 KiB

View File

@@ -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>

After

Width:  |  Height:  |  Size: 1.3 KiB

View File

@@ -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>

After

Width:  |  Height:  |  Size: 128 B

View File

@@ -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>

After

Width:  |  Height:  |  Size: 385 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

View File

@@ -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;
}

View File

@@ -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>
);
}

103
apps/webui/src/app/page.tsx Normal file
View File

@@ -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>
);
}

28
apps/webui/tsconfig.json Normal file
View File

@@ -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"]
}

View File

@@ -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 |
|--------|----------|
| **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) |
### Geplant
### Manuelle Discord-Tests (offen)
- `/stats setup` + Kanal-Update; Invite-Join → `/invites view|leaderboard`
- `/feeds add` (RSS/Reddit) + `/feeds test`
- `/schedule create` (once) + `/announce`
- `/backup create|list|info` und Delete/Restore-Bestätigung (Owner)
- Next.js App Router (`apps/webui`), Discord OAuth2, Redis-Sessions
- Dashboard-Layout (Sidebar, Server-Switcher, Dark/Light)
- Settings-Framework mit Sticky-Save-Bar
- Shared Zod-API-Schemas; Guild-Settings- und Module-Toggle-API
- Dashboard-Audit + Access-Rules (Prisma)
## 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).

View File

@@ -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)
});

View File

@@ -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);
});
});

View File

@@ -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;
}