# Act Angel AI
## Overview
Act Angel AI is an AI-powered, multi-tenant platform designed for managing AI assistants that handle calls and chats. It enables organizations to manage contacts, track enquiries and service requests, monitor AI assistant usage, and handle credits and billing. Each organization operates with an owner possessing full permissions and additional users with configurable role-based access. The platform aims to streamline customer interaction management and provide comprehensive oversight for businesses utilizing AI-driven communication solutions.
## User Preferences
Preferred communication style: Simple, everyday language.
## System Architecture
### Multi-Tenant Data Model
The system enforces strict tenant isolation, where each organization is an isolated tenant with its own data. Users belong to a single organization, and resources like contacts, assistants, and logs are scoped to their respective organizations. Access control is managed through role-based permissions stored as JSON, with a single owner per organization and granular permissions for other users.
### Super Admin (SAD) Role
A Super Admin has platform-level access, bypassing all permission checks and able to manage data across all organizations. Special routes and pages are protected for SAD users, who can filter data by organization via a dedicated selector.
### Backend and Frontend Stacks
The backend is built with Express.js and TypeScript, utilizing Passport.js for session-based authentication and bcrypt for password security. It exposes RESTful APIs and enforces tenant isolation. The frontend uses React 18 with TypeScript, Wouter for routing, TanStack React Query for state management, shadcn/ui and Radix UI for components, and Tailwind CSS for styling. Vite is used for frontend building.