Agent Voice Response - Admin panel

Repository for the AVR administration panel composed of:

• backend/: NestJS API (TypeORM + SQLite, JWT, Docker management)

• frontend/: Next.js 16 + React 19 interface with Tailwind CSS and shadcn/ui

• docker-compose-asterisk.yml: optional local Asterisk stack (PBX + AMI + softphone)

Requirements

• Node.js 18+
• npm 9+
• Docker Engine (required to run agent containers)
• Asterisk PBX (required onfly for telephony sections)

Local Development

This repository contains two independent npm projects. There is no npm workspace at root.

Backend:

cd backend
npm install
npm run start:dev

Frontend:

cd frontend
npm install
npm run start:dev

Backend runs on http://localhost:3001 and frontend runs on http://localhost:3000 in standalone dev mode.

Data structure

• SQLite database mounted in ./data (volume shared by the containers)
• JWT signed with JWT_SECRET, configurable via backend environment variables

Local Verification

Run checks from each project directory:

cd backend && npm run lint && npm test
cd frontend && npm run lint && npm run build

CI runs path-scoped quality gates on pull requests: backend-quality-gate.yml (lint + unit tests) and frontend-quality-gate.yml (lint + build). The main deploy workflow still builds and pushes Docker images only. Validate locally before pushing (see commands above).

See backend/README.md and frontend/README.md for full details.

Usage

Enjoy the Agent Voice Response App experience! After installation, you can access the application through your browser.

The intuitive dashboard for managing your voice response agents

Support & Community

• GitHub: https://github.com/agentvoiceresponse - Report issues, contribute code.
• Discord: https://discord.gg/DFTU69Hg74 - Join the community discussion.
• Docker Hub: https://hub.docker.com/u/agentvoiceresponse - Find Docker images.
• Wiki: https://wiki.agentvoiceresponse.com/en/home - Project documentation and guides.

Support AVR

AVR is free and open-source. Any support is entirely voluntary and intended as a personal gesture of appreciation. Donations do not provide access to features, services, or special benefits, and the project remains fully available regardless of donations.

License

MIT License - see the LICENSE file for details.