{"id":30726547,"url":"https://github.com/22p31a0512/wexa_ai","last_synced_at":"2026-04-06T21:32:28.690Z","repository":{"id":311346954,"uuid":"1042883105","full_name":"22P31A0512/wexa_ai","owner":"22P31A0512","description":"A modern, scalable helpdesk system with ticketing, knowledge base, real-time notifications, and optional AI-powered automation for smarter customer support.","archived":false,"fork":false,"pushed_at":"2025-08-23T06:28:40.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-09T16:52:10.071Z","etag":null,"topics":["chatbot","customer-experience","customer-support-assistant","docker","expressjs","fastapi","microservices","mongodb","nodejs","react","realtime-notifications","support-automation","ticketing-system","vite"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/22P31A0512.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-22T18:28:04.000Z","updated_at":"2025-08-23T06:28:43.000Z","dependencies_parsed_at":"2025-08-24T09:44:07.681Z","dependency_job_id":"61a526d9-09ef-44e8-a351-79780ebf1836","html_url":"https://github.com/22P31A0512/wexa_ai","commit_stats":null,"previous_names":["22p31a0512/wexa_ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/22P31A0512/wexa_ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/22P31A0512%2Fwexa_ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/22P31A0512%2Fwexa_ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/22P31A0512%2Fwexa_ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/22P31A0512%2Fwexa_ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/22P31A0512","download_url":"https://codeload.github.com/22P31A0512/wexa_ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/22P31A0512%2Fwexa_ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31491097,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","customer-experience","customer-support-assistant","docker","expressjs","fastapi","microservices","mongodb","nodejs","react","realtime-notifications","support-automation","ticketing-system","vite"],"created_at":"2025-09-03T13:23:36.101Z","updated_at":"2026-04-06T21:32:28.671Z","avatar_url":"https://github.com/22P31A0512.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n\r\n# 🚀 Helpdesk Project\r\n\r\nA **modern, scalable, and AI-powered Helpdesk System** designed for enterprises, startups, and support teams.\r\nThis solution provides a seamless **ticketing system, real-time communication, knowledge base, and AI-driven assistance** to optimize customer support operations.\r\n\r\n---\r\n\r\n## 🏗 Architecture Overview\r\n\r\nThe system follows a **modular, service-oriented architecture** with three primary components:\r\n\r\n1. **Backend (API Layer)** – Built with **Node.js \u0026 Express**, powered by **MongoDB** for flexible and scalable data storage.\r\n\r\n   * Handles authentication, ticket workflows, user management, and knowledge base APIs.\r\n   * Implements **role-based access control (RBAC)** for secure multi-user environments.\r\n\r\n2. **Frontend (Client Layer)** – A **React + Vite** web application delivering a clean, responsive, and interactive user interface.\r\n\r\n   * Optimized for performance with modern bundling tools.\r\n   * Provides intuitive dashboards for **agents, admins, and end-users**.\r\n\r\n3. **Agent Worker (AI Layer - Optional)** – A **Python FastAPI microservice** for AI-driven automation.\r\n\r\n   * **Ticket classification** using NLP.\r\n   * **Smart reply suggestions** and response drafting.\r\n   * Can be extended with **OpenAI/GPT or custom ML models**.\r\n\r\n---\r\n\r\n## ⚡ Key Features\r\n\r\n* **🔐 Authentication \u0026 Authorization**\r\n\r\n  * Secure JWT-based login and signup\r\n  * Role-based access (Admin, Agent, Customer)\r\n\r\n* **🎫 Ticket Management System**\r\n\r\n  * Create, assign, track, and close tickets\r\n  * Priority \u0026 SLA management\r\n  * Comment threads and attachments support\r\n\r\n* **📚 Knowledge Base**\r\n\r\n  * Create and manage help articles\r\n  * Searchable knowledge system for customers\r\n  * Markdown editor for article creation\r\n\r\n* **🤖 AI Capabilities (Optional)**\r\n\r\n  * Automated ticket categorization\r\n  * Suggested responses for agents\r\n  * Sentiment analysis on customer messages\r\n\r\n* **🔔 Real-Time Notifications**\r\n\r\n  * WebSocket-based live updates\r\n  * New ticket alerts, status changes, and agent mentions\r\n\r\n* **📊 Admin Dashboard**\r\n\r\n  * Ticket volume analytics\r\n  * Agent performance monitoring\r\n  * SLA compliance reports\r\n\r\n* **☁️ Cloud \u0026 Container Support**\r\n\r\n  * Docker-based deployment\r\n  * Scalable with Kubernetes or Docker Swarm\r\n  * CI/CD ready\r\n\r\n---\r\n\r\n## 🛠 Development Setup\r\n\r\n### Prerequisites\r\n\r\n* **Node.js** v18+\r\n* **Python** 3.8+\r\n* **MongoDB** (local or cloud e.g., MongoDB Atlas)\r\n* **Docker** (optional for containerized deployment)\r\n\r\n### Setup Instructions\r\n\r\n#### 1. Backend Setup\r\n\r\n```bash\r\ncd backend\r\nnpm install\r\nnpm run dev\r\n```\r\n\r\n#### 2. Frontend Setup\r\n\r\n```bash\r\ncd frontend\r\nnpm install\r\nnpm run dev\r\n```\r\n\r\n#### 3. Agent Worker Setup (Optional)\r\n\r\n```bash\r\ncd agent-worker\r\npip install -r requirements.txt\r\npython -m app.main\r\n```\r\n\r\n#### 4. Docker Setup (Full System)\r\n\r\n```bash\r\ncd config\r\ndocker-compose up -d\r\n```\r\n\r\n---\r\n\r\n## 📂 Project Structure\r\n\r\n```\r\nhelpdesk-project/\r\n├── backend/           # Node.js Express API\r\n│   ├── src/           # API source code\r\n│   ├── tests/         # Unit \u0026 integration tests\r\n│   └── docs/          # API Documentation\r\n├── frontend/          # React Vite application\r\n│   ├── src/           # React components \u0026 pages\r\n│   └── public/        # Static assets\r\n├── agent-worker/      # Python FastAPI AI service\r\n├── config/            # Docker, env files, deployment configs\r\n└── scripts/           # Database seeding \u0026 maintenance scripts\r\n```\r\n\r\n---\r\n\r\n## 📖 API Documentation\r\n\r\nDetailed API docs available in:\r\n👉 [Backend README](./backend/README.md)\r\n👉 Swagger UI available at `/api/docs` when running the backend service.\r\n\r\n---\r\n\r\n## 🚀 Future Enhancements\r\n\r\n* **AI-powered chatbots** integrated with the knowledge base\r\n* **Multi-channel support** (Email, WhatsApp, Slack, MS Teams)\r\n* **Customizable workflows** for different industries\r\n* **Plugin architecture** for third-party integrations (CRM, ERP, Slack, etc.)\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nWe welcome contributions from the community!\r\n\r\n1. Fork the repository\r\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\r\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\r\n4. Push to the branch (`git push origin feature/amazing-feature`)\r\n5. Open a Pull Request\r\n\r\n---\r\n\r\n## 🎯 Why This Project?\r\n\r\n* Built with **modern technologies** ensuring performance \u0026 scalability\r\n* **AI integration** for smarter customer support\r\n* **Flexible deployment** – works on local, cloud, or containerized environments\r\n* Designed for **real-world support teams** handling large ticket volumes\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F22p31a0512%2Fwexa_ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F22p31a0512%2Fwexa_ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F22p31a0512%2Fwexa_ai/lists"}