feat(server): implement Phase 1.1 backend foundation

.github/workflows/ci.yml

@@ -43,6 +43,12 @@ jobs:
       - name: Check formatting
         run: pnpm format:check
 
+      - name: Generate Prisma Client
+        run: pnpm --filter @devradar/server db:generate
+        env:
+          DATABASE_URL: 'postgresql://user:pass@localhost:5432/db'
+          SHADOW_DATABASE_URL: 'postgresql://user:pass@localhost:5432/shadow'
+
       - name: Lint
         run: pnpm lint
 

.gitignore

@@ -45,3 +45,4 @@ coverage/
 
 # Docker
 docker-compose.override.yml
+apps/server/src/generated/

apps/server/eslint.config.js

@@ -0,0 +1,8 @@
+import baseConfig from '@devradar/eslint-config';
+
+export default [
+  ...baseConfig,
+  {
+    ignores: ['prisma.config.ts', 'prisma/generated/**'],
+  },
+];

apps/server/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@devradar/server",
+  "version": "0.0.0",
+  "private": true,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/server.js",
+  "scripts": {
+    "dev": "tsx watch --env-file=.env src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "clean": "rimraf dist",
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push",
+    "db:migrate": "prisma migrate dev",
+    "db:studio": "prisma studio"
+  },
+  "dependencies": {
+    "@devradar/shared": "workspace:*",
+    "@fastify/cookie": "^11.0.2",
+    "@fastify/cors": "^11.2.0",
+    "@fastify/helmet": "^13.0.2",
+    "@fastify/jwt": "^10.0.0",
+    "@fastify/rate-limit": "^10.3.0",
+    "@fastify/websocket": "^11.2.0",
+    "@prisma/adapter-pg": "^7.2.0",
+    "@prisma/client": "^7.2.0",
+    "dotenv": "^16.5.0",
+    "fastify": "^5.6.2",
+    "ioredis": "^5.8.2",
+    "pg": "^8.16.3",
+    "pino": "^10.1.0",
+    "pino-pretty": "^13.1.3",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@devradar/eslint-config": "workspace:*",
+    "@devradar/tsconfig": "workspace:*",
+    "@types/node": "^25.0.3",
+    "@types/pg": "^8.16.0",
+    "@types/ws": "^8.18.1",
+    "eslint": "^9.39.2",
+    "prisma": "^7.2.0",
+    "rimraf": "^6.1.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

apps/server/prisma.config.ts

@@ -0,0 +1,27 @@
+/**
+ * Prisma Configuration
+ *
+ * Prisma 7 configuration file for CLI commands (migrate, db push, etc.)
+ * Database URL for migrations is configured here.
+ *
+ * IMPORTANT: In Prisma 7, env vars must be explicitly loaded with dotenv.
+ */
+
+import 'dotenv/config';
+import { defineConfig, env } from 'prisma/config';
+
+export default defineConfig({
+  // Path to the Prisma schema file
+  schema: 'prisma/schema.prisma',
+
+  // Migration settings
+  migrations: {
+    path: 'prisma/migrations',
+  },
+
+  // Database connection for Prisma CLI (migrate, db push, studio)
+  datasource: {
+    url: env('DATABASE_URL'),
+    shadowDatabaseUrl: env('SHADOW_DATABASE_URL'),
+  },
+});

apps/server/prisma/schema.prisma

@@ -0,0 +1,110 @@
+// DevRadar Database Schema
+// Using Prisma 7 with PostgreSQL
+
+generator client {
+  provider     = "prisma-client"
+  output       = "../src/generated/prisma"
+  moduleFormat = "esm"
+}
+
+datasource db {
+  provider = "postgresql"
+  // Note: URL configured in prisma.config.ts for Prisma 7
+}
+
+// ===================
+// User Management
+// ===================
+
+model User {
+  id          String   @id @default(cuid())
+  githubId    String   @unique
+  username    String
+  displayName String?
+  avatarUrl   String?
+  email       String?
+  tier        Tier     @default(FREE)
+  privacyMode Boolean  @default(false)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  // Relations
+  following  Follow[]     @relation("Following")
+  followers  Follow[]     @relation("Followers")
+  teams      TeamMember[]
+  ownedTeams Team[]       @relation("TeamOwner")
+
+  @@index([username])
+  @@index([githubId])
+}
+
+// ===================
+// Social Graph
+// ===================
+
+model Follow {
+  followerId  String
+  followingId String
+  createdAt   DateTime @default(now())
+
+  // Relations
+  follower  User @relation("Following", fields: [followerId], references: [id], onDelete: Cascade)
+  following User @relation("Followers", fields: [followingId], references: [id], onDelete: Cascade)
+
+  @@id([followerId, followingId])
+  @@index([followerId])
+  @@index([followingId])
+}
+
+// ===================
+// Team Management
+// ===================
+
+model Team {
+  id        String   @id @default(cuid())
+  name      String
+  slug      String   @unique
+  ownerId   String
+  tier      Tier     @default(TEAM)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // Relations
+  owner   User         @relation("TeamOwner", fields: [ownerId], references: [id], onDelete: Cascade)
+  members TeamMember[]
+
+  @@index([slug])
+  @@index([ownerId])
+}
+
+model TeamMember {
+  id        String   @id @default(cuid())
+  userId    String
+  teamId    String
+  role      Role     @default(MEMBER)
+  joinedAt  DateTime @default(now())
+
+  // Relations
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+  team Team @relation(fields: [teamId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, teamId])
+  @@index([userId])
+  @@index([teamId])
+}
+
+// ===================
+// Enums
+// ===================
+
+enum Tier {
+  FREE
+  PRO
+  TEAM
+}
+
+enum Role {
+  OWNER
+  ADMIN
+  MEMBER
+}

apps/server/src/config.ts

@@ -0,0 +1,90 @@
+/**
+ * Environment Configuration
+ *
+ * Validates and exports environment variables using Zod.
+ * Follows 12-factor app principles - all config from environment.
+ */
+
+import { z } from 'zod';
+
+/**
+ * Environment schema with validation rules.
+ * All required variables must be set or have sensible defaults.
+ */
+const envSchema = z.object({
+  // Node environment
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+
+  // Server
+  PORT: z.coerce.number().int().min(1).max(65535).default(3000),
+  HOST: z.string().default('0.0.0.0'),
+
+  // Database
+  DATABASE_URL: z
+    .string()
+    .url()
+    .refine((url: string) => url.startsWith('postgresql://') || url.startsWith('postgres://'), {
+      message: 'DATABASE_URL must be a valid PostgreSQL connection string',
+    }),
+
+  // Redis
+  REDIS_URL: z
+    .string()
+    .url()
+    .refine((url: string) => url.startsWith('redis://') || url.startsWith('rediss://'), {
+      message: 'REDIS_URL must be a valid Redis connection string',
+    }),
+
+  // JWT
+  JWT_SECRET: z.string().min(32, 'JWT_SECRET must be at least 32 characters'),
+  JWT_EXPIRES_IN: z.string().default('7d'),
+
+  // GitHub OAuth
+  GITHUB_CLIENT_ID: z.string().min(1, 'GITHUB_CLIENT_ID is required'),
+  GITHUB_CLIENT_SECRET: z.string().min(1, 'GITHUB_CLIENT_SECRET is required'),
+  GITHUB_CALLBACK_URL: z.string().url(),
+
+  // Logging
+  LOG_LEVEL: z.enum(['fatal', 'error', 'warn', 'info', 'debug', 'trace']).default('info'),
+});
+
+/**
+ * Parsed and validated environment configuration.
+ */
+export type Env = z.infer<typeof envSchema>;
+
+/**
+ * Parse and validate environment variables.
+ * Throws descriptive error if validation fails.
+ */
+function parseEnv(): Env {
+  const result = envSchema.safeParse(process.env);
+
+  if (!result.success) {
+    console.error('❌ Invalid environment variables:\n', result.error.format());
+    throw new Error('Invalid environment configuration');
+  }
+
+  return result.data;
+}
+
+/**
+ * Validated environment configuration.
+ * Access this throughout the application for type-safe config.
+ */
+export const env = parseEnv();
+
+/**
+ * Check if running in production mode.
+ */
+export const isProduction = env.NODE_ENV === 'production';
+
+/**
+ * Check if running in development mode.
+ */
+export const isDevelopment = env.NODE_ENV === 'development';
+
+/**
+ * Check if running in test mode.
+ */
+export const isTest = env.NODE_ENV === 'test';