https://github.com/bartosz-ziolkowski/declare-repo
Social Repository for Storing and Sharing Declare Process Models for Primarily Model Reuse and Benchmarking Purposes
https://github.com/bartosz-ziolkowski/declare-repo
bpm business-process-management declarative-process-models declare-process-models process-modeling
Last synced: 7 months ago
JSON representation
Social Repository for Storing and Sharing Declare Process Models for Primarily Model Reuse and Benchmarking Purposes
- Host: GitHub
- URL: https://github.com/bartosz-ziolkowski/declare-repo
- Owner: bartosz-ziolkowski
- License: apache-2.0
- Created: 2024-10-19T16:11:06.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-02-22T19:01:59.000Z (8 months ago)
- Last Synced: 2025-02-22T20:18:22.377Z (8 months ago)
- Topics: bpm, business-process-management, declarative-process-models, declare-process-models, process-modeling
- Language: JavaScript
- Homepage: https://declare-repo.vercel.app
- Size: 1.75 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
Awesome Lists containing this project
README
# Declare Repository [](https://doi.org/10.5281/zenodo.14609574)
A web-based repository for storing, sharing and analyzing DECLARE process models.
## Overview
Declare Repository is a comprehensive platform designed to facilitate the storage, sharing, and analysis of declarative process models expressed in DECLARE language. The repository aims to promote model reuse and enable benchmarking capabilities within the declarative process modeling community.
## Features
- **Model Management**
- Upload and store DECLARE process models in multiple formats (.decl, .txt, .png)
- Browse and search stored models
- Filter models based on various metrics and characteristics
- Download models for reuse
- **Metric Analysis**
- Automatic calculation of initial classifiers:
- Size
- Density
- Constraint Variability
- Number of Activities
- Number of Constraints
- Separability
- Semantic Redundancy
- Consistency
- Purpose
- Application Domain
- **API Integration**
- RESTful API for programmatic access
- Comprehensive API documentation via Swagger UI
- Secure authentication and authorization
## Technology Stack
- **Frontend**: Next.js, React
- **Backend**: Next.js API routes
- **Database**: MongoDB
- **Cloud Services**:
- AWS S3 for file storage
- AWS EC2 for metric computation
- **Deployment**: Vercel
## Getting Started
### Prerequisites
- Node.js 14.x or higher
- MongoDB
- AWS account for S3 and EC2 services
### Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/declare-repo.git
```
2. Install dependencies:
```bash
cd declare-repo
npm install
```
3. Configure environment variables:
```bash
cp .env.example .env.local
```
Edit `.env.local` with your configuration values
4. Run the development server:
```bash
npm run dev
```
## Usage
1. Visit https://declare-repo.vercel.app/
2. Register an account to upload and manage models
3. Browse existing models or upload new ones
4. Use the filtering system to find specific models
5. Download models or analyze their classifiers
## API Documentation
Full API documentation is available at https://declare-repo.vercel.app/api-docs
## Browser Support
- Chrome 64+
- Edge 79+
- Firefox 67+
- Opera 51+
- Safari 12+
## Release Information
🎉 **Official Release Date**: *January 16, 2025* 🎉
The Declare Repository was officially released on January 16, 2025. Since then, it has been empowering the declarative process modeling community with tools for efficient storage, sharing, and analysis of DECLARE process models. Explore the platform, contribute to its growth, and make the most of this innovative repository!
## Contributing
We welcome contributions to improve the Declare Repository. Please follow these steps:
1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request
## License
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
## Contact
For questions and support, please open an issue in the GitHub repository.
## Acknowledgments
This project was developed as part of a Master's thesis at the Section for Software Systems Engineering, Department of Applied Mathematics and Computer Science, at the Technical University of Denmark (DTU).
**Project Supervisors:**
- **Andrey Rivkin** - Assistant Professor (Tenure track), Section for Software Systems Engineering, Department of Applied Mathematics and Computer Science, Technical University of Denmark
- **Ekkart Kindler** - Associate Professor, Section for Software Systems Engineering, Department of Applied Mathematics and Computer Science, Technical University of Denmark
Their invaluable guidance, thoughtful feedback, and dedicated support during weekly meetings were instrumental in shaping this research and ensuring its successful completion.