Soleprint

Cada paso deja huella / Each step leaves a mark

Development workflow and documentation platform. Run, test, and document everything in one place.

Quick Start

cd gen
pip install -r requirements.txt
python main.py
# Visit http://localhost:12000

Systems

	System	What it does
💉	Artery	Connectors to external services (Jira, Slack, APIs)
🗺️	Atlas	Actionable documentation (BDD, Gherkin, specs)
🎛️	Station	Tools, environments, test runners

Structure

spr/
├── schema.json        # Model definitions (source of truth)
├── config/            # Framework configuration
├── artery/            # Connectors (source)
├── atlas/             # Documentation (source)
├── station/           # Tools (source)
│   └── tools/
│       ├── generator/ # Generates models & structure
│       ├── datagen/   # Test data generation
│       └── tester/    # Test runner
├── data/              # Content (JSON)
└── gen/               # Runnable instance (run from here)

Components

Shared:

• Room - Environment configuration
• Depot - Data storage

System-specific:

• Vein (Artery) - Single connector
• Template (Atlas) - Doc pattern
• Tool (Station) - Utility

Composed:

• Pulse = Vein + Room + Depot
• Book = Template + Depot
• Desk = Cabinet + Room + Depots

Development

Run locally

cd gen
python main.py

Regenerate models (when schema.json changes)

cd station/tools/generator
python -m generators.orchestrator --output ../../../gen

Ports

Service	Port
Hub	12000
Artery	12001
Atlas	12002
Station	12003

Background

Born from the friction of:

• Testing requiring PRs on small teams
• Documentation scattered across tools
• Quick API connectors taking too long to set up
• No self-contained environment to experiment freely

Soleprint lets you run everything in isolation while building reusable pieces.

License

TBD

---

Built for small teams who need to move fast without breaking things.