How terboubomar/tadqeeq works
Tadqeeq audits delivery-platform settlements and invoices. Users submit platform files; strict parsing feeds deterministic HungerStation, Keeta, and Jahez accounting engines, whose results drive exceptions and evidence for human review. AI is a separate explanation and insight layer: it receives server-built audited facts, not raw financial files, and cannot alter accounting results. The README documents these domain relationships; several route and persistence implementations were not sampled, so uncertain runtime links are omitted.
Main entry points: types.ts Audit results · exceptions.ts Exception logic · compensation-evidence.ts Evidence trail · ops.server.ts Operations admin
Components 21
Settlement audit
- File import
src/routes/_authenticated/import.tsx - Strict parser
src/lib/analysis/parse.ts - Platform engines
src/lib/analysis - Audit results
src/lib/analysis/types.ts
Exceptions and claims
- Exception logic
src/lib/exceptions.ts - Evidence trail
src/lib/compensation-evidence.ts - Compensation cases
src/routes/compensation - Contract compliance
src/lib/contract-compliance.ts - Telegram intake
src/lib/telegram-webhook.server.ts
AI and intelligence
- Exception explanations
src/lib/ai/exception-ai.server.ts - Period summaries
src/lib/ai/period-summary-ai.server.ts - Period intelligence
src/lib/period-intelligence.ts - Ask Tadqeeq
src/lib/ai/analyst-ai.server.ts - Fact registry
src/lib/ai/analyst-context.ts
Workspace operations
- Workspace access
src/lib/workspace-access.ts - Client onboarding
src/lib/onboarding.ts - Operations admin
src/lib/ops.server.ts - Ops client tools
src/components/OpsClientForms.tsx - Supabase services
src/integrations/supabase/client.server.ts
Other components
- Finance user
- Human reviewer
Connections 19
- Finance user → File import: uploads files
- File import → Strict parser: parses files
- Strict parser → Platform engines: feeds engines
- Platform engines → Audit results: calculates results
- Audit results → Exception logic: identifies exceptions
- Exception logic → Evidence trail: builds evidence
- Evidence trail → Human reviewer: supports review
- Exception logic → Exception explanations: explains audited facts
- Audit results → Period summaries: summarizes metrics
- Audit results → Period intelligence: compares periods
- Fact registry → Ask Tadqeeq: grounds answers
- Audit results → Fact registry: provides audited facts
src/lib/ai/analyst-context.ts - Evidence trail → Compensation cases: supports claims
- Finance user → Workspace access: requests access
- Workspace access → Supabase services: checks access
- Ops client tools → Operations admin: submits client updates
src/components/OpsClientForms.tsx - Operations admin → Supabase services: reads and writes
src/lib/ops.server.ts - Operations admin → Client onboarding: loads suspension data
src/lib/ops.server.ts - Telegram intake → Supabase services: stores intake data
src/lib/telegram-webhook.server.ts