JET Numerology System — System Architecture

AI-Enhanced Knowledge Platform

Numerology CMS

Chaldean Numerology CMS for JET International — knowledge base management and personalized PDF report generation

Laravel 11 React 18 Inertia.js SQLite DomPDF OpenAI GPT-4

75 React Pages 38 Eloquent Models 56 Migrations 17+ Calculation Methods 4 PDF Formats

Automated numerological analysis with AI-generated interpretive text and multi-format PDF reports

1Problem

Numerology consultant needed a structured system to manage Chaldean numerological knowledge (numbers, planets, zodiac, Lo Shu Grid) and generate personalized client reports at scale

2Solution

Built a full CMS with 16 CRUD modules, 17+ numerological calculation methods (Driver, Conductor, Kua, Lo Shu Grid analysis), 4 PDF report generators (Standard, AI, Premium, Professional), and GPT-4 integration for interpretive text generation

3Outcome

75 React pages, 38 Eloquent models, automated report generation replacing hours of manual calculation per client

Key Engineering Decisions

Inertia.js for SPA experience without API overhead

Server-driven with React frontend

SQLite for portable, zero-config deployment

Suitable for single-consultant use

4 PDF generator variants for different client tiers and use cases

Tiered report generation

NumerologyCalculator service encapsulating all 17+ calculation methods

Centralized domain logic

GPT-4 integration (Phase 2) for AI-generated interpretive text on reports

AI-enhanced report narratives

DaisyUI + MUI dual component library for rapid UI development

Speed of development

Spatie Browsershot for high-fidelity PDF rendering via Puppeteer

Premium report quality

React Pages
27 Directories

Eloquent
Models

Database
Migrations

17+

Calculation
Methods

PDF Report
Formats

Controllers

My Role

Platform architecture & technology selection

Domain modeling (numerological knowledge base schema)

Calculation engine design (17+ methods)

PDF generation pipeline architecture

AI integration strategy (GPT-4 Phase 2)

React Pages

Eloquent Models

Numerology
Calculations

Migrations

PDF Report
Generators

Lo Shu Grid
Numbers

Client Application

Admin Dashboard (SPA)

React 18 / TypeScript / Inertia.js

75 Pages 21 Components Tailwind + DaisyUI

CRUD Modules (16 Resources)

Numbers

Planets

Zodiac Signs

Zodiac Organs

Zodiac Diseases

Birth Dates

Letters (Chaldean)

Lo Shu Grid Numbers

Lo Shu Grid Clients

BN/DN Associations

BN/DN Zodiac Assoc.

Lucky/Unlucky

Descriptions

Entity Traits

Remedies

Health Issues

Key Screens

Dashboard — metrics, recent clients, report counts
Client Profile — full numerology report viewer
Custom Remedies Editor — per-client remedy management
PDF Generation — 4 report formats (Standard, AI, Premium, Professional)
Structured Numerology Report — interactive data viewer

Frontend Stack

Vite 5 / MUI 6 / Tailwind 3.4

Inertia.js SSR @headlessui/react Axios

UI Libraries

Material UI 6 (MUI) — icons, styled components
DaisyUI 4 — Tailwind component library, custom "professional" theme
Headless UI 2 — accessible dropdown, modal primitives
Emotion — CSS-in-JS for MUI styled components

Shared Components

CardContainer, Sidebar, DesktopNavigation, MobileMenu
ItemManager, TraitManager — polymorphic CRUD widgets
Pagination, Modal, Dropdown — reusable primitives
LuckyProfession — career report display component

Auth & Layouts

Laravel Breeze / Sanctum

Session Auth API Tokens CSRF

Auth Screens

Login, Register (disabled for admin-only portal)
Forgot Password, Reset Password
Email Verification, Confirm Password
Force password change on first login (EnsurePasswordChanged middleware)

Layouts

AuthenticatedLayout — sidebar navigation, admin chrome
GuestLayout — minimal login/register wrapper

INERTIA.JS · JSON PROPS

SANCTUM · SESSION

API & Services

LARAVEL 11

Backend Engine

PHP 8.2 · 24 Controllers · Inertia + REST API

Core

NumberController

Master number CRUD (1-9). Planet, trait, description, remedy associations.

Core

PlanetController

Planetary rulers for each number. Sanskrit names, organ associations.

Core

LetterController

Chaldean letter-to-number mapping. A-Z values for name calculations.

Core

ZodiacSignController

Zodiac sign management. Disease and organ associations per sign.

Data

DescriptionController

Polymorphic descriptions for numbers, planets, letters. Categorized by type.

Data

EntityTraitController

Positive/negative traits for any entity. Grouped endpoint for bulk display.

Data

RemedyController

Numerological remedies per number. Grouped retrieval for report building.

Data

HealthIssueController

Health issues by number, age range, and issue type with tips.

Data

NoteController

Polymorphic notes attached to any entity for consultant reference.

Data

AssociationController

Color, gem, direction associations per number. Grouped API endpoint.

Calc

LoshuGridNumberCtrl

Lo Shu Grid number meanings. Lucky/unlucky numbers per grid position.

Calc

LoshuGridClientCtrl

Per-client Lo Shu Grid data. DOB digit distribution across 3x3 grid.

Calc

BirthDateController

Birth date interpretations. Day-specific numerological significance.

Calc

BnDnAssociationCtrl

Birth Number ↔ Destiny Number compatibility matrix and readings.

Calc

BnDnZodiacAssocCtrl

BN/DN + Zodiac three-way association for deeper readings.

Report

ReportController

Main report view + 4 PDF generators: Standard, Premium, Professional, V2.

AIGenerationController

OpenAI GPT-4 report generation. Phase 1: disabled. Phase 2: auto-generate.

Report

UserController

Client (User) CRUD. Auto-generates numerology on create/update.

Admin

MetricsController

Dashboard metrics: total clients, reports generated, weekly/monthly stats.

Admin

LuckyUnluckyCtrl

Lucky/unlucky colors and numbers by life path number.

Sanctum Auth

HandleInertiaRequests

EnsurePasswordChanged

CSRF Protection

Ziggy Routes

CALCULATION ENGINE

Life Path

Destiny (Expression)

Soul Urge

Personality

Birthday

Maturity

Balance

Pinnacle [4]

Challenge [3]

Personal Year/Month/Day

Karmic Debt

Hidden Passion

Subconscious Self

Arrows of Pythagoras

Kua Number

Lo Shu Grid

Chaldean Name

NumerologyCalculator

Pure calculation engine

17 Methods Chaldean System

Calculations

Life Path — all date digits reduced, preserves master 11/22/33
Expression (Destiny) — Chaldean name sum, full alphabet
Soul Urge — vowels only (A, E, I, O, U)
Personality — consonants only
Birthday — strict single digit, no master preservation
Pinnacle [4 stages] — month+day, day+year, P1+P2, month+year
Challenge [3 stages] — absolute differences of date components
Kua Number — gender-aware, pre/post-2000 formula
Karmic Debt — checks 13, 14, 16, 19 in life path + expression
Arrows of Pythagoras — 8 arrows across Lo Shu Grid diagonals

NumerologyService

Report data orchestrator

8 Planes Lo Shu Grid Career

Features

Lo Shu Grid — DOB digit distribution, lucky/unlucky join
8 Plane Analysis — Thought, Will, Action, Mental, Emotional, Practical, Success 1&2
Repetitive Number Descriptions — 1-5 count depth for all 9 numbers
House Number Report — reduce to single digit, positive/negative meaning
Career Report — destiny number mapped to 200+ professions
Chaldean Name — letter breakdown with per-letter values
Lucky/Unlucky — colors and numbers by DOB total

ReportGenerationService

Multi-section report builder

8 Sections DB Transaction

Report Sections

Core Analysis — life path, destiny, soul urge, personality interpretations
Traits — positive/negative from EntityTrait + Description models
Recommendations — per-number remedies aggregated
Life Aspects — career, relationship, health, general descriptions
Lo Shu Grid — missing numbers impact + remedies
Letter Analysis — per-letter Chaldean interpretation
Planet Analysis — ruling planet data for core numbers
Manual Recommendations — consultant custom notes

Caching

180-day freshness check — reuses stored report data
DB transaction wrapping for atomic report generation

AI Text Generation

OpenAI GPT-4 / Phase 2

GPT-4 Phase 1: Manual

AI Report Sections (Phase 2)

Core numerology, traits, name analysis, zodiac-destiny report
Lo Shu grid interpretation, house number meaning
Karmic lessons, debt, pinnacles, personal year forecast
Maturity number, compatibility, hidden passion, balance
JSON-only output format, temperature 0.7, 3000 token max

Surname Matching

Reuses existing AI reports by last name when first name is unique
NumerologyReport model stores first_name + last_name separately

ELOQUENT ORM

SQLITE / QUEUE

Data Layer & External Services

Eloquent Models (38 Models)

SQLite · Doctrine DBAL · 56 Migrations

Core Domain Polymorphic HasFactory

Core Models

User (admin + client)

UserDetail (DOB, gender, house)

NumerologyNumber (17 fields)

NumerologyReport (AI content)

Number (1-9 master data)

Planet (ruling planets)

Letter (A-Z Chaldean)

Report (generated sections)

Numerology Domain

LoshuGridNumber

LoshuGridClient

BirthDate

BnDnAssociation

BnDnZodiacAssociation

LuckyUnlucky

LuckyUnluckyNumber

CustomRemedy

Zodiac & Health

ZodiacSign

ZodiacOrgan

ZodiacDisease

HealthIssue

PlanetOrgan

CelebrityExample

Polymorphic Entities

Description (entity_type/id)

EntityTrait (+/- traits)

Remedy (per entity)

Note (consultant notes)

Association (colors, gems)

ColorAssociation

Business Models

BusinessActivityNumber

BusinessNameNumber

BusinessPartnership

MarriageCompatibility

MarriageDate

MarriageRemedy

MobileNumerology

HouseNumber

NameNumber

NumberProfession

PDF Report Pipeline

DomPDF · Browsershot (Puppeteer)

4 Generators A4 Portrait Blade Templates

Report Types

Standard — DomPDF, full data dump with all numerology sections
AI Report — GPT-4 generated text (Phase 2), DomPDF render
Premium — Browsershot (Puppeteer), multi-page with cover, Lo Shu grid, traits, recommendations
Professional V1 — Browsershot, consultation-focused layout
Professional V2 — DomPDF, same content, broader compatibility

Premium Report Sections