luxu / fast-ecommerce-back

Ecommerce application

Fast Ecommerce

ApiRest in development

Pre-requirements Install Technologies

Pre-requirements

• PostgreSQL
• Repository clone

git clone https://github.com/jonatasoli/fast-ecommerce

cd fast-ecommerce
cd app

• Virtualenv

 pip install virtualenv

Create Virtualenv

virtualenv (namevirtualenv)

Activate virtualenv Windows

(namevirtualenv)\Scripts\activate.bat

Linux ou Mac

source (namevirtualenv)/bin/activate

Install requiriments

pip install -r requirements.txt

Install

alembic upgrade head

uvicorn main:app --reload --host 0.0.0.0 --port 8001

Tests

• Create postgres database "test"
• Enter in app directory
• Run tests

python -m pytest

Domains

• User: Handles all user management operations, such as user registration, login, and profile management.
• Direct Sales: Manages operations related to selling a product directly, bypassing any intermediary.
• Payment: Handles all payment-related operations, including processing payments through various methods such as credit cards, PIX, boleto, and installment plans.
• Freight: Responsible for managing operations related to shipping, delivery, and logistics.
• Order: Manages operations related to processing and fulfilling customer orders, including order creation, tracking, and status updates.
• Notification: Handles operations related to user notifications, including sending out notifications for order updates, promotions, and other relevant information.
• Product: Manages all aspects related to products, including product creation, editing, categorization, and attributes.
• Catalog: Handles the listing and presentation of products, providing features such as search, filtering, and sorting for users to browse and explore.
• Cart: Deals with operations related to the shopping cart, allowing users to add, remove, and modify items before proceeding to checkout.
• Inventory: Manages the control and tracking of product inventory, including stock levels, replenishment, and availability.
• Reviews: Handles customer reviews, comments, and ratings for products, allowing users to share their experiences and opinions.
• Coupons: Manages promotional campaigns, discounts, and coupon codes to attract and incentivize customers.
• Reports: Provides reporting and analytics capabilities, allowing stakeholders to gain insights into sales, customer behavior, and other relevant metrics.
• Sales: Handles integrations with sales tools and platforms, facilitating processes such as order synchronization, inventory management, and sales data analysis.
• Campaign: Manages integrations with marketing tools and platforms, enabling targeted marketing campaigns, customer segmentation, and automation.

Getting Started

• Create Roles in database |id|status|role| |1|active|ADMIN| |2|active|USER| |3|active|AFFIALIATE|

• Create user with route -> /user/signup

• Enter in database and change role_id from 2 to 1

• Create credit card config with route -> /create-config

[!info] Credit card config need tax installment fee, min and max installments

• Create product with route -> create_product suggest test product

    product = {
        'description': 'Test Product',
        'direct_sales': None,
        'installments_config': 1,
        'name': 'Test',
        'price': 10000,
        'upsell': None,
        'uri': '/test',
        'image_path': 'https://i.pinimg.com/originals/e4/34/2a/e4342a4e0e968344b75cf50cf1936c09.jpg',
        'quantity': 100,
        'discount': 100,
        'category_id': 1,
        'installments_list': [
            {'name': '1', 'value': 'R$100,00'},
            {'name': '2', 'value': 'R$50,00'},
            {'name': '3', 'value': 'R$33,00'},
            {'name': '4', 'value': 'R$25,00'},
            {'name': '5', 'value': 'R$20,00'},
        ],
    }

Technologies

• PostgreSql
• FastApi
• DynaConf