commit b4d44661e0783a00316094c52146c5e5ca0b2606 Author: ProcessGit Templates Date: Thu Feb 5 21:19:43 2026 +0000 Initial template import diff --git a/.gitea/template b/.gitea/template new file mode 100644 index 0000000..51623ac --- /dev/null +++ b/.gitea/template @@ -0,0 +1,7 @@ +# Expand placeholders across docs, manifests, and workflow templates +README.md +enterprise/** +packages/** +.github/** +.gitea/** +tools/** diff --git a/.gitea/workflows/validate.yml b/.gitea/workflows/validate.yml new file mode 100644 index 0000000..dbbbd27 --- /dev/null +++ b/.gitea/workflows/validate.yml @@ -0,0 +1,13 @@ +name: Validate Process Assets + +on: + push: + pull_request: + +jobs: + validate: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Run validation + run: tools/validate.sh diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml new file mode 100644 index 0000000..2e5435d --- /dev/null +++ b/.github/workflows/validate.yml @@ -0,0 +1,14 @@ +name: Validate Process Assets + +on: + push: + pull_request: + +jobs: + validate: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + - name: Run validation + run: tools/validate.sh diff --git a/README.md b/README.md new file mode 100644 index 0000000..3fcc9c1 --- /dev/null +++ b/README.md @@ -0,0 +1,52 @@ +# UAPF Validation Ready Template + +This template provides a complete Level-4 process package with validation schema support. + +## Structure + +``` +uapf-validation-ready/ +├── enterprise/ +│ └── enterprise.yaml # Enterprise-level index +├── demo-process/ # Example process package +│ ├── uapf.yaml # Package configuration +│ ├── bpmn/ # BPMN process models +│ │ └── process.bpmn.xml # Document review workflow +│ ├── dmn/ # DMN decision models +│ │ └── decisions.dmn.xml # Approval requirements +│ ├── cmmn/ # CMMN case models +│ │ └── case.cmmn.xml # Exception handling +│ ├── resources/ # Resource mappings +│ │ └── mappings.yaml +│ ├── metadata/ # Process metadata +│ │ ├── ownership.yaml +│ │ └── lifecycle.yaml +│ └── docs/ # Documentation +│ └── notes.md +└── validation/ # Validation schemas + └── schemas/ + └── README.md + +``` + +## Process: Document Review & Approval + +This template demonstrates a document review and approval process with: + +- **BPMN Process**: Submit → Validate Format → Review → Approve/Reject → Publish +- **DMN Decision**: Dynamic approval routing based on document type and value +- **CMMN Case**: Exception handling for review issues +- **Validation**: Schema-based validation for all artifacts + +## Features + +- ✅ Complete Level-4 process package +- ✅ Validation schema support +- ✅ Multiple approval levels +- ✅ Exception handling +- ✅ Template variable support +- ✅ Enterprise indexing + +## Usage + +This template is used when creating new ProcessGit repositories that require validation-ready processes. diff --git a/demo-process/bpmn/process.bpmn.xml b/demo-process/bpmn/process.bpmn.xml new file mode 100644 index 0000000..5340e2c --- /dev/null +++ b/demo-process/bpmn/process.bpmn.xml @@ -0,0 +1,309 @@ + + + + + + + + Flow_1 + + + + + Flow_1 + Flow_2 + + + + + Flow_2 + Flow_3 + + + + + Flow_3 + Flow_Valid + Flow_Invalid + + + + + Flow_Invalid + Flow_Rejected + + + + + Flow_Valid + Flow_4 + + + + + Flow_4 + Flow_5 + + + + + Flow_5 + Flow_Approved + Flow_RejectedReview + Flow_NeedsRevision + + + + + Flow_Approved + Flow_6 + + + + + Flow_RejectedReview + Flow_Rejected + + + + + Flow_NeedsRevision + Flow_RevisionRequested + + + + + Flow_6 + Flow_7 + + + + + Flow_7 + Flow_Rejected + Flow_RevisionRequested + Flow_8 + + + + + Flow_8 + + + + + + + + + formatValid == true + + + + formatValid == false + + + + + + + decision == "approved" + + + + decision == "rejected" + + + + decision == "revision" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/demo-process/cmmn/case.cmmn.xml b/demo-process/cmmn/case.cmmn.xml new file mode 100644 index 0000000..ef8434f --- /dev/null +++ b/demo-process/cmmn/case.cmmn.xml @@ -0,0 +1,273 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + create + + + + + + complete + + + + + + + exceptionType == "critical" || exceptionAge > 72 + + + + + + + complete + + + + + + + + + + + + + + + + + + + + + + + + + complete + + + + + + complete + + + + + + complete + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + complete + + + + + + complete + + + + + + + + + + + + + + + + + + + + + + + + + complete + + + + + + complete + + + + + + complete + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/demo-process/dmn/decisions.dmn.xml b/demo-process/dmn/decisions.dmn.xml new file mode 100644 index 0000000..2355622 --- /dev/null +++ b/demo-process/dmn/decisions.dmn.xml @@ -0,0 +1,346 @@ + + + + + + + + + + + + + + + + + + + + documentType + + + + + + documentValue + + + + + + department + + + + + + + + + + + + + + + "Contract","Purchase Order","Financial Statement" + + + >= 100000 + + + - + + + "Executive" + + + 3 + + + "CFO, CEO, Board Member" + + + 72 + + + + + + + "Contract","Purchase Order" + + + [10000..100000) + + + - + + + "Senior Management" + + + 2 + + + "Director, VP Finance" + + + 48 + + + + + + + "Purchase Order" + + + < 10000 + + + - + + + "Manager" + + + 1 + + + "Department Manager" + + + 24 + + + + + + + "Legal Agreement","NDA","Compliance Document" + + + - + + + - + + + "Legal" + + + 2 + + + "Legal Counsel, CLO" + + + 48 + + + + + + + "HR Policy","Employee Handbook" + + + - + + + "Human Resources" + + + "HR Leadership" + + + 2 + + + "HR Director, CHRO" + + + 48 + + + + + + + "Technical Specification","Architecture Document","API Documentation" + + + - + + + "Engineering" + + + "Technical" + + + 2 + + + "Tech Lead, Engineering Manager" + + + 24 + + + + + + + "Marketing Material","Press Release","Blog Post" + + + - + + + "Marketing" + + + "Marketing" + + + 1 + + + "Marketing Manager" + + + 12 + + + + + + + "SOP","Process Document","Work Instruction" + + + - + + + - + + + "Process Owner" + + + 2 + + + "Process Owner, Quality Manager" + + + 36 + + + + + + + "Training Material","User Guide","Tutorial" + + + - + + + - + + + "Standard" + + + 1 + + + "Department Manager" + + + 24 + + + + + + + - + + + - + + + - + + + "Standard" + + + 1 + + + "Manager" + + + 24 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/demo-process/docs/notes.md b/demo-process/docs/notes.md new file mode 100644 index 0000000..32d2021 --- /dev/null +++ b/demo-process/docs/notes.md @@ -0,0 +1,44 @@ +# Document Review & Approval Process + +## Overview +This process handles the review and approval workflow for various document types within the organization. + +## Process Flow +1. **Document Submission**: User submits a document for review +2. **Format Validation**: Automated validation of document format and structure +3. **Review**: Designated reviewers assess the document content +4. **Approval Determination**: Business rules determine required approval levels based on document type and value +5. **Decision**: Document is approved, rejected, or sent back for revision +6. **Publication**: Approved documents are published to the appropriate repository + +## Key Features +- Automated format validation +- Dynamic approval routing based on document type and value +- Exception handling through CMMN case management +- Multiple outcome paths (approve/reject/revise) + +## Approval Levels +- **Standard**: Single manager approval for routine documents +- **Manager**: Department manager approval for low-value transactions +- **Senior Management**: Director/VP approval for medium-value transactions +- **Executive**: C-level approval for high-value or critical documents +- **Legal**: Legal counsel approval for contracts and compliance documents +- **Technical**: Engineering leadership approval for technical specifications + +## Document Types Supported +- Contracts and Purchase Orders +- Financial Statements +- Legal Agreements and NDAs +- HR Policies +- Technical Specifications +- Marketing Materials +- Standard Operating Procedures +- Training Materials + +## Exception Handling +When issues arise during the review process, a CMMN case is created to manage: +- Format correction +- Missing information requests +- Reviewer reassignment +- Stakeholder escalation +- Resolution verification diff --git a/demo-process/metadata/lifecycle.yaml b/demo-process/metadata/lifecycle.yaml new file mode 100644 index 0000000..2fc5be2 --- /dev/null +++ b/demo-process/metadata/lifecycle.yaml @@ -0,0 +1,7 @@ +kind: uapf.metadata.lifecycle +status: draft +effectiveFrom: null +effectiveUntil: null +reviewCycle: quarterly +lastReview: null +nextReview: null diff --git a/demo-process/metadata/ownership.yaml b/demo-process/metadata/ownership.yaml new file mode 100644 index 0000000..8dc309e --- /dev/null +++ b/demo-process/metadata/ownership.yaml @@ -0,0 +1,7 @@ +kind: uapf.metadata.ownership +owners: + - type: team + id: "{{.RepoOwner}}" + name: "{{.RepoOwner}}" +created: "2025-01-01" +updated: "2025-01-01" diff --git a/demo-process/resources/mappings.yaml b/demo-process/resources/mappings.yaml new file mode 100644 index 0000000..2e4f705 --- /dev/null +++ b/demo-process/resources/mappings.yaml @@ -0,0 +1,3 @@ +kind: uapf.resources.mapping +targets: [] +bindings: [] diff --git a/demo-process/uapf.yaml b/demo-process/uapf.yaml new file mode 100644 index 0000000..a9080d4 --- /dev/null +++ b/demo-process/uapf.yaml @@ -0,0 +1,25 @@ +kind: uapf.package +id: uapf.validation-ready +name: Validation Ready Process +description: Process with validation schemas +level: 4 +version: 0.1.0 +includes: [] +cornerstones: + bpmn: true + dmn: true + cmmn: true + resources: true + validation: true +paths: + bpmn: bpmn + dmn: dmn + cmmn: cmmn + resources: resources + metadata: metadata + validation: ../validation +owners: + - type: team + id: "{{.RepoOwner}}" + contact: "{{.RepoOwner}}@processgit.local" +lifecycle: draft diff --git a/enterprise/enterprise.yaml b/enterprise/enterprise.yaml new file mode 100644 index 0000000..68d44a5 --- /dev/null +++ b/enterprise/enterprise.yaml @@ -0,0 +1,10 @@ +kind: uapf.enterprise.index +level: 0 +enterprise: + id: "{{.RepoName}}" + name: "{{.RepoName}}" + description: Enterprise process collection for {{.RepoOwner}} +packages: + - ref: ../demo-process + level: 4 + domain: operations diff --git a/tools/validate.sh b/tools/validate.sh new file mode 100755 index 0000000..c548c92 --- /dev/null +++ b/tools/validate.sh @@ -0,0 +1,25 @@ +#!/usr/bin/env sh +set -eu + +log() { + printf '%s\n' "$1" +} + +log "Checking required files" +REQUIRED_PATHS="enterprise/enterprise.index.json packages" +for path in $REQUIRED_PATHS; do + if [ ! -e "$path" ]; then + log "Missing required path: $path" + exit 1 + fi +done + +log "Validating XML assets when xmllint is available" +if command -v xmllint >/dev/null 2>&1; then + find . -type f \( -name '*.bpmn' -o -name '*.dmn' -o -name '*.cmmn' \) -print0 | + xargs -0 -r -n1 xmllint --noout +else + log "xmllint not installed; skipping XML validation" +fi + +log "Validation complete" diff --git a/validation/schemas/README.md b/validation/schemas/README.md new file mode 100644 index 0000000..629a859 --- /dev/null +++ b/validation/schemas/README.md @@ -0,0 +1,41 @@ +# Validation Schemas + +This directory contains validation schemas for process artifacts. + +## Purpose +Validation schemas ensure that process definitions, configurations, and resources conform to organizational standards and best practices. + +## Schema Types + +### BPMN Schemas +- Process model validation rules +- Task naming conventions +- Gateway configuration requirements + +### DMN Schemas +- Decision table structure validation +- Input/output data type validation +- Hit policy compliance + +### CMMN Schemas +- Case model validation rules +- Sentry and milestone configuration +- Stage dependency validation + +### Resource Schemas +- Resource mapping validation +- Binding configuration rules +- Target definition standards + +## Usage +Schemas in this directory are automatically applied during: +- Process package validation +- CI/CD pipeline checks +- Pre-commit hooks +- Repository template instantiation + +## Adding New Schemas +1. Create schema file in appropriate subdirectory +2. Follow JSON Schema or XML Schema standards +3. Document validation rules and examples +4. Update validation configuration to reference new schema