# 📋 Step-by-Step Deployment Instructions

## Current Status: ✅ READY TO USE

Both applications are ready and working!

---

## 🌐 Web Application (Currently Running)

### ✅ What's Already Working

- **API Server:** Running on port 8001
- **Web Frontend:** Running on port 3000
- **Access:** http://localhost:3000
- **Features:** Search, View PDFs, Download, Print
- **No Authentication:** Open access (as requested)

### 📋 Detailed Information Displayed

Each search result shows:
- ✅ **Document ID** (#10000000013791)
- ✅ **Page Count** (46 pages)
- ✅ **Available Images** (46 images)
- ✅ **Submission Date** (Mar 9, 2015)
- ✅ **Status Badge** (Complete/Partial)
- ✅ **Issued By** (if available)
- ✅ **Document Type** with icon (📁 Property File)
- ✅ **View Document Button**

### 🚀 Deploy for Production

#### Step 1: Install Nginx (5 minutes)

```bash
sudo apt update
sudo apt install nginx
```

#### Step 2: Create Nginx Config (10 minutes)

```bash
sudo nano /etc/nginx/sites-available/aumentum
```

Paste this configuration:

```nginx
server {
    listen 80;
    server_name your-server-ip;  # Change to your IP or domain
    
    # Frontend
    location / {
        root /home/plagis/workspace/plagis_aumentum/web_frontend;
        try_files $uri $uri/ /index.html;
        
        # Cache static files
        expires 1h;
        add_header Cache-Control "public, immutable";
    }
    
    # API
    location /api/ {
        rewrite ^/api/(.*) /$1 break;
        proxy_pass http://127.0.0.1:8001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        
        # Increase timeout for large PDFs
        proxy_read_timeout 300s;
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        
        # Don't cache API responses
        expires off;
        add_header Cache-Control "no-cache, no-store, must-revalidate";
    }
}
```

#### Step 3: Update Frontend to Use Nginx Proxy (2 minutes)

```bash
# Edit index.html
nano /home/plagis/workspace/plagis_aumentum/web_frontend/index.html

# Change line with API_BASE:
# FROM: const API_BASE = 'http://localhost:8001';
# TO:   const API_BASE = '/api';
```

Or use this command:
```bash
cd /home/plagis/workspace/plagis_aumentum/web_frontend
sed -i "s|const API_BASE = 'http://localhost:8001';|const API_BASE = '/api';|" index.html
```

#### Step 4: Enable Site (2 minutes)

```bash
# Enable site
sudo ln -s /etc/nginx/sites-available/aumentum /etc/nginx/sites-enabled/

# Test configuration
sudo nginx -t

# Restart Nginx
sudo systemctl restart nginx
```

#### Step 5: Setup API as System Service (5 minutes)

```bash
sudo nano /etc/systemd/system/aumentum-api.service
```

Paste this:

```ini
[Unit]
Description=Aumentum Document API
After=network.target

[Service]
Type=simple
User=plagis
WorkingDirectory=/home/plagis/workspace/plagis_aumentum
Environment="PATH=/home/plagis/workspace/plagis_aumentum/venv/bin"
ExecStart=/home/plagis/workspace/plagis_aumentum/venv/bin/uvicorn aumentum_api:app --host 127.0.0.1 --port 8001 --workers 4
Restart=always
RestartSec=10
StandardOutput=append:/home/plagis/workspace/plagis_aumentum/api.log
StandardError=append:/home/plagis/workspace/plagis_aumentum/api_error.log

[Install]
WantedBy=multi-user.target
```

Enable and start:

```bash
sudo systemctl daemon-reload
sudo systemctl enable aumentum-api
sudo systemctl start aumentum-api
sudo systemctl status aumentum-api
```

#### Step 6: Configure Firewall (2 minutes)

```bash
# Allow HTTP
sudo ufw allow 80/tcp

# Optional: Allow only from office network
# sudo ufw allow from 192.168.1.0/24 to any port 80

# Enable firewall
sudo ufw enable
```

#### Step 7: Access Your Web App! ✅

```
http://your-server-ip
```

**No more port numbers needed!** 🎉

---

## 💻 Desktop Application

### Option 1: Electron (Cross-Platform)

#### Step 1: Create Project (10 minutes)

```bash
cd /home/plagis/workspace
mkdir aumentum-desktop
cd aumentum-desktop

# Initialize npm project
npm init -y

# Install dependencies
npm install electron electron-builder
```

#### Step 2: Create Files (20 minutes)

**`main.js`** (Main process):

```javascript
const { app, BrowserWindow } = require('electron');
const path = require('path');

function createWindow() {
    const win = new BrowserWindow({
        width: 1400,
        height: 900,
        webPreferences: {
            nodeIntegration: false,
            contextIsolation: true
        },
        icon: path.join(__dirname, 'assets', 'icon.png')
    });
    
    // Load your web frontend
    win.loadFile(path.join(__dirname, 'web_frontend', 'index.html'));
    
    // Or load from server:
    // win.loadURL('http://localhost:8001/static/index.html');
}

app.whenReady().then(createWindow);

app.on('window-all-closed', () => {
    if (process.platform !== 'darwin') {
        app.quit();
    }
});

app.on('activate', () => {
    if (BrowserWindow.getAllWindows().length === 0) {
        createWindow();
    }
});
```

**`package.json`** (Update):

```json
{
  "name": "aumentum-desktop",
  "version": "1.0.0",
  "description": "Aumentum Document Viewer Desktop Application",
  "main": "main.js",
  "scripts": {
    "start": "electron .",
    "build": "electron-builder",
    "build:linux": "electron-builder --linux",
    "build:win": "electron-builder --win",
    "build:mac": "electron-builder --mac"
  },
  "build": {
    "appId": "com.aumentum.viewer",
    "productName": "Aumentum Document Viewer",
    "directories": {
      "output": "dist"
    },
    "linux": {
      "target": ["AppImage", "deb"],
      "icon": "assets/icon.png",
      "category": "Office"
    },
    "win": {
      "target": "nsis",
      "icon": "assets/icon.ico"
    },
    "mac": {
      "target": "dmg",
      "icon": "assets/icon.icns"
    }
  },
  "dependencies": {
    "electron": "^27.0.0"
  },
  "devDependencies": {
    "electron-builder": "^24.6.0"
  }
}
```

#### Step 3: Copy Web Frontend (5 minutes)

```bash
# Copy your web frontend
cp -r /home/plagis/workspace/plagis_aumentum/web_frontend .

# Update API_BASE in index.html to point to your server
sed -i "s|http://localhost:8001|http://your-server-ip:8001|" web_frontend/index.html
```

#### Step 4: Add Icon (2 minutes)

```bash
mkdir assets
# Copy/create icon files:
# - assets/icon.png (256x256 PNG for Linux)
# - assets/icon.ico (for Windows)
# - assets/icon.icns (for macOS)
```

#### Step 5: Build Desktop App (5 minutes)

```bash
# Install dependencies
npm install

# Test run
npm start

# Build for Linux
npm run build:linux

# Output: dist/Aumentum Document Viewer-1.0.0.AppImage
# and:     dist/aumentum-desktop_1.0.0_amd64.deb
```

#### Step 6: Install Desktop App (1 minute)

**For AppImage:**
```bash
chmod +x "dist/Aumentum Document Viewer-1.0.0.AppImage"
./dist/Aumentum\ Document\ Viewer-1.0.0.AppImage
```

**For .deb:**
```bash
sudo dpkg -i dist/aumentum-desktop_1.0.0_amd64.deb
```

**For Windows (.exe):**
```bash
# On Windows machine:
npm run build:win
# Run the installer from dist/ folder
```

---

## Quick Commands Reference

### Start/Stop Services

**API Server:**
```bash
# Start
cd /home/plagis/workspace/plagis_aumentum
source venv/bin/activate
python3 aumentum_api.py

# Or as background service:
sudo systemctl start aumentum-api

# Stop
pkill -f aumentum_api
# or
sudo systemctl stop aumentum-api

# View logs
tail -f /home/plagis/workspace/plagis_aumentum/api.log
```

**Web Server (Development):**
```bash
# Start
cd /home/plagis/workspace/plagis_aumentum/web_frontend
python3 -m http.server 3000

# Stop
pkill -f "http.server 3000"
```

**Nginx (Production):**
```bash
# Start
sudo systemctl start nginx

# Stop
sudo systemctl stop nginx

# Restart (after config changes)
sudo systemctl restart nginx

# Check status
sudo systemctl status nginx
```

### Maintenance

**Clear PDF Cache:**
```bash
rm -rf /tmp/aumentum_pdfs/*
```

**Restart Everything:**
```bash
sudo systemctl restart aumentum-api
sudo systemctl restart nginx
```

**View Logs:**
```bash
# API logs
tail -f /home/plagis/workspace/plagis_aumentum/api.log

# Nginx access logs
sudo tail -f /var/log/nginx/access.log

# Nginx error logs
sudo tail -f /var/log/nginx/error.log
```

---

## Troubleshooting

### Web App Not Loading

**Check if API is running:**
```bash
ps aux | grep aumentum_api
curl http://localhost:8001/
```

**Check if Nginx is running:**
```bash
sudo systemctl status nginx
```

**Check firewall:**
```bash
sudo ufw status
```

### PDF Not Displaying

**Clear server cache:**
```bash
rm -rf /tmp/aumentum_pdfs/*
```

**Clear browser cache:**
- Ctrl+Shift+Delete
- Or hard refresh: Ctrl+Shift+R

**Check logs:**
```bash
tail -50 /home/plagis/workspace/plagis_aumentum/api.log
```

### Desktop App Issues

**Can't connect to API:**
- Make sure API server is accessible
- Check firewall allows port 8001
- Update API_BASE URL in index.html

---

## Security Recommendations (Without Authentication)

### Network-Level Security

**Option 1: IP Whitelist (Recommended)**
```nginx
# In nginx.conf, add inside server block:
location / {
    allow 192.168.1.0/24;  # Office network
    deny all;
}
```

**Option 2: Firewall Rules**
```bash
# Only allow from office network
sudo ufw allow from 192.168.1.0/24 to any port 80
sudo ufw deny 80
```

**Option 3: VPN Only**
- Deploy on internal network
- Require VPN connection to access

**Option 4: Internal Network Only**
- Don't expose to internet
- Access only from office computers

---

## Deployment Checklist

### Web Application Production Deployment

- [ ] API server running as systemd service
- [ ] Nginx configured and running
- [ ] Firewall rules configured
- [ ] Frontend updated with correct API URL
- [ ] SSL certificate installed (optional)
- [ ] Backup strategy in place
- [ ] Monitoring setup (optional)
- [ ] Users notified of URL

### Desktop Application Distribution

- [ ] Electron project created
- [ ] Web frontend copied
- [ ] API URL configured
- [ ] Icon added
- [ ] Built for target platform (Linux/Windows/Mac)
- [ ] Tested on clean machine
- [ ] Installation instructions created
- [ ] Distributed to users

---

## Timeline

### Web Application (Production Ready)

| Task | Time | Status |
|------|------|--------|
| Backend development | - | ✅ Complete |
| Frontend development | - | ✅ Complete |
| Local testing | - | ✅ Complete |
| Install Nginx | 5 min | ⏳ Pending |
| Configure Nginx | 10 min | ⏳ Pending |
| Setup systemd | 5 min | ⏳ Pending |
| Configure firewall | 2 min | ⏳ Pending |
| **Total** | **22 min** | **Ready to deploy!** |

### Desktop Application

| Task | Time | Status |
|------|------|--------|
| Setup Electron | 10 min | ⏳ Pending |
| Copy frontend | 5 min | ⏳ Pending |
| Configure & test | 10 min | ⏳ Pending |
| Build executable | 5 min | ⏳ Pending |
| **Total** | **30 min** | **Can start anytime** |

---

## Support

**Quick Test:**
```bash
# Is everything working?
curl http://localhost:8001/
curl "http://localhost:8001/documents/by-document-number?document_number=PL11089"
```

**Full Test:**
```bash
# Open browser
firefox http://localhost:3000
# or
google-chrome http://localhost:3000
```

**Need Help?**
- Check `SIMPLE_DEPLOYMENT.md` for detailed guides
- Check `web_frontend/FEATURES.md` for feature documentation
- Check `DEPLOYMENT_PLAN.md` for advanced options

---

## What's Next?

### Immediate (5 minutes):
1. Open http://localhost:3000 in your browser
2. Search for PL11089
3. View the detailed information (now matches browser extension!)
4. Click "View Document" to see the PDF

### Today (30 minutes):
1. Deploy with Nginx (follow Step 1-6 above)
2. Share with colleagues: `http://your-server-ip`
3. Get feedback

### This Week (1-2 hours):
1. Create desktop app (if needed for offline use)
2. Setup automatic backups
3. Create user guide

### Optional Enhancements:
- [ ] Add SSL certificate (https)
- [ ] Add export to Excel
- [ ] Add bulk document download
- [ ] Add document history tracking
- [ ] Add usage analytics

---

**Your application is production-ready and working perfectly!** 🚀