very first commit

docs/DEPLOYMENT.md

@@ -0,0 +1,156 @@
+# Dexar Market - Deployment Guide
+
+## Prerequisites
+- Ubuntu/Debian server with root access
+- Domain: dexarmarket.ru
+- Node.js 18+ installed
+
+## Quick Deployment
+
+### 1. Build locally
+```bash
+npm install
+npm run build
+```
+Output: `dist/dexarmarket/browser/`
+
+**VERIFY BUILD LOCALLY:**
+```bash
+cd dist/dexarmarket/browser
+ls -la
+```
+You MUST see `index.html`, chunk files, `assets/` folder, etc.
+
+### 2. Upload to server
+```bash
+scp -r dist/dexarmarket/browser/* user@your-server:/var/www/dexarmarket/browser/
+```
+
+### 3. Set permissions on server
+```bash
+sudo chown -R www-data:www-data /var/www/dexarmarket
+sudo chmod -R 755 /var/www/dexarmarket
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+## Initial Server Setup (one-time)
+
+### Install and configure Nginx
+```bash
+sudo apt update
+sudo apt install nginx -y
+sudo mkdir -p /var/www/dexarmarket/browser
+```
+
+Copy `nginx.conf` content to `/etc/nginx/sites-available/dexarmarket`:
+```bash
+sudo nano /etc/nginx/sites-available/dexarmarket
+```
+
+Then enable it:
+```bash
+sudo ln -s /etc/nginx/sites-available/dexarmarket /etc/nginx/sites-enabled/
+sudo rm /etc/nginx/sites-enabled/default
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+### Setup SSL (recommended)
+```bash
+sudo apt install certbot python3-certbot-nginx -y
+sudo certbot --nginx -d dexarmarket.ru -d www.dexarmarket.ru
+```
+
+## Common Issues & Solutions
+
+### ❌ 404 Error - Files Not Found
+
+**Check 1: Verify files on server**
+```bash
+ls -la /var/www/dexarmarket/browser/
+```
+Should show: `index.html`, `chunk-*.js`, `assets/`, etc.
+
+**If empty:**
+```bash
+# Re-upload files
+scp -r dist/dexarmarket/browser/* user@your-server:/var/www/dexarmarket/browser/
+```
+
+**Check 2: Verify permissions**
+```bash
+namei -l /var/www/dexarmarket/browser/index.html
+```
+All directories need `x` (execute) permission.
+
+**Fix permissions:**
+```bash
+sudo chown -R www-data:www-data /var/www/dexarmarket
+sudo chmod -R 755 /var/www/dexarmarket
+```
+
+**Check 3: Test nginx config**
+```bash
+sudo nginx -t
+```
+Should say "syntax is ok" and "test is successful".
+
+**Check 4: View nginx error log**
+```bash
+sudo tail -f /var/log/nginx/error.log
+```
+This shows the actual error!
+
+### ❌ 502 Bad Gateway - API Issues
+
+**This means the API backend is down or unreachable.**
+
+**Check 1: Is API accessible?**
+```bash
+curl -v https://api.dexarmarket.ru:445/ping
+```
+
+**Check 2: Port 445 problem**
+Port 445 is unusual for HTTPS and may be blocked by firewalls. Standard HTTPS uses port 443.
+
+**Check 3: CORS issues**
+The API must allow requests from `https://dexarmarket.ru`. Check API CORS configuration.
+
+**Check 4: SSL certificate**
+```bash
+curl -k https://api.dexarmarket.ru:445/ping
+```
+If this works but without `-k` doesn't, SSL cert is invalid.
+
+### ✅ Final Verification Checklist
+
+On server, run all these:
+```bash
+# 1. Files exist
+ls -la /var/www/dexarmarket/browser/index.html
+
+# 2. Nginx config is valid
+sudo nginx -t
+
+# 3. Nginx is running
+sudo systemctl status nginx
+
+# 4. Site is enabled
+ls -la /etc/nginx/sites-enabled/ | grep dexarmarket
+
+# 5. Test API from server
+curl -v https://api.dexarmarket.ru:445/ping
+
+# 6. Check logs
+sudo tail -20 /var/log/nginx/error.log
+sudo tail -20 /var/log/nginx/access.log
+```
+
+### Debug Steps
+
+If still having issues:
+1. Check browser console (F12 → Console tab) - shows JavaScript errors
+2. Check browser network tab (F12 → Network tab) - shows failed requests
+3. Check exact error message in nginx logs
+4. Test locally: `cd dist/dexarmarket/browser && python3 -m http.server 8000`