# Glossary System — Landvex Ecosystem

## Overview

A **living database** of terms used across quiXzoom, AMOS, and Landvex. Automatically updated, SEO-optimized, and responsive.

## Structure

```
glossary/
├── glossary-data.json          # Master data file (JSON)
├── index.html                  # Dynamic renderer (quixzoom.com/glossary/)
├── update-glossary.js          # Auto-revision script
├── deploy.sh                   # Deployment script
├── smp-tag-helper.js           # SMP tag auto-linker
├── dist/                       # Generated static files
│   ├── index.html             # All terms
│   ├── glossary-quixzoom.html # quiXzoom terms only
│   ├── glossary-aamos.html    # AMOS terms only
│   └── glossary-landvex.html  # Landvex terms only
└── README.md
```

## Features

### ✅ Dynamic JSON Database
- All terms stored in `glossary-data.json`
- Categories: Platform, Technical, Payment, Legal, Core, AMOS Engine, Landvex, quiXzoom, Product
- Cross-domain support (terms can belong to multiple domains)

### ✅ Auto-Revision
- Daily cron job at 02:00 UTC
- Scans source files for new SMP tags
- Updates glossary automatically
- Regenerates all static files

### ✅ SEO Optimized
- Structured data (Schema.org DefinedTermSet)
- Canonical URLs per domain
- Meta descriptions and Open Graph tags
- Robots: index, follow

### ✅ Responsive Design
- Mobile-first approach
- Sticky navigation with A-Z jump
- Live search with instant filtering
- Domain filter buttons

### ✅ SMP Tag System
- HTML: `<span data-smp="term-id">Term</span>`
- Auto-converts to glossary links
- Tooltips with short definitions

## Usage

### Adding a New Term

1. Edit `glossary-data.json`
2. Add term object:
```json
{
  "id": "unique-id",
  "name": "Term Name",
  "category": "technical",
  "short": "Brief description",
  "long": "Full definition...",
  "context": "Example usage...",
  "contextLabel": "In quiXzoom",
  "related": ["other-term-id"],
  "domains": ["quixzoom", "aamos"]
}
```

3. Run `node update-glossary.js`
4. Deploy with `./deploy.sh`

### Using SMP Tags

In HTML:
```html
<span data-smp="amos">AMOS</span> is our AI platform.
```

Include helper:
```html
<script src="/glossary/smp-tag-helper.js"></script>
```

## Domains

| Domain | URL | Terms |
|--------|-----|-------|
| All | quixzoom.com/glossary/ | 100 |
| quiXzoom | quixzoom.com/glossary/ | 79 |
| AMOS | aamos.ai/glossary/ | 53 |
| Landvex | landvex.com/glossary/ | 41 |

## Auto-Revision Schedule

- **Daily**: 02:00 UTC
- **Job ID**: `737ba486-ffd1-45b9-8b04-3069888d5012`
- **Actions**: Scan → Update → Generate → Deploy

## Last Updated

2026-07-14