Microservices architecture for cryptographic data validation and fiscal workflow automation.
Fiscal-grade data integrity is hard: invoices, ledgers and audit chains need to be tamper-evident, signable and queryable without coupling business logic to the cryptography layer.
VeriStack splits that concern into independent, dockerized microservices that talk over a private network and are orchestrated via n8n for retries, alerts and batch jobs.
flowchart LR
Client[Client / Partner API] -->|REST| Gateway[FastAPI Gateway]
Gateway --> Verify[Verification Service]
Gateway --> Sign[Signing Service]
Verify --> Hash[(Hash Chain Store)]
Sign --> Keys[(Key Vault)]
n8n[n8n Orchestrator] -->|webhook| Gateway
n8n -->|alerts| Slack[Alerting]
style Gateway fill:#009688,color:#fff
style n8n fill:#EA4B71,color:#fff
| Service | Responsibility | Stack |
|---|---|---|
| Gateway | Auth, rate-limit, routing | FastAPI + JWT |
| Verification | Hash-chain validation, audit trail | Python + SQLite/PG |
| Signing | Cryptographic signing, key rotation | Python + cryptography |
| Orchestration | Retries, batch jobs, alerts | n8n |
git clone https://github.com/franamaro-dev/VeriStack.git
cd VeriStack
docker compose up --buildGateway will be available at http://localhost:8000/docs (OpenAPI).
pip install -r requirements.txt
pytest -vSee TESTING.md for fixtures and coverage strategy.
| Layer | Tools |
|---|---|
| API | FastAPI, Pydantic v2 |
| Crypto | cryptography, hashlib, JWT |
| Persistence | SQLite (dev), PostgreSQL (prod) |
| Orchestration | n8n |
| Packaging | Docker, docker-compose |
| Testing | pytest, httpx |
.
├── app/ # FastAPI services (gateway, verify, sign)
├── tests/ # pytest suite
├── docker-compose.yml # multi-service orchestration
├── Dockerfile # base image
├── requirements.txt
└── TESTING.md # test strategy
- XAdES signature module (RD 1007/2023 compliance)
- Distributed hash chain (Merkle tree)
- OpenTelemetry instrumentation
- Helm chart for Kubernetes
MIT © Francisco Amaro Prieto
Built by Francisco Amaro — Backend Engineer & SOC L1 Analyst LinkedIn · Email