smart-social-network v1.0.2

Modern Django-Powered Social Network Platform

A comprehensive, feature-rich social networking platform built from the ground up with Django. Complete suite of social features with real-time interactions.

Django Python PostgreSQL Redis WebSocket Celery

Smart Social Network is a comprehensive, feature-rich social networking platform built from the ground up with Django. It offers a complete suite of social features with real-time interactions.

Development Note: The complete development history, including experimental features, iterations, and testing phases, was conducted in a private repository. The full development history with over 1000+ commits is available upon request for serious collaborators or potential employers.

Advanced Authentication System:

  • Secure and minimized Registration & Login
  • Custom Two-Factor Authentication via Telegram bot integration
  • Password Recovery with Telegram bot verification
  • Session Management with comprehensive login history tracking

Complete User Profiles:

  • Customizable Profiles with avatar management
  • Real-time User Status Indicators (online/offline)
  • Profile Visits Tracking with management
  • Advanced Friends System with request management
  • Granular Privacy Controls for profile visibility settings

Content Management:

  • Personal Walls for user posts
  • Rich Text Posts with emoji support (51+ integrated emojis)
  • Post Interactions - likes, comments, editing, deletion
  • Intelligent Rate Limiting for posts, comments and interactions

Advanced Messaging System:

  • Real-time Chat with WebSocket integration
  • Group Chats & Direct Messaging
  • Message Editing with instant synchronization
  • Typing Indicators for enhanced communication
  • Chat Categories - active, archived, deleted

Multimedia Integration:

  • Smart Audio Player with visualizations
  • Image Gallery with comments, likes and privacy controls
  • Document Management with visibility settings

Applications:

  • Integrated Apps Platform for future extensions
  • Built-in Smart Password Manager

Backend Technologies:

  • Django 5++ — Full-stack web framework
  • PostgreSQL 15+ — Production-grade relational database
  • Redis — High-performance caching and message broker
  • Celery — Distributed task queue
  • WebSocket — Real-time bidirectional communication
  • Django Channels — WebSocket integration

Frontend Technologies:

  • Responsive Design — Mobile-first approach
  • Dark Theme — Modern UI/UX design
  • JavaScript — Dynamic client-side interactions
  • WebSocket Client — Real-time frontend-backend communication

Security Framework:

  • Custom Two-Factor Authentication via Telegram
  • Custom Rate Limiting for abuse protection
  • SQL Injection Protection with Django ORM
  • CSRF Protection

System Requirements:

  • OS: Arch Linux (recommended) or other Linux
  • Python: 3.10+
  • Database: PostgreSQL 15+
  • Cache: Redis/Valkey

Installation:

# Clone repository
git clone https://github.com/smartlegionlab/smart-social-network.git
cd smart-social-network

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

# Apply migrations
python manage.py migrate

# Load fixtures
python manage.py loaddata data/fixtures/cities.json
python manage.py loaddata data/fixtures/emoji.json

# Create superuser
python manage.py createsuperuser

# Run server
python manage.py runserver

Celery Workers (separate terminals):

# Terminal 2 - Celery Worker
celery -A smart_social_network worker --loglevel=info

# Terminal 3 - Celery Beat (optional)
celery -A smart_social_network beat --loglevel=info

Access at: http://localhost:8000 | Admin: http://localhost:8000/admin

Custom Two-Factor Authentication System:

  • Proprietary Implementation developed from scratch
  • Telegram Bot Integration for secure code delivery
  • Time-based Code Generation with custom algorithm
  • Secure Session Management with comprehensive tracking
  • Login History Tracking with IP logging and device information

Password Management:

  • Built-in Password Generator — cryptographically secure
  • Secure Password Reset with Telegram-based verification

  • 1000+ Commits — Comprehensive development history
  • 6+ Months — Intensive active development period

Note: This platform is still under active development. The system features a proprietary two-factor authentication system with Telegram integration. This list of features is not exhaustive - the platform includes many additional capabilities beyond those described here. The platform is designed for scalability, maintainability, and excellent user experience across all devices, but should be used responsibly and in accordance with all applicable laws.

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md

License: BSD 3-Clause License