Inventory Management API

Backend API for a multi-user inventory management system.
The system allows users to manage products, categories, stock movements, purchase documents and internal sales records.

This is not an ecommerce platform. It does not process payments.
It is focused on inventory control, sales registration, stock tracking and business reporting.

Tech Stack

• Python
• Flask
• SQLAlchemy
• PostgreSQL / Supabase
• Flask-Migrate / Alembic
• JWT Authentication
• Pydantic
• Cloudinary
• Nubefact
• Swagger / OpenAPI

Main Features

• User registration and login
• JWT protected routes
• Role-based users
• Product management
• Category management
• Inventory movements
• Purchase document registration
• Sales registration
• Stock validation
• Profit and loss calculation
• Reports and dashboard metrics

Architecture

The project follows a feature-based backend architecture.

app/
├── common/
├── utils/
├── integrations/
│   ├── cloudinary/
│   └── nubefact/
├── features/
│   ├── auth/
│   ├── users/
│   ├── roles/
│   ├── products/
│   ├── categories/
│   ├── inventory/
│   ├── purchase_documents/
│   ├── sales/
│   ├── reports/
│   └── dashboard/
├── config.py
├── extensions.py
└── routes.py

# Inventory Project Backend

Backend API for a multi-user inventory management system built with Flask.

## Current Status

### Completed

- Flask project structure
- Feature-based architecture
- PostgreSQL (Supabase)
- SQLAlchemy ORM
- Alembic migrations
- JWT Authentication
- User registration
- User login
- Protected routes
- Categories CRUD
- Products CRUD
- Repository Pattern
- Service Layer
- Pydantic validation

### In Progress

- Inventory movements
- Sales module
- Purchase documents
- Reports
- Dashboard
- Cloudinary integration
- Nubefact integration
- Swagger documentation