# Modyo Content Module

Headless CMS for structured content management.

## Resource Hierarchy

```
Platform
└── Spaces (content repositories)
    ├── Types - Content schemas
    │   └── Fields (text, rich_text, asset, location, etc.)
    ├── Entries - Content instances
    │   ├── Field values per locale
    │   ├── Meta (slug, tags, category)
    │   └── Workflow (draft/review/published)
    ├── Assets - Media files
    │   └── Folders for organization
    └── Categories - Content taxonomy
```

## Key Concepts

### Spaces
- Isolated content repositories
- Each space has its own types, entries, assets
- Identified by `spaceId` or `space_uid`

### Types
- Define content structure (schema)
- Fields: text, rich_text, asset, location, checkbox, dropdown, etc.
- Support localization per field

### Entries
- Content instances of a type
- Multi-locale support
- Publishing workflow: draft → review → published

### Assets
- Media files (images, videos, documents)
- Organized in folders
- Referenced by entries via asset fields

### Segments (from Customers realm)
- Content spaces can connect to one realm
- Entries can be targeted to specific user segments

## Localization

### Main Locales
- `es-es` - Spanish
- `en-en` - English
- `pt-pt` - Portuguese

### Accessing Other Locales
Use Liquid filter for other languages:
```liquid
{{ entry.field | by_lang: "fr" }}
{{ entry.title | by_lang: "de" }}
```

## Content API

Published entries accessible via:
```
GET /api/content/spaces/{space_uid}/types/{type_uid}/entries
```

## Tools

| Tool | Purpose |
|------|---------|
| `spaces-manage` | Space lifecycle |
| `types-manage` | Type/schema management |
| `entries-manage` | Entry CRUD + publishing |
| `assets-manage` | Asset upload and management |
| `categories-manage` | Taxonomy management |