Dashboard

Complete or Dismiss the Store Setup Checklist

The dashboard checklist shows only setup work that Posnic can prove is still incomplete from current shop data; completing a card changes real configuration, while Dismiss only hides the reminder on that device.

Menu path
Home -> Dashboard -> Let's finish setting up your store
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

frontend/modules/dashboard.html checklist strip, cards and Dismiss control, frontend/static/script/js/modules/js/dashboard.js SETUP_CARDS, live loading and device-local dismissal, api/src/controllers/dashboard.controller.js getSetupChecklist database completion rules, demo.posnic.io checklist observed on 2026-09-08

Live store setup checklistOnly incomplete checks are shown. Select a card to open its real setup screen, or Dismiss to hide this strip on the current device without completing anything.

Read the Checklist Before Dismissing It

  1. Open Home -> Dashboard and wait briefly for the checklist to load above the outlet card.
  2. Read every visible card. Posnic omits checks already satisfied by current data.
  3. Select one card to open the related setup page; the card itself does not save or create a record.
  4. Complete and save the real form using the detailed guide linked for that workflow.
  5. Return to Dashboard and allow the checklist to reload. The completed card should disappear when its database condition is true.
  6. Repeat until no cards remain. The entire strip hides automatically when all five checks are complete.

Exact Completion Rules

Checklist cardPosnic marks it complete whenCard destinationDetailed guide
Set up your outlet infoThe current branch has both a nonblank store address and telephone.Current branch edit pageEdit Branch and Outlet Details
Add your first itemsAt least one non-instant item exists for the current branch and licence.Items -> NewCreate an Item
Add your logoThe current branch image is present and is not the default store.png image.Current branch edit pageEdit Branch and Outlet Details
Add your employeesMore than one user exists for the licence.Manage -> UsersCreate an Employee User
Set up taxesAt least one tax-group record exists for the current branch and licence.Settings -> TaxCreate and Manage Tax Groups

Important Meaning of Each Check

  • Outlet info checks only address and telephone. It does not prove that receipt address, email, currency, time zone, tax identity or every branch field is ready.
  • First items excludes instant Quick Sale records. A temporary sale description does not count as a configured catalog item.
  • Logo checks for a non-default branch image. It does not prove that the image is sharp, correctly cropped or readable on the printed receipt.
  • Employees is licence-wide and counts users, not whether every employee has the correct role, branch access, PIN or training.
  • Taxes checks for a branch tax group. It does not prove the rate, components, item assignments or legal tax treatment are correct.
  • A missing card means its narrow database condition is satisfied, not that the wider workflow has passed owner review.

What Dismiss Actually Does

Dismiss stores setup_checklist_dismissed=true in Posnic's local storage and immediately hides the strip. It does not write a completion flag to the shop database, change any checklist condition or hide the reminder on every till.

  • Dismiss only on a device where the owner accepts losing this reminder.
  • Another browser profile, private window, cleared app data or separate desktop till can still show the checklist.
  • Completing setup after dismissal still changes the underlying shop data normally; only the reminder remains hidden on that local profile.
  • The current interface has no Show setup checklist again button and does not automatically clear the dismissal preference when a setup condition later becomes incomplete.
  • Do not clear all browser or desktop app data casually to restore one reminder; local data can include other till preferences and session state.

Permissions and Branch Scope

SituationWhat the operator may seeCorrect action
Cashier sees a setup card but cannot edit its destinationThe dashboard check is visible, while the target module is permission-controlled.Ask an administrator to complete or assign the specific setup task; do not share an admin login.
One branch shows outlet or logo workOutlet and logo checks use the currently selected branch.Edit that branch, then return to its dashboard context.
Items differ by branchThe item check requires a non-instant item accessible to the current branch.Create or assign a real item to that branch.
Employee card disappears for all branchesThe employee count is licence-wide rather than branch-specific.Still review each user's actual branch access and role.
Tax card remains in one branchTax groups are checked for the current branch and licence.Create or verify the group in that exact branch context.

Troubleshoot the Setup Checklist

SymptomLikely causeAction
Checklist never appearsIt is complete, locally dismissed, still loading, or the setup request failed.Verify the five real records directly. Do not infer completion only from an absent strip.
A saved card remains visibleIts exact completion condition is still false or the dashboard has not reloaded.Check the rule in this page, confirm branch context, then reopen Dashboard.
Outlet card remains after adding an addressTelephone is blank.Save both store address and telephone for the current branch.
Item card remains after Quick SaleInstant items are excluded from the check.Create or assign a normal catalog item to the branch.
Logo card remains after uploadThe branch still references store.png or the upload was not saved.Reopen branch edit, verify the saved preview and test the receipt.
Checklist was dismissed by mistakeThe local dismissal preference is set and there is no restore control.Complete the five checks through their normal modules. Ask support before clearing local application data solely to restore the strip.
Tax card disappeared but sales tax is wrongThe check proves only that a group exists.Audit tax components, rates, defaults and item assignments before trading.