Build social media integration

[LaGodxy]

Description

This PR delivers the complete Social Media Integration System for Veritix. The module enables multi-platform social media promotion, referral marketing, influencer collaborations, and social proof tools to maximize event visibility and engagement. It is fully integrated into the backend, enterprise-ready, and aligned with Veritix’s ecosystem.

Related Issues

Closes #320

Changes Made

🏗 Core Architecture

• 9 Entities:

  • SocialAccount – Manage multi-platform accounts
  • SocialPost – Post creation, scheduling, engagement tracking
  • SocialCampaign – Campaign management + analytics
  • ReferralProgram, ReferralCode, ReferralTracking – Referral marketing lifecycle + fraud prevention
  • SocialProof – Friend attendance, testimonials, activity feeds
  • UserGeneratedContent – UGC management + AI-based moderation
  • InfluencerCollaboration – Influencer partnership + ROI tracking

• 7 Services:

  • SocialMediaApiService – API integrations (FB, IG, Twitter, LinkedIn)
  • SocialPostService – Automated posting, scheduling, AI content gen
  • ReferralProgramService – Referral codes, tracking, rewards
  • SocialProofService – Widget + social proof tracking
  • InfluencerCollaborationService – Influencer discovery, contracts, deliverables
  • SocialMediaAnalyticsService – Reporting + competitor analysis
  • AnalyticsService – Unified performance dashboard

• 7 Controllers (80+ Endpoints):

  • Full CRUD operations across all entities
  • Auth + validation layers
  • Swagger/OpenAPI documentation

🚀 Key Features

• Multi-Platform Integration:

  • Facebook, Instagram, Twitter, LinkedIn APIs
  • Automated + scheduled posting with media support
  • Token refresh + account lifecycle management
  • Cross-platform publishing

• Referral Program:

  • Unique referral code generation
  • Device fingerprinting + fraud prevention
  • Conversion tracking + reward distribution
  • Analytics dashboards

• Social Proof Widgets:

  • Friend attendance + trending displays
  • Live activity feeds + testimonials
  • Embeddable widgets for websites/apps

• Influencer Collaboration:

  • Influencer search + discovery
  • Contract management + deliverable tracking
  • Approval workflows
  • ROI + performance measurement

• Advanced Analytics:

  • Campaign metrics + time-series data
  • Competitor insights
  • Engagement + conversion breakdowns
  • Centralized dashboard

🧪 Testing

• Unit tests across all core services
• Mocked external API calls
• Edge case + error scenario validation
• 90%+ test coverage for business-critical logic

Business Impact

• Amplified Organic Reach through automated posting and multi-platform integration
• Lower CAC with referral programs and fraud-resistant tracking
• Boosted Engagement via social proof and user-generated content
• New Monetization Channels through influencer partnerships
• Data-Driven Decisions powered by advanced analytics dashboards

How to Test

1. Connect a social media account (FB/IG/Twitter/LinkedIn).
2. Schedule + publish a post with media.
3. Create + distribute referral codes, track conversions.
4. Embed social proof widget and verify live data.
5. Register influencer, set contract + deliverables, track results.
6. Review campaign analytics dashboard.

Checklist

• Code follows standards
• API docs updated
• Tests passing (90%+ coverage)
• Verified integration with Veritix ecosystem