mirror of
https://github.com/R0m1k3/LogiFlow.git
synced 2026-10-11 17:27:31 +02:00
michaelschal
c24e19da52
Update the user deletion process to prioritize transferring ownership to the `admin_local` user, falling back to any available admin if `admin_local` is not found. Replit-Commit-Author: Agent Replit-Commit-Session-Id: a8a78c07-e900-425c-a577-5b4c5894379d Replit-Commit-Checkpoint-Type: full_checkpoint Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/1957c339-2757-4d1f-8e92-e9f71a1ce58e/a8a78c07-e900-425c-a577-5b4c5894379d/vetH0Gp
4.9 KiB
4.9 KiB
LogiFlow - Replit Development Guide
Overview
LogiFlow is a comprehensive logistics management platform for La Foir'Fouille retail stores. It centralizes order, delivery, customer order, inventory, and user administration across multiple store locations. Its business vision is to streamline logistics operations, enhance inventory accuracy, and improve overall operational efficiency for retail chains.
User Preferences
Preferred communication style: Simple, everyday language.
System Architecture
Frontend
- Framework: React 18 with TypeScript
- Build Tool: Vite
- UI Framework: Shadcn/ui (built on Radix UI)
- Styling: Tailwind CSS with custom CSS variables
- State Management: TanStack Query (React Query)
- Routing: Wouter
- Forms: React Hook Form with Zod validation
- UI/UX Decisions: Focus on a clean, intuitive interface using Shadcn/ui components for consistency and accessibility. Color schemes are managed via Tailwind CSS custom variables for easy theming.
Backend
- Framework: Express.js with TypeScript
- Runtime: Node.js with ES modules
- Database ORM: Drizzle ORM
- Authentication: Dual system (local for production, Replit Auth for development)
- Session Management: Express sessions with PostgreSQL storage
- Security: Comprehensive middleware (rate limiting, input sanitization, security headers)
Database
- Primary Database: PostgreSQL with Drizzle ORM
- Development: Neon serverless PostgreSQL
- Production: Standard PostgreSQL in Docker containers
- Schema: Centralized definition in
shared/schema.ts - Migrations: Drizzle Kit
Core Business Entities
- Orders: Purchase orders, supplier relationships, delivery tracking.
- Deliveries: Delivery tracking and status.
- Customer Orders: Point-of-sale management with barcode generation.
- Suppliers: Vendor management and order history.
- Publicities: Marketing campaign management and store participation.
- DLC Products: Management of products with limited shelf life, including status tracking and alerts.
- Tasks: Streamlined task management with simplified assignment and completion tracking.
Data Flow
- Request Flow: Client requests via React Query, processed by Express middleware for authentication/security, then by route handlers using Drizzle ORM for database operations.
- Authentication Flow: Replit Auth for dev, secure username/password for production with PostgreSQL-backed sessions and role-based authorization.
- Data Synchronization: Real-time updates via React Query with optimistic updates and intelligent cache invalidation. Global store context filters data.
Key Features
- Authentication System: Secure dual authentication system with robust password hashing and session management.
- Multi-Store Management: Global store context, role-based access control (admin, manager, employee, directeur), and data isolation.
- Universal Pagination: Reusable client-side pagination component applied across all main tabular data pages (Orders, Deliveries, Customer Orders, DlcPage, BLReconciliation, Tasks) with configurable limits per module.
- Reconciliation Module: For balancing and tracking financial discrepancies.
- Permission System: Granular permission management with 54 permissions across 12 categories, assigned to 4 roles.
External Dependencies
Frontend Dependencies
- UI Components: Radix UI
- Form Management: React Hook Form, Zod
- Date Handling: date-fns
- Query Management: TanStack Query
- Barcode Generation: JsBarcode
Backend Dependencies
- Database: PostgreSQL (pg driver), Drizzle ORM
- Authentication: Passport.js (local strategy), connect-pg-simple
- Security: express-rate-limit, helmet equivalent
- Validation: Zod
Development Dependencies
- Build Tools: Vite (React plugin, TypeScript support)
- Code Quality: ESLint, TypeScript compiler
- Development Server: Vite dev server
Other Integrations
- NocoDB Integration: Configurable for invoice verification and data synchronization.
Recent Changes
August 11, 2025 - User Deletion Fix
- Issue: Foreign key constraint errors when deleting users who created customer orders or other records
- Root Cause: User records were referenced by multiple tables (customer_orders, deliveries, DLC products, etc.)
- Solution Implemented:
- Enhanced deleteUser method with database transaction for atomicity
- Prioritized lookup for
admin_local(default admin) with fallback to any admin user - Ownership transfer of all user-created records to existing admin before deletion
- Comprehensive handling of all foreign key relationships
- Graceful error handling when no admin user exists
- Tables Handled: customer_orders, orders, deliveries, publicities, dlcProducts, tasks, nocodbConfig, userGroups, userRoles
- Result: Safe user deletion while preserving business data integrity