Add .NET Framework to .NET Core Migration Assessment Documentation #9
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add .NET Framework to .NET Core Migration Assessment Documentation
Summary
This PR adds comprehensive documentation for the planned migration of SampleMvcWebApp from .NET Framework 4.5.1 to .NET Core 6+. This is an assessment-only task with no code changes - the documentation will guide the actual migration implementation.
Three deliverables are included:
DEPENDENCY_ANALYSIS.md - Detailed analysis of all .NET Framework packages and their .NET Core alternatives, covering Entity Framework 6 → EF Core, ASP.NET MVC 5 → ASP.NET Core MVC, Autofac 3.5 → 8.x, System.Web dependencies, AutoMapper, Identity, SignalR, and the GenericServices replacement strategy using MediatR.
MIGRATION_BOUNDARIES.md - Layer-by-layer breakdown of the 3-tier architecture (DataLayer, ServiceLayer, SampleWebApp), listing every file that requires modification, the type of change needed, and a recommended 6-week phased migration order.
MIGRATION_BOUNDARY_DIAGRAM.md - Visual diagrams in Mermaid format showing architecture overview, layer dependencies, migration flow, current vs target architecture comparison, entity relationships, and file migration status matrix.
Review & Testing Checklist for Human
Recommended verification: Open each markdown file in GitHub's preview mode to ensure diagrams render properly. Cross-reference the dependency lists against the actual
packages.configfiles in DataLayer, ServiceLayer, and SampleWebApp projects.Notes
This assessment identifies that the ServiceLayer migration (Weeks 3-4) carries the highest risk due to the complete replacement of GenericServices with custom services + MediatR. The DataLayer migration is recommended first as it has no upstream dependencies and can be tested in isolation.
Key architectural decisions documented:
Link to Devin run: https://app.devin.ai/sessions/0555a6b280cb4046a115b3ba284b1655
Requested by: Abhay Aggarwal (@abhay-codeium)