Actions

Website and Tools

From Annapolis Makerspace Wiki

Revision as of 17:20, 10 November 2026 by Gryffyn (talk | contribs) (Created page with "= Annapolis Makerspace — Tools & Features Overview = ''This page is meant to be kept up to date as tools are added, changed, or removed. It is written in MediaWiki markup so it can be pasted directly into a wiki page.'' ''Last major revision: 2026-11-10. Public/member-facing features are listed first in each section; admin/staff-only features are segregated into their own subsection at the bottom.'' __TOC__ == Member Portal — members.makeannapolis.org == The...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Annapolis Makerspace — Tools & Features Overview

This page is meant to be kept up to date as tools are added, changed, or removed. It is written in MediaWiki markup so it can be pasted directly into a wiki page.

Last major revision: 2026-11-10. Public/member-facing features are listed first in each section; admin/staff-only features are segregated into their own subsection at the bottom.

Member Portal — members.makeannapolis.org

The main self-service site every member logs into. Handles account/billing and is the home base for day-to-day access (door unlock, dashboard widgets).

Member Features

  • Login / Forgot Password / Reset Password — account access; a member whose account hasn't been set up yet (no password set) is prompted to finish setup via email.
  • Dashboard — one landing page after login showing:
    • Next billing date
    • Upcoming machine reservations (linked to the Reservations tool)
    • Open ShopStatus trouble tickets you've reported
    • My Training Requests — your own requests to be trained on a trainer-backed machine, with status
    • Training (as a trainer) — shown only if you're a qualified trainer for at least one machine: pending requests you can accept, sessions you've accepted, and your own upcoming availability
  • Unlock Door (mobile only) — geofenced button that remotely triggers the same 5-second door-strike pulse as badging in at the door, for members in good standing (active billing, waiver signed, orientation complete). Includes a 15-second cooldown to prevent spamming.
  • CNC / Laser remote activation — buttons exist on the dashboard for members with CNC/Laser access, but are currently disabled/stubbed pending on-site firmware testing (not live yet).
  • Billing page — view your Stripe subscription(s) and self-service cancel (cancellation takes effect at the end of the current paid period, not immediately).

Admin Features (members.makeannapolis.org)

  • Super Admin Settings page — one Super-Admin-only role, layered above the regular member/admin flags. Lets a Super Admin edit, without touching server files:
    • Email sending (SocketLabs) credentials
    • Particle (door/CNC/laser hardware) credentials
    • amsproxy integration URL
    • Geofence coordinates/radius used by the Unlock Door feature
    • Stripe API key
    • (The core database connection and encryption key never move out of the server config — everything else does.)

Staff Tools — tools.makeannapolis.org

A staff-only companion site to the Member Portal — nothing here is public or member-facing, it's all admin/staff tooling, so it's listed as one block rather than split into member/admin sections.

  • Member Search & Management — search all members by name/email, filter to "no RFID tag yet," and toggle Waiver/Orientation/CNC/Laser permission flags directly.
  • Member Detail / Cancel — pull up one member and immediately cancel their subscription (not deferred like the member's own self-service cancel), with an optional full or prorated refund. Requires typing "CANCEL" to confirm.
  • Stripe Stats Dashboard — revenue/subscription reporting charts, refreshed from a nightly sync job.
  • Settings page (Super Admin) — shares the same Super-Admin-tier Settings concept as the Member Portal's, for this app's own settings.

ShopStatus — shopstatus.makeannapolis.org

Equipment status, maintenance requests, and materials tracking for the shop floor.

Member Features

  • Equipment List & Status — browse all tools/equipment and see current status (in service / out of service) at a glance, grouped by category.
  • Equipment Detail Page — status, open maintenance history, and a "Training Required" badge where applicable, for one piece of equipment.
  • Report a Problem — flag equipment as out of service and describe the issue, with photo upload.
  • Equipment QR Label / Placard — scan a QR code on a machine to jump straight to its status/report page.
  • Materials Catalog — browse available shop materials and view detail on a specific material (code, quantity, etc).
  • Shop Care Log — log shop-care contributions (cleaning, tidying, restocking); contributes to a running "shop care points" tally shown on your own dashboard widgets.
  • Downtime Calendar — read-only month view of equipment downtime and scheduled-maintenance due dates.

Admin / Maintenance Features

  • Maintenance Dashboard — queue of open maintenance requests; assign to a maintenance person, add notes, resolve.
  • Return to Service — checklist-style confirmation when bringing out-of-service equipment back online; staff choose which outstanding requests to resolve along with it (not an automatic bulk-close).
  • Scheduled Maintenance / Dashboard Schedule — day-horizon table of upcoming scheduled maintenance tasks, with CSV export.
  • Print Labels — bulk-print QR labels/placards for multiple pieces of equipment at once.
  • Materials Dashboard — admin-wide view of material activity across all members.
  • Role tiers — per-member roles (maintenance / admin / super admin) control what a given staff member can do here; being a regular AMS member is not enough to even log in — access must be explicitly invited.
  • Settings page (Super Admin) — Slack webhook URL and SocketLabs email credentials for this app specifically.

Machine Reservations — reservations.makeannapolis.org

TeamUp-style booking calendar for 3D printers, laser, CNC router, sewing, and trainer-led orientation/training sessions.

Member Features

  • Reservation Calendar (month/week/day) — book time on a machine; see other members' bookings (color-coded per machine), with automatic conflict prevention.
  • My Reservations — your own upcoming/past bookings, with a cancel option.
  • Push Notifications — "your reservation is ending soon" alert with a one-tap "Extend 30 min" action (requires enabling notifications once).
  • Orientation / Training Request Calendar — a separate calendar showing when qualified trainers are available; pick an open slot to request hands-on training with that specific trainer. Separate from the above — this reserves the trainer's time, not the machine's.
  • My Training Requests — track your own pending/accepted/declined training requests, with the ability to cancel a pending one.
  • Automatic rules enforced behind the scenes: bookings auto-confirm within normal limits (block length / advance notice / how many active bookings you can hold); anything over those limits lands as "pending" for staff approval; CNC/Laser bookings are blocked entirely if you don't hold that tool's access grant; booking a machine ShopStatus currently shows as down/flagged asks you to confirm before proceeding instead of silently blocking you.

Trainer Features

  • My Availability — if you're a qualified trainer for a machine, set your own recurring weekly availability plus one-off date exceptions for accepting training requests.
  • Accept/decline training requests — any member qualified as a trainer for a machine can see and act on pending requests for it, no admin role required.

Admin Features

  • Approval Queue — reservations that exceeded a limit, or training requests awaiting a trainer's acceptance, all land here for staff/trainer action.
  • Manage Machines — per-machine booking limits and an active/inactive toggle. (Which machines/categories exist at all is actually driven by ShopStatus now — a machine becomes reservable there, and shows up here automatically.)
  • Manage Admins/Trainers — per-category roster: grant category-wide or per-machine Admin rights, and flag who's a qualified Trainer for which machines.
  • Per-category Slack notifications — each category (3D Printing, Laser, CNC, etc.) can post reservation created/edited/cancelled/deleted notices to its own Slack channel, configured by that category's owner.
  • Settings page (Super Admin) — SocketLabs email and the Web Push (VAPID) keypair used for the "ending soon" notifications above.

Access Control (Door / CNC / Laser hardware)

Not a website members browse to — this is the RFID badge/physical-access layer that runs in the background, tying into the Member Portal and Slack above.

Member-Facing

  • Badge swipe at the front door, CNC router, or laser cutter — a member's RFID tag is checked against their current billing/waiver/orientation status (and, for CNC/Laser, their specific tool access grant) before the door unlocks or the tool powers on.

Behind the Scenes / Staff Features

  • Remote Unlock Door from the Member Portal dashboard (see above) — goes through the exact same check a physical badge swipe would.
  • Slack bot (#tool-log → #membermgt) — watches the raw access-control event feed and, for anything staff needs to act on, posts interactive buttons to a private staff channel:
    • Unrecognized RFID tag → pick (or search for) the member it belongs to and assign the tag
    • Member denied CNC/Laser/Woodworking access → one-click grant (with a confirm step and an Undo button in case of a misclick)
    • After assigning a tag, automatically offers to mark Waiver/Orientation complete if either is still missing
    • Plain warning notices (no buttons) for "waiver not signed," "orientation" mentions, and "billing terminated" events
    • All interactive buttons auto-expire (replaced with a plain notice) after 5 minutes unanswered, so nobody can act on a stale prompt later
  • Waiver auto-matching — watches for SignNow's "document completed" emails, reads the signed PDF, and automatically marks Waiver Signed for the matching member; if the typed email doesn't match anyone exactly, posts a staff picker to Slack instead.
  • /accesscontrol Slack slash command — lock, unlock, reset, or pulse-trigger the door directly from Slack.