{"id":36938521,"url":"https://github.com/smartlegionlab/smart-social-network","last_synced_at":"2026-04-08T07:01:18.732Z","repository":{"id":326375271,"uuid":"1059067065","full_name":"smartlegionlab/smart-social-network","owner":"smartlegionlab","description":"Modern Django-Powered Social Network Platform. A comprehensive, feature-rich social networking platform built from the ground up with Django. Smart Social Network offers a complete suite of social features with real-time interactions.","archived":false,"fork":false,"pushed_at":"2025-11-27T11:55:19.000Z","size":3899,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-11-30T04:44:21.552Z","etag":null,"topics":["django-social-network","django-web-application","smart-social-network","smartlegionlab","social-network"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smartlegionlab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-18T00:31:47.000Z","updated_at":"2025-11-27T11:49:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/smartlegionlab/smart-social-network","commit_stats":null,"previous_names":["smartlegionlab/smart-social-network"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/smartlegionlab/smart-social-network","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartlegionlab%2Fsmart-social-network","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartlegionlab%2Fsmart-social-network/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartlegionlab%2Fsmart-social-network/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartlegionlab%2Fsmart-social-network/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smartlegionlab","download_url":"https://codeload.github.com/smartlegionlab/smart-social-network/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartlegionlab%2Fsmart-social-network/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28380809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T10:00:56.084Z","status":"ssl_error","status_checked_at":"2026-01-13T09:45:11.986Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["django-social-network","django-web-application","smart-social-network","smartlegionlab","social-network"],"created_at":"2026-01-13T10:19:36.225Z","updated_at":"2026-04-08T07:01:18.721Z","avatar_url":"https://github.com/smartlegionlab.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Smart Social Network \u003csup\u003ev1.0.2\u003c/sup\u003e\n\n## Modern Django-Powered Social Network Platform\n\nA comprehensive, feature-rich social networking platform built from the ground up with Django. \nSmart Social Network offers a complete suite of social features with real-time interactions.\n\n**Development Note:** The complete development history, including experimental features, iterations, \nand testing phases, was conducted in a private repository.\nThe full development history with over 1000+ commits is available upon request for serious collaborators or potential employers.\n\n![Smart Social Network](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/smart_social_network.png)\n\n---\n\n[![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python)](https://python.org)\n[![Django](https://img.shields.io/badge/Django-5.0+-green?logo=django)](https://djangoproject.com)\n[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-15+-blue?logo=postgresql)](https://postgresql.org)\n[![Redis](https://img.shields.io/badge/Redis-Cache_\u0026_Broker-red?logo=redis)](https://redis.io)\n[![Celery](https://img.shields.io/badge/Celery-Task_Queue-green)](https://docs.celeryq.dev)\n[![WebSocket](https://img.shields.io/badge/WebSocket-Real--time-yellow)](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket)\n[![Arch Linux](https://img.shields.io/badge/Arch_Linux-Recommended-blue?logo=arch-linux)](https://archlinux.org)\n[![Telegram](https://img.shields.io/badge/Telegram-2FA_Bot-blue?logo=telegram)](https://telegram.org)\n[![License](https://img.shields.io/badge/License-BSD_3_Clause-lightgrey)](LICENSE)\n[![Project Status](https://img.shields.io/badge/Status-Active_Development-yellow)](https://github.com/smartlegionlab/smart-social-network)\n[![Dev.to Article](https://img.shields.io/badge/Article-dev.to-black?logo=dev.to)](https://dev.to/smartlegionlab/what-it-takes-to-build-a-modern-social-network-in-django-24dd)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/smartlegionlab/smart-social-network)](https://github.com/smartlegionlab/smart-social-network/)\n[![GitHub stars](https://img.shields.io/github/stars/smartlegionlab/smart-social-network?style=social)](https://github.com/smartlegionlab/smart-social-network/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/smartlegionlab/smart-social-network?style=social)](https://github.com/smartlegionlab/smart-social-network/network/members)\n![GitHub top language](https://img.shields.io/github/languages/top/smartlegionlab/smart-social-network)\n\n---\n\n## ⚠️ Disclaimer\n\n**By using this software, you agree to the full disclaimer terms.**\n\n**Summary:** Software provided \"AS IS\" without warranty. You assume all risks.\n\n**Full legal disclaimer:** See [DISCLAIMER.md](https://github.com/smartlegionlab/smart-social-network/blob/master/DISCLAIMER.md)\n\n---\n\n## Table of Contents\n\n1. [Key Features](#-key-features)\n2. [Architecture \u0026 Tech Stack](#-architecture--tech-stack)\n3. [Quick Start](#-quick-start)\n4. [Authentication \u0026 Security](#-authentication--security)\n5. [Social Features](#-social-features)\n6. [Real-Time Communication](#-real-time-communication)\n7. [Media Management](#-media-management)\n8. [Administration](#-administration)\n9. [System Monitoring](#-system-monitoring)\n10. [Installation Guide](#-installation-guide)\n11. [License](#-license)\n12. [Disclaimer](#-disclaimer)\n\n---\n\n## Key Features\n\n### Advanced Authentication System\n- **Secure and minimized** Registration \u0026 Login\n- **Custom Two-Factor Authentication** via Telegram bot integration\n- **Password Recovery** with Telegram bot verification\n- **Session Management** with comprehensive login history tracking\n\n### Complete User Profiles\n- **Customizable Profiles** with avatar management (upload/reset to default)\n- **Real-time User Status Indicators** (online/offline)\n- **Profile Visits Tracking** with management\n- **Advanced Friends System** with request management and mutual connections\n- **Granular Privacy Controls** for profile visibility settings\n\n### Content Management\n- **Personal Walls** for user posts\n- **Rich Text Posts** with emoji support (51+ integrated emojis)\n- **Post Interactions** - likes, comments, editing, deletion\n- **Intelligent Rate Limiting** for posts, comments and interactions\n\n### Advanced Messaging System\n- **Real-time Chat** with WebSocket integration for instant messaging\n- **Group Chats \u0026 Direct Messaging** with flexible participant management\n- **Message Editing** with instant synchronization across all users\n- **Comprehensive Chat Management** - mute, archive, delete, restore functionality\n- **Typing Indicators** for enhanced communication\n- **Chat Categories** - organized into active, archived or deleted sections\n\n### Multimedia Integration\n- **Smart Audio Player** with visualizations and audio management\n- **Image Gallery** with comments, likes and privacy controls\n- **Document Management** with visibility settings and sharing capabilities\n- **Cross-user Media Sharing** with add audio to playlist\n- **Media Statistics** - analytics on likes\n\n### Applications\n- **Integrated Apps Platform** for future extensions and integrations\n- **Built-in Smart Password Manager** for secure credential management\n- **Expandable Ecosystem** - designed for additional applications\n\n### Additional Features\n- **User Search** with instant results\n- **News Section** with admin-published articles and engagement metrics\n- **Visits System** - track who visited your profile and who you visited\n- **Notifications Center** - comprehensive management of all alerts\n- **Main Menu Indicators** - real-time notifications for new posts, messages, friend requests or profile visits\n\n---\n\n## Architecture \u0026 Tech Stack\n\n### Backend Technologies\n- **Django 5++** - Full-stack web framework with optimized performance\n- **PostgreSQL 15+** - Production-grade relational database\n- **Redis** - High-performance caching and message broker\n- **Celery** - Distributed task query for asynchronous processing\n- **WebSocket** - Real-time bidirectional communication\n- **Django Channels** - WebSocket integration for real-time features\n\n### Frontend Technologies\n- **Responsive Design** - Mobile-first approach with cross-device compatibility\n- **Dark Theme** - Modern UI/UX design throughout the application\n- **JavaScript** - Dynamic client-side interactions\n- **CSS3** - Advanced styling with animations and transitions\n- **WebSocket Client** - Real-time frontend-backend communication\n\n### Security Framework\n- **Custom Two-Factor Authentication** - Proprietary implementation via Telegram\n- **Custom Rate Limiting** - Comprehensive protection against abuse and spam\n- **SQL Injection Protection** - Django ORM security with parameterized queries\n- **CSRF Protection** - Cross-site request forgery prevention\n\n---\n\n## Quick Start\n\n### System Requirements\n\n#### Recommended Development Environment\n- **Operating System**: Arch Linux (recommended) or other Linux distributions\n- **Python**: 3.10 or higher\n- **Database**: PostgreSQL 15+\n- **Cache/Broker**: Redis/Valkey\n- **IDE**: PyCharm Professional (recommended) or Visual Studio Code\n\n### Package Installation\n\n#### Install Required Packages\n\n**For Redis:**\n```bash\nsudo pacman -S redis\nsudo systemctl start redis\nsudo systemctl enable redis\n```\n\n**For Valkey (alternative):**\n```bash\nsudo systemctl start valkey\nsudo systemctl enable valkey\n```\n\n### Database Setup\n\n#### PostgreSQL Installation\n\n```bash\n# Install PostgreSQL\nsudo pacman -S postgresql\n\n# Initialize database cluster\nsudo su - postgres -c \"initdb --locale en_US.UTF-8 -D '/var/lib/postgres/data'\"\n# Errors when running this command in Arch are resolved by deleting the postgres folder and reinstalling PostgreSQL\n\n# Start and enable PostgreSQL service\nsudo systemctl start postgresql\nsudo systemctl enable postgresql\n\n# Access PostgreSQL shell\nsudo -u postgres psql\n```\n\nExecute the following SQL commands to create the database:\n```sql\n-- Create main database with proper encoding\nCREATE DATABASE smart_social_network_db\n    OWNER postgres\n    ENCODING 'UTF-8'\n    LC_COLLATE 'en_US.UTF-8'\n    LC_CTYPE 'en_US.UTF-8'\n    TEMPLATE template0;\n\n-- Exit PostgreSQL\n\\q\n```\n\n### Project Installation\n\n#### Clone and Setup Repository\n```bash\n# Clone the repository\ngit clone https://github.com/smartlegionlab/smart-social-network.git\ncd smart-social-network\n\n# Create and activate virtual environment\npython -m venv venv\nsource venv/bin/activate\n\n# Install Python dependencies\npip install --upgrade pip\npip install -r requirements.txt\n```\n\n#### Environment Configuration\n\nCreate a `.env` file in the project root directory with the following content:\n\n```ini\n# Core Settings\nDJANGO_ENV=development\nSECRET_KEY=your-generated-secret-key-here\nDEBUG=True\n\n# Database Configuration\nDB_NAME=smart_social_network_db\nDB_USER=postgres\nDB_PASSWORD=postgres\nDB_HOST=localhost\nDB_PORT=5432\n\n# Redis/Celery Settings\nREDIS_URL=redis://localhost:6379/1\nCELERY_BROKER_URL=redis://localhost:6379/0\nCELERY_RESULT_BACKEND=redis://localhost:6379/0\n\n# Development Tools\nDEBUG_TOOLBAR_ENABLED=True\n```\n\n**Important**: Replace `your-generated-secret-key-here` with an actual secret key. You can generate one using:\n```bash\npython -c \"from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())\"\n```\n\n### Database Initialization\n\n#### Apply Migrations and Load Data\n```bash\n# Apply database migrations\npython manage.py migrate\n\n# Load initial data fixtures\npython manage.py loaddata data/fixtures/cities.json\npython manage.py loaddata data/fixtures/emoji.json\n\n# Create administrator account\npython manage.py createsuperuser\n```\n\n### Running the Application\n\n#### Development Mode\nStart the application in development mode with these commands:\n\n**Terminal 1 - Django Server:**\n```bash\npython manage.py runserver\n```\n\n**Terminal 2 - Celery Worker:**\n```bash\ncelery -A smart_social_network worker --loglevel=info\n```\n\n**Terminal 3 - Celery Beat (optional):**\n```bash\ncelery -A smart_social_network beat --loglevel=info\n```\n\n### PyCharm Configuration\n\nFor optimal development experience in PyCharm:\n- **Database User**: `postgres`\n- **Database Password**: `postgres`\n- **Database Name**: `smart_social_network_db`\n- **Host**: `localhost`\n- **Port**: `5432`\n\n### Access the Application\n\nOnce all services are running, access the application at:\n**http://localhost:8000**\n\nThe admin interface will be available at:\n**http://localhost:8000/admin**\n\n---\n\n## Authentication \u0026 Security\n\n### Custom Two-Factor Authentication System\n- **Proprietary Implementation** - Unique authentication system developed from scratch\n- **Telegram Bot Integration** - Secure code delivery through Telegram\n- **Time-based Code Generation** - Custom algorithm implementation\n- **Secure Session Management** - Comprehensive session tracking and control\n- **Login History Tracking** - Detailed IP logging and device information\n\n### Password Management\n- **Built-in Password Generator** - Cryptographically secure password generation\n- **Secure Password Reset** - Telegram-based verification system\n\n### Privacy \u0026 Data Protection\n- **Visit History Management** - Comprehensive tracking and control\n- **Content Privacy Settings** - Flexible content visibility options\n\n---\n\n## Social Features\n\n### User Interaction System\n- **Advanced Friend System** - Mutual connections with request management\n- **Profile Visits** - Tracking with timestamps\n- **Post Interactions** - Likes and comments\n- **Notification System** - Comprehensive activity notifications\n\n### Content Management System\n- **Rich Text Editor** - Advanced editing with emoji support\n- **Post Management** - Create, edit, delete\n- **Comment System** - Nested replies with moderation tools\n\n### Discovery \u0026 Exploration\n- **User Search** - Instant results with advanced filtering\n- **Profile Discovery** - Multiple discovery channels and algorithms\n- **Content Exploration**\n\n---\n\n## Real-Time Communication\n\n### Chat \u0026 Messaging\n- **Instant Messaging** - Real-time delivery with WebSocket integration\n- **Group Chats** - Multi-participant conversations with management tools\n- **Message Editing** - Live synchronization across all connected clients\n\n### Notification System\n- **Real-time Alerts** - Instant notifications for all interactions\n- **Notification Center** - Centralized management and organization\n\n### Live Updates\n- **Online Status** - user presence indicators\n- **Typing Indicators** - Live typing notifications in chats\n- **Real-time Counters** - Live update of all statistics\n\n---\n\n## Media Management\n\n### Audio System\n- **Smart Audio Player** - Advanced player with visualizations\n- **Music sharing** - Music sharing\n- **Audio Analytics** - Popularity tracking\n\n### Image Management\n- **Photo Uploads** - Optimized uploads with compression\n- **Image Comments** - Interaction features\n- **Privacy Controls** - Flexible visibility settings\n- **Shareable Links** - External sharing capabilities\n\n### Document Management\n- **File Uploads** - Type validation and security checks\n- **Document Sharing** - Permission-based sharing system\n\n---\n\n## Administration\n\n- **Django and Custom Admin panel** protected from unauthorized access on request level\n\n### Django Admin Interface\n- **User Management** - Advanced user controls\n- **Content Moderation** - Comprehensive content review tools\n- **System Configuration** - Centralized configuration management\n\n### Custom Admin Panel\n- **Profile Management** - Detailed user profile views and controls\n- **Login History** - IP analysis and security monitoring\n- **Report System** - User complaint management and resolution\n\n### Moderation Tools\n- **User Reports** - Comprehensive report management system\n- **Content Review** - Structured review workflow process\n- **Ban Management**\n- **Appeal Process** - User appeal and resolution system\n\n### Global Settings\n- **Application Configuration** - Site name, description, contact information\n- **Telegram Bot Settings** - Token and URL configuration\n- **System Information** - Real-time server monitoring and metrics\n\n---\n\n## System Monitoring\n\n### Real-time System Information\n```\nSystem boot time: 17.09.2025 20:33:14\nCPU number of physical cores: 6\nCPU number of logical cores: 12\nCPU load system wide: 13.2%\nMemory (total): 15.5gb\nMemory (available): 10.8gb\nMemory (free): 5.6gb\nMemory (in use): 4.2gb\nMemory (percentage of load): 30.3%\nDisk: Total: 145.5gb | Busy: 32.0gb | Available: 112.5gb | Utilization percentage: 22.2%\n```\n\n### Performance Optimization\n- **Database Optimization** - N+1 query solutions and performance tuning\n- **Caching Strategy** - Redis integration for optimal performance\n- **Asset Optimization** - Fast loading and efficient resource usage\n- **Code Refactoring** - Maintainable and optimized codebase\n\n---\n\n## 📜 License\n\nBSD 3-Clause License\n\nCopyright (©) 2025, Alexander Suvorov\n\n---\n\n## 🌟 Development Statistics\n\n- **1000+ Commits** - Comprehensive development history\n- **6+ Months** - Intensive active development period\n\n\u003e **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.\n\n---\n\n**Created by Alexander Suvorov**\n\n[![GitHub](https://img.shields.io/badge/GitHub-@smartlegionlab-blue?logo=github)](https://github.com/smartlegionlab)\n[![Email](https://img.shields.io/badge/Email-smartlegiondev@gmail.com-blue?logo=mail.ru)](mailto:smartlegiondev@gmail.com)\n\n---\n\n## Images\n\n![Smart Social Network](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/smart_social_network.png)\n\n![Smart Social Network Auth](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/auth.png)\n\n![Smart Social Network Profile](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/profile.png)\n\n![Smart Social Network Wall](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/wall.png)\n\n![Smart Social Network Chats](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/chats.png)\n\n![Smart Social Network Messages](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/messages.png)\n\n![Smart Social Network Friends](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/friends.png)\n\n![Smart Social Network Visits](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/visits.png)\n\n![Smart Social Network Notofocations](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/notofocations.png)\n\n![Smart Social Network Search](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/search.png)\n\n![Smart Social Network Articles](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/articles.png)\n\n![Smart Social Network Article](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/article.png)\n\n![Smart Social Network Audio](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/audio.png)\n\n![Smart Social Network Images](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/images.png)\n\n![Smart Social Network Docs](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/docs.png)\n\n![Smart Social Network Apps](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/apps.png)\n\n![Smart Social Network Smart Password Manager](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/smart-pass-man.png)\n\n![Smart Social Network Smart Password Generator](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/smart-password.png)\n\n![Smart Social Network TG 2FA](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/tg-2fa.png)\n\n![Smart Social Network User Profile](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/user-profile.png)\n\n![Smart Social Network User Report](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/user-report.png)\n\n![Smart Social Network Admin Articles](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/admin-articles.png)\n\n![Smart Social Network Admin References](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/admin-references.png)\n\n![Smart Social Network Admin Reports](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/admin-reports.png)\n\n![Smart Social Network Admin Site Config](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/admin-site-config.png)\n\n![Smart Social Network Admin System](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/admin-system.png)\n\n![Smart Social Network Admin Users](https://github.com/smartlegionlab/smart-social-network/raw/master/data/images/admin-users.png)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartlegionlab%2Fsmart-social-network","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmartlegionlab%2Fsmart-social-network","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartlegionlab%2Fsmart-social-network/lists"}