Over the course of this workshop,

we're going to be learning about channels by adding a real time dashboard

to a Django project.

This is the kind of addition that channels makes possible and

which can allow you to start super charging your Django products.

Let's take a quick tour of what we'll be doing by looking at our finished project.

So we've started with an existing Django project,

we're tracking how members of city council voted on each measure.

It's a pretty simple app since the focus of the workshop is channels,

not Django itself.

Due to this will just add a modifier data through the admin

set of building any sort of crowd features in the app.

Let's look at what we have available here.

Now a project has one app the votes app and the votes app has two models votes and

voters, or rather vote and voter, because the admin pluralizes this.

So we go look at the voter page we can look at say Mayor Adamson, and

we see that we have a name which is the person's last name,

and we have a title which would be their position on city council.

And now that we have some voters, we can also look at the votes.

So let's actually add a new vote.

So at the top of the vote we list the issue.

So this would be like a proposal number or pave Lombard Street or whatever.

And then we have which category it belongs to and

you can add more of these in the model's .py if you need to, and

then you can choose who voted yes and who voted no for that particular vote.

And if we look at our finished dashboard here, we'll see that there is a listing of

each council member and how they voted on particular categories.

If we open up the admin interface in another window,

which we conveniently already have open, and we add a new issue.

So let's say this is issue number 89 and it is for Housing.

And Mayor Adamson and Tompkins, and

Perez, all voted yes, but Bello voted no.

And then let's save this one.

And we can see that the vote counts updated in real time.

Now, behind the scenes, our browser in the window where we've loaded the dashboard,

has opened a web connection to our Django project running with channels.

When we save a vote, we're firing an event that channels picks up and

routes a special event handling code to that channels calls a consumer.

The consumer gets the message and send some data over the website,

gets the connection back to the browser.

The JavaScript in the browser then updates the dashboard.

If any of this seems confusing or like magic now,

it should get clearer as we dive into the code.

In the next video will start getting our hands dirty by installing and

configuring the channels package.