SynexFlow AI / Tattwir Hackathon

PrototypeHackathon AI planning platform / 2025

Problem

Sales, operations, logistics, and inventory planning often sit in separate tools, which slows forecasting, stock response, and coordination.

Solution

Build SynexFlow with a Next.js dashboard/landing page, Express/MongoDB IBP API, and FastAPI AI service for TimeGPT forecasting plus LangGraph planning flows.

Key Features

TimeGPT-style sales forecasting endpoint that accepts historical order totals and returns forecast horizons

LangGraph product planning workflow for product data retrieval, market context search, and integrated plan generation

LangGraph alert action workflow for ERP alert retrieval, alert classification, web context, and final action planning

Express/TypeScript API modules for auth, products, clients, regions, orders, suppliers, warehouses, inventory, alerts, actions, integrations, and forecasts

MongoDB/Mongoose data model for operational records, inventory movement, alerts, actions, forecasts, and planning entities

Next.js dashboard surfaces for sales, products, inventory, alerts, production planning, forecasting, and reporting

Second-place finish at the Tattwir hackathon hosted by Micro Club at USTHB

Architecture Map

Mermaid

flowchart LR
  Visitor["Landing page visitor"] --> Landing["Next.js landing page"]
  BusinessUser["Business user"] --> Dashboard["Next.js dashboard"]
  Landing --> Dashboard
  Dashboard --> Rest["Axios REST client"]
  Rest --> Api["Express TypeScript API"]
  Api --> Auth["JWT auth, validation, uploads"]
  Api --> Modules["IBP modules"]
  Modules --> Records["Products, orders, suppliers, warehouses, inventory, alerts, forecasts"]
  Api <--> Mongo[("MongoDB and Mongoose")]
  Api --> AiApi["FastAPI AI service"]
  AiApi --> Forecast["TimeGPT sales forecasting"]
  AiApi --> ProductGraph["LangGraph product planning workflow"]
  AiApi --> AlertGraph["LangGraph alert action workflow"]
  ProductGraph --> ProductData["Product endpoint data"]
  ProductGraph --> MarketSearch["Web search context"]
  AlertGraph --> ERPData["ERP alert data"]
  AlertGraph --> MarketSearch
  MarketSearch --> LLM["DeepSeek through OpenRouter"]
  ERPData --> LLM
  ProductData --> LLM
  LLM --> Plans["Integrated plans and action recommendations"]
  Forecast --> Insights["Forecast results"]
  Plans --> Dashboard
  Insights --> Dashboard

SynexFlow Screenshots

4 views

SynexFlow production planning dashboard with a monthly calendar and event list. — Production planning surface from the landing repo, showing the calendar workflow and shared planning sidebar.

SynexFlow sales forecasting dashboard with charts, KPI cards, product popularity, and traffic panels. — Forecasting dashboard visual: sales trend chart, KPI cards, product popularity, traffic by location, and marketing metrics.

SynexFlow alerts and predictions dashboard with alert states, triggered alerts, and alert history chart. — Alerts and predictions surface for stock shortages, shipment delays, unusual increases, and alert history.

SynexFlow external market and environmental factors dashboard with integration cards. — External factor integrations for weather, logistics, financial markets, IoT warehouses, competitor prices, and behavior analysis.