Initial People app scaffold

gramps_online/settings.py

@@ -57,6 +57,7 @@
     'django.contrib.sessions',
     'django.contrib.messages',
     'django.contrib.staticfiles',
+    'people',
 ]
 
 if os.environ.get('DJANGO_USE_DEBUG_TOOLBAR'):

people/__init__.py

@@ -0,0 +1,17 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+

people/admin.py

@@ -0,0 +1,20 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from django.contrib import admin
+
+# Register your models here.

people/apps.py

@@ -0,0 +1,22 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from django.apps import AppConfig
+
+
+class PeopleConfig(AppConfig):
+    name = 'people'

people/migrations/0001_initial.py

@@ -0,0 +1,21 @@
+# Generated by Django 2.1.4 on 2019-01-20 17:38
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Person',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('private', models.BooleanField(help_text='Whether this person has been designated for limited distribution or display.')),
+            ],
+        ),
+    ]

people/migrations/0002_person_sex.py

@@ -0,0 +1,18 @@
+# Generated by Django 2.1.4 on 2019-01-25 19:08
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('people', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='person',
+            name='sex',
+            field=models.CharField(choices=[('female', 'Female'), ('intersex', 'Intersex'), ('male', 'Male'), ('unknown', 'Unknown')], max_length=8, null=True),
+        ),
+    ]

people/migrations/0003_name.py

@@ -0,0 +1,24 @@
+# Generated by Django 2.1.4 on 2019-02-02 22:08
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ('people', '0002_person_sex'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Name',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('type', models.CharField(choices=[('birth_name', 'Birth name'), ('married_name', 'Married name'),
+                                                   ('also_known_as', 'Also known as'),
+                                                   ('adoptive_name', 'Adoptive name'), ('formal_name', 'Formal name'),
+                                                   ('religious_name', 'Religious name')], max_length=255, null=True)),
+                ('person', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='people.Person')),
+            ],
+        ),
+    ]

people/migrations/__init__.py

@@ -0,0 +1,17 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+

people/models.py

@@ -0,0 +1,91 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from django.db import models
+
+class Person(models.Model):
+    """
+    A natural person,
+    modeled after GEDCOM X Person
+    http://www.gedcomx.org/v1/Person
+    """
+
+    # Choices for Person 'sex' field
+    # using 'sex' to conform to contemporary distinction of 'sex' and 'gender' while aligning with GEDCOM X 2.0 roadmap
+    # see: https://github.com/FamilySearch/gedcomx/issues/318
+    # https://github.com/FamilySearch/gedcomx/issues/319
+    SEX_FEMALE = "female"
+    SEX_INTERSEX = "intersex"
+    SEX_MALE = "male"
+    SEX_UNKNOWN = "unknown"
+
+    SEX_CHOICES = (
+        (SEX_FEMALE, "Female"),
+        (SEX_INTERSEX, "Intersex"),
+        (SEX_MALE, "Male"),
+        (SEX_UNKNOWN, "Unknown")
+    )
+
+    private = models.BooleanField(
+        help_text="Whether this person has been designated for limited distribution or display."
+    )
+    sex = models.CharField(
+        max_length=8,
+        choices=SEX_CHOICES,
+        null=True,
+    )
+
+
+class Name(models.Model):
+    """
+    Name of a natural person.
+    Modeled after GEDCOM X Name
+    https://github.com/FamilySearch/gedcomx/blob/master/specifications/conceptual-model-specification.md#name-conclusion
+    """
+
+    # GEDCOM X known name types
+    # https://github.com/FamilySearch/gedcomx/blob/master/specifications/conceptual-model-specification.md#known-name-types
+    TYPE_BIRTH_NAME = "birth_name"
+    TYPE_MARRIED_NAME = "married_name"
+    TYPE_ALSO_KNOWN_AS = "also_known_as"
+    TYPE_ADOPTIVE_NAME = "adoptive_name"
+    TYPE_FORMAL_NAME = "formal_name"
+    TYPE_RELIGIOUS_NAME = "religious_name"
+
+    NAME_TYPE_CHOICES = (
+        (TYPE_BIRTH_NAME, "Birth name"),
+        (TYPE_MARRIED_NAME, "Married name"),
+        (TYPE_ALSO_KNOWN_AS, "Also known as"),
+        (TYPE_ADOPTIVE_NAME, "Adoptive name"),
+        (TYPE_FORMAL_NAME, "Formal name"),
+        (TYPE_RELIGIOUS_NAME, "Religious name"),
+    )
+
+    person = models.ForeignKey(
+        Person,
+        null=False,
+        on_delete=models.CASCADE,
+    )
+    type = models.CharField(
+        max_length=255,
+        choices=NAME_TYPE_CHOICES,
+        null=True,
+    )
+    # TODO: determine how best to model the date field
+    # https://github.com/FamilySearch/gedcomx/blob/master/specifications/conceptual-model-specification.md#conclusion-date
+
+# TODO: add NameForms model

people/tests.py

@@ -0,0 +1,20 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from django.test import TestCase
+
+# Create your tests here.

people/views.py

@@ -0,0 +1,20 @@
+#  Gramps Online - an online version of the Gramps genealogy program
+#
+#  Copyright (C) 2018-2019 Brylie Christopher Oxley
+#
+#  This program is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Affero General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Affero General Public License for more details.
+#
+#  You should have received a copy of the GNU Affero General Public License
+#  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from django.shortcuts import render
+
+# Create your views here.