Snack Bot - Revision history

Lskaling: /* Technical */

2024-01-05T19:46:41Z

Technical

← Older revision		Revision as of 19:46, 5 January 2024
Line 42:		Line 42:

	An SQL database stores the snack credits. They are differentiated into two segments: free credits and earned credits. Free credits are used before earned credits, as free credits do not roll over. This is abstracted to the user with a single credit number. When a user invokes any command for the first time, they are added to the database with the free snacks.		An SQL database stores the snack credits. They are differentiated into two segments: free credits and earned credits. Free credits are used before earned credits, as free credits do not roll over. This is abstracted to the user with a single credit number. When a user invokes any command for the first time, they are added to the database with the free snacks.

			Because of confusion with the package manager, there are two virtual environments. Venv was used on my mac for testing, snackbotvenv is used on the Raspberry Pi. The latter is excluded from github.

			Snack-bot is located in the home directory of the Pi. Do not move, as the directory is hard coded in the startup execution.

	The Raspberry Pi is set up to run the script upon booting, so it is resilient against power outages.		The Raspberry Pi is set up to run the script upon booting, so it is resilient against power outages.

	The password to SSH into the raspberry pi is stored in Dashlane.		The password to SSH into the raspberry pi is stored in Dashlane.

Lskaling at 19:35, 5 January 2024

2024-01-05T19:35:35Z

← Older revision		Revision as of 19:35, 5 January 2024
Line 44:		Line 44:

	The Raspberry Pi is set up to run the script upon booting, so it is resilient against power outages.		The Raspberry Pi is set up to run the script upon booting, so it is resilient against power outages.

			The password to SSH into the raspberry pi is stored in Dashlane.

Lskaling at 07:06, 1 January 2024

2024-01-01T07:06:43Z

← Older revision		Revision as of 07:06, 1 January 2024
Line 1:		Line 1:
	Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You'll need to spend a few minutes tidying the workspace, then you can redeem a snack. Here are possible ways to fulfill the requirement:		Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You'll need to spend a few minutes tidying the workspace, then you can redeem a snack. Here are possible ways to fulfill the requirement:

	=== Cleaning ~~options~~ ===		=== Cleaning Ideas ===

	* Put away tools left out on a table		* Put away tools left out on a table
Line 24:		Line 24:
	The expectation is that cleaning lasts at least 2 minutes, and makes a noticeable change to the workspace. Cleaning a mess you made does not count, and should benefit others in the club (i.e. not a box that only you use).		The expectation is that cleaning lasts at least 2 minutes, and makes a noticeable change to the workspace. Cleaning a mess you made does not count, and should benefit others in the club (i.e. not a box that only you use).

	For accountability, when you send a photo it gets uploaded to #snackbot-pics. Anyone is allowed to join this channel and see what others have cleaned. If someone believes a photo was taken without cleaning, it can be flagged with the :x: emoji, and it will be sent to the workspace managers for review.		For accountability, when you send a photo it gets uploaded to #snackbot-pics. Anyone is allowed to join this channel and see what others have cleaned. If someone believes a photo was taken without cleaning, it can be flagged with the :not-clean: emoji, and it will be sent to the workspace managers for review.

			== Workspace Managers ==
			Additional functionality is available to those in the #workspace-core private channel:

			=== <code>/workspace-add-snack-credits</code> ===
			Adds snack credits to the users tagged in the slash command. Multiple users can be added with any or no delimiter. Add a number, 1-9, at the beginning or end of the command to specify the number of snack credits; it otherwise defaults to one.

			=== <code>/workspace-unlock-snack-cabinet</code> ===
			Unlock the snack cabinet for 5 minutes. Intended to be used to restock the snack cabinet.

			=== <code>/workspace-refresh-snack-credits</code> ===
			Resets all free snack credits to 2. Intended to be used at the start of the quarter. Snack credits granted through photo upload or /workspace-add-snack-credits are not affected by this. Free snack credits do not roll over if unused, though.

	== Technical ==		== Technical ==
	The slack bot is run locally on a Raspberry Pi, using a Python script. Lawton maintains the Slack API access. When the button is pressed, a solenoid on the ~~cooresponding~~ .		The slack bot is run locally on a Raspberry Pi, using a Python script. Lawton maintains the Slack API access. When the button is pressed, a solenoid is actuated on the corresponding cabinet.

			An SQL database stores the snack credits. They are differentiated into two segments: free credits and earned credits. Free credits are used before earned credits, as free credits do not roll over. This is abstracted to the user with a single credit number. When a user invokes any command for the first time, they are added to the database with the free snacks.

	The ~~raspberry pi~~ is set up to run the script upon booting, so it is ~~resiliant~~ against power ~~outtage~~.		The Raspberry Pi is set up to run the script upon booting, so it is resilient against power outages.

Lskaling at 20:25, 31 December 2023

2023-12-31T20:25:37Z

@@ Line 1: / Line 1: @@
-Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You are expected to spend a few minutes tidying the workspace, then can redeem a snack. Here are possible ways to fulfil the requirement:
+Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You'll need to spend a few minutes tidying the workspace, then you can redeem a snack. Here are possible ways to fulfill the requirement:
 === Cleaning options ===
@@ Line 15: / Line 15: @@
 == Usage ==

Lskaling: Created page with "Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You are expected to spend a few minutes tidying the workspac..."

2023-12-31T19:56:29Z

Created page with "Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You are expected to spend a few minutes tidying the workspac..."

New page

Snack Bot is a Slack Bot that incentives workspace cleaning by giving snacks to those who share proof of cleaning. You are expected to spend a few minutes tidying the workspace, then can redeem a snack. Here are possible ways to fulfil the requirement:

=== Cleaning options ===

* Put away tools left out on a table
* Repair a broken 3D printer
* Sweep floor
* Organize a bin
* Remove scraps from around 3D printers
* Clean the whiteboard
* Clean the break room
* Organize cable storage rack
* Replenish low workspace consumables (solder, wire, fasteners, etc)
* Tidy downstairs

== Usage ==