Growth Features

Growth Architecture:
├── kulcare-api-backend/parts/growth/    # Backend API and business logic
├── kulcare-growth/                      # Frontend growth dashboard
└── growth_website/                      # Public clinic websites (Rails)

parts/growth/
├── controllers/          # API endpoints for growth features
├── interactors/         # Business logic using interactor pattern
├── models/              # Data models for websites, domains, GMB
├── services/            # External integrations (Google, domain providers)
├── policies/            # Authorization policies
├── serializers/         # JSON response formatters
└── routes.rb           # Growth feature routes

# Table: clinic_websites
class ClinicWebsite < ApplicationRecord
  belongs_to :clinic
  has_many :clinic_domain_requests
  has_many :clinic_domains
  has_many :clinic_website_seos
  
  # Key columns:
  # clinic_id: integer           - Associated clinic
  # status: string               - Website status (draft, published)
  # wordpress_url: string        - WordPress site URL
  # current_step: integer        - Setup completion step
  # has_unpublished_data: boolean - Pending changes flag
  # published_at: datetime       - Last publication timestamp
  
  def default_domain
    clinic_domains.where(domain_type: 'DEFAULT').first&.domain_name
  end
  
  def custom_domain
    clinic_domains.where(
      domain_type: 'CUSTOM',
      status: 'ACTIVE'
    ).first&.domain_name
  end
  
  def seos
    # Returns SEO configurations for different page types
    basic_seo_types = %w[homepage about_us gallery doctors services packages reviews]
    # ... SEO management logic
  end
end

# Table: website_themes
class WebsiteTheme < ApplicationRecord
  has_many :clinic_website_themes
  has_many :website_theme_variations
  has_many :theme_fonts
  has_many :theme_color_schemes
  
  # Key columns:
  # name: string                 - Theme name
  # description: text            - Theme description
  # url: string                  - Theme demo URL
  # thumbnail_url: string        - Theme preview image
  # active: boolean              - Theme availability
end

# Table: clinic_website_themes
class ClinicWebsiteTheme < ApplicationRecord
  belongs_to :clinic_website
  belongs_to :website_theme
  belongs_to :theme_color_scheme
  belongs_to :theme_font
  
  # Key columns:
  # current: boolean             - Currently active theme
  # published_at: datetime       - Theme publication timestamp
  # custom_settings: jsonb       - Theme customization data
end

# Table: clinic_domains
class ClinicDomain < ApplicationRecord
  belongs_to :clinic_website
  has_many :clinic_domain_requests
  
  # Key columns:
  # domain_name: string          - Domain name (e.g., "myclinic.com")
  # domain_type: string          - 'DEFAULT' or 'CUSTOM'
  # status: string               - Domain status (active, inactive)
  # ssl_enabled: boolean         - SSL certificate status
  # created_at: datetime         - Domain creation timestamp
end

# Table: clinic_domain_requests
class ClinicDomainRequest < ApplicationRecord
  belongs_to :clinic_domain
  belongs_to :clinic
  
  # Key columns:
  # request_type: string         - 'CREATE', 'VERIFY', 'DELETE'
  # status: string               - Request status
  # request_data: jsonb          - Request parameters
  # response_data: jsonb         - Response from domain provider
  # failed_at: datetime          - Failure timestamp
  
  enum request_type: {
    create: 'CREATE',
    verify: 'VERIFY',
    delete: 'DELETE'
  }
  
  enum status: {
    pending: 'PENDING',
    in_progress: 'IN_PROGRESS',
    completed: 'COMPLETED',
    failed: 'FAILED'
  }
end

# Table: gmb_accounts
class GmbAccount < ApplicationRecord
  belongs_to :clinic, foreign_key: 'profile_id', optional: true
  has_many :gmb_account_locations
  
  # Key columns:
  # profile_id: integer          - Associated clinic ID
  # account_name: string         - GMB account name
  # account_id: string           - Google account identifier
  # access_token: string         - OAuth access token
  # refresh_token: string        - OAuth refresh token
  # expires_at: datetime         - Token expiration
end

# Table: gmb_account_locations
class GmbAccountLocation < ApplicationRecord
  belongs_to :gmb_account
  has_many :gmb_location_questions
  has_many :gmb_location_posts
  
  # Key columns:
  # location_name: string        - Business location name
  # location_id: string          - Google location identifier
  # place_id: string             - Google Places API ID
  # address: string              - Business address
  # phone_number: string         - Contact number
  # website_url: string          - Business website
  # place_action_links: jsonb    - Google action links data
  # qanda_enabled: boolean       - Q&A feature status
end

# Table: google_reviews
class GoogleReview < ApplicationRecord
  belongs_to :gmb_account_location
  
  # Key columns:
  # review_id: string            - Google review identifier
  # reviewer_name: string        - Reviewer name
  # rating: integer              - Star rating (1-5)
  # review_text: text            - Review content
  # review_time: datetime        - Review timestamp
  # reply_text: text             - Business reply content
  # reply_time: datetime         - Reply timestamp
end

# Table: clinic_website_seos
class ClinicWebsiteSeo < ApplicationRecord
  belongs_to :clinic_website
  
  # Key columns:
  # seo_type: string             - Page type (homepage, about_us, etc.)
  # title: string                - SEO page title
  # description: text            - Meta description
  # keywords: text               - SEO keywords
  # og_title: string             - Open Graph title
  # og_description: text         - Open Graph description
  # og_image_url: string         - Open Graph image
end

# Table: ad_campaign_leads_webhooks
class AdCampaignLeadsWebhook < ApplicationRecord
  has_many :ad_campaign_leads
  
  # Key columns:
  # webhook_data: jsonb          - Complete webhook payload
  # source: string               - Lead source (facebook, google)
  # processed: boolean           - Processing status
  # error_message: text          - Error details if failed
end

GET  /clinics/:clinic_id/growth_profile              # Get profile data
GET  /clinics/:clinic_id/growth_profile/dashboard    # Growth dashboard
GET  /clinics/:clinic_id/growth_profile/reports      # Growth reports
GET  /clinics/:clinic_id/growth_profile/setup_status # Setup completion
POST /clinics/:clinic_id/growth_profile/save_photo_tag # Save photo tags

{
  "success": true,
  "data": {
    "clinic": {
      "id": 123,
      "name": "Heart Care Clinic",
      "total_appointments": 456,
      "website_visits": 789,
      "google_reviews_count": 23,
      "average_rating": 4.8
    },
    "website": {
      "status": "published",
      "domain": "heartcareclinic.com",
      "ssl_enabled": true,
      "last_published": "2024-01-15T10:30:00Z"
    },
    "google_business": {
      "connected": true,
      "locations_count": 2,
      "pending_questions": 3,
      "recent_reviews": 5
    }
  }
}

POST /clinics/:clinic_id/clinic_website                    # Create website
GET  /clinics/:clinic_id/clinic_website                    # Get website details
POST /clinics/:clinic_id/clinic_website/initialize_request # Initialize setup
POST /clinics/:clinic_id/clinic_website/current_step      # Update setup step
POST /clinics/:clinic_id/clinic_website/publish           # Publish website

GET  /clinics/:clinic_id/clinic_website_theme              # List themes
POST /clinics/:clinic_id/clinic_website_theme              # Apply theme
GET  /clinics/:clinic_id/clinic_website_theme/:id          # Get theme details

{
  "clinic_website_theme": {
    "website_theme_id": 5,
    "theme_color_scheme_id": 12,
    "theme_font_id": 8,
    "custom_settings": {
      "primary_color": "#2E8B57",
      "secondary_color": "#F0F8FF",
      "logo_url": "https://example.com/logo.png",
      "hero_text": "Welcome to Heart Care Clinic"
    }
  }
}

GET  /clinics/:clinic_id/clinic_domains                    # List domains
POST /clinics/:clinic_id/clinic_domain_requests            # Request domain
PUT  /clinics/:clinic_id/clinic_domain_requests/:id        # Update request
POST /clinics/:clinic_id/clinic_domain_requests/:id/verify # Verify domain
DELETE /clinics/:clinic_id/clinic_domain_requests/:id      # Delete request

{
  "clinic_domain_request": {
    "domain_name": "myclinic.com",
    "request_type": "CREATE",
    "request_data": {
      "registrar": "godaddy",
      "nameservers": ["ns1.kulcare.com", "ns2.kulcare.com"]
    }
  }
}

POST /clinics/:clinic_id/google_my_business              # Connect GMB account
GET  /clinics/:clinic_id/google_my_business/connection   # Check connection status

GET  /clinics/:clinic_id/growth_profile/google_locations # List GMB locations
POST /clinics/:clinic_id/growth_profile/google_locations # Update location

GET  /clinics/:clinic_id/growth_profile/google_reviews              # List reviews
POST /clinics/:clinic_id/growth_profile/google_reviews/:review_id/review_reply # Reply to review
POST /clinics/:clinic_id/growth_profile/google_reviews/:review_id/review_reply/delete # Delete reply

GET  /clinics/:clinic_id/growth_profile/google_posts        # List posts
POST /clinics/:clinic_id/growth_profile/google_posts        # Create post
PUT  /clinics/:clinic_id/growth_profile/google_posts/:id    # Update post
DELETE /clinics/:clinic_id/growth_profile/google_posts/:id  # Delete post
GET  /clinics/:clinic_id/growth_profile/google_posts/:id/insights # Post insights

GET  /clinics/:clinic_id/growth_profile/google_questions       # List Q&A
POST /clinics/:clinic_id/growth_profile/google_questions       # Create question
POST /clinics/:clinic_id/growth_profile/google_questions/:id/answer # Answer question
POST /clinics/:clinic_id/growth_profile/google_questions/create_multiple # Bulk create

GET  /clinics/:clinic_id/growth_profile/services           # List services
PUT  /clinics/:clinic_id/growth_profile/services/:id       # Update service
DELETE /clinics/:clinic_id/growth_profile/services/:id     # Delete service
POST /clinics/:clinic_id/growth_profile/services/copy      # Copy services

GET  /clinics/:clinic_id/growth_profile/packages           # List packages
PUT  /clinics/:clinic_id/growth_profile/packages/:id       # Update package
DELETE /clinics/:clinic_id/growth_profile/packages/:id     # Delete package
POST /clinics/:clinic_id/growth_profile/packages/copy      # Copy packages

GET  /clinics/:clinic_id/growth_profile_seo                # Get SEO settings
POST /clinics/:clinic_id/growth_profile_seo                # Update SEO settings

GET  /clinics/:clinic_id/growth_profile_analytics          # Get analytics
POST /clinics/:clinic_id/growth_profile_analytics          # Update analytics settings

GET  /clinics/:clinic_id/growth_profile/reports/ad_campaigns    # Ad campaign reports
GET  /clinics/:clinic_id/growth_profile/reports/email_campaigns # Email campaign reports
GET  /clinics/:clinic_id/growth_profile/reports/credits         # Credit usage reports
GET  /clinics/:clinic_id/growth_profile/reports/messaging       # Messaging reports

POST /ad_campaign_leads/webhook                          # Webhook endpoint for leads

# parts/growth/interactors/clinic_website_management/create.rb
class ClinicWebsiteManagement::Create
  include Interactor
  
  def call
    # 1. Validate clinic eligibility
    # 2. Create website record
    # 3. Set up default theme
    # 4. Initialize SEO settings
    # 5. Create default domain
    # 6. Send creation notifications
  end
end

# parts/growth/interactors/clinic_website_management/publish.rb
class ClinicWebsiteManagement::Publish
  include Interactor
  
  def call
    # 1. Validate website completeness
    # 2. Generate static website files
    # 3. Deploy to hosting infrastructure
    # 4. Update DNS records
    # 5. Enable SSL certificates
    # 6. Update publication timestamp
  end
end

# parts/growth/interactors/domains/verify_and_host.rb
class Domains::VerifyAndHost
  include Interactor
  
  def call
    # 1. Verify domain ownership
    # 2. Configure DNS settings
    # 3. Set up SSL certificate
    # 4. Update hosting configuration
    # 5. Test domain accessibility
    # 6. Activate domain
  end
end

# parts/growth/interactors/gmb_management/add_connection.rb
class GmbManagement::AddConnection
  include Interactor
  
  def call
    # 1. Validate OAuth tokens
    # 2. Fetch GMB account details
    # 3. Import business locations
    # 4. Sync existing reviews
    # 5. Enable webhooks for updates
    # 6. Store connection details
  end
end

# parts/growth/interactors/gmb_review_reply/create.rb
class GmbReviewReply::Create
  include Interactor
  
  def call
    # 1. Validate review exists
    # 2. Check reply permissions
    # 3. Post reply to Google
    # 4. Store reply locally
    # 5. Update review status
    # 6. Track reply analytics
  end
end

# parts/growth/services/sync_google_profile.rb
class SyncGoogleProfile
  def self.call(gmb_account_location)
    # Sync business profile data from Google
    # Update local records with latest information
    # Handle API rate limiting
    # Log sync activities
  end
end

# parts/growth/services/create_google_post.rb
class CreateGooglePost
  def self.call(location, post_data)
    # Create post on Google My Business
    # Handle different post types (update, offer, event)
    # Upload media if present
    # Return post details
  end
end

# parts/growth/services/auto_map_domain_https.rb
class AutoMapDomainHttps
  def self.call(clinic_domain)
    # Configure SSL certificate
    # Update load balancer settings
    # Set up HTTPS redirects
    # Verify SSL configuration
  end
end

# parts/growth/services/auto_remove_domain.rb
class AutoRemoveDomain
  def self.call(clinic_domain)
    # Remove domain from hosting
    # Revoke SSL certificates
    # Clean up DNS records
    # Update database records
  end
end

# Example dashboard data structure
{
  overview: {
    total_visits: 1250,
    new_patients: 45,
    google_profile_views: 890,
    average_rating: 4.7,
    total_reviews: 123
  },
  trends: {
    visits_trend: "↑ 23% from last month",
    reviews_trend: "↑ 12% from last month",
    ratings_trend: "→ Stable"
  },
  top_sources: [
    { source: "Google Search", visits: 456, percentage: 36.5 },
    { source: "Direct", visits: 234, percentage: 18.7 },
    { source: "Social Media", visits: 178, percentage: 14.2 }
  ]
}

# Example campaign workflow
{
  campaign: {
    name: "New Patient Special",
    target_audience: "Local residents aged 25-45",
    channels: ["google_ads", "facebook_ads"],
    budget: 5000,
    duration: "30 days"
  },
  landing_page: {
    theme: "medical_professional",
    headline: "Get Your Health Check-up Today",
    offer: "50% off first consultation",
    form_fields: ["name", "phone", "email", "preferred_time"]
  },
  automation: {
    immediate_response: "Thank you email with clinic details",
    follow_up_sequence: [
      { delay: "1 hour", action: "appointment_reminder_sms" },
      { delay: "1 day", action: "clinic_information_email" },
      { delay: "3 days", action: "special_offer_reminder" }
    ]
  }
}

# Automated review response suggestions
{
  positive_templates: [
    "Thank you for your wonderful review! We're thrilled that you had such a positive experience.",
    "We appreciate your kind words and are glad we could provide excellent care.",
    "Your feedback means the world to us. Thank you for choosing our clinic!"
  ],
  negative_templates: [
    "We sincerely apologize for your experience. Please contact us directly so we can make this right.",
    "Thank you for bringing this to our attention. We'd like to discuss this further to improve our service.",
    "We take all feedback seriously and would appreciate the opportunity to address your concerns."
  ]
}

# Growth features health check
def growth_health_check
  {
    websites_published: ClinicWebsite.where(status: 'published').count,
    domains_active: ClinicDomain.where(status: 'ACTIVE').count,
    ssl_expiring_soon: ClinicDomain.where('ssl_expires_at < ?', 30.days.from_now).count,
    gmb_connections_active: GmbAccount.where('expires_at > ?', Time.current).count,
    pending_domain_requests: ClinicDomainRequest.where(status: 'PENDING').count
  }
end