DynamicFormBuilder.Domain 1.0.0

Dynamic Form Builder Package

A flexible and powerful .NET 9 package for building dynamic forms with rich validation and customization options.

Features

• Create and manage dynamic forms with various question types
• Support for multiple question types:
  • Text (single-line and multi-line)
  • DateTime (with optional time component)
  • Single Choice (dropdown or radio buttons)
  • Multiple Choice (checkboxes)
• Built-in validation framework
• Form submissions storage and retrieval
• Clean Architecture design
• Full UI components for form design and rendering
• API-first approach with Swagger documentation

Architecture

The solution follows Clean Architecture principles with the following projects:

• DynamicFormBuilder.Domain: Core entities and business rules
• DynamicFormBuilder.Application: Use cases, interfaces, and application logic
• DynamicFormBuilder.Infrastructure: Data persistence and external integrations
• DynamicFormBuilder.UI: Razor components for form rendering
• DynamicFormBuilder.Api: RESTful API endpoints

Prerequisites

• .NET 9.0 SDK
• SQL Server (can be run using Docker)
• Visual Studio 2022+ or Visual Studio Code

Installation

1. Clone the repository:

git clone https://github.com/yourusername/form-builder-package.git
cd form-builder-package

2. Restore dependencies:

dotnet restore

3. Update database connection string in appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=FormBuilder;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

4. Apply database migrations:

cd DynamicFormBuilder.Api
dotnet ef database update

Usage

API Integration

1. Add package references to your project:

<PackageReference Include="DynamicFormBuilder.Core" Version="1.0.0" />
<PackageReference Include="DynamicFormBuilder.EntityFrameworkCore" Version="1.0.0" />

2. Register services in your Program.cs:

services.AddDynamicFormBuilder(options => {
    options.UseConnectionString("DefaultConnection");
    options.UsePermissions(PermissionScheme.Simple);
});

UI Integration

1. Add the UI package:

<PackageReference Include="DynamicFormBuilder.UI" Version="1.0.0" />

2. Use the components in your Razor pages:

<DynamicFormDesigner FormId="@formId" />
<DynamicFormRenderer FormId="@formId" />

API Documentation

The API is documented using Swagger/OpenAPI. When running in development mode, access the Swagger UI at:

https://localhost:5001/swagger

Testing

The solution includes comprehensive tests:

dotnet test

Includes:

• Unit tests for domain logic
• Integration tests for repositories
• End-to-end API tests
• UI component tests

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.