.NET to React + Python Refactor Agent

Core Workflow

Phase 1: Assessment & Architecture Planning

1. Analyze .NET application — run the assessment script:

   python scripts/assess_dotnet_app.py /path/to/dotnet/project
   

   Outputs: project type, controllers, models, views, services, DB contexts, auth, NuGet packages.

2. Design target architecture (see

   references/architecture-patterns.md

   ):
   • Frontend: React SPA (routing, state management, UI framework)
   • Backend: Python REST API (FastAPI/Flask/Django) + ORM
   • Auth: JWT, OAuth2, or session-based
   • Data: same DB or migration strategy

Phase 2: Backend Migration (.NET → Python)

1. Initialize Python backend:

   python scripts/init_python_backend.py <name> --framework fastapi --db-type postgresql
   

   Framework choice: FastAPI (async, OpenAPI docs), Flask (lightweight), Django REST (full-featured with ORM/admin).

2. Migrate business logic: map .NET controllers → Python endpoints; translate C# classes, LINQ → Python/ORM queries, async/await patterns. See

   references/framework-equivalents.md

   .

3. Data access: map Entity Framework models → SQLAlchemy/Django ORM; convert queries and stored procedures. See

   references/orm-migration.md

   .

4. Auth: map ASP.NET Identity → JWT tokens or session auth; preserve role-based/policy authorization. See

   references/authentication-patterns.md

   .

Phase 3: Frontend Migration (.NET Views → React)

1. Initialize React (Vite recommended):

   npm create vite@latest frontend -- --template react-ts
   

   See

   assets/react-project-template/

   for recommended structure.

2. Convert Razor views to JSX (semi-automated):

   python scripts/convert_razor_to_jsx.py ./Views --output ./frontend/src/components
   

   Use

   assets/react-component-templates/

   for production-ready Button, Input, and Modal components.

3. State management: Context API (small apps), Zustand (medium), Redux Toolkit (large); convert ViewBag/ViewData to component or global state.

4. Routing: replace ASP.NET routing with React Router; implement protected routes for authenticated pages.

5. API integration: React Query + axios with auth interceptors. See

   references/api-integration.md

   .

6. Forms: React Hook Form or Formik; client-side validation matching backend rules.

Phase 4: Data Layer Migration

1. Generate ORM models:

   python scripts/generate_migration.py /path/to/models --framework sqlalchemy --output ./migrations
   

2. Preserve relationships, constraints, indexes, and custom type mappings.

3. Apply migrations: Alembic (SQLAlchemy) or Django migrations.

Phase 5: Testing & Validation

• Backend (pytest): unit tests, endpoint integration tests, auth flows, error handling.
• Frontend (Jest + RTL): component tests; Cypress/Playwright for E2E.
• Data integrity: compare query results between .NET and Python; validate CRUD and cascading deletes.

Phase 6: Deployment

1. Environment: configure env vars, secrets, and per-environment configs (dev/staging/prod).
2. Backend: Gunicorn/Uvicorn + Nginx reverse proxy; health checks and DB connection pooling.
3. Frontend: production build → static hosting (Netlify, Vercel, S3+CloudFront); CDN for assets.
4. Cutover strategy: Big Bang (fast, higher risk) | Strangler Fig (incremental, lower risk) | Parallel Run.
5. See

   references/deployment-guides/

   for step-by-step Docker Compose and AWS guides. Use

   assets/docker-compose.yml

   and

   assets/nginx.conf

   .

Execution Guidelines

Order: backend first → frontend as endpoints become available → staging validation → cutover with rollback plan.

Key pitfalls:

• N+1 queries: Python ORM lazy loading differs from Entity Framework
• Async/await: C# and Python semantics differ
• Timezones: standardize on UTC
• Decimal precision: map carefully for financial calculations

Standards: PEP 8 + type hints + mypy (Python); ESLint + Prettier + TypeScript (React); 80%+ test coverage.

Performance: profile DB queries early; add Redis caching; paginate large datasets; use React.memo/useMemo and lazy loading.

Quick Reference

Scripts

assess_dotnet_app.py

init_python_backend.py

generate_migration.py

convert_razor_to_jsx.py

Reference Docs (

references/

)

architecture-patterns.md

framework-equivalents.md

orm-migration.md

authentication-patterns.md

api-integration.md

testing-strategies.md

security-hardening-checklist.md

troubleshooting-guide.md

deployment-guides/docker-compose-deployment.md

deployment-guides/aws-deployment.md

Assets (

assets/

)

react-project-template/

react-component-templates/

docker-compose.yml

nginx.conf

Dockerfile.dev

.env.example

cicd-templates/