django forums app

Django论坛

基于Django框架的示例论坛应用程序。我构建了这个应用程序以更多地了解Django，我想学习如何进行父/子数据库模型，以了解Django的这一方面。它也可以看作是一个示例应用程序，可以查看如何在Django中实现下面列出的功能。

包括：

• 论坛，线程和帖子（在主题中回复）
• 订阅线程并获取电子邮件通知
• 自定义用户模型（电子邮件而不是用户名）
• 可选地通过GitHub帐户登录
• 与用户单独模型中的用户配置文件
• 电子邮件验证
• Django调试工具栏（仅在开发中）
• 用于旋转容器的Docker文件（Python和PostgreSQL）
• 页面，用户和论坛的基本测试
• 不同的设置文件进行开发和生产
• 基本的引导样式
• API通过Django REST框架
• 用redis缓存
• 电子邮件任务队列与芹菜

生产和开发环境

设置文件在生产和开发设置文件中分配。此外，该项目还有一个docker-compose.yml生产，一个用于开发。在Docker-Compose文件中，您可以在RunServer命令上找到要使用的设置文件的参数。为了使每个命令键入更轻松，更少，有一个具有不同常见操作的makefile。

快速开始

注意：我尚未测试Windows或Linux上以下设置此项目的设置。仅在MacOS上。

1. 克隆这个存储库

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

2. 安装Docker桌面，以便能够使用Docker环境。

3. 使用以下参数在根文件夹中创建.ENV文件：

 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>

注意：使用开发设置时，您不需要SendGrid帐户。默认情况下，它将邮件发送到控制台。您可以为这些值添加一些随机值。另外，您不需要使用Sentry进行记录。只需在 /settings /base.py中评论哨兵设置即可。

3. 在克隆存储库的目录中，运行以下命令：

make dev_build

4. 现在应该启动容器并运行。在浏览器中查看您在http://127.0.0.1:8080上查看启动网页

5. 运行迁移以构建数据库

make dev_web_exec cmd='python manage.py migrate'

6. 创建DJANGO超级用户登录到管理员

make dev_web_exec cmd='python manage.py createsuperuser'

7. 获取管理页面（请参阅urls.py），并使用您刚创建的超级用户帐户登录。

如果要停止运行容器：

make dev_down