Getting-Started Guide · 2026

Issue ticketing across organizations

One ticketing fabric. Every agency in its own room.

This guide is for teams adopting portablemind's cross-organization issue ticketing: a service provider — Istonish, in our running example — supporting software applications used by many State Agencies.

It covers three things: what the solution is, why it works the way it does, and how each person on your team uses it day to day.

Three isolated agency workspaces each file issues that flow automatically to the provider workspace, which acknowledges, fixes, and reports back. Agency A Private workspace · its own issues only Agency B Private workspace · its own issues only Agency C Private workspace · its own issues only EVERY ISSUE, AUTOMATICALLY Provider — Istonish Sees and administers every agency's issues Acknowledge · prioritize · link fix work Merge duplicates · publish to agencies ONE QUEUE, EVERY AGENCY AGENCIES NEVER SEE EACH OTHER'S ISSUES — UNLESS THE PROVIDER PUBLISHES ONE

Each agency files and tracks issues in its own private workspace; the provider automatically receives and works all of them.

01What it is

A shared ticketing system that respects boundaries.

Employees report issues against the software applications they use. Their agency sees its own issues; the provider sees them all. Four building blocks make that work.

Agency workspaces

Every agency gets its own private workspace. Its employees, its issues, its data — invisible to every other agency, automatically.

isolation by structure

Provider intake

Every issue an agency files flows to the provider the moment it's created — no forwarding, no export. The provider works one queue across all agencies.

automatic, standing

Applications & Programs

Each software application (and the Program it serves) is a Project the provider owns. Agencies are granted access to exactly the applications they're entitled to.

provider-owned master data

Issues that drive work

An issue names its application, carries priority and status, and can link to the fix task — so reporters see Planned → In progress → Shipped without asking.

from report to roadmap
02Why it works this way

Five decisions, made for you.

The design choices below came out of the refinement with Istonish. Each one favors something structural over something you'd otherwise have to police with rules and memos.

  1. 01

    Isolation is structural, not a setting

    An agency is a workspace, not a folder with permissions. Nothing to configure, nothing to get wrong — another agency's issues simply do not exist in your view.

  2. 02

    Acknowledgement, not another status

    A reporter can delete an issue until the provider acknowledges it. After acknowledgement, the provider administers it. One timestamp settles ownership without complicating the status workflow.

  3. 03

    Merging never destroys

    When the same defect is reported twice — even by two different agencies — the duplicates are linked to one canonical issue and closed. Nothing is deleted, so a merge can be reviewed and reversed.

  1. 04

    Publishing is deliberate — and honest

    The provider can make one issue visible to any set of agencies (a known-issue notice, a shared defect). A published issue shows its full content, including who reported it — visibility is explicit, never accidental.

  2. 05

    Visibility can narrow to Programs — when you want it

    By default, everyone in an agency sees all of that agency's issues. If an agency prefers employees to see only the Programs they belong to, that's a per-workspace switch — off until you ask for it.

  3. ·

    The common thread

    Every rule that matters — who sees what, who may delete, who owns an issue — is enforced by the platform itself, not by convention. Your auditors will like that as much as your users do.

03How to use it

Day to day, by role.

Three roles touch the system: agency employees who report issues, agency admins who run their workspace, and the provider team that works the queue.

Agency employees — report & follow

  1. File an issue. Open Tickets → New issue, describe the problem, and pick the Application it concerns. The picker only offers applications your agency has been granted — you can't file against the wrong one.
  2. Follow it. The issue's status and roadmap chip (Planned / In progress / Shipped) update as the provider works the fix. Use the issue's chat to add detail or answer questions.
  3. Filed by mistake? You can delete your issue any time before the provider acknowledges it. After that, ask the provider — it's theirs to administer.

Agency admins — run your workspace

  1. Manage your people. Create and deactivate your employees' accounts yourself — no ticket to the provider needed.
  2. Manage Program membership. Open an Application (Project) → Members tab to add or remove your employees, choosing the role that describes them — Standard Team, Leadership, or View Only. Membership matters when per-Program visibility is on — see the next two sections.
  3. Mind the boundary. You can see the applications the provider granted you and manage your own people on them — the application definitions themselves stay with the provider.

Provider team — work the queue

  1. Acknowledge new issues to take ownership. This is the moment the reporting agency loses delete rights — make it your triage habit.
  2. Prioritize and link the fix. Set priority, then link the issue to the task that will fix it. The task's progress drives the roadmap status the reporter sees.
  3. Merge duplicates. Same defect, many reports? Pick the canonical issue and merge the rest into it — across agencies too. Duplicates close but survive, so merges are reversible.
  4. Publish when many agencies are affected. Make one issue visible to a chosen set of agencies. Remember: a published issue shows full content, including the reporter.
Read this twice

Members and Assignments are not the same thing.

Two project concepts sound alike and get confused constantly. They answer different questions, live in different places, and only one of them affects what an employee can see.

Project → Members tab

Members

Who belongs to this Application or Program.

  • Answers: “who can see this Program's issues?” (when per-Program visibility is on)
  • Managed by agency admins for their own employees, on each granted Application's Members tab
  • Has an active window — a lapsed membership stops counting
  • Says nothing about who is doing any work

Tasks → assignees

Assignments

Who is working on which task, and when.

  • Answers: “who is doing this work?” — task-by-task staffing and allocation
  • Managed by whoever runs the work — typically the provider's team on fix tasks
  • Drives workload, time tracking, and planning views
  • Has no effect on which issues anyone can see

Members decide who can see. Assignments decide who does the work. Neither one implies the other.

Why the distinction matters: when your agency turns on per-Program visibility, an employee's view of the ticket queue is defined entirely by Program membership. Assigning someone a task does not let them see the Program's issues, and adding a member does not put them to work. If someone "can't see a ticket they should," check the Members tab — not the task's assignees.

Membership comes in three roles.

When you add a member, you pick the role that best describes them. The role is a label for people — it says what someone is on the team, so the member list reads like an org chart instead of a flat list.

team · standard

Standard Team

A working member of the project or Program — the everyday role, and the default when you add someone.

team · lead

Leadership

Marks who runs the project or Program — the person to ask, the name reviewers and approvers look for.

team · observer

View Only

Someone who follows the project without actively contributing — a stakeholder, a sponsor, an auditor.

One thing all three share: each one makes the person a member, and any active membership — whatever its role — is what grants issue visibility when per-Program visibility is on. The role describes the person; it does not add or remove project permissions.

Optional · per agency

Turning on per-Program visibility.

Off by default — every agency starts with agency-wide visibility, and nothing changes until you opt in. When you do, employees see only the Programs they're members of.

Step 1 · Ask

Request the switch for your workspace from your provider or platform contact. It's a per-agency setting — your choice never affects other agencies.

Step 2 · Add members

Before it goes live, have your admin add each employee to the Programs they work with — Application → Members tab. Anyone not yet a member of a Program stops seeing that Program's issues the moment the switch flips.

Step 3 · Verify

Spot-check as an employee: the ticket list should show only their Programs' issues (plus any issue not linked to an application, which stays visible to everyone in the agency).

The fine print: matching is strict — even an issue an employee filed themselves disappears from their view if they're not a member of its Program. Issues with no application link remain visible to the whole agency. The provider's view is never affected. And issues shared directly with a person stay visible regardless.

Quick start

The first week, on one page.

For the provider

  1. Create your Applications — one Project per application/Program you support.
  2. Invite each agency as a partner; their workspace is created when they accept.
  3. Grant access — share each Application with the agencies entitled to it (view access is all they need).
  4. Confirm intake — have the agency file a test issue and watch it arrive in your queue.
  5. Adopt the habit: acknowledge on triage, link fix tasks, merge duplicates, publish known issues.

For each agency

  1. Accept the partnership invite and set up your workspace admin.
  2. Add your employees — accounts are yours to manage, self-service.
  3. File a test issue against a granted Application; confirm the provider sees it.
  4. Decide on visibility — stay agency-wide, or opt into per-Program visibility.
  5. If opting in: add Program members first, then request the switch, then spot-check.

File the first issue. The rest follows.

Everything in this guide is live in your workspace today. Your portablemind contact can walk your team through any of it — or just start with one test ticket and watch it flow.