Skip to content
View adolfojmnz's full-sized avatar
๐Ÿ”ญ
๐Ÿ”ญ

Block or report adolfojmnz

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
adolfojmnz/README.md

๐Ÿ‘จโ€๐Ÿ’ป Adolfo Jimenez | Lead Python Backend Engineer

Portfolio LinkedIn Email


About Me

I am a Lead Backend Engineer specializing in Distributed Systems, Human Capital Management (HCM) Architectures, and Industrial IoT. With a background in Electronic Engineering.

My focus is on building resilient, high-concurrency systems that solve critical business problemsโ€”from automating complex payroll logic for thousands of employees to orchestrating industrial machinery via Python.

  • Core Stack: Python, Django/DRF, AWS, Docker, PostgreSQL, Redis, Celery, Linux.
  • Key Achievement: Architected the system that enabled SMETA Audit Compliance for two consecutive years, securing international export licenses.
  • Location: Maracaibo, Venezuela (Open to Remote Roles globally).

๐Ÿš€ Project Showcase: Confremarca Enterprise ERP (HCM)

โš ๏ธ Note: This is a portfolio showcase repository for a proprietary system engineered for Grupo Confremarca. The full source code is private. This repository highlights the architectural decisions, patterns, and modules designed to solve complex Human Capital Management (HCM) challenges at scale.

Confremarca Enterprise ERP is a high-availability, distributed Human Capital Management (HCM) system engineered to serve thousands of employees across multiple industrial plants. It replaces legacy manual processes with an automated platform handling everything from biometric attendance to complex payroll calculations.

  • Role: Sole Architect & Lead Engineer
  • Stack: Python, Django, Celery, Redis, Docker, PostgreSQL, AWS
  • Status: Production (Active since Feb 2024)

๐Ÿ—๏ธ System Architecture

The system is designed as a modular monolith using Django as the core, decoupled from heavy processing tasks via Celery and Redis. It integrates with physical hardware (Biometric IoT) and legacy ERPs.

High-Level Data Flow

  1. Ingestion Layer: Biometric devices push logs to an intermediary buffer.
  2. Async Pipeline: Celery workers pick up logs, apply "thundering herd" protection (Mutex locks), and normalize data.
  3. Core Logic: Django models process standardized events into "Attendance," "Shift," or "Absence" records.
  4. Sync Layer: Validated data is pushed to the legacy ERP for accounting consistency.

โšก Key Technical Challenges & Solutions

1. The "Thundering Herd" (Data Integrity)

  • Challenge: At shift changes (e.g., 7:00 AM), thousands of employees clock in simultaneously. The legacy system would crash or create duplicate records due to race conditions during sync.
  • Solution: Implemented a Distributed Lock (Mutex) pattern using Redis.
    • A dedicated Celery task acquires a non-blocking lock redis.set(..., nx=True).
    • If a sync cycle is already running, subsequent triggers "fail fast" and wait for the next cycle.
  • Result: Zero duplicate records and 100% data integrity for compliance audits.

2. Complex Rotative Shifts (24/7 Operations)

  • Challenge: Standard libraries couldn't handle industrial shifts like "2 Days, 2 Nights, 2 Rest" with dynamic overtime calculation spanning across midnight.
  • Solution: Engineered a custom Shift Projection Engine.
    • Mathematical models project the shift pattern indefinitely into the future.
    • Used Strategy Pattern to apply different overtime rules based on shift type (Diurnal/Nocturnal/Mixed).

3. SMETA Audit Compliance

  • Challenge: International exports required a tamper-proof record of working hours and breaks.
  • Solution: Built an immutable "Audit Log" module.
    • Every modification to an attendance record creates a shadowed log entry.
    • Digital Signature workflow ensures employees legally validate their overtime hours.
  • Impact: The system was the primary evidence used to pass the SMETA audit for 2 consecutive years.

๐Ÿ› ๏ธ Tech Stack Deep Dive

Component Technology Purpose
Backend Python 3.10+ / Django 4.2 Core business logic, ORM, and REST API.
API Django REST Framework (DRF) Strict contract definition for Frontend/Mobile apps.
Async Celery + Redis Background processing, email reports, and biometric sync.
Database PostgreSQL 15 JSONB for flexible audit logs, complex relational queries.
Infra Docker Compose Parity between Dev/Prod environments.
Docs ReportLab / Pandas PDF generation for payroll receipts and Excel reporting.

๐Ÿ“ธ Key Modules

  • Attendance & Shifts: Real-time tracking of entry/exit with geolocation and biometric verification.
  • Payroll Engine: Automatic calculation of variable pay, bonuses, and statutory deductions.
  • Digital Signature: Legal workflow for document acceptance.
  • Industrial Dining: Logistics module for cafeteria management and food benefit distribution.

๐Ÿ“ซ Contact

Adolfo Jimenez | Lead Python Backend Engineer

Pinned Loading

  1. littlelemon-API littlelemon-API Public

    The LittleLemon API is the final assignment for the APIs Course part of the Meta BackEnd Developer Professional Certificate on Coursera.

    Python 17 14

  2. e-commerce-API e-commerce-API Public

    An E-commerce API build with Django, Django Rest Framework, and PostgreSQL

    Python 1 2