Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/IvanchoDev89/maleku-system/llms.txt

Use this file to discover all available pages before exploring further.

Maleku System is an open-source, production-ready tourism platform built for Costa Rica’s multi-vendor travel ecosystem. It provides a FastAPI backend, a Nuxt.js 3 SSR frontend, and a complete suite of booking, payment, and vendor management tools — all deployable with Docker in minutes.

Quick Start

Run the full stack locally with Docker Compose in under 5 minutes.

Architecture

Understand the system layers: FastAPI, PostgreSQL, Redis, Cloudinary, and Stripe.

API Reference

Explore every REST endpoint with request/response schemas and authentication details.

Vendor Guide

Learn how vendors register, list services, manage availability, and receive payouts.

​
What Maleku System Does

Maleku System connects travelers with local vendors across five listing categories — hotels, tours, vehicles, boats, and flights — through a single unified API and web application.

Marketplace

Multi-vendor listings with full-text search and an interactive map.

Bookings

Real-time availability engine with race-condition-safe advisory locks.

Payments

Stripe Checkout and Connect with automatic 10% commission splits.

Search

PostgreSQL full-text search with GIN indexes and geo-aware map results.

Vendor Dashboard

Analytics, availability calendars, payout tracking, and fleet management.

Admin Panel

User and vendor management, CMS, audit logs, and platform analytics.

​
Get Up and Running

1

Clone and configure

Clone the repository and copy the example environment files for backend and frontend.
git clone https://github.com/IvanchoDev89/maleku-system.git
cd maleku-system
cp backend/.env.example backend/.env
2

Start all services

Launch the full stack — PostgreSQL, Redis, backend, and frontend — with a single command.
docker compose up -d
3

Run migrations and seed data

Apply database migrations and optionally seed sample Costa Rica data.
docker compose exec backend alembic upgrade head
docker compose exec backend python -m app.scripts.seed_costa_rica
4

Open the app

The platform is ready. Visit the frontend, explore the Swagger UI, or start making API calls.
ServiceURL
Frontendhttp://localhost:3000
API (Swagger)http://localhost:8000/docs
API (ReDoc)http://localhost:8000/redoc
Metricshttp://localhost:8000/metrics

​
Tech Stack at a Glance

LayerTechnology
FrontendNuxt.js 3, Vue 3, TypeScript, Tailwind CSS, Pinia
BackendFastAPI, SQLAlchemy 2.0 async, Pydantic v2
DatabasePostgreSQL 15 with GIN indexes and full-text search
CacheRedis for rate limiting, sessions, and caching
PaymentsStripe Checkout + Connect
ImagesCloudinary CDN
EmailResend (production), MailHog (development)
MonitoringPrometheus + Grafana
Maleku System is released under the MIT License. Contributions are welcome — see the Contributing guide to get started.

Build docs developers (and LLMs) love

Get started for freeTalk to us