# hrishikeshmundhe/rule-engine-with-ast architecture

> Architecture diagram of the GitHub repository hrishikeshmundhe/rule-engine-with-ast, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hrishikeshmundhe/rule-engine-with-ast
- Repository: https://github.com/hrishikeshmundhe/rule-engine-with-ast

## Overview

This Spring Boot rule-engine API accepts rule definitions as JSON ASTs, persists rules, and evaluates stored rules against supplied test data. Its main path is client → RuleEngineController → RuleEngineService → RuleRepository, with AST traversal and condition evaluation inside the service. A second, simpler CRUD API is implemented separately by RuleController and RuleService. README-described H2 persistence is represented by the repository/model layer; database configuration details were not sampled.

Main entry points: [`rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java) (Engine API), [`rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java`](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java) (Engine Service), [`rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/repository/RuleRepository.java`](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/repository/RuleRepository.java) (Rule Repository), [`rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java`](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java) (CRUD API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST APIs"]
  node_engine_controller["Engine API"]
  node_crud_controller["CRUD API"]
  node_rule_dto["Rule DTO<br/>[RuleDTO.java]"]
  node_evaluation_dto["Evaluation DTO<br/>[EvaluationDTO.java]"]
end

subgraph group_logic["Rule Logic"]
  node_engine_service["Engine Service"]
  node_rule_service["Rule Service<br/>[RuleService.java]"]
  node_ast_node["AST Node<br/>[ASTNode.java]"]
end

subgraph group_persistence["Persistence"]
  node_rule_model[("Rule Entity<br/>[Rule.java]")]
  node_rule_repository["Rule Repository"]
  node_h2[("H2 Database")]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_engine_controller
node_engine_controller -->|"accepts creation"| node_rule_dto
node_engine_controller -->|"accepts test data"| node_evaluation_dto
node_engine_controller -->|"calls"| node_engine_service
node_engine_controller -->|"returns results"| node_client
node_client -->|"sends requests"| node_crud_controller
node_crud_controller -->|"calls"| node_rule_service
node_crud_controller -->|"returns rules"| node_client
node_engine_service -->|"saves and loads"| node_rule_repository
node_engine_service -->|"traverses AST"| node_ast_node
node_engine_service -->|"creates and reads"| node_rule_model
node_rule_service -->|"saves and lists"| node_rule_repository
node_rule_repository -->|"stores entities"| node_rule_model
node_rule_model -->|"contains AST"| node_ast_node
node_rule_repository -.->|"persists to"| node_h2

click node_engine_controller "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java"
click node_crud_controller "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java"
click node_rule_dto "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/dto/RuleDTO.java"
click node_evaluation_dto "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/dto/EvaluationDTO.java"
click node_engine_service "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java"
click node_rule_service "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleService.java"
click node_rule_model "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/Rule.java"
click node_ast_node "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/ASTNode.java"
click node_rule_repository "https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/repository/RuleRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_engine_controller,node_crud_controller,node_rule_dto,node_evaluation_dto,node_client toneBlue
class node_engine_service,node_rule_service,node_ast_node toneAmber
class node_rule_model,node_rule_repository,node_h2 toneMint
```

## Components

### REST APIs

- [Engine API](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`
- [CRUD API](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java`
- [Rule DTO](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/dto/RuleDTO.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/dto/RuleDTO.java`
- [Evaluation DTO](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/dto/EvaluationDTO.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/dto/EvaluationDTO.java`

### Rule Logic

- [Engine Service](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java`
- [Rule Service](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleService.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleService.java`
- [AST Node](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/ASTNode.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/ASTNode.java`

### Persistence

- [Rule Entity](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/Rule.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/Rule.java`
- [Rule Repository](https://github.com/hrishikeshmundhe/rule-engine-with-ast/blob/main/rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/repository/RuleRepository.java): `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/repository/RuleRepository.java`
- **H2 Database**

### Other components

- **API Client**

## Connections

- API Client → Engine API: sends requests (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`)
- Engine API → Rule DTO: accepts creation (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`)
- Engine API → Evaluation DTO: accepts test data (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`)
- Engine API → Engine Service: calls (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`)
- Engine API → API Client: returns results (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleEngineController.java`)
- API Client → CRUD API: sends requests (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java`)
- CRUD API → Rule Service: calls (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java`)
- CRUD API → API Client: returns rules (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/controller/RuleController.java`)
- Engine Service → Rule Repository: saves and loads (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java`)
- Engine Service → AST Node: traverses AST (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java`)
- Engine Service → Rule Entity: creates and reads (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleEngineService.java`)
- Rule Service → Rule Repository: saves and lists (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/service/RuleService.java`)
- Rule Repository → Rule Entity: stores entities (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/repository/RuleRepository.java`)
- Rule Entity → AST Node: contains AST (evidence: `rule-engine-ast/src/main/java/com/myproject/rule_engine_ast/model/Rule.java`)
- Rule Repository → H2 Database: persists to (evidence: `README.md`)
