> ## Documentation Index
> Fetch the complete documentation index at: https://docs.a7manager.se/llms.txt
> Use this file to discover all available pages before exploring further.

# Users and Projects

> Superuser-only administration.

Two administration pages, visible only to superusers. They are the one part of the
application that is **not scoped to the selected project** — the project picker in the header
has no effect here, because these pages are what create and populate projects in the first
place.

## Projects

The full list of projects, with create and edit.

A project has a name, an optional description, and an active flag. **Projects are never
deleted** — they are deactivated, so their history stays intact.

## Users

The global list of user accounts. Available actions:

| Action             | What it does                                                         |
| ------------------ | -------------------------------------------------------------------- |
| Add user           | Creates an account                                                   |
| Edit user          | Name, email and account details                                      |
| Edit project roles | Grants and revokes [roles](/platform/projects-and-roles) per project |
| Reset password     | Forces the user to set a new one at next sign-in                     |
| Change password    | Sets one directly                                                    |
| Toggle superuser   | Grants or removes platform-wide administration                       |

### Granting access

Access is granted as a **role within a specific project**. A user can hold different roles in
different projects, and several roles in the same project — in which case their capabilities
are the sum of those roles.

<Note>
  Most roles are narrow. A Warranty Manager cannot see inspections, and an Inspector cannot see
  warranty claims. Someone whose job spans two areas needs **both roles assigned**, or they will
  find sections missing from the sidebar rather than merely locked.

  See [Projects and roles](/platform/projects-and-roles) for what each role allows.
</Note>

<Card title="Field reference" icon="table" href="/data/tables/projects-and-users">
  `project`, `user_project_role` and `users_user` — every column and constraint.
</Card>

### Superuser versus Project Admin

These are different things and it is worth keeping them apart:

* **Project Admin** is complete authority *inside one project*, granted per project like any
  other role. A Project Admin cannot grant Project Admin to anyone else.
* **Superuser** is a flag on the account itself. It applies platform-wide, and it is what
  creates projects and user accounts.