How ibrahimsarran/al-arbin40 works
Al-Arba'in is a browser-based reader and study app for the 42 Nawawi hadith, with playback, offline access, personal records, and a source-grounded question assistant. Readers enter through the web app, browse and study a hadith, and can ask the assistant about its meaning or context; the assistant returns a validated answer with references. The graph includes the documented reading, study, audio, records, language, and offline capabilities. Some client wiring and data loading are unsampled, so unsupported links are omitted.
Main entry points: reader-controller.mjs Reader · research-service.mjs Research Service · audio-controller.mjs Audio Controller · route.ts Research Route
Components 24
Reading and Study
- Reader
public/js/controllers/reader-controller.mjs - Reader View
public/js/views/reader-view.mjs - Hadith Search
public/js/services/hadith-service.mjs - Study Service
public/js/services/study-service.mjs - Text Domain
public/js/utils/domain.mjs - Language UI
public/js/controllers/language-controller.mjs - Browser Entry
public/app.mjs
Audio and Offline
- Audio Controller
public/js/controllers/audio-controller.mjs - Audio Player
public/js/audio/audio-player.mjs - Verified Downloads
public/js/services/audio-download-service.mjs - Audio Storage
public/js/repositories/audio-repository.mjs - Offline Cache
public/service-worker.js
Personal Records
- Study Storage
public/js/repositories/study-repository.mjs
Research Assistant
- Assistant Panel
public/js/controllers/research-controller.mjs - Research Route
app/api/research/route.ts - Research Service
server/research-service.mjs - Evidence Retrieval
server/evidence-repository.mjs - Meaning Search
server/meaning-search.mjs - Answer Validation
server/answer-validator.mjs - AI Client
server/ai-client.mjs
Bundled Content
- Hadith and Study Data
public/hadiths.json - Recording Catalog
public/audio-catalog.json
Other components
- Reader
- Gemini
Connections 27
- Reader → Browser Entry: opens
README.md - Browser Entry → Reader: starts
public/app.mjs - Reader → Reader View: renders
public/js/controllers/reader-controller.mjs - Reader → Hadith Search: searches with
public/js/controllers/reader-controller.mjs - Reader → Study Service: records study via
public/js/controllers/reader-controller.mjs - Reader → Audio Controller: delegates audio
public/js/controllers/reader-controller.mjs - Reader → Assistant Panel: creates assistant
public/js/controllers/reader-controller.mjs - Reader → Study Storage: uses storage
public/js/controllers/reader-controller.mjs - Hadith Search → Text Domain: uses text logic
public/js/services/hadith-service.mjs - Study Service → Text Domain: uses validation
public/js/services/study-service.mjs - Reader → Language UI: supports language UI
README.md - Audio Controller → Audio Player: controls playback
public/js/controllers/audio-controller.mjs - Audio Controller → Verified Downloads: downloads recordings
public/js/controllers/audio-controller.mjs - Verified Downloads → Audio Storage: saves verified files
public/js/services/audio-download-service.mjs - Audio Controller → Recording Catalog: selects recordings
README.md - Reader → Offline Cache: caches app offline
README.md - Assistant Panel → Research Route: posts question
README.md - Research Route → Research Service: handles request
app/api/research/route.ts - Research Route → Evidence Retrieval: provides corpus
app/api/research/route.ts - Research Route → AI Client: configures client
app/api/research/route.ts - Research Service → Evidence Retrieval: retrieves evidence
README.md - Research Service → Meaning Search: matches meanings
server/research-service.mjs - Research Service → AI Client: generates answer
README.md - Research Service → Answer Validation: validates answer
README.md - Evidence Retrieval → Meaning Search: finds matches
server/evidence-repository.mjs - Evidence Retrieval → Hadith and Study Data: retrieves passages
app/api/research/route.ts - AI Client → Gemini: requests generation
server/ai-client.mjs