bmcgonag/get_my repository overview

⁠Get My

Open source shopping / list app.

⁠NOTE:

If you were using this previously, the new updates change the data structure. Please remove your old database if you find odd behavior or errors. The data structures may simply be incompatible. I apologize for any inconvenince as I simplify the app a bit.

⁠Keeping it Simple

• Registration / Login System built in
• 1st user to register is the system admin by default.
• All other useers are added as "user".
• No serious permissions difference as of now other than system settings and user management for the system admin.
• Product Information Levels:
  • Products
    • Product Name
    • Store you most frequently buy it at (optional)
• Lists
  • Can be shared with other users to add items (green text)
  • Can be private for keeping your own list of things to buy or tasks to do.
  • Can be marked as complete and removed from view.
• List Items
  • Added to specific lists
  • Can be marked as
    • Ordered (crossed out on list, but visible)
    • Received (check mark icon to remove from visible list, but can be seen by selecting an option at the top of the list if needed.)
• Tasks
  • A simple todo list of tasks that can be made for yourself, or if you're an admin, for others on the system, and a due date can be assigned. No reminders, or push notifications, just open it, and look at your list of todos, then mark it complete when you finish one.
    • Add Todo Items
      • Add Due Date
    • Mark Items as Completed
    • See Overdue items in a different color (need an icond for this too)
• Menus
  • Create a Menu (we like to create one for a week or so, but you can create different Menus at the same time)
  • Add menu items to a simple menu list.
    • Name a Menu (e.g. Guisado, Beans, Rice, side-salad)
    • Pick a date to serve the item.
  • Dashboard shows the item for that day.
  • Shift the menu by 1 day with a simple click (we use this when we end up eating something else in the middle of menu week.)
• User Config
  • Dark Mode Preference
• System Config
  • Allow / Disallow Registration
  • Allow / Disallow System Admin registration

⁠What Get My Is

• a Simple Lists App

⁠What Get My Is Not

• a Reminders app with calendar / timer events.
• A full ERP / CRM for your home.
• A portal or interface to any shopping / eCommerce sit online.

⁠Built With

• MeteorJS
  • Blaze UI
• MongoDB
• Materialize-css

⁠To Run in Docker Compose

Create a new folder to keep the application in:

mkdir -p ~/get_my

Move into that folder, and create a new empty file named "compose.yaml":

cd get_my

nano compose.yaml

Copy the code below, and paste it into the new "compose.yaml" file, then save with CTRL + O, press Enter to confirm, and exit the editor with CTRL + X.

Start the application with:

docker compose up -d

Once started, you can access the web interface in a browser at the IP address of your host system, and port 80 (unless you changed 80 to a different port in the compose.yaml file).

---
services:
  get_my:
    container_name: get_my
    image: get_my
    ports:
      - "80:3000"    # you can change the left side to a less common port number if needed
    healthcheck:
      test: curl --fail -s http://localhost:3000/ || exit 1
      interval: 30s
      timeout: 10s
      retries: 3
    links:
      - mongo
    depends_on:
      - mongo
    restart: unless-stopped
  mongo:
    container_name: get_my-mongo
    image: mongo
    volumes:
      - ./data:/data/db    # this will store the application data in the same directory where you have the compose.yaml file.
    restart: unless-stopped

⁠License

MIT Copyright 2022 - Brian McGonagill

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.