CertQuiz

A modern web application for technical certification exam preparation, built with TypeScript and emphasizing test-driven development. Supports various technical certifications including networking, security, and cloud computing exams.

🚀 Quick Start

# Prerequisites: Bun 1.0+, Docker, Git

# Clone and install
git clone <repository-url>
cd certquiz
bun install

# Start services
bun run docker:up      # PostgreSQL + KeyCloak
bun run db:migrate     # Run migrations
bun run dev           # Start dev servers

Frontend: http://localhost:5173
API: http://localhost:4000/swagger
KeyCloak: http://localhost:8080

🛠️ Tech Stack

• Runtime: Bun - Fast all-in-one JavaScript runtime
• Frontend: SvelteKit + TypeScript + TailwindCSS
• Backend: Hono + Drizzle ORM
• Database: PostgreSQL 16
• Auth: KeyCloak
• Testing: Vitest
• API Spec: TypeSpec → OpenAPI

📁 Project Structure

cert-quiz/
├── apps/
│   ├── web/          # SvelteKit frontend
│   └── api/          # Hono backend API
├── packages/
│   ├── shared/       # Shared types & utilities
│   └── typespec/     # API specifications
├── docker/           # Docker configurations
├── k8s/             # Kubernetes manifests
└── docs/            # Documentation

🧪 Development Principles

Test-Driven Development (TDD)

Mandatory - Write tests first, then code:

bun run test --watch      # Run tests in watch mode
bun run test --coverage   # Check coverage (min 80%)

Schema-First API Development

Define schemas → Generate types → Implement:

bun run typespec:compile   # Generate from TypeSpec
bun run db:generate       # Generate migrations

📚 Documentation

• Task List - Current development tasks
• API Specification - Endpoint docs
• Database Schema - Data models
• Coding Standards - Code conventions
• Commit Convention - Git commit guidelines
• GitHub Actions Strategy - CI/CD pipeline design

🔧 Common Commands

# Development
bun run dev              # Start all services
bun run typecheck        # TypeScript checking
bun run lint            # Biome linter
bun run format          # Biome formatter

# Database
bun run db:generate      # Generate migrations
bun run db:migrate       # Apply migrations
bun run db:studio        # Drizzle Studio GUI
bun run db:test:migration # Test migrations locally (CI-like)

# Testing
bun run test                # Run all tests
bun run test:unit           # Unit tests only
bun run test:integration    # Integration tests

# Docker
bun run docker:up        # Start services
bun run docker:down      # Stop services

🏗️ Architecture

• Monorepo: Shared types between frontend/backend
• Type Safety: End-to-end type safety with TypeScript
• Schema-Driven: Database and API schemas drive development
• Performance: Quiz response time < 200ms target

📝 License

[License type] - See LICENSE file for details

Built with ❤️ using modern TypeScript tooling