Ops Dashboard (ops-dashboard)

Internal operational portal for regional warehouse management, dispatch tracking, stock movement monitoring, and daily fulfillment reporting across Indonesia operational hubs.

Features

• Real-Time Summary Widgets: Live tracking for daily fulfillment counts, pending dispatches, and regional warehouse capacity.
• Dispatch Queue & Surat Jalan: Filterable dispatch queue with batch driver/courier assignment and printable surat jalan manifests.
• Stock Movement Log: Detailed incoming receipt tracking and inter-warehouse stock transfer audit.
• Operational Alerts: Immediate visual indicators for shipping delays and low stock threshold breaches.
• Multi-Sheet Excel Reporting: Automated .xlsx export generator for daily operational reconciliations.
• Printable PDF Reports: Direct generation of shift handover receipts and daily dispatch manifests.
• RBAC & Auth: Role-based permissions (Ops Director, Branch Manager, Warehouse Operator) secured via corporate JWT authentication.
• Audit Logs: System-wide logging for order status modifications and sensitive operations.

Tech Stack

• Backend: Go 1.22
• Templating: a-h/templ + HTMX 2.0 (migrated June 2024)
• Styling: Tailwind CSS 3.4
• Database: PostgreSQL 16
• PDF & Excel: gofpdf, excelize/v2
• Auth: JWT (RS256 signature verification)

Local Development Setup

Prerequisites

• Go 1.22 or higher
• PostgreSQL 16
• Node.js 18+ (for Tailwind CSS compiler)
• templ CLI installed (go install github.com/a-h/templ/cmd/templ@latest)

Environment Variables

Create a .env file in the root directory:

PORT=8080
DB_HOST=localhost
DB_PORT=5432
DB_USER=ops_user
DB_PASSWORD=ops_password
DB_NAME=ops_db
DB_SSLMODE=disable
JWT_SECRET_KEY=your-local-development-secret-key-32-chars

Running Locally

1. Install dependencies and compile CSS:

   npm install
   npx tailwindcss -i ./static/css/input.css -o ./static/css/output.css --watch

2. Generate Templ components:

   templ generate

3. Run database migrations:

   go run ./cmd/migrate up

4. Start the Go application:

   go run ./cmd/server/main.go

5. Open your browser at http://localhost:8080.

Running with Docker Compose

docker-compose up --build -d

Production Deployment

The service runs inside the Jakarta Corporate Datacenter behind an F5 BIG-IP load balancer terminating TLS 1.3. Application logs are written to host-mounted directories linked to the corporate rsyslog cluster.