soleprint/atlas/CLAUDE.md

ALBUM: Documentation System

Purpose

Documentation, templates, and data. Composed into books.

Book Types

Single-larder book (template: null)

• Book and larder are interchangeable
• Just static content served directly
• Listed in books.json, NOT in larders.json

Templated book (template: {...})

• Template defines the structure
• Larder must contain only elements matching that template
• Template validates/constrains the larder content
• Shows a styled landing page linking to template and larder

Larders vs Books

• Larders = buckets that connect to other systems (e.g., drive, external data sources)
• Books = standalone content, may be single-larder or template+larder
• Single-larder books are listed as books, not larders

Templated Book Structure

A templated book must contain a template/ folder with the template definition inside:

book/{book-slug}/
├── template/           # REQUIRED for templated books
│   └── {template-files}
├── {larder-name}/      # The actual data (marked with .larder file)
│   └── .larder
├── index.html          # Larder browser (used at /book/{slug}/larder/)
└── detail.html         # Detail view template (if needed)

Example:

book/feature-form-samples/
├── template/           # Template definition
│   └── plantilla-flujo.md
├── feature-form/       # Larder data (constrained by template)
│   ├── .larder
│   ├── pet-owner/
│   ├── veterinarian/
│   └── backoffice/
├── index.html          # Larder browser
└── detail.html         # Detail renderer

Routes for templated books:

• /book/{slug}/ → Landing page (template + larder links)
• /book/{slug}/template/ → Template definition
• /book/{slug}/larder/ → Larder browser

Components

Template (Patterns)

Gherkin/BDD

• Status: Pending
• Goal: .feature files, simple templates for non-tech

Index Templates

• Status: Pending
• Goal: HTML generators for indexes

Vault (Data)

drive/

• Status: Downloaded
• Contents: Company drive (identity, marketing, ops, supply, finance, clients, pitches)

Book (Composed Docs)

drive-index

• Status: Priority
• Goal: Two indexes (internal full, public privacy-conscious)

flow-docs

• Status: Pending
• Goal: User flow documentation (pet owner, vet, ops)

Upward Report

ALBUM: Drive index priority. Template + vault → book composition defined.

Priority

1. Drive index book (HTML from vault/drive)
2. One gherkin template example
3. Flow documentation structure

Vault Contents (vault/drive)

• 01.Identidad Amar Mascotas
• 2. Marketing contenidos
• 3. Marketing Growth
• 5. ATC - Operaciones
• 6. Supply (vetes-labo-clinicas)
• 7. Finanzas y contabilidad
• Clientes - ventas - devoluciones
• Pitch Decks - Presentaciones

Deployment

• URL: https://album.mcrn.ar
• Port: 12002
• Service: systemctl status album

FastAPI app serving documentation. Currently serves index.html at root, expandable for book browsing.

Upstream (for main pawprint thread)

This is now a separate repo. See pawprint/UPSTREAM.md for merge notes.