Windstorm Trade

Windstorm Trade is the web-based user interface for the Windstorm platform, providing a browser-based environment for interacting with Windstorm workflows, artifacts, and analysis results.

This application is built using Vue.js and serves as the primary frontend for the Windstorm backend services.

Windstorm is part of the broader DigitalForge digital engineering ecosystem, enabling automated workflows triggered by repository events, container builds, and other development activities.

---

Overview

Windstorm Trade provides a modern web interface that allows users to:

• Browse and interact with Windstorm data
• Monitor workflow execution results
• Inspect artifacts produced by automated analysis pipelines
• Visualize information stored within the Windstorm database

The frontend communicates with the Windstorm backend API and presents information generated by automated workflows triggered throughout the DigitalForge environment.

Typical data sources include:

• Repository events (commits, pull requests)
• Container image pushes
• Automated analysis workflows
• Artifact generation pipelines

---

Architecture

                +---------------------+
                |   GitHub / Gitea    |
                +----------+----------+
                           |
                           | Webhooks
                           v
                  +------------------+
                  |  Event Processors|
                  | (Windstorm Mage) |
                  +--------+---------+
                           |
                           | Triggers
                           v
                   +---------------+
                   | Argo Workflows|
                   +-------+-------+
                           |
                           v
                     +---------+
                     | Postgres|
                     +----+----+
                          |
                          v
                 +--------------------+
                 | Windstorm Dwarven  |
                 |  FastAPI Backend   |
                 +---------+----------+
                           |
                           v
                 +--------------------+
                 |  Windstorm Trade   |
                 |   Vue Frontend     |
                 +--------------------+

Windstorm Trade provides the user interface for interacting with the data stored and processed by the Windstorm system.

---

Repository Structure

windstorm-trade
│
├── trade/                 # Vue frontend application
│
├── .github/workflows/     # CI/CD workflows
│
├── Dockerfile             # Container build configuration
│
├── LICENSE
├── NOTICE
└── README.md

---

Technology Stack

Component Technology

---

Frontend Framework Vue.js Language TypeScript / JavaScript Containerization Docker Backend API Windstorm Dwarven (FastAPI) Database PostgreSQL Workflow Engine Argo Workflows

---

Development

Prerequisites

• Node.js
• npm or yarn
• Docker (optional for container builds)

---

Install Dependencies

cd trade
npm install

---

Run Development Server

npm run dev

The application will be available at:

http://localhost:5173

---

Build Production Assets

npm run build

---

Docker

A container image can be built using the included Dockerfile.

docker build -t windstorm-trade .

Example run:

docker run -p 8080:80 windstorm-trade

---

Configuration

Windstorm Trade connects to the Windstorm backend API.

Typical configuration parameters include:

API_BASE_URL

These may be provided through:

• environment variables
• container configuration
• Kubernetes deployment manifests

---

Deployment

Windstorm Trade is typically deployed within a Kubernetes environment as part of the Windstorm namespace.

Typical deployment stack:

• Kubernetes
• Ingress controller
• TLS via cert-manager
• Argo Workflows
• PostgreSQL

---

Relationship to Other Windstorm Components

Component Purpose

---

windstorm-trade Web UI windstorm-dwarven Backend API windstorm-mage Webhook aggregation windspear / windsage Event ingestion windrunner Workflow dispatch windtrader SysML validation tooling

Together these components enable event-driven digital engineering workflows across the DigitalForge platform.

---

License

This project is licensed under the AGPL-3.0 License.

See:

LICENSE

for full details.

---

Contributing

Contributions are welcome.

Typical workflow:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

---

About DigitalForge

Windstorm is part of the DigitalForge digital engineering platform, which provides:

• automated verification workflows
• digital thread infrastructure
• model-driven development environments
• artifact traceability across engineering tools

For more information see:

https://westfall.io