Welcome to Macondo Link Manager
Macondo Link Manager is a comprehensive SaaS platform designed for marketing agencies to shorten URLs, organize campaigns, and track detailed analytics. Built with a domain-driven architecture, it provides a robust backend API and a modern Next.js frontend.Key Features
Link Shortening
Create shortened links with custom codes and QR generation
Campaign Management
Organize links by clients and marketing campaigns
Analytics Dashboards
Track clicks, browsers, locations, and more with bot filtering
Tag System
Categorize links with a flexible many-to-many tag system
Google OAuth
Secure authentication with domain restriction
Geolocation
Track clicks by country and city automatically
Tech Stack
Macondo Link Manager is built with modern, production-ready technologies: Frontend- Next.js 14 with App Router
- TypeScript
- Tailwind CSS + shadcn/ui
- TanStack Query
- React Hook Form + Zod
- Node.js + Fastify
- Prisma ORM
- PostgreSQL
- JWT Authentication
- Google OAuth 2.0
- Docker & Docker Compose
- Vercel (Frontend)
- Railway (Backend + Database)
Architecture
The system follows a domain-oriented architecture with these core principles:- Backend as single source of truth - All business logic and data aggregations happen server-side
- Declarative frontend - React components consume stable read models from the API
- Transactional operations - Critical operations maintain data consistency
- Persistent metrics - Bot detection and filtering happen at write-time, not read-time
The domain model follows a hierarchical structure: Client → Campaign → Link, with links supporting many-to-many tags and detailed click tracking.
Getting Started
Quickstart
Set up and run the platform locally in minutes
API Reference
Explore the complete REST API documentation
Architecture
Understand the system design and data models
Deployment
Deploy to production with Docker and cloud providers
Live URLs
- Frontend: https://app.mcd.ppg.br
- API: https://li.mcd.ppg.br
- Swagger Docs: https://li.mcd.ppg.br/docs