How kondomino/kondos-api works
Project Type Analysis
This is a NestJS backend application that appears to be a real estate or property management system (based on the "kondo" module naming). It's built with TypeScript and follows NestJS's modular architecture pattern.
Main Components
A. Core Layer:
• Database Module (Sequelize integration)
• Authentication System (JWT, Google OAuth)
• Pagination Utilities
• Core Constants
B. Feature Modules:
• Kondo Module (Property Management)
• User Module
• Media Module
• Unit Module
• Like Module
• Integrator Module (Excel file processing)
C. Infrastructure:
• Firebase Hosting (indicated by workflows)
• Database (likely PostgreSQL/MySQL based on Sequelize usage)
┌─ Client Layer ─────────────────────────────────────┐
• External Clients (Mobile/Web Applications) │
• ┬───────────────────────────────┘
┌─ API Gateway ───────▼───────────────────────────────┐
• NestJS Controllers (Routes & Endpoints) │
• ┬───────────────────────────────┘
┌─ Authentication ────▼───────────────────────────────┐
• JWT Guard │ Google OAuth │ Public Routes │
• ┬───────────────────────────────┘
┌─ Business Logic ────▼───────────────────────────────┐
• ┌─────────────┐ ┌──────────┐ ┌────────┐ ┌────────┐ │
• Kondo Module │ │User Module│ │Media │ │Unit │ │
• Services │ │Services │ │Module │ │Module │ │
• ┘ └──────────┘ └────────┘ └────────┘ │
• ┬───────────────────────────────┘
┌─ Data Access ───────▼───────────────────────────────┐
• Repositories │ Entity Models │ DTOs │
• ┬───────────────────────────────┘
┌─ Database ──────────▼───────────────────────────────┐
• Sequelize ORM │ Database Provider │
• ┘
Important Details
a. Authentication Flow:
• JWT authentication path
• Google OAuth integration
• Public routes with special indicators
b. Module Relationships:
• How Kondo entities relate to Units
• Media attachments to Kondos
• User interactions with Likes
c. Data Flow:
• How the Integrator module processes Excel files
• Where the Slugify utility is used
• Pagination flow in list operations
Technical Stack Indicators
• NestJS Framework
• Sequelize ORM
• JWT/Google OAuth
• Firebase Hosting
• TypeScript