{"id":48250497,"url":"https://github.com/burgan-tech/vnext-example","last_synced_at":"2026-04-04T20:51:34.897Z","repository":{"id":326329735,"uuid":"1101144555","full_name":"burgan-tech/vnext-example","owner":"burgan-tech","description":"vnext-example provides reference workflows and components for the vNext Platform, demonstrating recommended patterns, composition techniques, and end-to-end flows to guide developers in building real-world implementations.","archived":false,"fork":false,"pushed_at":"2026-03-24T08:04:44.000Z","size":382,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-25T09:59:22.787Z","etag":null,"topics":["example","local","mock","vnext"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/burgan-tech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-21T09:00:08.000Z","updated_at":"2026-03-24T08:04:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/burgan-tech/vnext-example","commit_stats":null,"previous_names":["burgan-tech/vnext-example"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/burgan-tech/vnext-example","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burgan-tech%2Fvnext-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burgan-tech%2Fvnext-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burgan-tech%2Fvnext-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burgan-tech%2Fvnext-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/burgan-tech","download_url":"https://codeload.github.com/burgan-tech/vnext-example/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burgan-tech%2Fvnext-example/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31413284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["example","local","mock","vnext"],"created_at":"2026-04-04T20:51:31.302Z","updated_at":"2026-04-04T20:51:34.888Z","avatar_url":"https://github.com/burgan-tech.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# core\n\nA structured template package for vNext workflow components with domain-based architecture. This package provides a foundation for building scalable workflow systems with schemas, tasks, views, functions, and extensions.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## 🚀 Features\n\n- **Domain-Driven Architecture**: Organized by business domains with clear separation of concerns\n- **Component-Based Structure**: Modular design with schemas, workflows, tasks, views, functions, and extensions\n- **JSON Schema Validation**: Built-in validation for all component definitions\n- **Template System**: Ready-to-use template structure for new vNext projects\n- **Type Safety**: Structured exports with clear APIs for accessing components\n\n## 📦 Installation\n\n### Install as dependency\n```bash\nnpm install @my-organization/core\n```\n\n### Install as dev dependency\n```bash\nnpm install --save-dev @my-organization/core\n```\n\n## 🏗️ Project Structure\n\n```\nvnext-template/\n├── core/              # Domain-specific components\n│   ├── Extensions/            # Extension definitions\n│   ├── Functions/             # Function definitions\n│   ├── Schemas/              # JSON schema definitions\n│   ├── Tasks/                # Task definitions\n│   ├── Views/                # View components\n│   └── Workflows/            # Workflow definitions\n├── index.js                  # Main entry point\n├── vnext.config.json         # Domain configuration\n└── package.json              # Package metadata\n```\n\n## 🏛️ Architecture Principles\n\n### Component Types\n\n1. **Schemas**: JSON Schema definitions for data validation\n2. **Workflows**: Business process definitions and state machines\n3. **Tasks**: Individual task definitions and configurations\n4. **Views**: User interface and presentation components\n5. **Functions**: Reusable business logic functions\n6. **Extensions**: Plugin and extension definitions\n\n## 🛠️ Development\n\n### Running Tests\n```bash\nnpm test\n```\n\n## ⚙️ Configuration\n\nThe `vnext.config.json` file allows you to customize paths and exports:\n\n```json\n{\n  \"domain\": \"my-domain\",\n  \"paths\": {\n    \"componentsRoot\": \"my-domain\",\n    \"schemas\": \"Schemas\",\n    \"workflows\": \"Workflows\",\n    \"tasks\": \"Tasks\",\n    \"views\": \"Views\",\n    \"functions\": \"Functions\",\n    \"extensions\": \"Extensions\"\n  },\n  \"exports\": {\n    \"schemas\": [\"schema1.json\", \"schema2.json\"],\n    \"workflows\": [\"workflow1.json\"],\n    \"tasks\": [],\n    \"views\": [],\n    \"functions\": [],\n    \"extensions\": []\n  }\n}\n```\n\n### Path Configuration\n\nYou can customize component directory names:\n\n```json\n{\n  \"paths\": {\n    \"componentsRoot\": \"src\",\n    \"workflows\": \"Flows\",\n    \"schemas\": \"Models\"\n  }\n}\n```\n\n## ✅ Validation\n\nValidate your project structure and schemas:\n\n```bash\nnpm run validate\n```\n\nThis will check:\n- Package.json structure and content\n- Main entry point functionality\n- vnext.config.json validation\n- Domain directory structure\n- JSON file syntax validation\n- Schema validation using @burgan-tech/vnext-schema\n- Module functionality\n- Semantic versioning compliance\n\n### Validation Output\n\nThe validation provides detailed output with:\n- ✅ Passed validations\n- ❌ Failed validations with file paths and line numbers\n- 📊 Summary statistics\n- 📋 Failed files summary for easy navigation\n\n## 🏗️ Build\n\nBuild your domain package for deployment or cross-domain usage:\n\n```bash\n# Runtime build (default) - Complete domain structure\nnpm run build\n\n# Reference build - Only exported components\nnpm run build:reference\n\n# Runtime build explicitly\nnpm run build:runtime\n```\n\n### Build Options\n\n```bash\nnpm run build -- [options]\n\nOptions:\n  -o, --output \u003cdir\u003e     Output directory (default: dist)\n  -t, --type \u003ctype\u003e      Build type: reference or runtime (default: runtime)\n  --skip-validation      Skip validation during build\n  -h, --help             Show help message\n```\n\n### Build Types\n\n| Type | Description | Use Case |\n|------|-------------|----------|\n| `runtime` | Complete domain structure with all files | Engine deployment |\n| `reference` | Only exported components from vnext.config.json | Cross-domain usage |\n\n### Examples\n\n```bash\n# Build to custom directory\nnpm run build -- -o my-build\n\n# Reference build to custom directory\nnpm run build -- -t reference -o packages/ref\n\n# Skip validation for faster builds\nnpm run build -- --skip-validation\n```\n\n### Build Output Structure\n\n**Runtime Build:**\n```\ndist/\n├── \u003cdomain\u003e/\n│   ├── Extensions/\n│   ├── Functions/\n│   ├── Schemas/\n│   ├── Tasks/\n│   ├── Views/\n│   └── Workflows/\n├── vnext.config.json\n├── package.json\n├── README.md\n└── LICENSE\n```\n\n**Reference Build:**\n```\ndist/\n├── \u003cdomain\u003e/\n│   ├── Extensions/     # Only exported files\n│   ├── Functions/      # Only exported files\n│   ├── Schemas/        # Only exported files\n│   ├── Tasks/          # Only exported files\n│   ├── Views/          # Only exported files\n│   └── Workflows/      # Only exported files\n├── vnext.config.json\n├── package.json\n├── README.md\n└── LICENSE\n```\n\n## 📜 Available Scripts\n\n| Script | Description |\n|--------|-------------|\n| `npm run validate` | Validate project structure and schemas |\n| `npm run build` | Build runtime package to dist/ |\n| `npm run build:runtime` | Build runtime package explicitly |\n| `npm run build:reference` | Build reference package with exports only |\n| `npm run setup \u003cname\u003e` | Setup domain with given name |\n| `npm run sync-schema` | Sync schema version from dependencies |\n| `npm test` | Run tests |\n\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🏢 About Burgan Tech\n\nThis package is maintained by the Burgan Tech team as part of our commitment to building scalable, domain-driven workflow solutions.\n\n## 🔗 Links\n\n- [NPM Package](https://www.npmjs.com/package/@burgan-tech/vnext-example)\n- [GitHub Repository](https://github.com/burgan-tech/vnext-example)\n- [Issues](https://github.com/burgan-tech/vnext-example/issues)\n- [Documentation](https://github.com/burgan-tech/vnext-example#readme)\n\n## 📞 Support\n\nFor support and questions:\n- Create an issue on [GitHub](https://github.com/burgan-tech/vnext-example/issues)\n- Contact the development team at dev@burgan-tech.com\n\n---\n\nMade with ❤️ by the Burgan Tech team","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburgan-tech%2Fvnext-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fburgan-tech%2Fvnext-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburgan-tech%2Fvnext-example/lists"}