# zju-aces-ise/chatunitest-core architecture

> Architecture diagram of the GitHub repository zju-aces-ise/chatunitest-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zju-aces-ise/chatunitest-core
- Repository: https://github.com/zju-aces-ise/chatunitest-core

## Overview

##### Project type and purpose
- This is a Java-based core library (“chatunitest-core”) that implements a “Generate-Validate-Fix” framework for automated unit-test generation using large language models.
- It is packaged as a Maven artifact and consumed by plugins (Maven plugin, IntelliJ IDEA plugin) to integrate into existing Java build workflows.

##### File structure
- Top‐level:
- pom.xml (build + dependency)
- src/main/java: two major packages:
– slicing: a static‐analysis engine (CFG/PDG/SDG builders, slicing algorithms)
– zju.cst.aces: the core API (generator, runner, phase, prompt, parser, coverage, util, dto, graph)
- src/main/resources: configuration (config.properties) and Freemarker templates (FTL files)
- No “frontend” or UI; this is a back-end library consisting of modular subsystems.

##### README
- Describes the workflow: Build core → add as Maven dependency → configure templates → run plugin.
- Mentions FTL (Freemarker) templates for prompt generation, extensibility via Java enums and PhaseImpl subclasses.
- Outlines “Generate‐Validate‐Fix” steps.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Subgraphs
    subgraph "1. Source-code Input & Parser"
        direction TB
        ProjectParser["ProjectParser"]:::internal
        ClassParser["ClassParser"]:::internal
    end

    DTOs["AST/Metadata DTOs"]:::dto

    subgraph "2. Slicing Engine"
        direction TB
        SlicingEngine["Slicing Engine"]:::internal
    end

    subgraph "3. Prompt Generator"
        direction TB
        PromptGenerator["PromptGenerator"]:::internal
        PromptFile["PromptFile Enum"]:::internal
    end

    subgraph "4. Chat Service Adapter"
        direction TB
        AskGPT["AskGPT (LLM Adapter)"]:::external
    end

    subgraph "5. Response Processor"
        direction TB
        JsonResponseProcessor["JsonResponseProcessor"]:::internal
    end

    subgraph "6. Runner / Execution Engine"
        direction TB
        ClassRunner["ClassRunner"]:::internal
        MethodRunner["MethodRunner"]:::internal
        subgraph "Solution Runners"
            direction TB
            SolutionRunners["*Runner implementations"]:::internal
        end
    end

    subgraph "7. Validator & Coverage Analyzer"
        direction TB
        ValidatorImpl["ValidatorImpl"]:::internal
        CodeCoverageAnalyzer["CodeCoverageAnalyzer"]:::internal
    end

    subgraph "8. Configuration & Templates"
        direction TB
        ConfigProps["config.properties"]:::config
        PromptFTL["Freemarker Templates"]:::config
    end

    LLM["OpenAI API"]:::external

    %% Data Flows
    ProjectParser -->|"1. parse source"| DTOs
    ClassParser -->|"1. parse source"| DTOs

    DTOs -->|"2. slicing criterion"| SlicingEngine
    SlicingEngine -->|"3. code slice"| PromptGenerator

    PromptGenerator -->|"4. generate messages"| AskGPT
    AskGPT -->|"5. LLM response"| JsonResponseProcessor

    JsonResponseProcessor -->|"6. code snippet"| ClassRunner
    JsonResponseProcessor -->|"6. code snippet"| MethodRunner
    JsonResponseProcessor -->|"6. code snippet"| SolutionRunners

    ClassRunner -->|"7. execute tests"| ValidatorImpl
    MethodRunner -->|"7. execute tests"| ValidatorImpl
    SolutionRunners -->|"7. execute tests"| ValidatorImpl

    ValidatorImpl -->|"7. analyze coverage"| CodeCoverageAnalyzer

    CodeCoverageAnalyzer -->|"8. feedback on failure"| PromptGenerator

    PromptGenerator --> PromptFTL
    PromptGenerator --> ConfigProps

    AskGPT --> LLM

    %% Click Events
    click ProjectParser "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/parser/ProjectParser.java"
    click ClassParser "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/parser/ClassParser.java"
    click SlicingEngine "https://github.com/zju-aces-ise/chatunitest-core/tree/main/src/main/java/slicing"
    click PromptGenerator "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/prompt/PromptGenerator.java"
    click PromptFile "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/prompt/PromptFile.java"
    click AskGPT "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/util/AskGPT.java"
    click JsonResponseProcessor "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/util/JsonResponseProcessor.java"
    click ClassRunner "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/runner/ClassRunner.java"
    click MethodRunner "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/runner/MethodRunner.java"
    click SolutionRunners "https://github.com/zju-aces-ise/chatunitest-core/tree/main/src/main/java/zju/cst/aces/runner/solution_runner"
    click ValidatorImpl "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/api/impl/ValidatorImpl.java"
    click CodeCoverageAnalyzer "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/java/zju/cst/aces/coverage/CodeCoverageAnalyzer.java"
    click DTOs "https://github.com/zju-aces-ise/chatunitest-core/tree/main/src/main/java/zju/cst/aces/dto"
    click ConfigProps "https://github.com/zju-aces-ise/chatunitest-core/blob/main/src/main/resources/config.properties"
    click PromptFTL "https://github.com/zju-aces-ise/chatunitest-core/tree/main/src/main/resources/prompt"

    %% Styles
    classDef internal fill:#AED6F1,stroke:#21618C,color:#154360
    classDef external fill:#A9DFBF,stroke:#1D8348,color:#145A32
    classDef config fill:#F9E79F,stroke:#B9770E,color:#7E5109
    classDef dto fill:#D2B4DE,stroke:#6C3483,color:#4A235A
```
