Gemini's Project Analysis: Easy Islanders

# Gemini's Project Analysis: Easy Islanders

This document outlines my understanding of the Easy Islanders project, its architecture, and my plan for contributing.

## Project Overview

Easy Islanders is a real estate platform that connects property sellers with potential buyers and renters. The platform features a chat-based interface where an AI-powered agent assists users in finding properties that match their needs. The system is designed to handle both short-term and long-term rentals, with a clear distinction between the two.

The core of the application is a Django-based backend with a PostgreSQL database. The frontend is built with React. The project also includes a sophisticated intent routing system that uses a combination of machine learning and rule-based approaches to understand user queries and route them to the appropriate agent or service.

## Key Technologies

*   **Backend:** Django, Django Rest Framework, Python
*   **Frontend:** React, JavaScript, Axios
*   **Database:** PostgreSQL with PostGIS for geospatial queries
*   **AI/ML:** scikit-learn, OpenAI (optional)
*   **Real-time Communication:** Django Channels, WebSockets
*   **Authentication:** JWT, HttpOnly Cookies
*   **Deployment:** Docker, fly.io

## Directory Structure

*   `assistant/`: The core Django app for the AI assistant, including models, views, and services.
*   `easy_islanders/`: The main Django project, including settings and URL configurations.
*   `frontend/`: The React frontend application.
*   `real_estate/`: A Django app for managing property listings and availability.
*   `scripts/`: Various scripts for tasks like seeding the database and evaluating the router.
*   `docs/`: Project documentation, including API contracts and architectural diagrams.

## Core Components

### 1. AI Assistant & Intent Router

The AI assistant is the primary user interface for the platform. It uses a sophisticated intent router to understand user queries and determine the user's intent. The router is trained on a corpus of user utterances and can distinguish between different types of requests, such as property searches, booking inquiries, and general questions.

### 2. Real Estate App

The `real_estate` app manages property listings, including details about the property, pricing, and availability. The app supports both short-term and long-term rentals, with a clear data model to differentiate between the two.

### 3. Authentication & Authorization

The application uses a secure authentication system based on JWTs and HttpOnly cookies. This approach provides protection against common web vulnerabilities like XSS and CSRF.

### 4. Real-time Communication

WebSockets are used for real-time communication between the frontend and backend, enabling features like live chat and notifications.

## Next Steps

My immediate goal is to familiarize myself with the codebase and the development workflow. I will start by:

1.  **Running the project locally:** I will follow the instructions in the `README.md` file to set up the development environment and run the application on my local machine.
2.  **Exploring the frontend:** I will examine the React components and the overall structure of the frontend application to understand how it interacts with the backend.
3.  **Diving into the assistant app:** I will study the `assistant` app to understand how the AI assistant works, including the intent router and the different agent services.
4.  **Contributing to the project:** Once I have a solid understanding of the project, I will look for opportunities to contribute, such as fixing bugs, adding new features, or improving the documentation.