Role filters for groups

To implement nomad-gui#61 in the new GUI, we need a filter specifically for the owner. The same scheme should work for other role that may be added later, e.g. viewer, editor, manager.

Proposals

1. {'member': 'USERID1'}, {'owner': 'USERID1'}, ({'manager': 'USERID1'}, etc.), backwards-compatible {'user_id': 'USERID1'}
2. {'member': [{'user_id': 'USERID1', 'role': 'owner'}, {'user_id': 'USERID2', 'role': 'reviewer'}]} (connector AND or OR?)
3. {'user_id': 'USERID1', role: 'owner'} (simpler but less specific, role doesn't make sense on its own)

For now, the query for GraphAPI has the same filters as the query for GET /groups. At least for proposal 2 this cannot be done anymore. Should these features be dropped for REST or should we add POST /groups/query or something similar (POST /groups is currently used to create a new group)?

added API label

changed the description

@mscheidg I'm not currently working on this but it needs a decision medium-term. Do we already have an overarching concept for filter parameters and end points?

Sidenote: As far as I see, we don't use PATCH but we do use PUT in a few places, and we use POST {type}/{id}/edit instead of POST {type}/{id}. Is there a reasoning behind that, are we following a certain design pattern?

I think HTTP would be the same if it just had GET/POST/DELETE.

Since there are no operations in rest; you can only CRUD resources. Therefore, we do stuff like POST something/edit or POST something/query with the meaning to create an operation as a "temporary" resource like query or edit. Otherwise, we try to use PUT when updating.

With this in mind, you could say POST something/edit could also be PUT something. But, since the body of the POST is not the something itself, but rather an edit operation that only describes how to change something, we decided to use the POST something/edit pattern.

Discussion in the GUI meeting on 2025-01-16 point towards option 1, i.e. staying close to the MongoDB model instead of using an (so far) virtual role field.