Benevia Core Documentation

Benevia Core is an event-driven platform built around entities and their properties. You describe your model with attributes, and the framework handles the plumbing such as required fields, relationships, schema updates, and API generation. Business logic runs on the server through entity events, so behavior stays consistent no matter which client sends data. Frontend engineers can focus on the presentation layer, using entity metadata to generate consistent property components automatically.

Concepts and getting started

• Introduction to event-driven architecture - Understand event-driven concepts and development
• Quick Start - Start your project with a template. Be up and running in minutes
• Feature in a box - Organize your code well so that features in large projects can easily be understood and maintained

Platform Documentation

Configuration

• Configure your APP - Register services and setup your tenants
• Role-based access control (RBAC) - Define permissions in responsibilities and assign roles to users

Entities and logic (Server development)

• Create your model - Defining your entities
• Add logic to events - Add business logic for your entities
• Use interfaces - Adds powerful tools to C# interfaces. Reduce duplicate code with similar entities or add traits to entities.
• Database upgrade - Migrating data when the database schema changes
• Expose entities via MCP - AI client integration with auto-generated tools

Logging and debugging

• Common pitfalls - Pitfalls with event-driven architecture
• Observability - Standard ILogger and OpenTelemetry tracing, with built-in spans for events and OData requests.
• Debugging property changes - Tips on debugging property changes especially when using computes

Client development

• Use your API - OData API generation details
• Client libraries - Create clients that communicate with the API and create components based on entity meta data.