Realtor Buddy Core API

Django-based API system for real estate professionals to manage properties, automate client outreach, and handle payments.

🏗️ Services

• Building Service: Property data management with AI-powered search
• Client Outreach Service: Automated email campaigns via Gmail
• Twilio Service: SMS/WhatsApp messaging
• Stripe Service: Payment processing and subscriptions
• Slack Service: Team notifications and data validation
• Logging Service: Centralized monitoring

🛠️ Tech Stack

• Backend: Django 4.2+ with DRF, PostgreSQL, Celery/Redis
• Integrations: Twilio, Gmail API, Stripe, OpenAI GPT, AWS S3
• Deployment: Docker, Heroku-ready

🚀 Quick Start

# Setup
git clone https://github.com/hurryingauto3/api-django-RealtorBuddyCore && cd api-django-RealtorBuddyCore
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

# Configure environment
cp .env.example .env  # Edit with your API keys

# Run
python manage.py migrate
python manage.py runserver

# Background tasks
celery -A APIRealtorBuddyCore worker -l info
celery -A APIRealtorBuddyCore beat -l info

Docker

docker-compose up -d  # Development
docker-compose -f docker-compose.prod.yml up -d  # Production

⚙️ Key Environment Variables

DATABASE_URL=postgresql://user:pass@localhost:5432/db
REDIS_URL=redis://localhost:6379/0
TWILIO_ACCOUNT_SID=your-sid
TWILIO_AUTH_TOKEN=your-token
STRIPE_API_KEY=your-key
OPENAI_API_KEY=your-key
GMAIL_SERVICE_ACCOUNT={"type":"service_account",...}
SLACK_BA_TOKEN=your-token
AWS_ACCESS_KEY_ID=your-key

📋 Core Features

• Property Database: Building search with PostgreSQL full-text search
• Email Automation: Scheduled campaigns with reply tracking
• SMS Integration: Two-way messaging with AI processing
• Payment Processing: Stripe webhooks and subscription management
• Data Validation: Slack-based building data verification
• Batch Processing: S3-based data imports with Celery

🔗 Main Endpoints

# Buildings
GET/POST /buildings/building/

# Client Outreach  
GET/POST /outreach/clients/
GET /outreach/send_emails_bulk

# Webhooks
POST /twilio/textMessageReceived/
POST /stripe/events/
POST /slack/handleActionBuildingAssistant/

🚀 Deployment

Heroku:

git push heroku main
heroku run python manage.py migrate

Docker:

docker-compose -f docker-compose.prod.yml up -d