Project detailsDetalles del proyecto Enterprise AutomationAutomatización Empresarial

NEXUS Automation
Automation and reporting platform Plataforma de automatización y reportes

NEXUS runs reporting workflows with controlled access. My work covered requirements, IAM design, backend services, testing, and deployment on Google Cloud. NEXUS ejecuta flujos de reportes con acceso controlado. Mi trabajo incluyó requisitos, diseño IAM, servicios backend, pruebas y despliegue en Google Cloud.

This case shows my work on API authorization, background jobs, and audit logs. Este caso muestra mi trabajo en autorización de APIs, tareas en segundo plano y registros de auditoría.

Next.js TypeScript Python Firebase & GCP IAM Core
Project role: Agentic AI Solutions ArchitectRol en el proyecto: Agentic AI Solutions Architect

Requirements and scopeRequisitos y alcance

I turned reporting needs into user stories and clear module boundaries. Convertí las necesidades de reportes en historias de usuario y módulos definidos.

Identity and access designDiseño de identidad y acceso

I designed module permissions, admin controls, and auditable access changes. Diseñé permisos por módulo, controles de administración y cambios de acceso auditables.

Serverless servicesServicios serverless

I separated the frontend, business API, IAM service, and background worker. Separé el frontend, la API de negocio, el servicio IAM y el worker asíncrono.

Testing and deploymentPruebas y despliegue

I reviewed security controls, access tests, service authentication, and deployment readiness. Revisé controles de seguridad, pruebas de acceso, autenticación entre servicios y preparación del despliegue.

Technical focusEnfoque técnico

Access control in the backendControl de acceso en el backend

I designed a shared IAM service so admins could manage users and module permissions. Sensitive authorization checks stay in the backend. Diseñé un servicio IAM compartido para administrar usuarios y permisos por módulo. Las validaciones de autorización se realizan en el backend.

IAM
Permissions
by module
Permisos
por módulo

APIs deny access by default. Versioned policies and append only audit logs keep permission changes traceable. Las APIs deniegan el acceso por defecto. Las políticas versionadas y los registros de auditoría permiten seguir los cambios de permisos.

Design choiceDecisión de diseño

Define access rules early and keep them consistent across services. Definir las reglas de acceso desde el inicio y mantenerlas consistentes entre servicios.

How I workedCómo trabajé

1. Analysis and Coverage1. Análisis y Cubrimiento
Access requirementsRequisitos de acceso

I mapped reporting flows, user roles, permissions, and audit needs for each module. Definí los flujos de reportes, roles de usuario, permisos y necesidades de auditoría de cada módulo.

2. IAM Architecture Design2. Diseño de Arquitectura IAM
API only AuthZ Model

I defined Firestore as the IAM source of truth, moduleId/action contracts, policy_rev for cache invalidation, and append only audit logs. Definí Firestore como fuente de datos IAM, contratos moduleId/action, policy_rev para invalidar la caché y registros de auditoría sin sobrescritura.

3. Controlled Implementation3. Implementación Controlada
Separate servicesServicios separados

I guided implementation of separate services, backend authorization, job claims to prevent duplicates, and permission regression tests. Guié la implementación de servicios separados, autorización en el backend, control de tareas duplicadas y pruebas de regresión de permisos.

4. Deployment and Ops4. Despliegue y Ops
Secure RolloutSalida Segura

I reviewed fail closed behavior, OIDC authentication between services, structured denial logs, and monitoring. Revisé el cierre seguro ante errores, la autenticación OIDC entre servicios, los registros de acceso denegado y el monitoreo.

Security controlsControles de seguridad

  • Authorization Source of TruthFuente Única de Verdad de Autorización APIs resolve permissions from Firestore IAM to keep access rules consistent. Las APIs consultan los permisos en Firestore IAM para mantener reglas de acceso consistentes.
  • Policy versions and audit logsVersiones de políticas y auditoría policy_rev tracks access changes and invalidates cached permissions. Audit logs preserve the change history. policy_rev registra cambios de acceso e invalida permisos en caché. Los registros de auditoría conservan el historial.

Project artifactsDocumentos y entregables

Work stageEtapa de trabajo DeliverableEntregable
DiscoveryDescubrimiento access matrix.md / module catalog.md
Technical DesignDiseño Técnico iam architecture.md / ADRs
Secure ImplementationImplementación Segura Validated Monorepo + AuthZ TestsMonorepo Validado + Tests de AuthZ
OperationsOperaciones Audit Logs + Policy Revision + Rules

System componentsComponentes del sistema

1. Web Admin Frontend1. Frontend Administrativo Web

Next.js console for operations and administration. Navigation adapts to effective permissions by module. Consola Next.js para operación y administración. La navegación se adapta a permisos efectivos por módulo.

2. Shared IAM API2. API IAM compartida

Effective permissions, user grants, policy revisioning, and super admin audit control. Permisos de usuarios, versiones de políticas y control auditado para el administrador principal.

3. Business API + Worker3. API de Negocio + Worker

Python on Cloud Functions/Cloud Run plus Cloud Tasks for domain pipelines and job lifecycle execution. Python sobre Cloud Functions/Cloud Run más Cloud Tasks para pipelines de dominio y ejecución del ciclo de vida de jobs.

4. Firestore Control Plane4. Plano de Control en Firestore

Jobs, runs, IAM data, traceability, and audit evidence under a controlled data model. Jobs, runs, datos IAM, trazabilidad y evidencia de auditoría bajo un modelo de datos controlado.

Automation with Governed AccessAutomatización con Acceso Gobernado

The platform runs reporting workflows for areas such as finance and after sales. Admins control who can view and run each module. La plataforma ejecuta reportes para áreas como finanzas y posventa. Los administradores controlan quién puede ver y ejecutar cada módulo.

  • Ingest transform generate pipeline with full job/run traceability.Pipeline ingesta transformación generación con trazabilidad completa de job/run.
  • Administrative IAM panel to manage users, grants, and audit without exposing sensitive collections to the browser.Panel IAM para gestionar usuarios, permisos y auditoría sin exponer datos sensibles al navegador.
  • User experience shaped by effective permissions and module access.Experiencia de usuario moldeada por permisos efectivos y acceso por módulo.

Business ImpactImpacto en el Negocio

New reporting modules can reuse the same access controls and job tracking. Los nuevos módulos de reportes pueden reutilizar los controles de acceso y el seguimiento de tareas.

IAM and pipeline contractsContratos IAM y de procesamiento

Module IDs, actions, permission levels, and policy versions define a shared contract for the frontend, APIs, and workers. Los identificadores de módulo, acciones, permisos y versiones de política definen un contrato compartido para el frontend, las APIs y los workers.

  • Source of Truth:Fuente de Verdad: Firestore IAM as the single authorization source.Firestore IAM como fuente única de autorización.
  • Contract Stability:Estabilidad de Contrato: moduleId/action/policy_rev enables safe evolution and cache invalidation.moduleId/action/policy_rev habilita evolución segura e invalidación de caché.

Architecture PrinciplesPrincipios de Arquitectura

DecouplingDesacoplamiento
Frontend, business API, IAM, and worker remain separated by contract and responsibility.Frontend, API de negocio, IAM y worker se mantienen separados por contrato y responsabilidad.
AsynchronyAsincronía
API + queue + worker pattern decouples user experience from heavy processing.El patrón API + cola + worker desacopla la experiencia de usuario del procesamiento pesado.

Security by DesignSeguridad por Diseño

The backend checks permissions, denies access by default, and authenticates calls between services. El backend valida permisos, deniega el acceso por defecto y autentica las llamadas entre servicios.

  • Deny by DefaultDeny by Default
  • API only AuthZAuthZ API only
  • Fail ClosedFail Closed
  • OIDC WorkerWorker con OIDC

Adding new modulesAgregar nuevos módulos

New modules use a versioned catalog and shared IAM. policy_rev invalidates cached permissions when access rules change. Los nuevos módulos usan un catálogo versionado e IAM compartido. policy_rev invalida los permisos en caché cuando cambian las reglas de acceso.

My contributionMi contribución

Secure APIs and background processing APIs seguras y procesamiento en segundo plano

I worked on requirements, service design, access rules, and release checks for an automation platform. Trabajé en requisitos, diseño de servicios, reglas de acceso y validaciones de despliegue para una plataforma de automatización.

Practical access controlsControles de acceso prácticos

I designed permissions and audit logs as part of the application. Diseñé permisos y registros de auditoría como parte de la aplicación.

Clear service boundariesServicios con responsabilidades claras

I kept frontend, APIs, and workers focused on separate responsibilities. Definí responsabilidades separadas para el frontend, las APIs y los workers.

Testing and release checksPruebas y validación de despliegues

I reviewed access tests, service security, deployment, and operational checks. Revisé pruebas de acceso, seguridad entre servicios, despliegue y validaciones operativas.

Cloud operationsOperación en la nube

I included logs, monitoring, and safe failure handling. Incluí registros, monitoreo y manejo seguro de errores.

This project combines serverless automation with shared IAM and traceable background jobs. Este proyecto combina automatización serverless, IAM compartido y tareas asíncronas con trazabilidad.

View project infographicVer infografía del proyecto

See the visual project summary.Ver el resumen visual del proyecto.

Back to portfolioVolver al portafolio

See all projects and my profile.Ver todos los proyectos y mi perfil.

Back to homeVolver al inicio

CertificationsCertificaciones

AI Project Management
Python Programming Certificate
Python for Cybersecurity
OKR Master Professional
Scrum Master Professional
Management 3.0 Foundation

Looking for a software engineer?¿Buscas un ingeniero de software?

I'm interested in software and AI engineering roles. Let's talk about how I can contribute to your development team.Busco oportunidades en desarrollo de software e IA. Conversemos sobre cómo puedo aportar a tu equipo.