How mohammad200326/zakaty works
Zakaty offers two routes from user-provided financial data to a Zakat result: a manual calculator and a guided AI assistant that extracts and structures data. Both account for currency and a selectable gold-or-silver Nisab threshold; results can be viewed and saved for later history review. The graph includes documented capabilities whose wiring is not shown in the excerpts. Some UI-to-API and result-to-save relationships are therefore documented at product-workflow level rather than verified from sampled calls.
Main entry points: route.ts Assistant API · ZakatResultView.tsx Detailed results · ZakatCalculatorClient.tsx Manual calculator · check-ai-limit.ts AI usage limits
Components 19
Calculation modes
- Manual calculator
app/(root)/calculator/components/ZakatCalculatorClient.tsx - Guided assistant
app/(root)/assistant/components/AssistantClient.tsx - Assistant API
app/api/zakat-assistant/route.ts
Results and history
- Detailed results
app/(root)/result/components/ZakatResultView.tsx - Calculation storage actions
lib/actions/save-zakat-calculation.ts - History list
app/(root)/history/HistoryClient.tsx - History detail
app/(root)/history/[id]/page.tsx - Saved calculations
Access and plans
- AI access check
app/api/check-access/route.ts - AI usage limits
lib/ai/check-ai-limit.ts - Plan rules
lib/subscription-constants.ts - User plan lookup
lib/subscription.server.ts - AI usage records
Shared calculation services
- Nisab calculation
lib/nisab.ts - Exchange rates
lib/services/exchangeRates.service.ts - Currency constants
lib/constants.ts - Supabase client
lib/supabase/server.ts
Other components
- User
- Google Gemini
Connections 27
- User → Manual calculator: enters assets
README.md - User → Guided assistant: starts guided flow
README.md - Guided assistant → Assistant API: submits answers
- Assistant API → Google Gemini: extracts data
- Assistant API → Exchange rates: loads rates
app/api/zakat-assistant/route.ts - Assistant API → Currency constants: uses fallback rates
app/api/zakat-assistant/route.ts - Assistant API → Nisab calculation: calculates threshold
app/api/zakat-assistant/route.ts - Manual calculator → Nisab calculation: calculates threshold
app/(root)/calculator/components/ZakatCalculatorClient.tsx - Manual calculator → Currency constants: uses rates
app/(root)/calculator/components/ZakatCalculatorClient.tsx - Assistant API → AI usage limits: checks and records usage
app/api/zakat-assistant/route.ts - Guided assistant → Detailed results: opens detailed result
README.md - Manual calculator → Detailed results: opens detailed result
README.md - Detailed results → Exchange rates: loads rates
app/(root)/result/page.tsx - Detailed results → Nisab calculation: calculates threshold
app/(root)/result/page.tsx - Detailed results → Calculation storage actions: saves calculation
app/(root)/result/components/ZakatResultView.tsx - Calculation storage actions → Saved calculations: writes and reads
lib/actions/save-zakat-calculation.ts - History list → Calculation storage actions: loads calculations
app/(root)/history/page.tsx - History list → History detail: opens selected record
app/(root)/history/HistoryClient.tsx - History detail → Calculation storage actions: loads calculation
app/(root)/history/[id]/page.tsx - AI access check → User plan lookup: looks up plan
app/api/check-access/route.ts - AI access check → Plan rules: uses plan limits
app/api/check-access/route.ts - AI access check → Supabase client: reads usage
app/api/check-access/route.ts - AI usage limits → User plan lookup: looks up plan
lib/ai/check-ai-limit.ts - AI usage limits → Plan rules: uses plan limits
lib/ai/check-ai-limit.ts - AI usage limits → Supabase client: reads and updates usage
lib/ai/check-ai-limit.ts - Supabase client → AI usage records: accesses records
- Supabase client → Saved calculations: accesses records