Commit 533f17

2025-11-15 16:17:05 Hargata Softworks: x
vehicles/collaborators.md ..
@@ 50,10 50,32 @@
Household members differ from collaborators in that they automatically inherit vehicles from their head of household and their permissions are more limited than a full collaborator.
+ Collaborators are vehicle-specific whereas a household member is user-specific.
+
Head of Households must be full collaborators of the vehicle in order for their household members to access the vehicle.
- ## Managing Households
+ ### Managing Households
Every user has a household that they can manage
![](/Vehicles/Collaborators/a/image-1763222741115.png)
+
+ Users can add users to their household and set their roles which determines their permissions
+
+ ![](/Vehicles/Collaborators/a/image-1763222863061.png)
+
+ There are three roles:
+
+ - Viewer: Read-only permisisons
+ - Editor: Add and edit records
+ - Manager: Add, edit, and delete records
+
+ Household members cannot delete or manage collaborators for a vehicle inherited from their head of household.
+
+ Users can be members of multiple households, if there are different roles for the same vehicle across multiple households, they will have the permissions of the greater role. I.e.: if the household for `test` and `test2` can both access the same vehicle but `test` only granted Viewer role to `test3` whereas `test2` granted Manager role to `test3`, `tets3` will have permissions from the Manager Role.
+
+ Household members only inherit vehicles from their direct head of household. If their head of household is a household member of another user, the users do not inherit those vehicles. I.e.: `test3` is a member of `test` household, but `test` is a member of `test4` household, `test3` does not inherit vehicles from `test4`
+
+ #### Root User Household
+
+ Root users cannot have their own household by design as a household that can automatically view every vehicle created in the system is a security risk. Root users must create a separate user and add that new user as a collaborator to the vehicles before adding other users to their household.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9