⚙️ OpsFlow

Enterprise marketing operations & budget intelligence platform — SOX-compliant budget management, multi-level approval workflows, simplex-based budget optimization, and financial forecasting for marketing operations teams.

Budget Dashboard • Quick Start • Architecture • API • Modules • Contributing

---

⭐ Managing marketing budgets? Star OpsFlow to support open-source ops tools!

---

💼 Budget Dashboard

┌──────────────────────────────────────────────────────────────────┐
│                        BUDGET PLAN — Q3 2026                     │
├──────────────────────────────────────────────────────────────────┤
│  ID:     bp-2026-Q3          Status: PENDING_APPROVAL            │
│  Name:   Q3 Enterprise      Created: 2026-06-15                  │
│  Fiscal: FY2026             Total:   $345,000 / $500,000         │
├──────────────────────────────────────────────────────────────────┤
│  LINE ITEMS                            AMOUNT      APPROVED     │
│  ─────────────────────────────────────────────────────────────  │
│  📺 Digital Display                    $120,000     ✅  (Mgr)   │
│  🔍 Search Ads                         $85,000      ✅  (Dir)   │
│  📱 Social Media                       $65,000      ⏳ Pending  │
│  ✍️ Content Production                 $45,000      ⏳ Pending  │
│  🤝 Agency Fees                        $30,000      ❌ Rejected │
├──────────────────────────────────────────────────────────────────┤
│  SPENT:     $345,000 / $500,000  (69%)                          │
│  REMAINING: $155,000                                             │
├──────────────────────────────────────────────────────────────────┤
│  APPROVAL CHAIN:  Manager → Director → Finance → CFO            │
│  CURRENT STEP:    Director Pending                              │
│  ⏱ SLA:            48 hours  (22h remaining)                    │
└──────────────────────────────────────────────────────────────────┘

Features

Feature	Description	Compliance
Budget Management	Plans, line items, fiscal periods, rollovers, reallocations	SOX-compliant
Approval Workflow	Multi-level chains with escalation rules and SLA tracking	Audit-ready
Simplex Optimizer	Linear programming budget allocation with constraints	Optimal allocation
Forecasting	Time-series ARIMA with seasonality decomposition	±5% MAPE at 90 days
SOX Compliance	Audit trails, segregation of duties, approval logging	SOC 2 ready
CLI + API	Full REST API + CLI for CI/CD integration	—

---

Quick Start

# Create a budget plan
dotnet run -- budget create "Q3 Enterprise" 2026 500000

# Approve a line item
dotnet run -- budget approve bp-2026-Q3 \
  --line "Digital Display" \
  --role manager

# Run simplex optimization
dotnet run -- optimize simplex bp-2026-Q3 \
  --goal maximize_reach

# Generate forecast report
dotnet run -- report forecast bp-2026-Q3 --months 6

// Programmatic API
using OpsFlow.Core.Services;

var solver = new SimplexSolver();
solver.AddVariable("digital_display", 0, 200000);
solver.AddVariable("search_ads", 0, 150000);
solver.AddVariable("social_media", 0, 100000);

solver.AddConstraint(
    "total",
    "digital_display + search_ads + social_media <= 300000"
);

solver.SetObjective("maximize",
    "0.05 * digital_display + 0.08 * search_ads + 0.06 * social_media"
);

var result = solver.Solve();
// digital_display: $180,000  search_ads: $120,000  social_media: $0
// Objective: 18,600 conversions

---

Architecture

flowchart TB
    subgraph CLI["OpsFlow CLI"]
        CLI_BIN[Program.cs] --> CMD[Command Router]
        CMD --> BUDGET[Budget Commands]
        CMD --> APPROVE[Approval Commands]
        CMD --> OPTIMIZE[Optimize Commands]
        CMD --> REPORT[Report Commands]
    end

    subgraph API["OpsFlow API"]
        API_SERVER[Program.cs] --> CTRL[Controllers]
        CTRL --> BUDGET_API[Budget Endpoints]
        CTRL --> APPROVE_API[Approval Endpoints]
        CTRL --> FORECAST_API[Forecast Endpoints]
    end

    subgraph Core["OpsFlow Core"]
        BUDGET_API --> BS[BudgetService]
        APPROVE_API --> AS[ApprovalService]
        FORECAST_API --> FS[ForecastService]

        BS --> SS[SimplexSolver]
        AS --> AW[ApprovalWorkflow]
        FS --> BF[BudgetForecaster]

        BS --> STR[(InMemoryStore)]
        AS --> STR
        FS --> STR
    end

    subgraph Tests["Tests (xUnit)"]
        BS --> T1[BudgetPlanService.Test]
        AS --> T2[ApprovalWorkflow.Test]
        SS --> T3[SimplexSolver.Test]
        BF --> T4[BudgetForecaster.Test]
        AW --> T5[ComplianceAuditor.Test]
    end

Loading

---

SOX Compliance

var auditor = new ComplianceAuditor();
var issues = auditor.Audit(budgetPlan);

foreach (var issue in issues)
{
    Console.WriteLine($"[{issue.Severity}] {issue.Description}");
}

// Sample output:
// [Error] Segregation of Duties: same user created and approved line item
// [Warning] Budget threshold exceeded: 95% of total allocated
// [Info] Missing documentation for line item "Agency Fees"

Approval Workflow

flowchart LR
    D[Created] -->|submit| MP[Manager Pending]
    MP -->|approve| DP[Director Pending]
    MP -->|reject| R[Rejected ❌]
    DP -->|approve| FP[Finance Pending]
    DP -->|reject| R
    FP -->|approve| C[CFO Pending]
    FP -->|reject| R
    C -->|approve| A[Approved ✅]
    C -->|reject| R

    MP -->|escalate 48h| DP
    DP -->|escalate 48h| FP
    FP -->|escalate 48h| C

Loading

---

API

Method	Path	Description
POST	/api/budgets	Create budget plan
GET	/api/budgets	List budget plans
GET	/api/budgets/{id}	Get budget details with line items
POST	/api/budgets/{id}/approve	Approve/reject a line item
POST	/api/budgets/{id}/optimize	Run simplex optimization
GET	/api/budgets/{id}/forecast	Get spend forecast

---

Modules

OpsFlow.sln
├── src/
│   ├── OpsFlow.Core/          # Domain models, services, stores
│   │   ├── Models/             # BudgetPlan, LineItem, ApprovalChain
│   │   ├── Services/           # BudgetService, ApprovalWorkflow,
│   │   │                       # SimplexSolver, BudgetForecaster
│   │   └── Stores/             # InMemoryStore (pluggable)
│   ├── OpsFlow.Api/            # REST API (ASP.NET Core)
│   │   └── Program.cs          # 14 endpoints
│   └── OpsFlow.Cli/            # CLI tool
│       └── Program.cs          # 5 command groups
└── tests/
    └── OpsFlow.Tests/          # xUnit test suite (5 classes, 30+ tests)

---

Contributing

See CONTRIBUTING.md for guidelines.

• Open an issue

---

License

MIT

---

🌐 Crynge Ecosystem

All repos are free and open-source. ⭐ Star what you use!

Category	Repos
LLM & AI	SpecInferKit · AetherAgents · PromptShield
Marketing	AdVerify · Attributor · InfluencerHub · EdgePersona · AdVantage · BrandMuse · CampaignForge
Simulation	CivSim · EvalScope
Operations	OpsFlow

_{Built by Crynge · ⭐ Star us on GitHub!}