Role-Based Guides

Because Bambu is a B2B SaaS, a single "User Guide" is insufficient. A cashier interacts with the system vastly differently than the system SuperAdmin.

End Users (Cashiers / Sales Staff)

Common Tasks:

  • Ringing up sales at the POS.
  • Attaching customers to checkout carts.
  • Looking up product variants.

Permissions:

  • Only have access to Products, POS, and Customers.

Daily Workflows:

  • Opening their shift. Log into the system and ensure the POS terminal loads.
  • Completing a Sale.
  • Directing customers to pay via Cash/Card/Credit.

Mistakes to avoid:

  • Forgetting to select "Credit" when a known customer leaves with items but hasn't handed over cash. This will throw off the daily till.

Admins (Store Owners / Managers)

Common Tasks:

  • Reviewing Analytics and charts.
  • Restocking low inventory out-of-band.
  • Managing Subscriptions and Billing (Owners only).

Permissions:

  • Full system read/write access to their specific Tenant Schema. Cannot access any other business.

Daily Workflows:

  • Approving "Discrepancy" logs.
  • Triggering the End-of-Day closing flow.
  • Using the AI assistant to summarize weekly sales.

Best Practices:

  • If an item's cost price changes frequently, average the cost out when restocking or use the latest invoice standard to maintain margin accuracy.

Developers

Common Tasks:

  • Building new features.
  • Extending the Prisma Tenant Schema.
  • Supporting Vercel / Docker environments.

Permissions:

  • Full repository access. Requires direct DB URL to run Prisma migrations.

Mistakes to avoid:

  • Writing prisma.product.findMany() instead of tenantPrisma(req).product.findMany(). Failing to inject the tenant schema context will crash the request or return zero results.

Support Team (Bambu HQ)

Common Tasks:

  • Resetting passwords via Magic Links.
  • Checking system status / error logs using Sentry.
  • Manually triggering Stripe Webhook syncs for stuck payments.

Permissions:

  • SuperAdmin boolean set to true on the User object. Grants access to an internal cross-tenant dashboard routing.

Workflows:

  • If an Owner complains their account is paused, verify their Subscription object in the global database schema. Support staff CANNOT run queries inside a business-xxx tenant schema natively for privacy reasons.