# Project Tracker

A self-hosted project tracking web app. Dark-themed, minimal, fast.

---

## Quick Start (One Command)

On a **fresh Debian/Ubuntu** server with Docker:

```bash
curl -sL https://gitea.ledrew.me/ledadmin/project-tracker/raw/branch/master/deploy/setup.sh -o setup.sh && bash setup.sh
```

That's it. The script handles everything: system update → Docker → Docker Compose → clone → build → start.

**Requires:** Debian/Ubuntu, root access, port 80 available.

**Resource requirements:**
- **RAM:** 512 MB minimum, 1 GB recommended
- **CPU:** 1 vCPU
- **Disk:** 2 GB
- **Ports:** 80 (HTTP)

These are trivial requirements — runs comfortably on a 512 MB LXC or minimal VM.

**What it does:**
1. Updates system packages
2. Installs Docker (if not present)
3. Clones this repo
4. Builds and starts the app via Docker Compose
5. Shows you the URL when done

To interactively confirm before running, download first:
```bash
curl -sL https://gitea.ledrew.me/ledadmin/project-tracker/raw/branch/master/deploy/setup.sh -o setup.sh
bash setup.sh
```

---

## Manual Docker Install

If you prefer to install manually or already have Docker:

```bash
# Install Docker
apt-get update
apt-get install -y docker.io docker-compose

# Clone and start
git clone https://gitea.ledrew.me/ledadmin/project-tracker.git
cd project-tracker/deploy
docker compose up -d --build
```

---

## Seed Sample Projects

After first deploy, populate with sample projects:

```bash
docker exec -it project-tracker-api node -e "
const db = require('better-sqlite3')('/app/data/projects.db');
const items = [
  {name:'Pi-hole Ad Blocking',priority:'Medium',url:'https://pi-hole.net/',notes:'Network-wide ad blocking via DNS. Run on a dedicated Pi or LXC.',status:'Backlog',owner:'Admin',tags:'dns,network,security'},
  {name:'Home Assistant Upgrade',priority:'Medium',url:'https://www.home-assistant.io/',notes:'Upgrade HA to latest version. Check for breaking changes in release notes first.',status:'Backlog',owner:'Admin',tags:'homeassistant,automation'},
  {name:'Backup Strategy Review',priority:'Low',url:'',notes:'Audit current backup coverage. Verify VM and NAS backups are actually working.',status:'Backlog',owner:'Admin',tags:'backup,storage'},
  {name:'Portainer Migration',priority:'Low',url:'https://www.portainer.io/',notes:'Move away from Portainer to native Docker CLI or Docker Compose.',status:'Backlog',owner:'Admin',tags:'docker,management'},
  {name:'VLAN Segregation Audit',priority:'Low',url:'',notes:'Review VLAN configuration. Ensure IoT devices are isolated from main network.',status:'Backlog',owner:'Admin',tags:'networking,vlan,security'},
];
const stmt = db.prepare('INSERT INTO projects (name,priority,url,notes,status,owner,tags) VALUES (?,?,?,?,?,?,?)');
items.forEach(i => stmt.run(i.name,i.priority,i.url,i.notes,i.status,i.owner,i.tags));
console.log('Seeded', items.length, 'projects');
"
```

---

## Useful Commands

```bash
docker compose logs -f           # View logs
docker compose logs -f backend    # Backend logs only
docker compose restart           # Restart
docker compose down              # Stop
docker compose down -v           # Stop and DELETE database (CAREFUL!)
docker exec -it project-tracker-api sh   # Shell into backend
```

---

## Environment Variables

| Variable | Default | Description |
|---|---|---|
| `PORT` | `3000` | Backend port (internal) |
| `NODE_ENV` | `production` | Node environment |
| `DATA_DIR` | `/app/data` | SQLite data directory |

---

## Ports

| Port | Service |
|---|---|
| `80` | nginx (frontend + API proxy) |
| `3000` | Backend API (internal only) |

---

## Updating

```bash
# With setup.sh (pulls latest, rebuilds):
curl -sL https://gitea.ledrew.me/ledadmin/project-tracker/raw/branch/master/deploy/setup.sh -o setup.sh && bash setup.sh

# Manual update:
cd project-tracker
git pull
docker compose down
docker compose up -d --build
```

---

## SSL / HTTPS

For HTTPS, put nginx behind a reverse proxy (e.g., NginxProxyManager, Traefik, Caddy) on port 80/443. The nginx container should NOT be exposed directly to the internet.

---

## Stack

- **Backend:** Node.js + Express + better-sqlite3
- **Frontend:** Vanilla JS + CSS (no framework, no build step)
- **Web Server:** nginx (reverse proxy + static files)
- **Database:** SQLite (single file, no server process)
- **Deploy:** Docker Compose (2 containers: backend + nginx)

---

## API

| Method | Endpoint | Description |
|---|---|---|
| GET | `/api/projects` | List all projects |
| GET | `/api/projects/:id` | Get single project |
| POST | `/api/projects` | Create project |
| PUT | `/api/projects/:id` | Update project |
| DELETE | `/api/projects/:id` | Delete project |

### Body (POST/PUT)

```json
{
  "name": "Project Name",
  "priority": "High|Med-High|Medium|Low",
  "url": "https://...",
  "notes": "Description...",
  "status": "Active|Backlog|On Hold|Completed",
  "owner": "Admin",
  "tags": "tag1,tag2"
}
```

---

## File Structure

```
project-tracker/
├── deploy/
│   ├── docker-compose.yml    # Services definition
│   ├── Dockerfile            # Backend (Node.js)
│   ├── Dockerfile.nginx      # nginx + frontend
│   ├── nginx.conf            # Reverse proxy config
│   ├── setup.sh             # One-shot deploy script
│   ├── www/                  # Frontend (baked into nginx)
│   │   ├── index.html
│   │   └── favicon.png
│   └── README.md
└── backend/
    ├── server.js            # Express API
    └── package.json
```

---

## Notes

- No authentication on the API — intended for internal use behind a reverse proxy
- CORS is open for development; restrict in production if needed
- Database persists in Docker named volume — survives `docker compose down/up`