ACE — Internal Architecture

ACE — Internal Architecture

Interactive overview of how the ACE Arabic Computational Engine fits together: user interfaces, engines, data, documentation, and shared platform.

Tip: Click any module card to see its role and file path.
User Interface Layer
Pages the user actually visits in the browser.
Level 1 — UI
ACE Analyzer ace_main.php
Central UI for full conjugation / analysis.
Root, form, tense, pronoun, declension, frequency.
Stem Tester ace_stem_tester.php
Playground for stems, particles, broken plurals.
Uses debug views & color legend.
Reverse Analyzer reverse/reverse_analyzer.php
From surface word back to root / form / tense.
Shows debug trace for each stripping and root guess.
Dictionary Index ace_dictionary_index.php
Browse roots (ktb, drs, qwl, ...).
Acts as entry point into ACE dictionary.
Quran Viewer & Randomizers quran_viewer, f_ruku, f_ayat
Display verses and link back into analyzers.
Uses root & token links to ACE.
Core Engine Layer
Pure PHP logic: morphology, roots, vowels, Tajweed.
Level 2 — Engines
ACE Utility Engine ace_utils.php
Brain of ACE (verbs, nouns, Tajweed, DB).
Used by main analyzer, stem tester, reverse analyzer.
Reverse Engine reverse_analyzer_engine.php
Heuristic decomposition of any token.
Uses debug array to explain every step.
Stem Engine ace_stem_engine.php
Focus on internal stem structure & patterns.
Used mostly by documentation & playground.
Data & Dictionaries Layer
Structured arrays and SQL tables ACE runs on.
Level 3 — Data
ACE Arrays ace_file4_arrays.php
Master array repository.
Shared vocabulary, patterns, and meta-info.
Quran DB quran (table)
Source of verse text & root counts.
SQL-backed core corpus for ACE.
Pattern Tables tables.php & friends
Reference maps for patterns and families.
Human-readable support for debugging & teaching.
Supporting Documentation & Views
Pages that explain how ACE works and how to read output.
Level 4 — Docs & Views
Docs Home documentation_home.php
Entry point to ACE documentation set.
Orchestrates documentation subpages.
Legend & Color Legend ace_desc_legend.php, color_legend.php
Explain how to read ACE output.
Shared design language for UI & print.
Pronunciation Guide pronunciation_guide.php
Pedagogical support for IPA & Tajweed.
Connects visual colors to recitation rules.
ACE Platform & Infrastructure
Shared layout, navigation, styles, and utilities.
Level 5 — Platform
Global Header & Footer ace_header.php
Consistent layout and navigation.
Used by nearly every ACE page.
Global Styles & Scripts CSS & JS assets
Look & feel and small interactions.
Shared across analyzers, docs, and Tajweed tools.
DB Connection f_db_connection.php
Single source of DB connection.
Used by ACE DB helpers & Quran tools.