Logging in & roles¶
DepoViz has two separate front doors. Staff (your depot's own employees — gate clerks, yard supervisors, billing team, admins) log into the main application at the depot's staff URL, using an account created under Settings → Users. Customers and shipping lines log into a separate self-service Portal, using an account that must be invited by an admin under Settings → Portal Users — there is no self-registration on either side. The two logins are entirely independent: a staff account never grants portal access, and a portal invite never grants staff access. If a person needs both (rare — e.g. a depot employee who is also testing the customer-facing view), they need two separate accounts with two separate emails.
Before you start¶
- Nothing — this is the first thing every user encounters. If you're setting up the depot for the first time, see Overview & order of setup for what to configure once you're in.
Walkthrough¶
Staff login and the sidebar¶
Once logged in, staff see a left sidebar with these groups:
- Dashboard — a single link, no sub-items.
- Operations — Gate, Yard, Containers, Orders.
- Commerce — Shipping Lines, Customers.
- Inventory — parts/stock (a single link).
- Finance — Billing, Reports.
- Settings — a single link that opens the Settings sub-navigation (Organisation, Finance, Communications, Operations, Work Orders, Integrations, System — see Overview & order of setup).
Every sidebar group and every item inside it is shown or hidden based on what your role is allowed to see — a group with no visible items for your role is hidden entirely, not shown greyed-out.
Role visibility¶
DepoViz has six staff roles:
| Role | Dashboard | Operations (Gate/Yard/Containers/Orders) | Commerce (Shipping Lines/Customers) | Inventory | Finance (Billing/Reports) | Settings |
|---|---|---|---|---|---|---|
| Admin | Yes | Full read/write | Full read/write | Yes | Full read/write | Full access |
| Manager | Yes | Full read/write | Full read/write | Yes | Billing/reports read + invoice approve | Read (operational settings) |
| Gate Operator | Yes | Gate/Yard/Containers read-write; no Orders | No | No | No | No |
| Yard Operator | Yes | Containers/Gate read, Yard read-write; no Orders | No | No | No | No |
| Billing | Yes | Containers read only | Customers read + billing-write | No | Full — invoices, tariffs, payments, reports | No |
| Viewer | Yes | Read-only: Containers, Gate, Yard, Orders | Customers read only | No | Reports read only | No |
A few things worth calling out:
- Admin is the only role with unrestricted access — it sees and can do everything, including every Settings page.
- Manager can read Settings (operational settings like charge codes, email templates, alert rules), but the Settings section as a whole is only visible to Admin and Manager — Gate Operator, Yard Operator, Billing, and Viewer never see the Settings link at all.
- Gate Operator and Yard Operator are both operational-floor roles: neither can see Commerce, Finance, or Settings, and neither can approve orders.
- Billing is the inverse of the floor roles — full billing/invoicing/tariff/payments access, read-only on containers, and no gate or yard write access at all.
Global Search¶
The search box in the top bar searches across the whole system and only ever returns four types of result: Containers, Customers, Gate Passes, and Shipping Lines. It does not search Orders, Invoices, Work Orders, or any Settings data — for those, use the relevant list page's own filters instead.
Portal login¶
Portal contacts sign in at a separate URL and see only their own organisation's data, scoped to either a Customer or a Shipping Line — never both, and the scope is fixed when the admin sends the invite (see Users & portal access). See Customer Portal and Shipping Line Portal for what each scope actually sees.
Related pages¶
Who can access this¶
Every authenticated user sees the sidebar filtered to their own role — there is no separate "access roles page" permission; this page just documents what the product already enforces automatically in the interface (and independently enforces behind the scenes as the real authority).