# Modyo Customers Module

User identity and data collection management.

## Resource Hierarchy

```
Platform
└── Realms (identity domains)
    ├── Users - End customers
    │   ├── Profile data
    │   ├── Custom fields
    │   └── Segments
    ├── Forms - Data collection
    │   ├── Fields (text, select, file, etc.)
    │   └── Validations
    ├── Submissions - Form responses
    │   └── Originations workflow
    ├── Data Sets - Reference data
    └── Segments - User groups
        └── Dynamic rules
```

## Key Concepts

### Realms
- Identity domains for end-user authentication
- Connected to sites (one realm per site)
- Connected to content spaces (one realm per space)

### Users
- End customers (not platform team members)
- Custom profile fields
- Segment membership

### Segments
- Dynamic user groups with rule-based membership
- Used by channels for page visibility
- Used by content for entry targeting

### Forms
- Data collection templates
- Field types: text, textarea, select, checkbox, file, etc.
- Validation rules

### Originations
- Form submission workflows
- Multi-step processes
- Rule-based routing

### Data Sets
- Reference data for forms
- Dropdown options, lookup tables

## Authentication

Realms support:
- Modyo native auth
- OAuth2 providers
- SAML/SSO
- Custom identity providers

## Tools

| Tool | Purpose |
|------|---------|
| `realms-manage` | Realm lifecycle |
| `realm-user-manage` | User CRUD |
| `forms-manage` | Form builder |
| `submissions-manage` | Submission handling |
| `originations-manage` | Workflow management |
| `data-sets-manage` | Reference data |