django forums app

Foros de Django

Una aplicación de foros de muestra basada en el marco Django. Construí esta aplicación para aprender más a Django, y quería aprender a hacer un modelo de base de datos para padres/hijos para aprender también ese aspecto de Django. También se puede ver como una aplicación de ejemplo para ver cómo las características enumeradas a continuación podrían implementarse en Django.

Incluye:

• foros, hilos y publicaciones (respuesta en hilos)
• Suscríbase a los hilos y reciba notificaciones por correo electrónico
• Modelo de usuario personalizado (correo electrónico en lugar de nombre de usuario)
• Opcionalmente, inicie sesión a través de la cuenta GitHub
• Perfil de usuario en un modelo separado del usuario
• verificación por correo electrónico
• barra de herramientas de depuración de Django (solo en desarrollo)
• Archivos de Docker para recipientes giratorios (Python y PostgreSQL)
• Pruebas básicas para páginas, usuarios y foros
• Diferentes archivos de configuración para el desarrollo y la producción
• estilo básico de bootstrap
• API a través del marco de descanso Django
• caché con Redis
• cola de tareas de correo electrónico con apio

Configuración de producción y desarrollo

El archivo de configuración se divide en la producción y los archivos de configuración de desarrollo. También el proyecto tiene un Docker-Compose.yml para la producción y otro para el desarrollo. Dentro de los archivos Docker-Compose, puede encontrar el parámetro para el que el archivo de configuración se utilizará en el comando runServer. Para que sea más fácil y menos escribir para cada comando, hay un archivo de make con diferentes operaciones comunes.

Comienzo rápido

Nota: No he probado la configuración de este proyecto como se muestra a continuación en Windows o Linux. Solo en macOS.

1. Clon este repositorio

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

2. Instale Docker Desktop para poder usar el entorno Docker.

3. Cree un archivo .env en la carpeta raíz con los siguientes parámetros:

 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>

Nota: No necesita una cuenta SendGrid al usar la configuración de desarrollo. Envía correo a la consola por defecto. Puede simplemente poner algunos valores aleatorios para ellos. Además, no necesita usar Sentry para registrar. Simplemente comente la configuración de Sentry en /settings/base.py.

3. En el directorio donde clonó el repositorio, ejecute el siguiente comando:

make dev_build

4. El contenedor ahora debe estar en funcionamiento. Visite su navegador que ve una página web de inicio en http://127.0.0.1:8080

5. Ejecutar una migración para construir las bases de datos

make dev_web_exec cmd='python manage.py migrate'

6. Cree un usuario Django Super para iniciar sesión en el administrador

make dev_web_exec cmd='python manage.py createsuperuser'

7. Got de las páginas de administración (consulte URLS.py) e inicie sesión con la cuenta de Super Usuario que acaba de crear.

Si desea detener el contenedor de ejecución:

make dev_down