Enterprise React + TypeScript frontend for semantic-driven modernization from mainframe COBOL to Spring Boot + JPA + RESTful API using a DeepSeek-powered multi-agent pipeline.

This platform is designed for modernization factories and architecture teams to manage full migration lifecycle:

• Legacy artifact intake (COBOL, Copybook, JCL, VSAM, DB2, CICS, BMS)
• RAG grounding visibility
• Intermediate Representation (Program IR, Data IR, Logic IR)
• Agent pipeline orchestration
• Semantic mapping from legacy constructs to Spring Boot architecture
• Generated code and project structure inspection
• Validation, diff, risk, and audit governance
• Human-in-the-loop review workflows

• App shell + route modules with 12 dedicated product workspaces.
• Feature-first organization under src/features/*.
• Reusable components for layout, cards, tables, code viewer, JSON viewer, and tree viewer.
• Zustand state store for selected assets/code and DeepSeek settings.
• Service layer abstraction with typed DeepSeek client and domain services:
  • deepseekClient.ts
  • ragRetrievalService.ts
  • irBuilderService.ts
  • migrationAgentService.ts
  • reviewService.ts
• Mock data mode for demo and offline simulation.

npm install
npm run dev

Production build:

npm run build
npm run preview

1. Copy .env.example to .env
2. Set your key:

VITE_DEEPSEEK_API_KEY=your_key_here

3. Optional overrides:
   • VITE_DEEPSEEK_BASE_URL
   • VITE_DEEPSEEK_MODEL

VITE_MOCK_MODE=true keeps the platform running on enterprise-grade sample migration data.

Set VITE_MOCK_MODE=false to prepare for live API calls to DeepSeek from deepseekClient.ts.

src/
  app/
  components/
    common/
    layout/
    navigation/
    viewers/
    cards/
    tables/
  features/
    dashboard/
    legacy-assets/
    rag-knowledge/
    ir/
    agent-pipeline/
    semantic-mapping/
    outputs/
    code-viewer/
    validation-audit/
    review-center/
    llm-console/
    settings/
  services/
    api/
    deepseek/
    migration/
    rag/
    ir/
    review/
  store/
  types/
  data/
  routes/
  styles/

1. Add new typed agent data in src/types/domain.ts and src/data/mockData.ts
2. Extend orchestration logic in src/services/migration/migrationAgentService.ts
3. Add visualization detail in src/features/agent-pipeline/AgentPipelinePage.tsx
4. Add RAG grounding strategy in src/services/rag/ragRetrievalService.ts

• Keep agent prompts and migration contracts provider-neutral at feature/service level.
• Introduce a provider interface in src/services/deepseek/* and add another provider client implementation.
• Route selection by settings store (mock/live/provider) without changing UI modules.