Tinventory

Modern Warehouse Management, Fulfillment, and Delivery — Simplified.

Tinventory is a comprehensive Warehouse Management & Fulfillment Platform designed for B2C operations. It manages multi-warehouse inventory, fulfills customer orders from manual entry or e-marketplaces, and handles delivery via in-house drivers or external couriers.

---

🚀 Vision & Key Features

Inspired by ShipHero and Lalamove, Tinventory provides a seamless bridge between warehouse operations and the final customer delivery.

• 📦 Multi-Warehouse Management: Detailed layout mapping (Zones, Aisles, Racks, Bins).
• 🔄 Fulfillment Lifecycle: Streamlined pick (FEFO/FIFO), pack, and ship workflows.
• 🚚 Dual Delivery Model:
  • In-house: Real-time GPS tracking and Proof of Delivery (Photo + Signature).
  • External: Integration with J&T Express and other couriers.
• 🔌 E-commerce Ready: Native integration with Shopify, Lazada, and WooCommerce.
• 📱 Mobile-First: Dedicated Flutter apps for warehouse staff, pickers, and drivers.
• 📊 Real-time Analytics: Live stock visibility and SLA tracking dashboards.

---

🛠 Tech Stack

Tinventory is built on a modern, scalable foundation using Clean Architecture and CQRS.

Backend API

• Language: C# on .NET 8.0
• Architecture: Clean Architecture + CQRS (MediatR)
• Database: PostgreSQL 16 + PostGIS (Geospatial)
• Caching: Redis (Session & Rate Limiting)
• Real-time: SignalR (Live notifications & tracking)
• Security: JWT Auth + ASP.NET Identity + Google OAuth

Web Dashboard (Fulfillment & Ops)

• Framework: React 19 + TypeScript + Vite
• UI System: Ant Design (Enterprise-grade)
• State: TanStack Query (Server) + Zustand (Client)
• Charts: Recharts

Mobile Application (Staff & Drivers)

• Framework: Flutter 3.x
• State Management: flutter_bloc (BLoC pattern)
• Local DB: Drift (SQLite) for offline barcode lookups
• Features: Google Maps, Background Geolocation, MLKit Scanning

---

📂 Project Structure

nmht2603/
├── client/          # React Web Application (Vite + AntD)
├── server/          # .NET Core API (Clean Architecture)
│   ├── Tinventory.API/          # Entry point & Controllers
│   ├── Tinventory.Application/  # MediatR Handlers & Business Logic
│   ├── Tinventory.Domain/       # Entities & Domain Events
│   └── Tinventory.Infrastructure/ # EF Core & External Services
├── mobile/          # Flutter Cross-Platform App
├── docs/            # Technical & Project Documentation
└── docker-compose.yml # Orchestration for local development

---

🏁 Getting Started

Prerequisites

• .NET 8 SDK
• Node.js 20+
• Flutter SDK
• Docker Desktop

Quick Start with Docker

The easiest way to spin up the infrastructure (DB, Redis, API):

# Clone the repository
git clone <repo-url>
cd nmht2603

# Start the ecosystem
docker-compose up -d

Manual Development Setup

1. Backend

cd server/Tinventory.API
dotnet run

2. Frontend

cd client
npm install
npm run dev

3. Mobile

cd mobile
flutter pub get
flutter run

---

📜 Documentation

Detailed planning and architectural documents can be found in the /docs directory:

• Architecture Overview
• API Design
• Database Schema (ERD)
• Engineering Guidelines

---

🤝 Contributing

1. Create a Work Item (Feature/Bug).
2. Create a feature branch (feat/your-feature).
3. Follow the Engineering Guidelines.
4. Submit a Pull Request.

---

⚖️ License

Distributed under the MIT License. See LICENSE for more information.