ttxking / ku-polls

Web application for conducting online polls and surveys.

Kasetsart Polls

Web application for conducting online polls and surveys.

Project Documents

Vision Statement
Requirements
Iteration 1 Plan
Iteration 2 Plan

ku-polls's Issues

Adding related objects

10 mins - register Choice object

Creating the Polls app

10 mins - create polls app

User not clear

Your requirements are mostly good, but the word "user" isn't clear.
In some cases you mean someone who views or votes on a poll.
In others you mean someone who creates a poll question.

Use different words for these 2 cases, or clarify in requirement.
In some requirements you wrote "web visitor" as alternative term for user.
That would be OK.

The development server

5 mins - run server

Customize the admin form

15 mins - registering the Question model

Improve Security

remove the value of SECRET_KEY and DEBUG from settings.py and put their values in a .env file

Restrict vote

• Restrict each authenticated user to 1 vote per poll
• Only authenticated user can vote

Amend URLconf and views

15 mins - change urlpatterns and use Django’s generic views

Creating an admin user

5 min - create a username, email and password for admin user

User authentication

User authentication will be done using the username-password backend ModelBackend.

Add two methods for Question class

is_published returns true if the current date is on or after question’s publication date
can_vote returns true if voting is currently allowed for this question

Database Setup

10 mins - set up the database using SQLite

Add logging

• user login or logout. An “info” level log message, including username and IP address.
• unsuccessful login attempt (username or password incorrect). a “warning” log message, including username entered and IP address.
• user submits a vote for a poll. “info” log message including username and poll id voted on (but not choice id).
• all log messages should include the date and time
• log to the console,
• use loggers

Customize app

20 mins - style the application with CSS sheet

Improve the index page

• show all published poll questions.
• sort them so that the newest questions are first

Running test

5 mins - run all test on the command line

Update unit tests for new method

Create unit tests for is_published and can_vote

Improve navigation

• On the polls index page, add “vote” and “results” links for each question. Only show “vote” link for a poll where voting is allowed.
• On the polls detail page, add a “Back to List of Polls” link so website visitors can go back without voting.
• On the voting results page, also add a “Back to List of Polls” link.

Add an end_date attribute for the Question class

In the Question class, add an end_dateattribute that is the ending date for voting

Redirect web visitors to the polls index page and show an error message

If someone navigates to the polls detail page for a poll where voting is not allowed, redirect them to the polls index page and show an error message (using Django Messages Framework)

What's a poll?

Still some not clear items about "poll" or "survey" or "question",
and whether the opening/closing date apply to all the questions
or individual questions.

I posted on Google Classroom about this, since it something
everyone should do.

Write the first view

10 min - write the first view of the project

Write a minimal form

20 mins - update views and HTML page

Edit README.md

add iteration2 plan to README.md

Writing more views

30 mins - add detail, results and votes

Refractor unit tests

Divide tests into separate files, and grouped them according to functionality

Merge two branches

10 mins - merge master and iteration1

Create an iteration2 branch

Creating a project

5 mins - create a Django project

Keep track of votes of each poll for each user

Keep track of who has voted for which poll by changing the models.py.

Activating Model

15 mins - Create a database schema, Create a Python database-access API for accessing Question and Choice objects

Customize the admin look and feel

15 mins - customize project’s templates and application’s templates

Use Generic Views

10 mins - use generic view for index, detail and results

Creating Model

15 min - create two models (Question and Choice)

Create comprehensive tests

30 mins - write a test for question model, index and view.

Improve appearance of voting results page

Make the votes align in a column, omit the word “votes” after the count and remove the bullets