dev-api: add developer portal, OpenAPI spec, and Flatenbadet case study
- New /developers/ page with API docs, SDKs, pricing, use cases - OpenAPI 3.0 spec for Orders, Missions, Photos, Analytics - Case study: Glasskiosken i Flatenbadet — complete ROI analysis - Updated /order/ with recurring missions and frequency dropdown
This commit is contained in:
@@ -0,0 +1,106 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user