SERVICES.md — ROLLerUP Infrastructure Reference

# SERVICES.md — ROLLerUP Infrastructure Reference

## Quick Reference

| Port | Service | Domain | Description | Location |
|------|---------|--------|-------------|----------|
| 5000 | kb-website | kb.rollerup.ca | Knowledge Base search API | /opt/kb_website/ |
| 5001 | onboarding | - | Onboarding portal | /opt/onboarding_website/ |
| 5002 | sales-agent | bot.rollerup.ca | AI Sales Bot (Claude) | /opt/kb_website/sales_agent.py |
| 5003 | fsm | fsm.rollerup.ca | Field Service Management | /opt/fsm/ |
| 5004 | service-agent | - | AI Service Bot (Claude) | /opt/kb_website/service_agent.py |
| 8080 | Caddy | - | Reverse proxy | /etc/caddy/Caddyfile |
| - | bot-dashboard | dashboard.rollerup.ca | Admin dashboard | /opt/kb_website/dashboard.py |

---

## Service Details

### kb-website.service (Port 5000)
- **Purpose:** Knowledge base search API
- **Domain:** kb.rollerup.ca
- **Location:** /opt/kb_website/
- **Systemd:** `systemctl status kb-website`

### onboarding.service (Port 5001)
- **Purpose:** Employee/customer onboarding portal
- **Location:** /opt/onboarding_website/
- **Systemd:** `systemctl status onboarding`

### sales-agent.service (Port 5002)
- **Purpose:** AI-powered sales chatbot
- **Domain:** bot.rollerup.ca
- **Location:** /opt/kb_website/sales_agent.py
- **Endpoints:**
  - `POST /webhook/salesiq` — SalesIQ webhook (production)
  - `POST /api/test` — QA testing endpoint
  - `GET /health` — Health check
  - `GET /conversations` — View conversations
  - `GET /stats` — Statistics
- **Systemd:** `systemctl status sales-agent`

### fsm.service (Port 5003)
- **Purpose:** Field Service Management
- **Domain:** fsm.rollerup.ca
- **Location:** /opt/fsm/
- **Systemd:** `systemctl status fsm`

### service-agent.service (Port 5004)
- **Purpose:** AI-powered service/support chatbot
- **Location:** /opt/kb_website/service_agent.py
- **Endpoints:** (TBD - needs /api/test endpoint)
- **Systemd:** `systemctl status service-agent`

### bot-dashboard.service
- **Purpose:** Admin dashboard for bots
- **Domain:** dashboard.rollerup.ca
- **Location:** /opt/kb_website/dashboard.py
- **Systemd:** `systemctl status bot-dashboard`

---

## Common Commands

### Check all services
```bash
systemctl status kb-website sales-agent service-agent fsm onboarding bot-dashboard
```

### Restart a service
```bash
systemctl restart sales-agent
```

### View logs
```bash
journalctl -u sales-agent -f
journalctl -u service-agent -n 50 --no-pager
```

### Check ports
```bash
ss -tlnp | grep -E "500[0-9]|8080"
```

---

## Domains (via Caddy)

| Domain | Points To |
|--------|-----------|
| kb.rollerup.ca | localhost:5000 |
| bot.rollerup.ca | localhost:5002 |
| fsm.rollerup.ca | localhost:5003 |
| dashboard.rollerup.ca | bot-dashboard service |

---

## Database

- **Host:** openclaw-knowledge-db-do-user-8736740-0.e.db.ondigitalocean.com
- **Port:** 25060
- **Database:** openclaw_kb
- **Schemas:** zoho, kb, justcall

---

*Last updated: 2026-03-05*