CheckinMate Project Context

CheckinMate is a geolocation-based API service built with Elysia.js (a fast TypeScript web framework) and MongoDB. The application provides endpoints for searching places based on geographical coordinates, with data sourced from both MongoDB and the Overpass API (OpenStreetMap).

promptBeginner5 min to valuemarkdown

0 views

Jan 15, 2026

CheckinMate Project Context

Project Overview

Init Project

You should always run the server with the
```
make run
```
command in the terminal.
Test
```
test.http
```
in curls in terminal to easier test requests.

Key Features

Geospatial search with MongoDB's 2dsphere indexing
Integration with OpenStreetMap's Overpass API, for additional place data
LRU caching for improved performance
Comprehensive input validation using Zod schemas
Structured logging with Pino
Rate limiting to prevent API abuse
Docker containerization for easy deployment
Swagger documentation for API endpoints

Technologies Used - use mcp context7 to search about if necessary

Runtime: Bun (JavaScript/TypeScript runtime)
Framework: Elysia.js (TypeScript-focused web framework)
Database: MongoDB with Mongoose ODM
Validation: Zod (TypeScript-first schema declaration and validation)
Logging: Pino with pino-pretty for structured logging
Caching: lru-cache for in-memory caching
Containerization: Docker and Docker Compose
Geospatial Calculations: Haversine formula implementation
OverPass API: Integration for additional place data, using OverpassQL

Development Conventions

Architecture

MVC-inspired Pattern: Separation of concerns with Models, Controllers, and Routes
Dependency Injection: Services and models are injected into controllers
Validation First: All inputs are validated using Zod schemas before processing
Structured Logging: All operations are logged with contextual information
Error Handling: Centralized error handling with proper HTTP status codes

Data Flow

Request received by Elysia route handler
Input validation using Zod schemas
Rate limiting middleware
Controller method execution
Model/database interaction or external API calls
Caching layer for performance
Response formatting and return

Geospatial Implementation

MongoDB's 2dsphere index for efficient geospatial queries
GeoNear aggregation pipeline for distance calculations
Haversine formula for client-side distance calculations
Coordinate validation to ensure valid latitude/longitude values

Testing

The project includes a test.http file with example requests for:

Health check endpoint
Valid place search queries
Invalid parameter handling
Edge cases (excessive radius/limit values)

Future Considerations

Add authentication and authorization middleware
Implement more comprehensive unit and integration tests
Add metrics and monitoring endpoints
Implement data seeding for initial place data
Add data import functionality for bulk place data

Init Project

You should always run the server with the

make run

command in the terminal.

Test

test.http

in curls in terminal to easier test requests.

Geospatial search with MongoDB's 2dsphere indexing

Integration with OpenStreetMap's Overpass API, for additional place data

LRU caching for improved performance

Comprehensive input validation using Zod schemas

Structured logging with Pino

Rate limiting to prevent API abuse

Docker containerization for easy deployment

Swagger documentation for API endpoints

Runtime: Bun (JavaScript/TypeScript runtime)

Framework: Elysia.js (TypeScript-focused web framework)

Database: MongoDB with Mongoose ODM

Validation: Zod (TypeScript-first schema declaration and validation)

Logging: Pino with pino-pretty for structured logging

Caching: lru-cache for in-memory caching

Containerization: Docker and Docker Compose

Geospatial Calculations: Haversine formula implementation

OverPass API: Integration for additional place data, using OverpassQL

Development Conventions

MVC-inspired Pattern: Separation of concerns with Models, Controllers, and Routes

Dependency Injection: Services and models are injected into controllers

Validation First: All inputs are validated using Zod schemas before processing

Structured Logging: All operations are logged with contextual information

Error Handling: Centralized error handling with proper HTTP status codes

Request received by Elysia route handler

Input validation using Zod schemas

Rate limiting middleware

Controller method execution

Model/database interaction or external API calls

Caching layer for performance

Response formatting and return

MongoDB's 2dsphere index for efficient geospatial queries

GeoNear aggregation pipeline for distance calculations

Haversine formula for client-side distance calculations

Coordinate validation to ensure valid latitude/longitude values

CheckinMate Project Context

CheckinMate Project Context

Project Overview

Init Project

Key Features

Technologies Used - use mcp context7 to search about if necessary

Development Conventions

Architecture

Data Flow

Geospatial Implementation

Testing

Future Considerations

Related Skills

Nano Banana Pro

Markdown Converter

1password

CheckinMate Project Context

Project Overview

Init Project

Key Features

Technologies Used - use mcp context7 to search about if necessary

Development Conventions

Architecture

Data Flow

Geospatial Implementation

Testing

Future Considerations