Genealogy

About this project

Genealogy is a free and open-source (family tree) application to record family members and their relationships, build with PHP (Laravel 11).

This TallStack application is build using :

Logic concept

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)
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

Requirements

At least PHP 8.2, supporting Laravel 11.
At least MySQL 8.0.1 or MariaDB 10.2.2 or an equivalent database, supporting Recursive Common Table Expressions.

License

This project is open-sourced software licensed under the MIT license.

Demo

https://genealogy.kreaweb.be/

This demo has 2 family trees implemented, BRITISH ROYALS and KENNEDY.

E-mail	Password	Purpose
administrator@genealogy.test	password	to view teams BRITISH ROYALS and KENNEDY as team owner
manager@genealogy.test	password	to view team BRITISH ROYALS as manager
editor@genealogy.test	password	to view team KENNEDY as editor
member_1@genealogy.test	password	to view team BRITISH ROYALS as normal member
member_4@genealogy.test	password	to view team KENNEDY as normal member
developer@genealogy.test	password	to view options reserved for the developer, like the user management and access to all persons in all teams

Features

Light/Dark theme
Fully responsive
Multi-language, English, Dutch and German already implemented, language setting saved in authenticated users profile
Multi-timezone, timezone setting saved in authenticated users profile
Multi-tenancy by Jetstream Teams
Security through Jetstream Teams Roles & Permissions, 2FA & API can be enabled
Offcanvas menu
Multiple image upload with possibility of watermarking, photo carousel with navigation

Special features

This application has a built-in Backup Manager :

Backups can be initiated and managed manually
Backups can be scheludeld by issuing a cron job on your development or production server
An e-mail will be send after each backup

This application has a built-in Log Viewer, on demand showing :

INFO : All scheduled backups
DEBUG : All executed database queries, but only in local development mode
DEBUG : All executed requests
WARNING : All detected N+1 queries, but only in local development mode
ERROR : All detected errors

This application has a built-in User management & logging, available to the developer :

User statistics by country of origin
User statistics by year, month, week or day

To Do ...

GEDCOM import and export (help gladly accepted).

Techniques

Both the ancestors and descendants family trees are build using Recursive Common Table Expressions (Recursive CTE). This prevents the N+1 query problem generating the recursive tree family elements and dramatically improves performance.

Installation

create a new project folder, cd into the folder

git clone https://github.com/MGeurts/genealogy.git .

cp .env.example .env

make the needed changes regarding name, url, database connection & mail server

composer install

php artisan key:generate

php artisan storage:link

php artisan migrate:fresh --seed

npm install & npm run build

php artisan serve or npm run dev

Docker Installation

cp env.docker .env

run following command to initialize project

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php83-composer:latest \
    composer install --ignore-platform-reqs

run docker containers

./vendor/bin/sail up -d

./vendor/bin/sail artisan key:generate

./vendor/bin/sail artisan storage:link

./vendor/bin/sail artisan migrate:fresh --seed

./vendor/bin/sail npm install & npm run build

./vendor/bin/sail artisan serve or npm run dev

Testing

php artisan test

Contributing

Feel free to submit Issues or Pull Requests, for bugs, suggestions or feature requests.

Documentation

The documentation is included in the applications help. Visit the demo project to read the documentation.

Sponsoring

If you like this project, please consider giving it a star and spread the word. Thank you.

Impressum

Basic idea (2017)

This application is based on an original idea by Nafies Luthfi. Thanks for your excellent work.

Design & Development (2024)

This Laravel application is designed and developed by kreaweb.be.

iPublicis/genealogy