daltz333 / cosc-481w Goto Github PK

Implementation for #5. We need the hexadecimal color code to send to the API/database.

We should standardize on the following now.

• Primary Color
• Secondary Color
• Logo
• Name of the sponsoring company
• Licensing

We need mockups on how the GUI should look. The following features should be thought about.

1. What is the first screen that we display to the user?
   • It should be simple, we cannot assume any behavior by the user.
2. What kind of screens do we need?
   • Do we need a settings page?
     • Could be used for forcing a clear of the cache from the database.
   • Color-picker GUI?
   • Camera button/GUI?
   • Interface for showing the closest match grout and purchase link

Figma is great for prototyping UI's in. https://www.figma.com/

Mostly relies on #11 and #10, but it can pretty much be completed by using a sample JSON listed in the aforementioned issues.

Basically, the backend needs a function that takes a given hexadecimal string, asks the API for the information regarding it, and then returns the object representing the API response.

We might not be able to find a canned solution, so one possible thought would be.

1. Show image on page.
2. Request user to tap where the grout is on the picture
3. Grab the X/Y position of the tap, convert to coordinates on the image.

What needs to be done?

• Is the above possible? Is there an easier way?
• Pseudo code or PoC

Relies on #6

• Button to open camera to take a picture, this should be saved into the memory of the android application somewhere
• Button to open an existing photo

There might even be an android API that does both of these. I remember seeing applications.

This is just a brainstorming issue tracker for feature planning and breakdown of features. We should create individual issues with assignees for who is the lead on a given issue.

Utilizing OpenCV: https://answers.opencv.org/question/171376/how-to-find-pixels-with-coordinates-specified-color-values/

What needs to be done?

Pseudo (or proof of concept) code for grabbing hexadecimal color for a specific region. For PoC, we can hardcode this.

Basically, a HTTP server that accepts the following parameter

myip:443/api/v1/grout?hex=FFFFFF

where hex is the hexadecimal return. the output should be a JSON response similar to the following

{
   "color": "FFFFFF",
   "uri": "https://google.com"
}

if the request is invalid, we should return http error code 400.

The language can be w/e. Java/C#/Python/React/etc the developer is comfortable with.

Company name is THP

https://developer.android.com/distribute/marketing-tools/brand-guidelines

Ideally high resolution, like 1024x1024

Decide on three colors for the app, update any components existing to use those 3 colors

This can be done in a google sheet for now, but we basically need.

• Hex Color Code
• URI to purchase
• URI of image of product?

I personally like Figma for UI mockups, but whatever can be used, or it can be directly implemented.

Basically, we need a UI that is simple and clear to the user what the intent of our application is. That intent being a tool to take pictures of grout, and offer purchase suggestions.

This assumes #3 is done. This is the actual tracking issue for putting information in the database and testing queries.

• Create table that contains the following
  • Hexadecimal color code
  • URI to webpage to purchase grout

Ensure it works by running a few queries on it. If we want to be really fancy, we can make it read only since clients should never need to modify the database.

This is my rough thoughts on the matter, but we should clarify the requirements and design a database schema.

What needs to be done:

• Schema (what possible API calls would need to be done)
  • e.g. to grab a list of colors and uris would be GET myurl.com/api/v1/colors/
• Database Setup (maybe create the necessary tables)
  • I have a small cheap server I could give SSH access to if someone wants to experiment with

Here are some tasks to familiarize with the development environment (Android and Git)

1. Commit a test.txt file to the root of this repository. This file can contain whatever text you like. Bonus brownie points if you use a different branch, and then pull request it. DO NOT, use the website for this (defeats the purpose)
2. Run the repository in Android Studio
3. Easy: Add a button to the screen, when the user clicks on the button, increment a number on the GUI by one.
4. Medium: Add a recycleview (or whatever Android calls a list of data), this recycleview should have a list of text, can be any text