Lyo.People.Models 1.0.1

Lyo.People.Models

People and person-related models for the Lyo library suite.

Archetype A (Lyo domain). Vendor ingest (e.g. Lyo.Endato.Client) is Archetype C; map into people.* in the host. See package layout.

Examples

Usage

using Lyo.People.Models;
using Lyo.People.Models.Contact;
using Lyo.People.Models.Enum;
using Lyo.People.Models.Extensions;

var person = new Person
{
    Id = Guid.NewGuid(),
    Name = new PersonName
    {
        FirstName = "Jane",
        LastName = "Smith",
        PreferredName = "Janey"
    },
    EmailAddresses =
    {
        new ContactEmailAddress
        {
            Type = ContactEmailType.Personal,
            IsPrimary = true,
            EmailAddress = new EmailAddress { Email = "jane@example.com" }
        }
    }
};

// Person instance helpers (primary / by-type / current selectors)
var primaryAddr = person.GetPrimaryAddress();
var workAddr = person.GetAddressByType(ContactAddressType.Work);
var primaryPhone = person.GetPrimaryPhoneNumber();
var mobilePhone = person.GetPhoneNumberByType(ContactPhoneType.Mobile);
var primaryEmail = person.GetPrimaryEmailAddress();

// PersonExtensions (typed convenience wrappers + verification checks)
var homeAddress = person.GetHomeAddress();
var workEmail = person.GetWorkEmail();
var personalMail = person.GetPersonalEmail();
var hasValidMail = person.HasValidEmail(); // true when any current email has VerifiedAt set
var hasValidTel = person.HasValidPhone(); // true when any current phone has VerifiedAt set
var currentJob = person.GetCurrentEmployment();
var activeRels = person.GetActiveRelationships();

// PersonName formatting
var initials = person.Name.GetInitials();
var formatted = person.Name.GetFormattedName(NameFormat.Formal);
var display = person.Name.DisplayName; // PreferredName ?? FullName

Overview

This package provides domain models for representing people, their contact information, relationships, employment history, and preferences. It integrates with Lyo.Geolocation.Models for address support. Internal rows live in people.* with parallel {entity}_source link tables ( EntitySourceRecord / PeopleSourceTypes): source_entity_* + * imported_at* (owner via parent FK). Aggregates implement IEntitySourceDerived (Sources, optional LocallyModifiedAt). Enriched locations may also be stored in geolocation.address; link across stores via EntityRef on source rows (e.g. GeolocationAddress), not cross-schema FKs.

Models — Core

• Person — Main person entity with demographics, contact info, addresses, and metadata
• PersonName — Structured name with prefix, suffix, preferred name, and formatting options
• Employment — Employment history with company, title, dates, and compensation
• Identification — ID documents (passport, driver's license, SSN, etc.)

Models — Contact

• PhoneNumber — Base phone number (E.164 format)
• EmailAddress — Base email address
• ContactPhoneNumber — Person–phone association with type (mobile, home, work)
• ContactEmailAddress — Person–email association with type (personal, work)
• SocialMediaProfile — Social platform profiles (LinkedIn, Twitter, etc.)
• CommunicationPreferences — Channel preferences (email, SMS, marketing opt-in)

Models — Preferences

• PersonPreferences — Contact method, timezone, language
• PrivacyPreferences — Data sharing and directory visibility

Models — Relationships

• PersonRelationship — Links between people (spouse, parent, employer, etc.)

Enums

• ContactEmailType — Personal, Work, Other
• ContactPhoneType — Mobile, Home, Work, Fax, Other
• RelationshipType — Spouse, Parent, Child, Employer, etc.
• IdentificationType — Passport, DriversLicense, SSN, etc.
• EmploymentType — FullTime, PartTime, Contract, Freelance, etc.
• NameFormat — Full, Formal, Display, Initials, etc.

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

• Lyo.Common — (direct, lyo)
• Lyo.DateAndTime — (direct, lyo)
• Lyo.EntityReference.Models — (direct, lyo)
• Lyo.Geolocation.Models — (direct, lyo)
• Lyo.Exceptions — (transitive, lyo)
• Microsoft.Extensions.Logging.Abstractions 10.0.5 — (transitive, microsoft)
• System.Memory 4.6.3 — (transitive, microsoft, netstandard2.0)
• System.Text.Json 10.0.5 — (transitive, microsoft, netstandard2.0)