Soleprint

Cada paso deja huella / Each step leaves a mark

What Soleprint Solves

Freelance Work Standardization

Generalizing and homogenizing freelance work across projects. Instead of setting up different environments, testing approaches, and connector patterns for each client, Soleprint provides a consistent framework. Build once, reuse everywhere.

Missing Infrastructure Replication

When working with large corps where you can't access their Jira, Slack, payment systems, or internal APIs directly - Soleprint's shunts let you mock those systems locally. Test against fake MercadoPago, fake Jira tickets, fake webhooks without needing real credentials.

Reliable Testing Environment

Figure out what tests to write by actually running flows in a controlled environment. BDD -> Gherkin -> Tests workflow. Instead of guessing what to test, you explore the actual behavior first, document it, then generate tests from that documentation.

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 dev gen/standalone/
python build.py dev --cfg amar gen/amar/
python build.py dev --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