Nature Think

1. Executive Summary

Nature Think is a full-stack e-commerce platform dedicated to natural products. Built with a modern React frontend and a robust Node.js/Express backend, it features a custom file-based database (EveloDB) for data persistence. The platform supports user authentication, product management, order processing, and a comprehensive admin dashboard.

2. Technical Architecture

3. Database Schema (EveloDB)

The system uses a collection-based JSON storage engine. Key collections include:

4. API Specification

Authentication & User

Commerce & Operations

Admin Routes (Protected)

5. SEO Systems

Purpose: Improve organic discoverability and rich result coverage for product pages while keeping crawlability and performance high.

6. Core Business Logic

• Revenue Calculation: updateRevenue() aggregates data from 'delivered' orders to track income and package weights.
• Stock Sync: updateSellCount(orderId) automatically decrements inventory and increments 'sellCount' upon order placement.
• Rating System: calculateRating(itemId) dynamically computes average scores from the comments collection.
• Cascading Deletion: deleteUser(userId) ensures data integrity by removing associated comments, orders, cart items, and favourites.
• Proof of Delivery (POD): proofOfDelivery(req) handles courier-authenticated QR scans. It decodes qrData to an order ID, verifies the order exists and is not already delivered, sets state to 'delivered' and records deliveredAt (ISO timestamp). The endpoint is protected by authCourier middleware and returns informative error responses for missing/invalid QR data, non-existent orders, idempotent deliveries, or DB update failures.
• Security:
  • Password hashing using bcrypt (Salt rounds: 10).
  • OTP / Reset flow: OTPs are stored server-side (e.g. emailVerifyCodes) with an expireAt timestamp (typical expiry: 10 minutes). Invalid OTP submissions increment an attempts counter and the server enforces a max attempts limit (default: 5).
  • On successful OTP validation the new password is hashed (bcrypt, salt rounds: 10) and updated via db.edit('users', ...); detailed error responses are returned for missing/expired/invalid OTPs or DB failures.
  • /api/change-password is protected by authenticateUser and delegates to userFunctions.changePassword which verifies the old password, hashes the new password, and persists the update.
  • Login history tracking (Last 10 IP addresses).
• Backup & Restore: handleBackupAndRestore allows admins to generate a full system backup (database + files) as a ZIP archive and restore from it. The system handles file buffering, validation, and secure cleanup of temporary files.

7. Project Structure

nature-think/
├── backend/
│   ├── index.js              # Start Application
│   ├── apiServer.js          # Express Application Entry Point
│   ├── package.json          # Backend Dependencies
│   ├── database/             # Database Schema & Models
│   └── middleware/
│       ├── auth.js           # Authentication Middleware
│       ├── utills.js         # Core Database & Business Logic
│       ├── backup.js         # Backup & Restore logic
│       ├── sendEmail.js      # Email Service (Nodemailer)
│       ├── tools.js          # Utility Functions (Token, Formatting)
│       ├── evelodb-config.js # Database Configuration
│       ├── dataManager.js    # Data Management Utilities
│       ├── updateSiteMap.js  # Generate Sitemap
│       └── resendMail.js     # Email Resending Logic
└── frontend/
    ├── vite.config.ts        # Vite Configuration
    ├── tailwind.config.js    # Tailwind Configuration
    ├── project_plan.html     # This Document
    └── src/
        ├── main.tsx          # React Entry Point
        ├── App.tsx           # Main App Component
        ├── admin/            # Admin Dashboard
        │   ├── AdminHome.tsx
        │   ├── AdminActions.tsx
        │   └── components/
        │       ├── ManageUsers.tsx
        │       ├── ManageOrders.tsx
        │       ├── PackageLabel.tsx
        │       ├── Stock.tsx
        │       ├── CreateItem.tsx
        │       ├── EditItem.tsx
        │       ├── DeliveryService.tsx
        │       └── ManageUpdates.tsx
        └── routes/           # User Facing Routes
            ├── Home.tsx
            ├── Store.tsx
            ├── Item.tsx
            ├── Cart.tsx
            ├── Orders.tsx
            ├── Favourites.tsx
            ├── ChangePassword.tsx
            ├── ResetPassword.tsx
            ├── Login.tsx
            ├── Signup.tsx
            ├── Settings.tsx
            ├── About.tsx
            ├── Help.tsx
            ├── Updates.tsx
            ├── PrivacyPolicy.tsx
            ├── TermsConditions.tsx
            ├── WarrantyInfo.tsx
            ├── ShippingPolicy.tsx
            ├── Footer.tsx
            └── components/   # Shared Components
                ├── NavBar.tsx
                ├── ItemComponent.tsx
                ├── Loading.tsx
                ├── Rain.tsx
                ├── types.ts      # TypeScript Interfaces
                ├── utils.ts      # Frontend Utilities
                ├── sendReq.ts    # API Request Helper
                ├── categories.ts # Category Definitions
                ├── cart/         # Cart Specific Components
                │   ├── CartItem.tsx
                │   └── PlaceOrderSection.tsx
                ├── home/         # Home Page Components
                │   ├── Hero.tsx
                │   ├── Overview.tsx
                │   └── TopItems.tsx
                └── settings/     # Settings Page Components
                    ├── Account.tsx
                    └── Suggestions.tsx