person
An individual, and the class the largest number of others point at.
A person is an individual member of the human race.
Why it matters
Everything in a transaction attaches to a person: the borrower and coborrower, the loan officer, the seller, the notary, the agent. The class carries only what is true of the individual — name, demographics, identification, citizenship — and everything role-shaped hangs off it as a relationship instead.
That split is why the class is small relative to how much points at it. A person is not a borrower; a person has a finance relation whose role is borrower, and the same person can hold several such relations at once.
In practice
Identity across states is a stable global identifier named for the class, while every state of the record carries its own database-generated identifier. A correction to a name is a new record grouped with the old one rather than an overwrite, so the history of what was believed and when is a query rather than an audit log.
Properties
| Property | Type | Definition |
|---|---|---|
birth_date | date | A birth date is the date on which a person was born. It typically includes the day, month, and year of an individual's birth and is used to determine their age. |
city_name | string | City name refers to the name of the city in which the address is located. |
country_name | string | Country name refers to the country where a person resides. |
email_address | string | An email address is a unique identifier used to send and receive electronic messages over the internet. It typically consists of two parts: a username and a domain name, separated by the '@' symbol. |
first_name | string | A person's first name is the name that they are given at birth or during infancy, and it is typically used to identify them in a personal or informal context. |
first_time_home_owner | boolean | First time home owner refers a person who is purchasing a house and taking out a mortgage for the first time. |
full_address_txt | string | Full address text refers to the physical location where property is located. |
has_saved_search | saved_search | Links a person to a saved search instance, indicating that the person has saved this particular search. |
home_phone_number | string | A home phone number is a telephone number that is associated with a residential address, typically used for personal or family communication purposes. It is a phone number that is linked to a landline or a Voice over Internet Protocol (VoIP) service that is connected to a physical address. |
last_name | string | A person's last name, also known as surname or family name, is typically the name that is shared by all members of their immediate family. |
mailing_address | string | A mailing address is the physical location where mail is sent to a person or organization. It typically includes the recipient's name, street address, city, state or province, postal code and country. |
owned_environments | environment | Owned environment refers to a computing environment that is fully controlled by a particular person or organization. In an owned environment, the person or organization has complete control over the configuration, management, and security of the computing resources. This allows them to customize the environment to their specific needs and requirements, and to ensure that it is optimized for the application or service they are running. |
person_identifier | string | A person identifier is a unique code or number assigned to an individual for identification purposes. It is often used in various administrative and legal systems to ensure accuracy and consistency in record-keeping and data management. |
phone_number | string | A phone number is a unique sequence of digits assigned to a specific telephone line or mobile device that allows it to be reached by a caller. It is typically comprised of a country code, area code, and a specific number assigned to the device. |
postal_code | string | A postal code, also known as a ZIP code (in the United States) or postcode (in many other countries), is a numerical code used by postal services to identify specific geographic areas for efficient mail sorting and delivery. |
ssn | string | A Social Security number (SSN) is a unique nine-digit identification number assigned to individuals in the United States by the Social Security Administration (SSA). The SSN is used primarily for tracking individuals for Social Security and tax purposes, but it is also used for a variety of other purposes, such as credit reporting, employment verification, and financial transactions. |
state_code | string | State code is a code that represents the state in which the address is located. |
state_name | string | State name refers to the name of the state in which the address is located. |
us_citizenship_status | enumeration | Citizenship status refers to an individual's legal status as a citizen or non-citizen of a country. In the United States, citizenship status is determined by birthright, naturalization, or other legal means. USCitizenUSCitizenAbroadPermResidentAlienNonPermResidentAlienForeignNational |
veteran_status | boolean | Veteran status refers to an individual's status as a former member of the armed forces. In the United States, a person is considered a veteran if they have served in the active military, naval, or air service and were discharged or released from that service under conditions other than dishonorable. |
work_phone_number | string | A work phone number is a telephone number that is associated with an individual's place of employment. It is typically used for business purposes, such as to contact colleagues, clients, or customers. |
Relationships
| Property | Points at | Definition |
|---|---|---|
earns | income | A person has income. Income is information about the money that a person or organization earns or receives on a regular basis from various sources. For a person, income typically comes from wages or salaries earned from employment, as well as from investments, rental properties, or other sources of passive income. Income for organizations can come from sales of products or services, investments, grants, donations, or other sources. |
has_credit | credit | A person can have credit. Credit is a person's ability to borrow money or obtain goods or services with the understanding that they will pay for them later. Credit is typically measured by a credit score, which is a numerical rating that reflects a person's creditworthiness based on their credit history, income, debt-to-income ratio, and other factors. |