@rhart696/framework

Healthcare equity value assessment framework for Canadian healthcare enterprises.

Overview

The CHEEV Framework is a comprehensive assessment and strategy generation toolkit designed for consulting teams working with healthcare organizations. It provides standardized schemas, validation logic, and AI-powered analytics for evaluating and improving equity value.

Features

 Currently Implemented (v1.1.0)

• Assessment Schemas: Zod-based validation schemas for healthcare assessments
• Data Types: TypeScript types for assessments, roadmaps, and strategy planning
• Market Position Constants: Standardized market position categorization
• Roadmap Types: Type-safe roadmap and task structures
• AI Insights: Genkit-powered document analysis and insight generation
• File Utilities: Helper functions for file handling and data URI conversion

=� Planned for Future Releases

• Assessment Scoring: Multi-category scoring algorithms with industry benchmarks
• Strategy Generation: Recommendation engine based on assessment results
• Analytics Engine: Advanced calculations and progress tracking
• PDF Export: Generate client-facing reports and deliverables
• Template System: Pre-built assessment and roadmap templates

Installation

npm install @rhart696/framework

Usage

Assessment Schema

import { assessmentFormSchema, type AssessmentFormInput } from "@rhart696/framework";

// Validate assessment data
const assessmentData: AssessmentFormInput = {
  companyName: "Healthcare Corp",
  financialHealth: 7,
  operationalEfficiency: 8,
  marketPosition: "challenger",
  growthStrategy: "Geographic expansion into underserved markets"
};

const result = assessmentFormSchema.safeParse(assessmentData);

AI Insights

import { generateInsights, fileToDataURI } from "@rhart696/framework";
import { ai } from "./your-genkit-config";

// Convert file to data URI
const file = await fetch("/path/to/document.pdf").then(r => r.blob());
const dataUri = await fileToDataURI(file as File);

// Generate insights
const insights = await generateInsights(
  {
    documentDataUri: dataUri,
    query: "What are the key financial metrics in this assessment?"
  },
  ai
);

console.log(insights.insights);

Roadmap Types

import { type RoadmapColumn, defaultRoadmapColumns } from "@rhart696/framework";

// Use default roadmap structure
const roadmap: RoadmapColumn[] = defaultRoadmapColumns;

// Or create custom columns
const customRoadmap: RoadmapColumn[] = [
  {
    id: "planning",
    title: "Planning",
    tasks: [
      { id: "1", content: "Stakeholder interviews" }
    ]
  },
  // ... more columns
];

Project Structure

src/
�� assessment/
   �� scoring.ts              # Scoring algorithms (planned)
   �� validation.ts           # Validation schemas
   �� analytics.ts            # AI-powered insights
�� strategy/
   �� roadmap-builder.ts      # Roadmap types and defaults
   �� recommendation-engine.ts # Strategy generation (planned)
�� data/
   �� types.ts                # Core TypeScript types and schemas
   �� schemas/                # Additional schema definitions
�� export/
   �� pdf-generator.ts        # PDF export utilities (planned)
   �� templates/              # Export templates
�� index.ts                    # Main package exports

Dependencies

• zod (^3.24.2) - Schema validation
• genkit (optional) - AI flow integration

Development Status

Version: 1.1.0 Status: Early Development

This package is in active development. Core types and schemas are stable, but scoring algorithms and strategy generation features are planned for future releases.

Roadmap

Phase 1: Foundation (v1.0-1.1) 

• Core type definitions
• Assessment and roadmap schemas
• AI insights integration

Phase 2: Scoring Engine (v1.2-1.3) =�

• Multi-category scoring algorithms
• Industry benchmark data
• Progress tracking comparisons

Phase 3: Strategy Generation (v1.4-1.5) =�

• Recommendation engine
• Task prioritization logic
• Template system

Phase 4: Export & Analytics (v1.6-1.7) =�

• PDF generation
• Advanced analytics
• Custom report templates

Contributing

This is an internal framework under active development. Core implementations should be validated with real client data before being added to the package.

License

See LICENSE file for details.

Support

For questions or issues, please contact the CHEEV Framework development team.