Modernize Medical Qbank App

Convert Medical Qbank App from Next.js to Modern Full-Stack Application

Project Overview

We need an experienced full-stack developer to rebuild our existing
medical question bank application (Step 2 CK Qbank) using a modern tech
stack. The current application is built with Next.js 15 and needs to be
completely rebuilt from scratch using our newly selected Better-T-Stack
while maintaining exact functionality, flow, and visual appearance.

Current Application (To Be Replaced)

- Framework: Next.js 15 with App Router
- Database: PostgreSQL with custom queries
- Authentication: Custom session-based auth
- Styling: Tailwind CSS + shadcn/ui
- Features:
- User authentication (login, register, password reset)
- Medical question bank with test creation
- Multiple test modes (Standard vs Tutor)
- Question filtering and selection
- Performance analytics and charts
- Note-taking and highlighting
- Test results and analysis
- Dashboard with user progress tracking

New Tech Stack (Target)

- Frontend: React 19 + TanStack Router + Vite
- Backend: Hono + tRPC
- Database: PostgreSQL + Drizzle ORM
- Runtime: Bun
- Authentication: Better Auth
- Styling: TailwindCSS 4.0 + shadcn/ui
- Forms: TanStack React Form
- State Management: TanStack React Query
- Development: TypeScript, Biome (linting/formatting)

Key Requirements

Functional Requirements

1. 100% Feature Parity: Every feature in the current app must work
identically
2. Exact UI/UX: Visual appearance and user flow must match perfectly
3. Data Migration: data in db is mock data so dont worry about data migration

Technical Requirements

- Monorepo Structure: Frontend (apps/web) and Backend (apps/server)
- Type Safety: End-to-end TypeScript with tRPC
- Database: Migrate from custom PostgreSQL queries to Drizzle ORM
- Authentication: Replace custom auth with Better Auth
- Routing: Convert from Next.js App Router to TanStack Router
- API Layer: Replace Next.js API routes with Hono + tRPC

Core Features to Implement

- User authentication and session management
- Medical question bank management
- Test creation with multiple modes and filters
- Real-time test-taking interface with media support
- Performance analytics with charts (using Recharts)
- User data management (notes, highlights, marked questions)
- Dashboard with progress tracking
- Test results analysis and reporting

Deliverables

1. Complete application built with the new tech stack
2. Database migration scripts (if schema changes are needed)
3. Documentation for setup and deployment
4. Testing - Basic functionality testing to ensure feature parity
5. Deployment ready code that can run in production

Project Timeline

- Estimated Duration: 3-4 weeks
- Milestone 1 (Week 1): Authentication system and basic routing
- Milestone 2 (Week 2): Core question bank and test functionality
- Milestone 3 (Week 3): Dashboard, analytics, and user features
- Milestone 4 (Week 4): Testing, polishing, and deployment preparation

Required Skills & Experience

- Expert level TypeScript and React development
- Experience with tRPC and Hono
- Strong knowledge of TanStack ecosystem (Router, Query, Form)
- PostgreSQL and Drizzle ORM expertise
- Bun runtime experience
- Performance optimization skills