{"id":28204999,"url":"https://github.com/koubae/people","last_synced_at":"2026-04-19T13:32:47.883Z","repository":{"id":224194371,"uuid":"762681514","full_name":"Koubae/people","owner":"Koubae","description":"Django Social Media App - Social Networking called \"People\", built to learn the framework","archived":false,"fork":false,"pushed_at":"2024-02-27T18:10:19.000Z","size":96,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-14T10:37:13.561Z","etag":null,"topics":["back-end","django","django-example","django-project","example","facebook","facebook-clone","front-end","javascript","javascript-framework","learn","mysql","python","python-web-development","social","social-media","social-network","tutorial","web-application","web-django"],"latest_commit_sha":null,"homepage":"https://federicobau.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Koubae.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}},"created_at":"2024-02-24T11:49:39.000Z","updated_at":"2024-02-24T12:16:04.000Z","dependencies_parsed_at":"2024-02-27T19:39:33.327Z","dependency_job_id":null,"html_url":"https://github.com/Koubae/people","commit_stats":null,"previous_names":["koubae/people"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Koubae/people","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koubae%2Fpeople","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koubae%2Fpeople/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koubae%2Fpeople/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koubae%2Fpeople/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Koubae","download_url":"https://codeload.github.com/Koubae/people/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koubae%2Fpeople/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32009141,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["back-end","django","django-example","django-project","example","facebook","facebook-clone","front-end","javascript","javascript-framework","learn","mysql","python","python-web-development","social","social-media","social-network","tutorial","web-application","web-django"],"created_at":"2025-05-17T07:11:03.498Z","updated_at":"2026-04-19T13:32:47.850Z","avatar_url":"https://github.com/Koubae.png","language":"Python","readme":"People!\n======\n\n_Django Social Media App - Social Networking called \"People\", built to learn the framework_\n\n\n### What is it\n\nIs a simple, non production ready, Social Media Web Application use for learning and meant to be used as an example. \n\nQuick Start\n-----------\n\n* Make sure you have Python3.12 installed else please install via --\u003e https://www.python.org/downloads/\n* Install MySQL, preferably `MySQL 8`, should work in lower version but I developed using version 8 so can't guarantee it works for older ones.\n\n```bash\ngit clone git@github.com:Koubae/people.git\ncd people\n# create Python environment \npython -m venv env \n# Activate (linux)\nsource env/bin/activate\n# Activate (windows)\nenv/Scripts/activate.bat\n\n# Install \npython -m pip install requirements.txt\n# (Optional) Install development dependencies\npython -m pip install dev_requirements.txt\n# Go Inside MySQL\nmysql -u\u003cuser\u003e -p\u003cpassword\n# create database 'people'\nmysql\u003e CREATE DATABASE people;\nmysql\u003e USE people;\nmysql\u003e SELECT DATABASE();\n+------------+\n| DATABASE() |\n+------------+\n| people     |\n+------------+\n# exit mysql \nmysql\u003e exit\n\n# Cool now, let's create migration to intialize the database\npython manage.py makemigrations\npython manage.py migrate\n\n# run Django \npython manage.py runserver\n\n# Now go to\nlocalhost:8000\n```\n\n### Login\n\nNow use can use the demo user to login\n\n* **Email:** `awesome.guy@demo.com`\n* **Password:** `awesome`\n* **Username:** `peoplePerson`\n* **First Name:** `Guy`\n* **Last Name:** `Awesome`\n\n\n#### Stack\n\n* Python3.12\n* Django 5\n* Django Template _intentionally avoiding using any 'big' javascript framework in order to use Django Templating system_\n* MySQL 8\n\n### Specifications \n\n* [Model Structure](./model_structure.md)\n* User password for testings: `xPwVOJ-L0vVY3ERaLKgWOg`\n\nProjects\n---------------\n\n### Plugin - Django Library and cool Projects\n\n* [Datta Able Django](https://github.com/app-generator/django-datta-able)\n* [Django Material Dashboard](https://github.com/app-generator/django-material-dashboard)\n\n* [django-cities](https://github.com/coderholic/django-cities)\n* [django-smart-selects](https://github.com/jazzband/django-smart-selects)\n\n\n### Other Django Examples\n\n_Here a list of some example I found in github and online_\n\n* [django-realworld-example-app](https://github.com/gothinkster/django-realworld-example-app/tree/master)\n* [My django project](https://github.com/mach1el/my-django)\n* [E-Commerce Project For Baby Tools](https://github.com/MET-DEV/Django-E-Commerce)\n* [example.django.mi_aplicacion](https://github.com/macagua/example.django.mi_aplicacion)\n* [django-blog-example](https://github.com/rgab1508/django-blog-example)\n* [simple-django-page](https://github.com/90x-Development/simple-django-page)\n* [Simple Django Signals](https://github.com/BaseMax/SimpleDjangoSignals)\n* [django-tutorial-step-by-step](https://github.com/consideratecode/django-tutorial-step-by-step)\n\n\nTroubleshooting\n---------------\n\nTo keep things more organize, rather than have the application in root of the repository, I moved it inside [app](./app) folder.\nPyCharm by default starts and expect Django application to be developed at root level, so in order to make it work see the below article\n\nIn general simply do\n\n1. Go to Settings --\u003e Languages \u0026 Frameworks --\u003e Django --\u003e \n2. Modify `Django Project Root` and make it pointing to `app` \n\nAdditionally you may want to change Run configuration of PyCharm, set `Working Directory` also to `app` folder\n\n\n* [Getting Pycharm to run Django tests after moving the entire django source to a subfolder](https://intellij-support.jetbrains.com/hc/en-us/community/posts/115000622670-Getting-Pycharm-to-run-Django-tests-after-moving-the-entire-django-source-to-a-subfolder)\n\n\n### PyCharm complaining about 'templates' folder\n\n* [PyCharm code inspection complains template file not found, how to fix?](https://stackoverflow.com/questions/20873625/pycharm-code-inspection-complains-template-file-not-found-how-to-fix)\n\n\nFurther Reading\n---------------\n\n* [Organize django apps inside](https://stackoverflow.com/questions/73354083/organize-django-apps-inside)\n* [When to create a new app (with startapp) in Django?](https://stackoverflow.com/questions/64237/when-to-create-a-new-app-with-startapp-in-django)\n* [How to execute external script in the Django environment](https://stackoverflow.com/questions/41825037/how-to-execute-external-script-in-the-django-environment)\n* [How to define default data for Django Models?](https://stackoverflow.com/questions/39739439/how-to-define-default-data-for-django-models/39742847#39742847)\n* [Django - Working with many-to-many intermediary models](https://docs.djangoproject.com/en/5.0/ref/contrib/admin/#working-with-many-to-many-intermediary-models)\n* [Ordering admin.ModelAdmin objects in Django Admin](https://stackoverflow.com/questions/398163/ordering-admin-modeladmin-objects-in-django-admin)\n* [how to have \"city\" fields depending on \"country\" field in Django models, without creating their tables](https://stackoverflow.com/questions/39806588/how-to-have-city-fields-depending-on-country-field-in-django-models-without)\n* https://github.com/lukes/ISO-3166-Countries-with-Regional-Codes/blob/master/all/all.csv\n\n#### Social Media Related stuff\n\n* [What is Facebook's architecture?](https://www.quora.com/What-is-Facebooks-architecture-6)\n* [Facebook shares some secrets on making MySQL scale](https://ahmadrais.blogspot.com/2011/12/facebook-shares-some-secrets-on-making.html)\n* [Database normalization](https://en.wikipedia.org/wiki/Database_normalization)\n* [Falsehoods Programmers Believe About Names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/)\n\n* [Design a friends table for a social networking site](https://stackoverflow.com/questions/36998526/design-a-friends-table-for-a-social-networking-site)\n* [MySQL Structure for a social network](https://stackoverflow.com/questions/9930940/mysql-structure-for-a-social-network)\n* [Database schema for a social network website? MySql?](https://stackoverflow.com/questions/66652245/database-schema-for-a-social-network-website-mysql)\n* [Social web application database design: how can I improve this schema?](https://stackoverflow.com/questions/3844477/social-web-application-database-design-how-can-i-improve-this-schema)\n* [Table structure for social media content](https://stackoverflow.com/questions/36648479/table-structure-for-social-media-content)\n* [Guide To Design Database For Social Network System In MySQL](https://mysql.tutorials24x7.com/blog/guide-to-design-database-for-social-network-system-in-mysql)\n* [MySQL Social Network Database](https://github.com/j84guo/mysql-social-network)\n* [Analyzing Social Media Data with SQL](https://learnsql.com/blog/sql-social-media-analysis/)\n* [Going against the grain — Why we chose MySQL for building Social Graph](https://medium.com/gameskraft-engineering/why-we-chose-mysql-for-social-graph-service-332bc40ffcc9)\n* [SQL database for a social network](https://codereview.stackexchange.com/questions/153710/sql-database-for-a-social-network)\n* [Database 101: How social media “likes” are stored in a database](https://dev.to/danielhe4rt/database-101-how-social-media-likes-are-stored-in-a-database-3oii)\n* [In a MySQL social network database, should likes of posts and comments be in the same or separate tables?](https://www.quora.com/In-a-MySQL-social-network-database-should-likes-of-posts-and-comments-be-in-the-same-or-separate-tables)\n* [Database Design for Facebook: A Social Network Database Example](https://www.youtube.com/watch?v=sougyTO_Wjw)\n* ['schema' design for a social network](https://stackoverflow.com/questions/2839725/schema-design-for-a-social-network?rq=4)\n* [social networking website database management](https://stackoverflow.com/questions/3013103/social-networking-website-database-management?rq=4)\n* [Database scheme design social networking sites](https://stackoverflow.com/questions/2489739/database-scheme-design-social-networking-sites?rq=4)\n* [How to model database tables for implementing Friend relationship? [closed]](https://stackoverflow.com/questions/379236/how-to-model-database-tables-for-implementing-friend-relationship)\n* [How to store bidirectional relationships in a RDBMS like MySQL?](https://stackoverflow.com/questions/10807900/how-to-store-bidirectional-relationships-in-a-rdbms-like-mysql)\n* [What is the best way to implement Polymorphic Association in SQL Server?](https://stackoverflow.com/questions/7000283/what-is-the-best-way-to-implement-polymorphic-association-in-sql-server)\n\n* FOAF (FOAF Friend of a Friend)-format. \u003c-- What is it? | ref : https://stackoverflow.com/a/379301/13903942\n  * http://www.foaf-project.org\n  * https://en.wikipedia.org/wiki/FOAF\n  * https://www.amazon.com/dp/0123735564\n\n* What is **Boyce-Codd Normal Form (BCNF)** --\u003e https://github.com/j84guo/mysql-social-network/tree/master?tab=readme-ov-file#mysql-schema\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoubae%2Fpeople","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoubae%2Fpeople","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoubae%2Fpeople/lists"}