Owner: Engineering Team | Last Updated: 2026-01-30 | Status: Current
WWAI (Walter AI) is an AI-powered text humanization SaaS platform. The system transforms AI-generated text into human-like prose and provides AI detection scoring across 9 industry-leading detectors. The platform serves users through a web application, mobile app, Chrome browser extension, Shopify plugin, and WordPress plugin.
This document provides the highest-level architectural view (C4 Level 1), showing all external actors, system boundaries, and third-party integrations.
WWAI System Context (C4 Level 1)
+------------------+ +---------------------+ +---------------------+ +-------------------+
| End Users | | Browser Extension | | Shopify Store | | WordPress Site |
| (Web & Mobile) | | Users | | Owners | | Owners |
+--------+---------+ +---------+-----------+ +---------+-----------+ +--------+----------+
| | | |
| HTTPS | HTTPS | HTTPS | HTTPS
| | | |
+--------v------------------------v--------------------------v-------------------------v----------+
| |
| WWAI SYSTEM BOUNDARY |
| |
| +---------------------+ +---------------------+ +---------------------------+ |
| | | | | | | |
| | Next.js 16 Web App | ... | Flutter Mobile App | ... | Chrome Extension | |
| | (TypeScript/React) | | (Dart) | | (JavaScript) | |
| | | | | | | |
| +----------+----------+ +----------+----------+ +-------------+-------------+ |
| | | | |
| | REST API (HTTPS) | | |
| +----------------------------+------------------------------+ |
| | |
| +----------v----------+ |
| | | |
| | Django REST API | |
| | (Python Backend) | |
| | | |
| +----------+----------+ |
| | |
| +-----------------+-----------------+ |
| | | |
| +---------v---------+ +-----------v-----------+ |
| | | | | |
| | AI Humanization | | AI Detection | |
| | Models | | Models | |
| | (Proprietary) | | (Proprietary) | |
| | | | | |
| +-------------------+ +-----------------------+ |
| |
| +---------------------+ +---------------------+ +---------------------------+ |
| | Shopify Plugin | | WordPress Plugin | | Data Stores | |
| | (Embedded App) | | (PHP Plugin) | | - PostgreSQL | |
| +---------------------+ +---------------------+ | - AWS S3 | |
| | - Redis Cache | |
| +---------------------------+ |
+------------------------------------------------------------------------------------------------+
| | | |
| HTTPS | HTTPS | HTTPS | HTTPS
| | | |
+--------v--------+ +-------v--------+ +---------v---------+ +---------v---------+
| Authentication | | Payment | | AI Detectors | | Monitoring & |
| Providers | | Services | | (External) | | Analytics |
| | | | | | | |
| - Google OAuth | | - Stripe | | - GPTzero | | - Sentry |
| - Facebook OAuth| | - Churnkey | | - ZeroGPT | | - PostHog |
| | | | | - Sapling | | - Google Analytics|
+-----------------+ +----------------+ | - Copyleaks | | - MS Clarity |
| - Writer | | - AWS CloudWatch |
| - Turnitin | | |
| - Originality | +-------------------+
| - Crossplag |
| - Content at Scale|
+-------------------+
| Actor | Description | Interface | Protocol |
|---|---|---|---|
| End Users (Web) | Primary users accessing the humanization and detection features via browser | Next.js Web Application | HTTPS |
| End Users (Mobile) | Users on iOS/Android accessing via the Flutter app | Flutter Mobile App | HTTPS |
| Browser Extension Users | Users humanizing text directly from any webpage via Chrome Extension | Chrome Extension | HTTPS |
| Shopify Store Owners | E-commerce merchants integrating humanization into their Shopify stores | Shopify Embedded App | HTTPS |
| WordPress Site Owners | Content creators using humanization within their WordPress CMS | WordPress Plugin | HTTPS (REST API) |
| Component | Technology | Description |
|---|---|---|
| Web Application | Next.js 16, TypeScript, React, Redux, Tailwind CSS | Primary user interface. Server-side rendered with static optimization. Handles authentication via NextAuth.js with JWT sessions. |
| Mobile Application | Flutter, Dart | Cross-platform mobile app (iOS & Android). Shares the same backend API as the web app. |
| Chrome Extension | JavaScript, Chrome APIs | Browser extension allowing in-context text humanization. Communicates with the backend via extension-specific JWT tokens. |
| Shopify Plugin | Shopify App Bridge, Liquid | Embedded Shopify application for product description humanization. Installed via Shopify App Store. |
| WordPress Plugin | PHP, WordPress APIs | WP plugin providing humanization within the WordPress editor. Distributed via WordPress Plugin Directory. |
| Component | Technology | Description |
|---|---|---|
| Django REST API | Python, Django REST Framework | Core backend service handling all business logic, authentication, credit management, and orchestration of AI models and external detectors. |
| AI Humanization Models | Proprietary (Python/ML) | Custom-trained models that transform AI-generated text into human-like writing. Multiple model versions for different quality tiers. |
| AI Detection Models | Proprietary (Python/ML) | Internal detection models that score text for AI-generated content probability. |
| Store | Technology | Purpose |
|---|---|---|
| Primary Database | PostgreSQL | User accounts, subscriptions, usage history, API keys, audit logs |
| Object Storage | AWS S3 | Static assets, model artifacts, exported reports |
| Cache Layer | Redis | Session data, rate limiting counters, frequently accessed configuration |
| Provider | Protocol | Purpose |
|---|---|---|
| OAuth 2.0 (OIDC) | Social login, account linking | |
| OAuth 2.0 | Social login, account linking |
| Service | Integration Type | Purpose |
|---|---|---|
| Stripe | REST API + Webhooks | Payment processing, subscription management, invoicing |
| Churnkey | JavaScript SDK + Webhooks | Churn prevention, cancellation flow management, retention offers |
All 9 external detectors are called from the Django backend via their respective APIs:
| Detector | API Type | Purpose |
|---|---|---|
| GPTzero | REST API | AI detection scoring |
| ZeroGPT | REST API | AI detection scoring |
| Sapling | REST API | AI detection scoring |
| Copyleaks | REST API | AI detection scoring |
| Writer | REST API | AI detection scoring |
| Turnitin | REST API | AI detection scoring (academic focus) |
| Originality | REST API | AI detection scoring |
| Crossplag | REST API | AI detection scoring |
| Content at Scale | REST API | AI detection scoring |
| Service | Integration Point | Purpose |
|---|---|---|
| Sentry | Web App + Backend | Error tracking, performance monitoring (10% trace sample rate) |
| PostHog | Web App | Product analytics, feature flags, event tracking |
| Google Analytics | Web App (via GTM) | Traffic analytics, conversion tracking |
| Microsoft Clarity | Web App (Production) | Session replay, heatmaps, user behavior analysis |
| AWS CloudWatch | Backend (ECS) | Infrastructure monitoring, container logs, alarms |
| Service | Purpose |
|---|---|
| AWS ECS (Fargate) | Container orchestration for backend services |
| AWS ECR | Docker image registry |
| AWS S3 | Object storage for static assets and model artifacts |
| AWS CloudWatch | Logging, metrics, and alerting |
| Docker | Containerization of all backend services |
| GitHub Actions | CI/CD pipelines for all repositories |
Monolithic Backend with AI Model Services: The Django backend serves as the central orchestrator. AI models are invoked as internal services rather than separate microservices to reduce latency and operational complexity.
JWT-Based Authentication: All client applications authenticate via JWT tokens with 1-hour expiry and 55-minute proactive refresh. This enables stateless authentication across all platforms.
Credit-Based Usage Model: All humanization and detection operations consume credits from the user's plan allocation, providing a unified metering system across all client platforms.
External Detector Aggregation: Detection results from 9 external services are aggregated server-side, providing users with a comprehensive AI detection score without requiring individual detector accounts.
Multi-Platform Single Backend: All client applications (web, mobile, extension, plugins) share the same Django REST API, ensuring consistent business logic and data integrity.
| Date | Author | Change |
|---|---|---|
| 2026-01-30 | Admin | Initial creation |
Next: Service Map (C4 Level 2 - Container Diagram) | Up: General