Project Structure

webserver/
├── app/                    # Next.js App Router pages and API routes
├── components/             # React components
├── lib/                    # Utility functions and configurations
├── prisma/                 # Database schema and migrations
├── __tests__/              # Test files
├── public/                 # Static assets
└── Configuration files

app/
├── page.tsx                # Home page (root route: /)
├── layout.tsx              # Root layout wrapper
├── auth/
│   ├── login/
│   │   └── page.tsx        # Login page (/auth/login)
│   └── signup/
│       └── page.tsx        # Sign up page (/auth/signup)
├── dashboard/
│   └── page.tsx            # Dashboard page (/dashboard)
└── requests/
    ├── page.tsx            # All requests page (/requests)
    └── create/
        └── page.tsx        # Create request page (/requests/create)

app/api/
├── auth/
│   └── [...nextauth]/
│       └── route.ts        # NextAuth.js handler
├── user/
│   └── route.ts            # GET, PATCH user info
├── points/
│   └── route.ts            # GET, POST points balance
├── notifications/
│   └── route.ts            # GET, PATCH notifications
└── requests/
    ├── route.ts            # GET all, POST create
    └── [id]/
        ├── route.ts        # DELETE request
        ├── accept/
        │   └── route.ts    # POST accept request
        └── decline/
            └── route.ts    # POST decline request

import { NextResponse } from "next/server";
import { getCurrentUser } from "@/lib/auth";
import { prisma } from "@/lib/prisma";

export async function GET() {
  // 1. Check authentication
  const user = await getCurrentUser();
  if (!user || !user.id) {
    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
  }

  // 2. Perform database operations
  // 3. Return JSON response
}

components/
├── ui/                     # shadcn/ui components
│   ├── button.tsx
│   ├── card.tsx
│   ├── input.tsx
│   ├── label.tsx
│   ├── tabs.tsx
│   └── ...                 # Other UI primitives
├── providers.tsx           # Session provider wrapper
└── UpdatePointsForm.tsx    # Points update form component

lib/
├── auth.ts                 # Authentication utilities
├── prisma.ts               # Prisma client singleton
├── validation.ts           # Request validation functions
├── locations.ts            # UCSC dining locations
└── utils.ts                # General utility functions

import { auth } from "@/auth";

export async function getCurrentUser() {
  const session = await auth();
  return session?.user;
}

import { PrismaClient } from '@prisma/client';

const globalForPrisma = global as unknown as { prisma: PrismaClient };

export const prisma = globalForPrisma.prisma || new PrismaClient();

if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;

export const LOCATIONS = [
  "Cowell/Stevenson",
  "Crown/Merrill",
  "Porter/Kresge",
  "Rachel Carson/Oakes",
  "Nine/Ten",
] as const;

export type Location = typeof LOCATIONS[number];

import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}

prisma/
├── schema.prisma           # Database schema definition
└── migrations/             # Migration history

auth.config.ts              # NextAuth providers and callbacks
auth.ts                     # NextAuth instance with Prisma adapter

import type { NextAuthConfig } from "next-auth";
import Google from "next-auth/providers/google";
import Credentials from "next-auth/providers/credentials";

export default {
  providers: [Google, Credentials],
  // callbacks, pages, session config
} satisfies NextAuthConfig;

import NextAuth from "next-auth";
import { PrismaAdapter } from "@auth/prisma-adapter";
import authConfig from "./auth.config";
import { prisma } from "@/lib/prisma";

export const { handlers, auth, signIn, signOut } = NextAuth({
  adapter: PrismaAdapter(prisma),
  ...authConfig,
});

next.config.ts              # Next.js configuration

tsconfig.json               # TypeScript compiler options

tailwind.config.ts          # Tailwind CSS v4 configuration
postcss.config.js           # PostCSS configuration

package.json                # Dependencies and scripts

{
  "dev": "next dev",
  "build": "next build",
  "start": "next start",
  "lint": "next lint",
  "test": "vitest",
  "test:run": "vitest run"
}

.env                        # Environment variables (gitignored)
.env.example                # Example environment file

DATABASE_URL="postgresql://..."
AUTH_SECRET="..."
GOOGLE_CLIENT_ID="..."
GOOGLE_CLIENT_SECRET="..."

__tests__/
└── validation.test.ts      # Validation function tests

# Watch mode
npm test

# Run once
npm run test:run

// app/dashboard/page.tsx
import { getCurrentUser } from "@/lib/auth";

export default async function DashboardPage() {
  const user = await getCurrentUser();
  // Fetch data directly in component
  return <div>...</div>;
}

'use client';

import { useState } from 'react';

export default function UpdatePointsForm() {
  const [balance, setBalance] = useState(0);
  // Handle form submission, fetch calls
}

// app/api/requests/[id]/route.ts
export async function DELETE(
  request: NextRequest,
  { params }: { params: Promise<{ id: string }> }
) {
  const { id } = await params; // Await params
  // ...
}

const points = await prisma.points.upsert({
  where: { userId: user.id },
  update: {},
  create: { userId: user.id, balance: 0 },
});

await prisma.$transaction([
  prisma.points.update({ /* ... */ }),
  prisma.request.update({ /* ... */ }),
  prisma.notification.create({ /* ... */ }),
]);

# 1. Edit prisma/schema.prisma
# 2. Create and apply migration
npx prisma migrate dev --name descriptive_name
# 3. Generate updated Prisma Client
npx prisma generate

# Install shadcn/ui component
npx shadcn@latest add button