StockNest-2B
Gestion del inventario de un pequeño almacen, aplicacion web self-hosted
Trabajo
Tareas humanas y de agentes, conectadas con issues y milestones.
Contratos - Definir integración OpenAPI completa con 5 rutas CRUD + movimientos
Generar contrato OpenAPI v3.0 con endpoints /products, /stock_movements y validación de esquemas para evitar discrepancias Gate CONTRACTS.
@kibotBackend - Integrar SessionManager centralizado con todos los endpoints existentes
Implementar Dependency Injection para SessionManager en todos los endpoints CRUD y movimientos de stock. Resolver race conditions con SELECT FOR UPDATE.
@kibotDatabase - Configurar PostgreSQL y migraciones Alembic sincronizadas con modelos ORM
Inicializar base de datos PostgreSQL, crear alembic.ini y generar primera migración inicial que cree tablas products, stock_movements y sessions.
@kibotFrontend - Estructura básica React + Dashboard de gestión de inventario
Crear estructura base del frontend con React, configurar rutas para dashboard de productos, movimientos de stock y consultas de existencias. Preparar integración con backend API.
@kibotDevOps - Configuración Dockerfile y docker-compose.yml para despliegue self-hosted
Generar Dockerfile optimizado para aplicación Python + PostgreSQL, crear docker-compose.yml con servicios backend, database y frontend. Incluir variables de entorno desde .env.example.
@kibotBackend - Implementación inicial FastAPI con SQLAlchemy ORM y SessionManager centralizado
Crear estructura base del backend con FastAPI, configurar SQLAlchemy ORM, implementar SessionManager para gestión unificada de sesiones, y establecer contratos de integración OpenAPI. Asignar a especialista backend.
@kibotDatabase - Configuración PostgreSQL y migraciones iniciales
Configurar base de datos PostgreSQL con variables de entorno, crear modelos ORM para Productos y Movimientos de Stock, generar migración Alembic inicial sincronizada con esquemas.
@kibotDevOps - Configuración Dockerfile y docker-compose
Generar Dockerfile optimizado para la aplicación FastAPI, crear docker-compose.yml con servicios para backend, base de datos PostgreSQL y configuración de red para despliegue self-hosted.
@kibotManejo de Errores y Validación Global
Implementar ExceptionHandler personalizado para no exponer errores internos, validaciones globales con Pydantic, logging estructurado, y documentación API con OpenAPI/Swagger.
@kibotFrontend - Estructura básica React + Dashboard
Crear estructura inicial de frontend con React/Vite, componentes básicos para listado de productos, formulario de movimientos, y dashboard de stock disponible.
@kibotGenerate Alembic Migration for Initial Schema
Add migration script to create tables from models.
@kibotDiseño e Implementación del Dashboard Frontend
Crear la interfaz principal que muestre el resumen del inventario (stock bajo, productos más vendidos) y sirva como punto de acceso a las funcionalidades CRUD.
@kibotContrato de Integración - Definición de Endpoints
Documentar contrato de integración con OpenAPI/Swagger, definir endpoints CRUD para productos y movimientos de stock, especificaciones de validación y manejo de errores.
@kibotCreate FastAPI Application with Dependency Injection
Initialize FastAPI app, inject DB session via dependency.
@kibotImplement ORM Models for Products and StockMovements
Define SQLAlchemy models with relationships between Product and StockMovement.
@kibotBackend - Implementación FastAPI con ORM SQLAlchemy y Alembic
Crear estructura backend completa: database.py (engine/SessionLocal/Base), dependencies.py (get_db generator), models.py (Product, StockMovement con constraints), schemas.py (Pydantic), routers/products.py (CRUD completo
@kibotDesarrollo de Endpoints CRUD para Productos
Crear los endpoints RESTful necesarios para registrar, consultar y actualizar la información maestra de los productos. Debe incluir validaciones de negocio (ej: SKU único).
@kibotDespliegue - Configuración Dockerfile y docker-compose
Generar Dockerfile optimizado para backend FastAPI, docker-compose.yml con servicios backend/frontend/database, configuración de volumes para persistencia de datos y scripts de inicialización.
@kibotImplementación del Módulo de Movimientos de Stock (Transacciones)
Desarrollar el endpoint crítico que registra entradas y salidas. Este módulo debe actualizar el stock disponible en tiempo real y mantener un historial auditable de cada movimiento.
@kibotConfiguración inicial del proyecto (README, estructura de carpetas, requirements.txt)
Crear README.md con documentación del proyecto, estructura de directorios para backend/frontend, y archivo requirements.txt con dependencias esenciales (FastAPI, SQLAlchemy, Pydantic, uvicorn).
@kibotConfiguración de la Base de Datos y Esquema ORM
Diseñar e implementar el esquema completo de la base de datos (Productos, Transacciones, Categorías). Debe incluir la lógica para asegurar que el stock disponible se calcule correctamente a partir de las transacciones.
@kibotConfiguración de despliegue self-hosted
Crear Dockerfile y docker-compose.yml para despliegue completo del stack (backend FastAPI + frontend React), incluyendo configuración de base de datos PostgreSQL, variables de entorno, y scripts de migración Alembic.
@kibot