Residency Application Reviewer

An AI-powered system for evaluating residency applications across 12 standardized criteria for Funding the Commons.

Project Structure

residency-application-reviewer/
├── frontend/                 # React frontend application
│   ├── src/                 # Frontend source code
│   ├── public/              # Static assets
│   ├── package.json         # Frontend dependencies
│   └── tsconfig.json        # Frontend TypeScript config
├── backend/                 # Node.js backend API
│   ├── src/                 # Backend source code
│   ├── package.json         # Backend dependencies
│   ├── tsconfig.json        # Backend TypeScript config
│   └── jest.config.js       # Test configuration
├── shared/                  # Shared TypeScript types
│   └── types/               # Type definitions
│       ├── evaluation.ts    # Core evaluation models
│       ├── api.ts          # API interfaces
│       └── index.ts        # Type exports
└── package.json            # Root workspace configuration

Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm

Installation

npm run install:all

Development

# Start frontend (runs on port 3000)
npm run dev:frontend

# Start backend (runs on port 3001)
npm run dev:backend

Building

# Build frontend
npm run build:frontend

# Build backend
npm run build:backend

Testing

# Test frontend
npm run test:frontend

# Test backend
npm run test:backend

Core Features

• Single Evaluation: Evaluate individual applicant profiles
• Batch Processing: Process multiple applications simultaneously
• 12 Criteria Scoring: Standardized evaluation across all criteria
• Export Functionality: CSV and JSON export options
• AI Integration: OpenAI-powered text analysis
• High Selectivity: Optimized for competitive selection (14 spots for 80 applicants)

Technology Stack

• Frontend: React, TypeScript
• Backend: Node.js, Express, TypeScript
• Database: SQLite
• AI: OpenAI GPT-4
• Testing: Jest, React Testing Library