New Developer Onboarding

Welcome to the HandyManny development team! This guide will help you get up to speed quickly.

Overview

HandyManny operates a suite of 16+ applications across freight forwarding, trucking logistics, and data platforms. This documentation system provides comprehensive guides for all projects, workflows, and infrastructure.

Day 1: Setup

Access & Credentials

Contact Uriel for:

• GitHub repository access
• VPS SSH keys (~/.ssh/id_hostinger)
• n8n access (https://n8n.srv1139900.hstgr.cloud)
• Database credentials (CargoWise, PostgreSQL)
• API keys (Anthropic, NVIDIA, Gemini)

Development Environment

Required Software:

• Node.js v24+ (for Next.js projects)
• Python 3.12+ (for generators, MC dashboards)
• Docker Desktop
• Git
• VS Code (recommended) or your preferred IDE

Recommended VS Code Extensions:

• ESLint
• Prettier
• Prisma
• Python
• Docker

Clone Repositories

# Main projects
cd ~/projects
git clone <expediente-repo>
git clone <handymanny-repo>
git clone <mission-control-repo>

# Documentation
git clone <docs-repo>

Day 2-3: Learn the Stack

Technology Overview

Stack	Projects	Purpose
Next.js + Prisma + PostgreSQL	Expediente, CHAROS, HandyManny, FFTracking	Customer-facing portals
React + Express + SQLite	Mission Control v3	Operations dashboard
Python + Jinja2	Sales MC, WSI MC	Analytics dashboards
FastAPI + PostgreSQL	VIA Platform	API backend for convoy logistics
n8n (Node.js)	63 workflows	Automation & integration

Key Patterns to Learn

1. Multi-tenant deployment — NEXT_PUBLIC_BRAND_* env vars
2. Docker deployment — All apps use nginx + Traefik
3. n8n AI integration — Anthropic credential for Claude API
4. CargoWise schema — 142KB reference doc (see Reference)

Week 1: First Tasks

Recommended Learning Path

1. Day 1-2: Read this onboarding guide, set up dev environment
2. Day 3: Deploy one project locally (start with Expediente)
3. Day 4-5: Review Deployment SOP, make a test deploy to staging
4. Week 2: Pick up first real task from Mission Control

Your First Deploy

Start with a simple project to learn the deployment pattern:

cd ~/projects/expediente
npm install
cp .env.example .env  # (if exists)
npm run dev  # Test locally at localhost:3000

# When ready to deploy:
bash deploy.sh

See Deployment SOP for full procedures.

Resources

Essential Reading

• Project Overview — All 16 projects documented
• Infrastructure — VPS servers, Docker, networking
• n8n Workflows — 63 automation workflows
• CargoWise Schema — Database reference

Code Patterns

• Design Systems — UI patterns per project
• Reusable Components — Universal Search, etc.

Standard Operating Procedures

• Deployment SOP — Step-by-step deployment guide
• Rollback SOP — Emergency rollback procedures
• n8n Patterns — Workflow best practices & gotchas
• Security Guide — Security practices & monitoring
• Docker Inventory — All containers & services

Ask for Help

• Uriel: Architecture, business logic, complex debugging
• Mission Control: Check project status, dependencies
• This Documentation: Search (Cmd/Ctrl+K) for keywords

Next Steps

After completing this onboarding:

1. Review Deployment SOP
2. Read project-specific docs for your assigned work
3. Make your first commit!
4. Deploy to staging and verify

---

Welcome aboard! 🚀

Last Updated: Auto-generated daily