AutoEmployee v2.0 - Production-Ready AI Employee Platform

Enterprise-Grade Full-Stack Application with FastAPI Backend, Next.js 14 Frontend, PostgreSQL, and Real-Time Dashboard

🚀 Quick Start (5 Minutes)

Prerequisites

• Docker & Docker Compose
• OR: Python 3.13+, Node.js 20+, PostgreSQL 15+

Option 1: Docker (Recommended)

# 1. Clone/navigate to directory
cd Platinum-Tier

# 2. Copy environment file
cp .env.example .env

# 3. Start all services
cd docker
docker-compose up -d

# 4. Access application
# Frontend: http://localhost:3000
# Backend API: http://localhost:8000
# API Docs: http://localhost:8000/docs

Option 2: Manual Setup

# Backend
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

# Frontend (in new terminal)
cd frontend
npm install
npm run dev

# Database (ensure PostgreSQL is running)

📁 Organized Directory Structure

Platinum-Tier/
│
├── backend/                    # FastAPI Backend
│   ├── app/
│   │   ├── main.py            # Main application
│   │   ├── config.py          # Configuration
│   │   ├── database.py        # Database connection
│   │   ├── models/            # SQLAlchemy models
│   │   ├── schemas/           # Pydantic schemas
│   │   ├── api/               # API routes
│   │   ├── services/          # Business logic
│   │   └── auth/              # Authentication
│   ├── requirements.txt
│   └── Dockerfile
│
├── frontend/                   # Next.js 14 Frontend
│   ├── src/
│   │   ├── app/               # App router pages
│   │   ├── components/        # React components
│   │   ├── lib/               # Utilities
│   │   └── styles/            # CSS styles
│   ├── package.json
│   └── Dockerfile
│
├── docker/                     # Docker Configuration
│   ├── docker-compose.yml
│   └── nginx.conf
│
├── watcher/                    # AI Watchers (Existing)
│   ├── gmail_watcher.py
│   ├── facebook_watcher.py
│   └── ...
│
├── mcp-servers/                # MCP Servers (Existing)
│   ├── email-mcp/
│   └── ...
│
├── data/                       # Application Data
│   ├── Inbox/
│   ├── Needs_Action/
│   ├── Done/
│   └── Logs/
│
├── docs/                       # Documentation
│   ├── API.md
│   ├── FEATURES.md
│   └── DEPLOYMENT.md
│
├── scripts/                    # Utility Scripts
│   ├── setup.sh
│   └── init-db.sql
│
├── .env.example               # Environment template
├── .gitignore
└── README.md                  # This file

✨ Features

Backend (FastAPI)

Frontend (Next.js 14)

Infrastructure

🔐 Authentication

Default Credentials

Email: admin@autoemployee.com
Password: admin123

⚠️ Change immediately after first login!

Supported Methods

• Email/Password (JWT)
• Google OAuth2
• GitHub OAuth2

📊 Dashboard Features

The real-time dashboard displays:

Agent Status

• Cloud Executive (Running/Stopped)
• Local Executive (Running/Stopped)
• Uptime, CPU, Memory usage

Task Statistics

• Pending tasks (Cloud/Local breakdown)
• Completed today
• Pending approval queue

Watchers (11 Total)

1. Gmail Watcher
2. Facebook Watcher
3. Instagram Watcher
4. X/Twitter Watcher
5. LinkedIn Watcher
6. WhatsApp Watcher
7. Needs Action Watcher
8. HITL Watcher
9. Scheduler
10. Cloud Sync
11. Local Sync

MCP Servers (6 Total)

• email-mcp
• odoo-mcp
• social-mcp
• social-mcp-fb
• social-mcp-ig
• social-mcp-x

System Resources

• CPU usage %
• Memory usage (GB)
• Disk usage (GB)

🛠️ Development

Backend Development

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

Access API Docs: http://localhost:8000/docs

Frontend Development

cd frontend
npm install
npm run dev

Access Frontend: http://localhost:3000

Running Watchers

# Start individual watchers
python watcher/gmail_watcher.py
python watcher/facebook_watcher.py
python watcher/orchestrator_cloud.py
python watcher/orchestrator_local.py

📖 API Endpoints

Authentication

POST   /api/v1/auth/register       - Register new user
POST   /api/v1/auth/login          - Login (JWT)
POST   /api/v1/auth/refresh        - Refresh token
POST   /api/v1/auth/oauth/google   - Google OAuth
POST   /api/v1/auth/oauth/github   - GitHub OAuth

Users

GET    /api/v1/users               - List users
GET    /api/v1/users/me            - Current user
PUT    /api/v1/users/me            - Update profile

Tasks

GET    /api/v1/tasks               - List tasks
POST   /api/v1/tasks               - Create task
GET    /api/v1/tasks/{id}          - Get task
PUT    /api/v1/tasks/{id}          - Update task
DELETE /api/v1/tasks/{id}          - Delete task
POST   /api/v1/tasks/{id}/approve  - Approve task

Dashboard

GET    /api/v1/dashboard           - Full dashboard data
GET    /api/v1/dashboard/summary   - Lightweight summary
GET    /api/v1/dashboard/watchers  - Watcher status
GET    /api/v1/dashboard/resources - System resources
WS     /api/v1/dashboard/ws        - Real-time WebSocket

🚢 Production Deployment

Environment Variables

Create .env file:

# Database
DB_PASSWORD=secure-password-here

# Authentication
SECRET_KEY=your-super-secret-key-min-32-chars

# OAuth2 (Optional)
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-secret
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-secret

# CORS
ALLOWED_ORIGINS=https://yourdomain.com

Deploy with Docker

# Production mode
cd docker
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

# Check status
docker-compose ps

# View logs
docker-compose logs -f

Backup Database

docker-compose exec db pg_dump -U autoemployee autoemployee > backup.sql

🧪 Testing

Backend Tests

cd backend
pytest --cov=app

Frontend Tests

cd frontend
npm test

E2E Tests

python test_e2e_complete.py

📚 Documentation

🔧 Troubleshooting

Frontend won't load

# Check backend is running
curl http://localhost:8000/health

# Restart frontend
docker-compose restart frontend

Database connection error

# Check database is healthy
docker-compose ps db

# View database logs
docker-compose logs db

Watchers not showing data

# Ensure watchers are running
python watcher/gmail_watcher.py
python watcher/orchestrator_cloud.py

📞 Support

• Documentation: http://localhost:8000/docs
• GitHub Issues: https://github.com/adeelahmed/autoemployee/issues
• Email: support@autoemployee.com

🎯 Roadmap

Q2 2026

• Mobile app (iOS/Android)
• Advanced analytics
• Custom integrations

Q3 2026

• Plugin marketplace
• Multi-tenant support
• Advanced AI models

📄 License

Proprietary - All rights reserved

Version: 2.0.0
Last Updated: March 30, 2026
Status: ✅ Production Ready

Built with ❤️ by Adeel Ahmed