Birthday-Meet

Video Demo: https://youtu.be/cdIPjaSaYcE

Description:

Github Repository: https://github.com/AG2048/Birthday-Meet/

Have you ever had the thought of meeting someone who shares your birthday, but it just seems impossible to meet anyone like that?

Well, Birthday Meet is the solution to that problem! With this online social platform, you can easily find other people who share your birthday and send message to them to make new friends!

This website uses flask.

Home Page:

href="/" index.html

In the home page, the user will be seeing a brief description of this website and the logo, along with two buttons to Register and Log in.

All pages other than Home Page, Register, and Log in require user to be logged in.

Register:

href="/register" register.html

This page allows user to register a new account with username, password, and a birthday. This page will redirect user to Overview after registration.

Log In:

href="/login" login.html

This page allows user to log in to an existing account with username and password. This page will redirect user to Overview after log in.

Overview:

href="/" after log in overview.html

This page displays user's basic information (username and birthday), along with some status information (number of unresponded friend requests, number of unread messages, number of potential friends to be added)

Explore:

href="/explore" after log in explore.html

This page displays all the potential friends to be added (other users with the same birthday as user that are not user's friend, and user have not yet sent a friend request), and allows user to send friend requests to them (with optional request message).

There is a default request message if the user did not enter a request message.

If there are no potential friends, it will display a different message.

Requests:

ref="/requests" after log in requests.html

This page displays all unresponded friend requests that is directed to the user. The user may accept (which adds the sender to user's friend list) or ignore (the request is deleted, and the sender may send another request)

If there are no requests, it will display a different message.

Friends:

ref="/friends" after log in friends.html

This page displays a list of the user's friends' usernames.

If the user have no friends, it will display a different message.

Messages:

ref="/messages" after log in messages.html

This page displays a list of all messages directed to user, and allows user to mark an unread message read

This page also includes two buttons to direct users to Send and Sent.

If the user has not received any message, it will display a different message.

Send:

ref="/send" after log in send.html

This page allows user to select one of user's friends to send a message.

If the user has not sent any message, it will display a different message.

Sent:

ref="/sent" after log in sent.html

This page displays a list of all messages sent by user, displays if the message is read or unread.

This page also includes two buttons to direct users to Send and Messages.

Contact Us:

ref="/contact" after log in contact.html

This page allows user to send a message to the developers of the website, which can only be read by accessing the database file.

Only 1 message is allowed per day per user to prevent spam.

Non-HTML Files:

styles.css:

A file that includes certain classes not included in the bootstrap library

app.py:

This is the core file of the entire website.

The main functionality of this file is to respond to every GET request and POST request. For every POST request, the code also verifies if the request is "legal" and doesn't break the website (such as sending request to a non-existing user, accepting request from a user with different birthday, sending messages to another user who's not a friend, etc.). At the same time, the code stores information into birthday-meet.db

This code also sends "flash()" messages and error messages to the HTML files.

birthday-meet.db:

This database file stores the following tables:

• users A table that stores all the users' info
  • id Integer
  • username Text
  • hash Text, the hash of the user's password
  • month Integer, the month of the user's birthday
  • day Integer, the day of the user's birthday
• requests A table that stores all the requests
  • id Integer, id of the request
  • sender_id Integer, id of the user who sent this request
  • receiver_id Integer, id of the user who is receiving this request
  • request_message Text, the request message
  • when_sent Date, the date of when the request is sent
• friends A table linking two users
  • user_1_id Integer
  • user_2_id Integer
• messages A table of messages sent between users
  • id Integer, id of the message
  • sender_id Integer, id of the user who sent this message
  • receiver_id Integer, id of the user who is receiving this message
  • message_text Text, the text of the message
  • when_sent Date, the date of when the message's sent
  • is_read Bit, 0 for unread message, 1 for read message
• contact_messages A table of messages sent to the website's creator
  • id Integer, id of the message
  • sender_id Integer, id of the user who sent the message
  • message_text Text, message itself
  • when_sent Date, date of when the message is sent

BirthdayMeetText.png:

Picture of a fancy "Birthday Meet" text. Used in the navigation bar.

logo.png:

A picture containing the letters "B", "M" and the candle and egg in the "Birthday Meet" text. Used in home page and webpage icon.