96 lines
2.2 KiB
Markdown
96 lines
2.2 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|
|
```bash
|
|
cd gen
|
|
python main.py
|
|
```
|
|
|
|
### Regenerate models (when schema.json changes)
|
|
```bash
|
|
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.* |