# sanika47-hub/logicmaster architecture

> Architecture diagram of the GitHub repository sanika47-hub/logicmaster, 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/sanika47-hub/logicmaster
- Repository: https://github.com/sanika47-hub/logicmaster

## Overview

LogicMaster is a browser-based logic learning and assessment platform. Learners explore truth tables, equivalence, inference, proofs, and challenges; the frontend also tracks gamification progress locally. The server exposes equivalence and inference APIs plus rule names through a public interface. The sampled sources show those API paths and the analysis modules beneath them. The README documents the broader learning workflow, but the excerpts do not establish frontend-to-API wiring or how proof challenges are consumed, so those links are omitted.

Main entry points: [`Backend/member3.js`](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/member3.js) (Logic Facade), [`Backend/inference.js`](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/inference.js) (Inference Checker), [`Backend/equivalence.js`](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/equivalence.js) (Equivalence Checker), [`Backend/truthTable.js`](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/truthTable.js) (Truth Evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Learning Experience"]
  node_frontend["Learning UI<br/>[game.js]"]
  node_progress["Progress Tracking<br/>[game.js]"]
  node_truthui["Truth Tables<br/>[game.js]"]
  node_equivui["Equivalence Practice<br/>[game.js]"]
  node_inferenceui["Inference Practice<br/>[game.js]"]
  node_proofui["Proof Assistant<br/>[game.js]"]
  node_challengeui["Challenge Mode<br/>[game.js]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP Server<br/>[server.js]"]
  node_interface["Public Logic Interface"]
  node_facade["Logic Facade<br/>[member3.js]"]
end

subgraph group_logic["Logic Analysis"]
  node_equivalence["Equivalence Checker<br/>[equivalence.js]"]
  node_inference["Inference Checker<br/>[inference.js]"]
  node_parser["Expression Parser<br/>[parser.js]"]
  node_truth["Truth Evaluation<br/>[truthTable.js]"]
  node_rules["Inference Rule Library<br/>[ruleLibrary.js]"]
  node_proof["Proof Engine<br/>[proof.js]"]
end

subgraph group_proofdata["Proof Content"]
  node_proofchallenges["Proof Challenge Data<br/>[proofChallenges.js]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_frontend
node_frontend -->|"updates locally"| node_progress
node_server -->|"loads interface"| node_interface
node_interface -->|"delegates"| node_facade
node_facade -->|"checks equivalence"| node_equivalence
node_facade -->|"checks inference"| node_inference
node_facade -->|"retrieves rules"| node_rules
node_equivalence -->|"parses expressions"| node_parser
node_equivalence -->|"evaluates assignments"| node_truth
node_inference -->|"parses statements"| node_parser
node_inference -->|"checks assignments"| node_truth
node_inference -->|"looks up rules"| node_rules
node_truth -->|"parses expressions"| node_parser

click node_frontend "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_progress "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_truthui "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_equivui "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_inferenceui "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_proofui "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_challengeui "https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js"
click node_server "https://github.com/sanika47-hub/logicmaster/blob/main/server.js"
click node_interface "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/member3Interface.js"
click node_facade "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/member3.js"
click node_equivalence "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/equivalence.js"
click node_inference "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/inference.js"
click node_parser "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/parser.js"
click node_truth "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/truthTable.js"
click node_rules "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/ruleLibrary.js"
click node_proof "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/proof.js"
click node_proofchallenges "https://github.com/sanika47-hub/logicmaster/blob/main/Backend/proofChallenges.js"

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_frontend,node_progress,node_truthui,node_equivui,node_inferenceui,node_proofui,node_challengeui toneBlue
class node_server,node_interface,node_facade toneAmber
class node_equivalence,node_inference,node_parser,node_truth,node_rules,node_proof toneMint
class node_proofchallenges toneRose
class node_learner toneIndigo
```

## Components

### Learning Experience

- [Learning UI](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`
- [Progress Tracking](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`
- [Truth Tables](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`
- [Equivalence Practice](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`
- [Inference Practice](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`
- [Proof Assistant](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`
- [Challenge Mode](https://github.com/sanika47-hub/logicmaster/blob/main/Frontend/game.js): `Frontend/game.js`

### Backend API

- [HTTP Server](https://github.com/sanika47-hub/logicmaster/blob/main/server.js): `server.js`
- [Public Logic Interface](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/member3Interface.js): `Backend/member3Interface.js`
- [Logic Facade](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/member3.js): `Backend/member3.js`

### Logic Analysis

- [Equivalence Checker](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/equivalence.js): `Backend/equivalence.js`
- [Inference Checker](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/inference.js): `Backend/inference.js`
- [Expression Parser](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/parser.js): `Backend/parser.js`
- [Truth Evaluation](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/truthTable.js): `Backend/truthTable.js`
- [Inference Rule Library](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/ruleLibrary.js): `Backend/ruleLibrary.js`
- [Proof Engine](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/proof.js): `Backend/proof.js`

### Proof Content

- [Proof Challenge Data](https://github.com/sanika47-hub/logicmaster/blob/main/Backend/proofChallenges.js): `Backend/proofChallenges.js`

### Other components

- **Learner**

## Connections

- Learner → Learning UI: uses (evidence: `README.md`)
- Learning UI → Progress Tracking: updates locally (evidence: `Frontend/game.js`)
- HTTP Server → Public Logic Interface: loads interface (evidence: `server.js`)
- Public Logic Interface → Logic Facade: delegates (evidence: `Backend/member3Interface.js`)
- Logic Facade → Equivalence Checker: checks equivalence (evidence: `Backend/member3.js`)
- Logic Facade → Inference Checker: checks inference (evidence: `Backend/member3.js`)
- Logic Facade → Inference Rule Library: retrieves rules (evidence: `Backend/member3.js`)
- Equivalence Checker → Expression Parser: parses expressions (evidence: `Backend/equivalence.js`)
- Equivalence Checker → Truth Evaluation: evaluates assignments (evidence: `Backend/equivalence.js`)
- Inference Checker → Expression Parser: parses statements (evidence: `Backend/inference.js`)
- Inference Checker → Truth Evaluation: checks assignments (evidence: `Backend/inference.js`)
- Inference Checker → Inference Rule Library: looks up rules (evidence: `Backend/inference.js`)
- Truth Evaluation → Expression Parser: parses expressions (evidence: `Backend/truthTable.js`)
