Metadata-Version: 2.4
Name: vertac-bridge
Version: 0.2.1
Summary: VerTac Sensor Data Bridge - Lightweight connector for sensor data ingestion
Home-page: https://github.com/your-org/vertac-bridge
Author: VerTac Team
Author-email: VerTac Team <info@vertac.dev>
License: MIT
Project-URL: Homepage, https://github.com/your-org/vertac-bridge
Project-URL: Documentation, https://vertac-bridge.readthedocs.io
Project-URL: Repository, https://github.com/your-org/vertac-bridge.git
Project-URL: Issues, https://github.com/your-org/vertac-bridge/issues
Keywords: sensor,bridge,data-ingestion,monitoring,api-client
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Manufacturing
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# VerTac - Cycle-Based Monitoring Platform

A lightweight, web-based monitoring and analysis platform for small factories and technical environments where machines, test benches, or processes operate through repeated runs.

## Overview

VerTac is designed to analyze historical multi-sensor datasets organized into distinct cycles. The platform provides:

- **Cycle-centric analysis**: Each dataset is organized into distinct cycles treated as first-class entities
- **Automated comparisons**: Compares each cycle against a reference cycle and the preceding cycle
- **Deviation detection**: Identifies abnormal behavior in signal shape, timing, amplitude, or overall behavior
- **Root cause analysis**: For abnormal terminations, traces and ranks sensor deviations leading up to the stop
- **Synchronized visualization**: Time-series graphs for multi-sensor data
- **Operator-friendly**: Designed for maintenance technicians with explainability and ease of use

## Technology Stack

- **Backend**: Python FastAPI
- **Frontend**: React with TypeScript
- **Data Processing**: Pandas, NumPy, SciPy
- **Visualization**: Plotly.js
- **Database**: SQLite (development) / PostgreSQL (production)

## Project Structure

```
VerTac/
├── backend/          # FastAPI backend
├── frontend/         # React frontend
├── data/            # Sample datasets
├── docs/            # Documentation
└── tests/           # Test suites
```

## Getting Started

### Backend Setup

```bash
cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

### Frontend Setup

```bash
cd frontend
npm install
npm start
```

## Features

- Import and parse multi-sensor datasets
- Organize data into cycles
- Define reference cycles
- Automated cycle comparison
- Deviation detection and alerting
- Root cause analysis for abnormal stops
- Synchronized time-series visualization
- Lightweight and accessible web interface

## License

MIT
