django-assignment-desk

django-assignment-desk是一个简单的Django应用，用于存储和管理每周的编辑人员分配。

它依赖于员工列表（例如，由django-editorial-staff提供的列表），并提供一个丰富的API，可以被任何数量的消费者查询（我们正在使用它来提供只读Web界面和聊天机器人）。

此应用使用django.contrib.postgres；因此，它需要PostgreSQL数据库和Python到Postgres适配器（如psycopg2或psycopg2-binary）才能运行。

稍后将添加更详细的文档。

快速入门

1. 安装此应用

    pip install django-assignment-desk
   

2. 将六个条目（四个辅助应用，“editorial_staff”和“assignment_desk”）添加到您的INSTALLED_APPS设置（在settings.py中）如下

   INSTALLED_APPS = [
       ...
       'django.contrib.humanize',
       ...
       'bootstrap3',
       'colorfield',
       'rest_framework',
       ...
       'editorial_staff',
       'assignment_desk',
   ]
   

   注意：如果您已经安装了django-editorial-staff，您可能已经在INSTALLED_APPS设置中有了这些条目。它们只需要列出一次。

3. 将以下行添加（或更新）到您的 settings.py 文件中（以配置表单渲染）

    BOOTSTRAP3 = {
        'field_renderers': {
            'default': 'bootstrap3.renderers.FieldRenderer',
            'inline': 'bootstrap3.renderers.InlineFieldRenderer',
            'immaterial': 'assignment_desk.field_renderers.ImmaterialFieldRenderer',
        },
    }
   

   注意： 同样，这些行只需列出一次。如果您已经有了类似的行，请用这里写的版本替换它们。

4. 按照以下方式将 editorial_staff 和 assignment_desk URLconfs 包含在项目的 urls.py 中

   url(r'^staff/', include('editorial_staff.urls')),
   url(r'^assignments/', include('assignment_desk.urls')),
   

5. 运行 python manage.py migrate 将数据模型安装到您的数据库中。

   注意： 如上所述，如果您不是使用 PostgreSQL 数据库，则此命令将失败。

6. 启动开发服务器，访问 http://127.0.0.1:8000/assignments/ 开始编辑作业。

配置

您可以在项目的 settings.py 文件中指定以下配置选项。所有选项都是可选的

前端开发

django-assignment-desk 前端页面使用 ES6 和 SCSS 构建，该应用程序包含一个 Gulp 安装，可以将这些方言编写的文件转换为纯 JavaScript 和 CSS。

在开发前端时，您需要自行运行此 Gulp 安装。按照以下步骤开始。

1. 打开终端窗口并导航到应用程序的根目录。

2. 在应用程序中，导航到 ./assignment_desk/staticapp。

3. 如果您是第一次在此项目上运行 Gulp，请运行 npm install 以安装 JS 依赖项。这可能需要几分钟。

4. 一旦安装了依赖项，请运行 gulp 以开始本地开发。

5. 当 Gulp 服务器表示已启动并运行时，请访问 http://127.0.0.1:3000/assignments/ 以预览前端文件。

6. 通过更改 ./assignment_desk/staticapp/scss/ 和 ./assignment_desk/staticapp/js/ 中的文件来继续修改前端界面。您的更改将自动应用到 Gulp 服务器 URL，无需手动重新加载页面。