Requirements for PressBoxx Desktop & Pro setup program

[mikeschinkel]

1. Implement setup program in Go language.

2. Run setup program on host computer. This is only needed for desktop and pro, not for go.

3. Setup program connects to PressBoxx via Bluetooth LE.

4. Setup program requests type of PressBoxx over BTLE: desktop, go or pro

5. If first time connection then setup program ask the user if the PressBoxx should be access controlled. If user requests access control then:

   a. User provides email address and admin password

   b. If host IP is static then user selects choice of IP address or MAC address, otherwise MAC address is assumed.

   c. Host setup program then sends email address, password and access control choice via BTLE to PressBoxx.

   d. PressBoxx accepts the email address, admin password and access control by MAC address or IP address.

   e. PressBoxx submits the email address and admin password in order to create an online account for this PressBoxx. If the email address already has an account and the admin password for the account does not make the admin password for the PressBoxx then the PressBoxx requests the account password from the host setup program via BTLE so that the PressBoxx website can add this PressBoxx to the account.

6. If PressBoxx not connected via Ethernet:

   a. Host setup program presents user with list of available WiFi access points and allows user to select or lets user type in the name of the access point and host setup program sends the access point name to the PressBoxx via BTLE.

   b. PressBoxx attempts to connect to access point. If a password is required PressBoxx requests the password from the host via BTLE and the host setup program asks the user to provide the password which the host setup program sends back to the PressBoxx using BTLE.

   c. One the PressBoxx connects to the access it returns the DHCP-served IP address via BTLE to the host setup program.

   d. The host setup program then asks the user if they would like to use a static IP address and if so presents a form that asks for IP, netmask, gateway, and two DNS servers but prefills all fields with values assigned by DHCP so that user only needs to change the ones they want to change.

   e. If the user requested to change to a static IP address the host setup program sends the new connection info to the PressBoxx via BTLE and the PressBoxx changes the connect information and returns success or failure. If failure the host setup program reports the error and allows the user to re-edit the connection info or switch back to using DHCP. This continues on until success is reported back by PressBoxx to host setup program via BTLE.

7. Once PressBoxx has a verified working connection — WiFi or Ethernet — then the host setup program loads pressbox.local in the host's default browser and allows the user to login using the admin password for which an option to auto-login to pressbox.local is provided as a checkbox unless no admin password was set in which case no login will be required.

Needed

We need a method to allow the user to recover from a forgotten admin password. Not sure the best approach for this. My router allows me to set a reset button but there is no similar button for the RPi3.

One option might be to allow recovery via an online account that would have the ability to email a time limited reset code that would allow unlocking the box.