# Akadli-AI

> Open-source Algerian Cash-on-Delivery (COD) Voice Confirmation Engine & Store Adapters for the 2026 69-Wilaya / 1,708-Commune division.

Akadli-AI automates post-checkout COD order confirmation calls in Algerian Darja via ElevenLabs Conversational AI (ElevenAgents), normalizes Algerian addresses to the official 2026 69 Wilayas and 1,708 Communes, and applies real-time order mutations (confirmation, variant/address modification, and cancellation) across Shopify, YouCan, WooCommerce, Google Sheets, and Tassyir ERP.

- Website: https://akadli.me
- Arabic Documentation: https://akadli.me/ar/
- GitHub: https://github.com/HarrouAnderrahman/Akadli-AI
- Full LLM Context: https://akadli.me/llms-full.txt

## Quick Installation

```bash
pnpm add @akadli/core @akadli/dz-geo @akadli/provider-shopify
```

## Getting Started

- [Overview](https://akadli.me/getting-started/overview): Architectural lifecycle, webhook ingress, and order mutation flow.
- [Quickstart](https://akadli.me/getting-started/quickstart): 20-line end-to-end TypeScript integration example.
- [Playground](https://akadli.me/getting-started/playground): Local HTTPS WebRTC phone simulator (/phone) and admin console (/admin) over LAN Wi-Fi.

## Core Packages

- [@akadli/adapter-contract](https://akadli.me/core/adapter-contract): Universal TypeScript interfaces (StandardizedDzOrder, FinalizedOrderDecision, IEcommerceProvider) and Zod validation schemas. Zero runtime dependencies.
- [@akadli/dz-geo](https://akadli.me/core/dz-geo): Official 2026 Algerian 69 Wilayas, 1,708 Communes, ONP postal codes, and +213 phone normalizer.
- [@akadli/core](https://akadli.me/core/engine): Stateless voice orchestration engine connecting ElevenAgents with store providers.

## Store & ERP Adapters

- [@akadli/provider-shopify](https://akadli.me/providers/shopify): Shopify COD adapter with Dev Dashboard setup, protected customer data access, and missing-province fallback.
- [@akadli/provider-youcan](https://akadli.me/providers/youcan): YouCan (.shop) COD adapter with 1-page checkout extra_fields extraction.
- [@akadli/provider-woocommerce](https://akadli.me/providers/woocommerce): WooCommerce REST v3 adapter with DZ-XX state codes and COD plugin meta_data parser.
- [@akadli/provider-gsheets](https://akadli.me/providers/gsheets): Universal Google Sheets v4 & Zero-OAuth Apps Script bridge for SetShop, JustSell, and Foorweb.
- [@akadli/provider-tassyir](https://akadli.me/providers/tassyir): Official Tassyir Admin API (2026-10) with Standard Webhooks (v1a Ed25519) and OAuth installation flow.

## AI Coding Agent Guidance

- [AI Agent Portal](https://akadli.me/agents/overview): Canonical rules, skills, and prompt templates for Cursor, Antigravity, Claude Code, and Codex.
- Full context bundle for LLM ingestion: https://akadli.me/llms-full.txt