django forums app

Forums Django

Une application d'échantillon de forums construit sur le framework Django. J'ai construit cette application pour en savoir plus Django, et je voulais apprendre à faire un modèle de base de données parent / enfant pour apprendre également cet aspect de Django. Il peut également être considéré comme un exemple d'application pour voir comment les fonctionnalités énumérées ci-dessous pourraient être implémentées dans Django.

Comprend:

• Forums, threads et messages (Répondre dans les fils)
• Abonnez-vous aux threads et recevez des notifications par e-mail
• Modèle d'utilisateur personnalisé (e-mail au lieu du nom d'utilisateur)
• Connexion éventuellement via le compte GitHub
• Profil utilisateur dans un modèle séparé de l'utilisateur
• vérification par e-mail
• Django Debug Toolbar (uniquement en développement)
• Fichiers Docker pour les conteneurs de spinning (Python et PostgreSQL)
• Tests de base pour les pages, les utilisateurs et les forums
• différents fichiers de paramètres pour le développement et la production
• style bootstrap de base
• API via le cadre Django Rest
• mise en cache avec redis
• E-mail Fitre de tâches avec céleri

Paramètres de production et de développement

Le fichier de réglage est divisé dans la production et les fichiers de paramètres de développement. Le projet a également un docker-compose.yml pour la production et un pour le développement. Dans les fichiers Docker-Compose, vous pouvez trouver le paramètre pour lequel les fichiers de paramètres à utiliser sur la commande RunServer. Pour rendre plus facile et moins à taper pour chaque commande, il y a un makefile avec différentes opérations communes.

Démarrage rapide

Remarque: Je n'ai pas testé ce projet en cours comme ci-dessous sur Windows ou Linux. Uniquement sur macOS.

1. Cloner ce référentiel

https://github.com/Joeriksson/django-forums-app.git

2. Installez Docker Desktop pour pouvoir utiliser l'environnement Docker.

3. Créez un fichier .env dans le dossier racine avec les paramètres suivants:

 SENDGRID_PASSWORD=<you sendgrid password>
SENDGRID_USERNAME=<your sendgrid username>
SECRET_KEY=<your secret key>
DEBUG=True
SENTRY_KEY=<your sentry key>
SENTRY_PROJECT=<your sentry project id>

Remarque: vous n'avez pas besoin d'un compte SendGrid lors de l'utilisation des paramètres de développement. Il envoie le courrier à la console par défaut. Vous pouvez simplement mettre des valeurs aléatoires pour celles-ci. Vous n'avez pas non plus besoin d'utiliser Sentry pour l'exploitation forestière. Commentez simplement les paramètres Sentry dans /settings/base.py.

3. Dans le répertoire où vous avez cloné le référentiel, exécutez la commande suivante:

make dev_build

4. Le conteneur devrait maintenant être opérationnel. Vérifiez votre navigateur que vous voyez une page Web Démarrer sur http://127.0.0.1:8080

5. Exécuter une migration pour construire les bases de données

make dev_web_exec cmd='python manage.py migrate'

6. Créez un super utilisateur de Django pour vous connecter à l'administrateur

make dev_web_exec cmd='python manage.py createsuperuser'

7. Goto les pages d'administration (voir URLS.py) et connectez-vous avec le compte super utilisateur que vous venez de créer.

Si vous souhaitez arrêter le conteneur Run:

make dev_down