Hatka.ai - Real Estate Investment Platform

Hatka.ai is an AI-powered real estate investment platform that helps investors find undervalued properties in Belarus. The platform analyzes property listings from various sources (Realt.by, Kufar, Onliner) and provides investment recommendations based on ROI and market trends.

Features

• AI-powered property analysis
• Real-time market trends
• Investment recommendations
• Property alerts
• Subscription-based access
• User dashboard
• Market insights

Tech Stack

Frontend

• Next.js 14
• TypeScript
• Tailwind CSS
• React Query
• Zustand
• Mapbox GL
• Headless UI

Backend

• NestJS
• TypeScript
• TypeORM
• PostgreSQL
• OpenAI API
• Stripe
• Telegram Bot API

Getting Started

Prerequisites

• Node.js 18+
• PostgreSQL 14+
• npm or yarn

Installation

1. Clone the repository:

git clone https://github.com/yourusername/hatka-ai.git
cd hatka-ai

2. Install dependencies:

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

3. Set up environment variables:

• Copy .env.example to .env in the backend directory
• Copy .env.local.example to .env.local in the frontend directory
• Update the variables with your own values

4. Start the development servers:

# Start backend (from backend directory)
npm run start:dev

# Start frontend (from frontend directory)
npm run dev

The application will be available at:

• Frontend: http://localhost:3000
• Backend: http://localhost:4000

Project Structure

hatka-ai/
├── frontend/           # Next.js frontend application
│   ├── src/
│   │   ├── app/       # App router pages
│   │   ├── components/# React components
│   │   ├── hooks/     # Custom hooks
│   │   ├── mocks/     # Mock data
│   │   └── utils/     # Utility functions
│   └── public/        # Static files
│
└── backend/           # NestJS backend application
    ├── src/
    │   ├── modules/   # Feature modules
    │   ├── mocks/     # Mock data
    │   └── utils/     # Utility functions
    └── test/          # Test files

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.