What it is
A location-based chat application and information platform specifically designed for the Ordu province in Turkey.
The project provides local services including transportation, news, places search, and regional information through
an AI-powered chat interface. Built as a full-stack application with separate backend and frontend components.
Architecture
Backend (Deno + Hono) — API server with chat functionality and data crawling capabilities.
Frontend (Astro) — Web interface with mobile app capabilities through Capacitor.
Database — MongoDB with Mongoose ODM for flexible data storage.
AI Integration — OpenRouter for chat functionality with tool-based pipeline.
Key Features
• AI Chat Interface — Core functionality with tool-based pipeline
• Local Transportation — Public transport routes (Kentkart integration)
• Places Search — Mapping and location services
• Local News — Aggregated regional news
• Inter-district Transport — OrduBirlik integration
• Parking Availability — Real-time parking information
• Tourist Attractions — Curated local points of interest
• Bus Routes — Comprehensive transportation information
• Pharmacy Services — On-duty pharmacy schedules
• Restaurant Recommendations — Curated local dining options
Technical Implementation
| Component |
Technology |
Purpose |
| Backend Runtime | Deno | Modern JavaScript/TypeScript runtime |
| Backend Framework | Hono | Lightweight web framework |
| Database | MongoDB | Flexible document storage |
| Validation | Zod | Schema validation |
| Frontend Framework | Astro | Modern web framework |
| Mobile Support | Capacitor | Cross-platform mobile apps |
| AI Integration | OpenRouter | Chat functionality |
| HTML Parsing | Linkedom | Web scraping capabilities |
Data Pipeline
The system includes a comprehensive data pipeline with web crawling for local information,
scheduled data updates, and MongoDB storage with various data models. This ensures real-time
and accurate information for all local services.
Mobile Support
Native Android and iOS applications through Capacitor with geolocation services and
native app distribution. The mobile apps provide the full functionality of the web platform
with optimized mobile experience.