# 🚀 Simple Deployment Guide (No Authentication)
## Quick Overview
Since you don't need authentication, the deployment is much simpler:
- ✅ No login required
- ✅ No user management
- ✅ Direct access to search and view documents
- ✅ Faster implementation (3-5 days instead of 8-13 days)
---
## Option 1: Web Application (Recommended)
### Architecture (Simplified)
```
Browser → API Server (Port 8001) → Database + Files
```
**No authentication needed!** Users can directly search and view documents.
---
### Step-by-Step Implementation
#### Phase 1: Backend (Already Done! ✅)
Your current backend is **ready to use** as-is! No changes needed.
**Current working endpoints:**
- `GET /` - Health check
- `GET /documents/by-document-number?document_number=PL11089` - Search
- `GET /documents/pdf-by-document-number?document_number=PL11089&document_type=103&document_id=10000000013791` - View PDF
**Only update needed: CORS (if accessing from different domain)**
```python
# In aumentum_api.py - already configured!
app.add_middleware(
CORSMiddleware,
allow_origins=["*"], # Allow all origins (no auth needed)
allow_credentials=False, # No credentials needed
allow_methods=["*"],
allow_headers=["*"],
)
```
---
#### Phase 2: Simple Web Frontend (1-2 days)
**Option A: Ultra-Simple HTML (Single File)**
Create `public/index.html`:
```html
Aumentum Document Viewer
🗂️ Aumentum Document Viewer
Search and view land registry documents instantly
Search Results
🔍
Enter a document number above to begin
Document Viewer
📄
Select a document from the search results to view
```
**To use this:**
```bash
# 1. Save the file
mkdir -p /home/plagis/workspace/plagis_aumentum/web_frontend
# Copy the HTML above to: /home/plagis/workspace/plagis_aumentum/web_frontend/index.html
# 2. Make sure API is running
cd /home/plagis/workspace/plagis_aumentum
source venv/bin/activate
python3 aumentum_api.py &
# 3. Serve the frontend
cd web_frontend
python3 -m http.server 3000
# 4. Open browser
# Go to: http://localhost:3000
```
**That's it! No authentication, no complex setup!** 🎉
---
**Option B: React Frontend (More Features)**
If you want a more sophisticated UI later, you can use React:
```bash
# Create React app
npx create-react-app aumentum-web
cd aumentum-web
# Install dependencies
npm install axios @mui/material @emotion/react @emotion/styled react-pdf
# Copy the React components from DEPLOYMENT_PLAN.md (sections 2.2-2.4)
# But remove all authentication code (login, tokens, etc.)
# Start development server
npm start
```
---
#### Phase 3: Production Deployment (1-2 days)
**Option A: Simple Server Setup (No Docker)**
```bash
# 1. Install Nginx
sudo apt update
sudo apt install nginx
# 2. Configure Nginx
sudo nano /etc/nginx/sites-available/aumentum
```
```nginx
server {
listen 80;
server_name your-server-ip-or-domain;
# Frontend
location / {
root /home/plagis/workspace/plagis_aumentum/web_frontend;
try_files $uri $uri/ /index.html;
}
# API (proxy to backend)
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;
# Increase timeout for PDF generation
proxy_read_timeout 300s;
proxy_connect_timeout 300s;
}
}
```
```bash
# 3. Enable site
sudo ln -s /etc/nginx/sites-available/aumentum /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
# 4. Setup API as a service
sudo nano /etc/systemd/system/aumentum-api.service
```
```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/python3 -m uvicorn aumentum_api:app --host 127.0.0.1 --port 8001 --workers 4
Restart=always
[Install]
WantedBy=multi-user.target
```
```bash
# 5. Start service
sudo systemctl daemon-reload
sudo systemctl enable aumentum-api
sudo systemctl start aumentum-api
# 6. Check status
sudo systemctl status aumentum-api
# Done! Access at: http://your-server-ip
```
**Option B: Docker Deployment (Easier)**
Create `docker-compose.yml`:
```yaml
version: '3.8'
services:
api:
build: .
ports:
- "8001:8001"
volumes:
- /mnt/aumentum_contentstore:/mnt/contentstore:ro
- ./aumentum_pdfs:/tmp/aumentum_pdfs
environment:
- CONTENTSTORE_BASE=/mnt/contentstore
restart: unless-stopped
web:
image: nginx:alpine
ports:
- "80:80"
volumes:
- ./web_frontend:/usr/share/nginx/html:ro
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
- api
restart: unless-stopped
```
```bash
# Deploy
docker-compose up -d
# View logs
docker-compose logs -f
# Stop
docker-compose down
```
---
## Option 2: Desktop Application (No Authentication Needed)
Since there's no authentication, the desktop app is even simpler!
### Quick Desktop App (Electron)
**1. Setup (5 minutes)**
```bash
mkdir aumentum-desktop
cd aumentum-desktop
npm init -y
npm install electron
```
**2. Create `main.js`:**
```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
}
});
// Load the web version
win.loadFile('index.html');
// OR load from server:
// win.loadURL('http://localhost:3000');
}
app.whenReady().then(createWindow);
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') {
app.quit();
}
});
```
**3. Copy your HTML file:**
```bash
# Copy the web frontend HTML
cp /home/plagis/workspace/plagis_aumentum/web_frontend/index.html .
# Update API_BASE in the HTML to point to your server
# Change: const API_BASE = 'http://localhost:8001';
# To: const API_BASE = 'http://your-server-ip:8001';
```
**4. Add to `package.json`:**
```json
{
"name": "aumentum-desktop",
"version": "1.0.0",
"main": "main.js",
"scripts": {
"start": "electron .",
"build": "electron-builder"
},
"devDependencies": {
"electron": "^27.0.0",
"electron-builder": "^24.6.0"
},
"build": {
"appId": "com.aumentum.viewer",
"productName": "Aumentum Viewer",
"win": {
"target": "nsis"
},
"linux": {
"target": ["AppImage", "deb"]
}
}
}
```
**5. Run:**
```bash
npm start
```
**6. Build executable:**
```bash
npm install electron-builder --save-dev
npm run build
# Output in dist/ folder
```
---
## Security Considerations (Without Authentication)
Since you don't want authentication, consider these alternatives:
### Option 1: Network-Level Security
```bash
# Only allow access from office network
# In nginx.conf:
location / {
allow 192.168.1.0/24; # Your office network
deny all;
}
```
### Option 2: VPN Access
- Users connect via VPN
- Application only accessible on internal network
### Option 3: IP Whitelist
- Firewall rules to allow specific IPs only
### Option 4: Read-Only Access
- Current setup is already read-only (no modification endpoints)
- Users can search and view, but not modify data
---
## Quick Start Checklist
**For Web Application (30 minutes):**
- [x] ✅ Backend already working
- [ ] Create web_frontend folder
- [ ] Copy HTML file
- [ ] Update API_BASE URL
- [ ] Test locally (python -m http.server)
- [ ] Deploy to production server
**For Desktop Application (1 hour):**
- [ ] Install Node.js and npm
- [ ] Create Electron project
- [ ] Copy HTML file
- [ ] Update API_BASE URL
- [ ] Test (npm start)
- [ ] Build executable (npm run build)
---
## Recommended: Start with Web
**Why web first?**
- ✅ Faster to deploy (30 minutes)
- ✅ Works on any device (PC, tablet, phone)
- ✅ Easier to update
- ✅ No installation needed
- ✅ Can make desktop version later
**Timeline:**
- Today: Deploy simple HTML version (30 min)
- Test with users (1-2 days)
- If needed: Add React version (3-5 days)
- If needed: Create desktop app (1-2 days)
---
## Next Steps
1. **Choose:** Web or Desktop?
2. **Deploy:** Follow the quick start above
3. **Test:** Try with PL11089, PL689, etc.
4. **Share:** Send URL to users
**Want me to help you deploy right now?** Just let me know!