django-assignment-desk

django-assignment-desk is a simple Django app to store and manage weekly editorial staff assignments.

It depends on a staff list (such as the one provided by django-editorial-staff), and returns a rich API that can be queried by any number of consumers (we're using it to feed both a read-only web interface and a chatbot).

More detailed documentation will be added at a later date.

Quick start

1. Install this app:

    pip install django-assignment-desk
   

2. Add "assignment_desk" to your INSTALLED_APPS setting like this:

   INSTALLED_APPS = [
       ...
       'assignment_desk',
   ]
   

3. Include the assignment_desk URLconf in your project urls.py like this:

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

4. Run python manage.py migrate to install the data models into your database.

5. Start the development server and visit http://127.0.0.1:8000/assignments/ to start editing assignments.

6. Visit http://127.0.0.1:8000/assignments/api/ to explore the app's REST API.

Front-end development

django-assignment-desk front-end pages are built using ES6 and SCSS, and this app includes a Gulp installation that converts files written in these dialects to plain JavaScript and CSS, respectively.

When developing on the front-end, you'll need to run this Gulp installation yourself. Follow these steps to get started.

1. Open a terminal window and navigate to the root of this app.

2. Within the app, navigate to ./assignment_desk/staticapp.

3. If this is your first time running Gulp on this project, run npm install to install JS dependencies. This may take several minutes.

4. Once your dependencies are installed, run gulp to begin local development.

5. When your Gulp server says it's up and running, visit http://127.0.0.1:3000/assignments/ for a live preview of your front-end files.

6. Proceed to modify your front-end interface by changing files in ./assignment_desk/staticapp/scss/ and ./assignment_desk/staticapp/js/. Your changes will be applied to the Gulp server URL without the need for to reload the page manually.