Aero Armour ERP System

Welcome to the Aero Armour ERP System repository. This project is an enterprise resource planning (ERP) solution tailored for a clothing brand, designed to streamline operations, manage orders, production, inventory, and returns with high efficiency and minimal manual intervention.

Project Overview

The Aero Armour ERP System automates operational processes by integrating with existing e-commerce infrastructure and external services like Shopify and ShipRocket. Built with a Service-Oriented Architecture (SOA) and leveraging AWS serverless technologies, the system ensures scalability, performance, and cost efficiency.

Key Objectives

• Order Management: Seamless order synchronization, status tracking, and vendor assignment.
• Production Tracking: Real-time updates on production tasks and vendor performance.
• Inventory Control: Real-time stock monitoring, automated low-stock alerts, and streamlined returns processing.
• Analytics Dashboard: Comprehensive insights into sales trends, inventory levels, and operational metrics.
• External Integration: Robust connections with systems like Shopify for order data and ShipRocket for order confirmations.

Features

From the Software Requirements Specification (SRS)

• User Roles & Access Control: Customized dashboards and interfaces for Admins, Order Management Crew, Production Crew, Inventory Management Crew, and Vendors.
• Real-Time Data Management: Automated synchronization with external APIs ensuring up-to-date information.
• Order Assignment & Tracking: Intelligent order routing and vendor assignment with automated alerts for unresponsive vendors.
• Returns Management: Efficient processing of returned items with validations and inventory updates.

From the Feature Analysis Manual (FAM)

• Analytics Dashboard: Visual insights including live stock levels, sales trends, and vendor performance metrics.
• Comprehensive Order Views: Dedicated pages for order metadata, all orders, and advanced filtering capabilities.
• Order & Production Management Sheets: Separate interfaces for order management (OMS) and product management (PMS), enabling task assignments and progress tracking.
• Configuration Management: Centralized settings for application constants, vendor details, and product attributes.
• Automated Data Sync: Integration with Shopify webhooks for continuous order updates and fallback mechanisms for data integrity.

Architecture

The system follows a Service-Oriented Architecture (SOA) comprising:

• Frontend & Delivery Layer: Developed using React, hosted on Amazon S3, and delivered via CloudFront for optimal performance.
• API & Compute Layer: AWS API Gateway paired with AWS Lambda functions manages business logic and inter-service communication.
• Database Layer: Amazon DynamoDB provides a unified, scalable, and high-performance NoSQL database solution.
• External Integrations: Real-time integrations with Shopify for order synchronization and ShipRocket for order confirmations, complemented by in-app and email notifications.

Tech Stack

• Frontend: React, HTML5, CSS
• Backend: Node.js
• Serverless Architecture: AWS Lambda, API Gateway, DynamoDB, S3, CloudFront
• Authentication: JWT-based authentication (with potential integration of Firebase or similar solutions)

API Specification

The ERP system offers a range of APIs, including:

• Authentication & Authorization: Endpoints for login, logout, and JWT token refresh.
• Analytics: Endpoints to retrieve inventory levels and generate sales/inventory reports.
• Order Management: APIs for fetching order metadata, synchronizing with Shopify, and managing order assignments.
• Product Management: Endpoints to assign production tasks and monitor manufacturing progress.
• Returns Management: APIs to update inventory following return processing.

For a detailed list of endpoints and parameters, please refer to the api_specs.pdf document.

Database Design

The system uses a single-table design on DynamoDB, managing key entities such as:

• Orders: Stores order metadata, statuses, and detailed information.
• Items: Includes production details and associated attributes for each order.
• Films: Manages design assets and related image links.
• Inventory: Tracks real-time stock levels and updates.

Global Secondary Indexes (GSIs) are implemented to optimize queries based on production status and supplier details. See the DB_Design.pdf for an in-depth overview.

Getting Started

Prerequisites

• Node.js
• AWS CLI (configured with the appropriate credentials)
• Git

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/aero-armour-erp.git
   cd aero-armour-erp

2. Install dependencies:

   npm install

3. Set up environment variables as per the .env.example file.
4. Deploy the backend services using AWS CloudFormation templates or the Serverless framework.

Running Locally

To run the application locally:

npm start