# Web Dashboard Design

Design document for the Atlas web LAN dashboard.

## Overview

A simple, local web interface for monitoring and managing the Atlas voice agent system. Accessible only on the local network.

## Goals

1. **Monitor System**: View conversations, tasks, reminders
2. **Admin Control**: Pause/resume agents, kill services
3. **Log Viewing**: Search and view system logs
4. **Privacy**: Local-only, no external access

## Pages/Sections

### 1. Dashboard Home
- System status overview
- Active conversations count
- Pending tasks count
- Active timers/reminders
- Recent activity

### 2. Conversations
- List of recent conversations
- Search/filter by date, agent type
- View conversation details
- Delete conversations

### 3. Tasks Board
- Read-only Kanban view
- Filter by status
- View task details

### 4. Timers & Reminders
- List active timers
- List upcoming reminders
- Cancel timers

### 5. Logs
- Search logs by date, agent, tool
- Filter by log level
- Export logs

### 6. Admin Panel
- Agent status (family/work)
- Pause/Resume buttons
- Kill switches:
  - Family agent
  - Work agent
  - MCP server
  - Specific tools
- Access revocation:
  - List active sessions
  - Revoke sessions/tokens

## API Design

### Base URL
`http://localhost:8000/api` (or configurable)

### Endpoints

#### Conversations
```
GET    /conversations           - List conversations
GET    /conversations/:id       - Get conversation
DELETE /conversations/:id       - Delete conversation
```

#### Tasks
```
GET    /tasks                   - List tasks
GET    /tasks/:id               - Get task details
```

#### Timers
```
GET    /timers                  - List active timers
POST   /timers/:id/cancel       - Cancel timer
```

#### Logs
```
GET    /logs                    - Search logs
GET    /logs/export             - Export logs
```

#### Admin
```
GET    /admin/status            - System status
POST   /admin/agents/:type/pause    - Pause agent
POST   /admin/agents/:type/resume   - Resume agent
POST   /admin/services/:name/kill   - Kill service
GET    /admin/sessions          - List sessions
POST   /admin/sessions/:id/revoke  - Revoke session
```

## Security

- **Local Network Only**: Bind to localhost or LAN IP
- **No Authentication**: Trust local network (can add later)
- **Read-Only by Default**: Most operations are read-only
- **Admin Actions**: Require explicit confirmation

## Implementation Plan

### Phase 1: Basic UI
- HTML structure
- CSS styling
- Basic JavaScript
- Static data display

### Phase 2: API Integration
- Connect to MCP server APIs
- Real data display
- Basic interactions

### Phase 3: Admin Features
- Admin panel
- Kill switches
- Log viewing

### Phase 4: Real-time Updates
- WebSocket integration
- Live updates
- Notifications

## Technology Choices

- **Simple**: Vanilla HTML/CSS/JS for simplicity
- **Or**: Lightweight framework (Vue.js, React) if needed
- **Backend**: Extend MCP server with dashboard endpoints
- **Styling**: Simple, clean, functional

## Future Enhancements

- Voice interaction (when TTS/ASR ready)
- Mobile app version
- Advanced analytics
- Customizable dashboards