Soleprint

Cada paso deja huella / Each step leaves a mark

What Soleprint Solves

Freelance Work Standardization

Consistent framework across projects. Build once, reuse everywhere.

Missing Infrastructure

Mock systems you can't access yet - DB designs in progress, Kubernetes not ready, APIs being built. Test locally with shunts.

Reliable Testing

BDD -> Gherkin -> Tests. Explore behavior first, then generate tests.

System Overview

View Full
System Overview

The four systems that make up Soleprint.

Systems

  • Soleprint: Core coordinator hub (port 12000)
  • Artery: Connectors to external services - "Todo lo vital"
  • Atlas: Actionable documentation - "Documentacion accionable"
  • Station: Tools and monitors - "Centro de control"

Artery Hierarchy

View Full
Artery Hierarchy

How connectors evolve from simple to complex.

Connector Types

Type Description Example
Vein Stateless API connector Jira, Slack, Google
Shunt Fake connector for testing MercadoPago mock
Pulse Vein + Room + Depot Jira for AMAR project
Plexus Full app (backend + frontend + DB) WhatsApp with chat UI

Build Flow

View Full
Build Flow

How source is built into runnable instances.

Commands

Command Output
python build.py gen/standalone/
python build.py --cfg amar gen/amar/
python build.py --all both

Room Configuration

View Full
Room Configuration

How rooms are configured in cfg/.

Room Structure

  • config.json: Framework branding, terminology
  • data/: veins.json, shunts.json, depots.json
  • soleprint/: Docker config for this room
  • databrowse/, tester/, monitors/, models/: Room-specific extensions

Technology Stack

Core

  • Python 3.11+
  • FastAPI
  • Jinja2

Tools

  • modelgen
  • tester (Playwright)
  • datagen
  • databrowse

Veins

  • Jira
  • Slack
  • Google (OAuth)

Infrastructure

  • Docker
  • Woodpecker CI
  • Nginx