## Help

## 1. Concept: Models & relationships ### a. People

A person can have 1 biological father (1 person, based on father_id)
A person can have 1 biological mother (1 person, based on mother_id)
A person can have 1 set of parents, biological or not (1 couple of 2 people, based on parents_id)
A person can have 0 to many biological children (n people, based on father_id/mother_id)
A person can have 0 to many partners (n people), being part of 0 to many couples (opposite or same biological sex)
A person can be part of a couple with the same partner multiple times (remarriage or reunite)

### b. Couples

A couple can have 0 to many children (based on parents_id as a couple or father_id/mother_id individually)
A couple can be married or not, still together or separated in the meantime

## 2. Authentification, multi-tenancy and data accessibility ### a. Users Menu

Users can register themselves.
At least a surname, a valid e-mail address, a language, a timezone and a password are required.

After registration and optional e-mail verification, users can login.
Login

Authenticated users, without invitation, by default belong to (and own) their own personal team.
New users, after accepting an invitation by email from another user and registering, by default will be logged in to the team they were invited to. Those users by default also have their own personal team at their disposal. Team

Two Factor Authentification (2FA) and E-mail Verification can be enabled and configured in config/fortify.php. ### b. User account and profile Authenticated users can manage their account and user profile by using the dropdown menu in the top right-hand corner of the menu bar. Profile settings

### c. Teams This application uses Laravel Jetstream with the Teams option to implement and enforce multi-tenancy. Authenticated users can manage their teams and teams settings by using the dropdown menu in the top right-hand corner of the menu bar. Team settings

Users can manage either their personal team or create new teams.
The personal team and all teams created by a user are also owned by that user.
Only the owner can invite other (new or already registered) users (by e-mail) to join the owned teams.
The owner can transfer the team ownership to another team member. A notification e-mail will be send to the new owner. The previous owner will become Administrator. Team management

Create a new and separate team for each family tree you want to manage and invite other users to it.

Do not use your personal team for building family trees because the ownership of peronal teams can NOT be transferred to another team member.

By assigning users the proper role you can define the rights they have in the selected team. Authenticated users can only see people and couples:

created by the teams they own themselves
created by the teams they were invited to by the team owner as either Administrator, Manager, Editor or Member

### d. Roles & permissions

Role	Model	Permissions
Administrator	user	create, read, update, delete
	person	create, read, update, delete
	couple	create, read, update, delete
Manager	person	create, read, update, delete
Manager	couple	create, read, update, delete
Editor	person	create, read, update
Editor	couple	create, read, update
Member	person	read
Member	couple	read

## 3. Search Menu

After login and selecting the proper team, click on the Search button in the top navigation menu. Search

Enter search values in the search box.
Above the search box, the number of people available to / found in the current team are shown.
Tips:

The system wil look up every single word in the search value in the attributes surname, firstname, birthname and nickname.
Begin the search string with % if you want to search parts of names, for instance : %Jr.
Be aware this kinds of searches are slower.
If a surname, firstname, birthname or nickname containes any spaces, enclose the name in double quoutes, for instance : "John Fitzgerald Jr." Kennedy Kennedy.

The results are shown in a grid below the search box. Each person is represented in one card.
You can use the pagination buttons to navigate. You can also change the number of people shown per page. Menu

Click on the Profile or Family chart button to see details about that person.
Click on the father's or mother's name to visit the parents.

## 4. Adding people ### a. New person After login and selecting the proper team, click on the Search button in the top navigation menu. Search

You can add a new person by clicking the Add person button above the search bar.

### b. New person being a father or mother Another way to add people is to click on the Add father or Add mother tab in the Family context menu of an existing person.
These options are only available if the existing person doesn't have a father or mother yet.

You can either create a brand NEW person or select an EXISTING person as the person's new father or mother.

### c. New person being a partner Another way to add people is to click on the Add relationship tab in the Partners context menu of an existing person.

You can either create a brand new person or select an existing person as the person's new partner.

### d. New person being a child A last way to add people is to click on the Add child tab in the Children context menu of an existing person.

You can either create a brand new person or select an existing person as the person's new child.

## 5. Persons and relationships ### a. Profile The personal overview shows all information about the selected person. Person overview

The navigation bar on top allows you to chose some specific items. Person menu

The Profile card shows all general information about the person. Profile deceased

Notice this card shows different data for living and deceased people. Profile living

You can edit the profile, contact and death data by choosing the corresponding tab in the context menu. Profile edit

### b. Events You can edit the custom events by choosing the corresponding tab in the context menu. Profile edit

You can add, edit or delete events. Edit event

### c. Photos Photo editing

You can browse through the available photos by using the navigation bar above the photo carousel.
You can manage photos by choosing the corresponding tab in the context menu. Profile edit

You can upload (multiple) new images.
You can download or delete existing images.
After deleting the primary photo, the first image in the collection wil become the new primary photo.
You can also set the primary image by clicking the Star button. ### d. Family The Family card shows the person's parents and the current partner. Family

Father and Mother are always referring to the biological father and mother.
Non-biological parent can be defined by the Parents link. You can edit the family data by selecting the Edit option in the family context menu.
In case the person's father or mother are not yet known, you can add or edit them directly in the family context menu. Family edit

### e. Partners (Couples)

You can add, edit or delete a relationship by choosing the corresponding tab in the context menu.
When deleting a relationship, the ex-partner stays in the collection as a separate person.
Under normal circumstances, you should only delete relationships when entered by mistake.
You can end every exiting relationship by setting the relation as ended, with or without specifying the end date. Partners add

When adding a partner you can either create a brand new person or select an existing person as the new partner.

### f. Children

You can add a child or disconnect existing children by choosing the corresponding tab in the context menu.
The disconnected child will remain in the database as a person but just not have the selected person as father or mother anymore. Child add

When adding a child you can either create a brand new person or select an existing person.

### g. Siblings Siblings are shown on the siblings card.

A sibling can be full: both the same biological parents as the selected person.
A sibling can be half: only the biological mother or the biological father are common. [1/2]
A sibling can be plus: neither the biological father nor the biological mother are common, but the child is part of the current relationship of the selected person [+] ### h. Files This Files card shows the files attached to the person.
You can use this feature to attach documentation. Files

You can upload (multiple) new documents.
You can specify the source of the documents you want to upload.
You can rearrange the order of the documents by clicking the Up or Down buttons.
You can download documents by clicking the Download button or open them in a seperate window by clicking on the document icon.
You can delete a document by clicking on the Delete button. ### i. Ancestors This shows the selected person's ancestors.
You can change the tree depth by using the control in the Ancestors card header.

### j. Descendants This shows the selected person's descendants.
You can change the tree depth by using the control in the Descendants card header.

### k. Family chart This shows the compleet family chart, 3 generations deep.
Click on a family member name to see that person's family chart.

### l. Timeline This shows the persons timeline including fixed events like birth, death (own and children) and relationships combined with all custom events like baptism, military service, ...

### m. Datasheet This shows the datasheet of the selected person.
You can use this to print an overview.

### n. History This shows the history of the selected person.
History

## 6. Birthdays After login and selecting the proper team, click on the Birthdays button in the top navigation menu. Menu

This shows the upcomming birthdays.

## 7. Offcanvas menu Users can click a button in the top right-hand menu to open the offcanvas menu.
On top the users role and permissions in the current team are shown.
If a user has the proper rights, additional features are presented.

### a. Team The offcanvas menu allows all users to consult the active team and the corresponding logbooks for Team/Users and People/Couples. Team

### b. Teams & people The offcanvas menu allows developers to consult all teams and people. Teams

### c. Users & logging The offcanvas menu allows developers to consult the users and their logging information. Users

### d. Settings The Settings menu item allows developers to manage Logging settings.

### e. Backups The Backups menu item allows developers to manage database backups. Backups

### f. Log viewer The Log Viewer menu item allows developers to consult the application log files.

### g. Dependencies The Dependencies menu item allows developers to consult the application dependencies.

### h. Session The Session menu item allows developers to consult the application session. Session

## 8. Language & Timezone ### a. Visitors Visitor can change the language in the top right-hand menu by using the language selector.
De default application language is English. Language menu

### b. Authenticated users Authenticated users can change the language and the timezone in the top right-hand menu by using the profile editor.
The selected language and timezone are saved in the database.

## 9. Color theme Users can change the color theme in the top right-hand menu by using the theme icon.
The default application theme is Dark mode. Theme selector