- Fix NameError in link_media_groups_to_catalog: raw_mk/raw_pmk were used before assignment in Priority 0 comma-split block; moved fetches to top of variant loop so all priority levels share the same resolved values - Expand variant_attributes.attribute_value to String(2000) for comma-separated multi-image media keys - Expand products, device_models, device_series, media_library, migration_media_items URL/path/name columns to String(2000) - Update Pydantic VariantAttributeCreate.attribute_value max_length=2000 - Add rollback cache eviction for new series/model keys (fixes MySQL 1452) - Add comma-separated media key splitting in upsert_executor for multi-image variant image attachment - Add Priority 0 comma-separated MEDIA_LINK support in migration_worker - Update docs/12-ai session summary and current state
9.2 KiB
9.2 KiB
Current State
Current Feature
Bulk Migration Engine 2000-Character Capacity & Multi-Image Comma-Separated Media Pipeline
Current Work
-
Migration Pipeline 2000-Character Expansion & Comma-Separated Media Keys:
variant_attributes.attribute_value: Migrated fromVARCHAR(255)toVARCHAR(2000)in database, SQLAlchemy model, and Pydantic schema (Catalog.py).- Expanded column sizes to
VARCHAR(2000)acrossproducts.name,products.full_path,products.warranty_summary,product_images.image_url,variant_images.image_url,device_models.name,device_models.full_path,device_series.name,media_library.original_filename,media_library.cdn_url, andmigration_media_items.file_name. upsert_executor.py: Implemented comma-separated media key splitting: parses all comma-separated keys, stores individual keys invariant_attributes, and attaches all corresponding images in sequential order (sort_order = 0, 1, 2, ...).upsert_executor.py: Implemented savepoint rollback cache eviction: onsp.rollback(), uncommitted series and models are evicted fromseries_cacheandmodel_cache, eliminating cascade foreign key errors (MySQL 1452).migration_worker.py: Added Phase 4MEDIA_LINKsupport for comma-separated media keys, sequentially linking multi-image media groups.- Deployed and verified on both local FastAPI and remote production server (
ifixkart.service).
-
Native Swarm Intelligence Engine (
swarm/):- Multi-agent digital twin simulating 50 personas across 5 behavioral archetypes.
- 4 business simulation scenarios: Pricing Elasticity, WhatsApp Campaign Pre-Flight, Workshop Surge & SLA Delay, B2B Fleet Quote Negotiation.
- Statistical calibration against real store data (2,819 orders/catalog products) with empirical 95% CI and explicit epistemic notice disclaimers.
- Air-gapped sandbox (
SET SESSION TRANSACTION READ ONLY) preventing simulation access to live messaging/payments. - Durable atomic queue state machine with row-level locks, heartbeats, cancellation, and startup zombie-reaper.
- FastAPI REST API (
SimulationRouter.py) with RBAC and SlowAPI rate limiting. - Next.js Admin UI (
/simulation) with Recharts visualizer, Markdown synthesis, and interactive persona interview station.
-
Dynamic Footer Router APIs & Customer Feedback Pipeline:
CustomerFeedbackModel.py: MySQL tablecustomer_feedbacksfor persistent user feedback storage and ratings.storefront.py: Public endpointPOST /api/v1/storefront/feedbackand dynamic layout endpointsGET /api/v1/storefront/layout/{page}.admin_storefront.py: Feedbacks administration endpoints and bulk-save partition engine ensuring safe per-page updates.storefrontService.ts: Public API client fetching dynamic layouts and dispatching feedback submissions.- Storefront dynamic pages:
/about,/terms,/privacy,/help,/feedback,/faqs,/payments.
-
Admin CMS "Homepage Layout" Manager Multi-Page Customizer:
app/(admin)/storefront-sections/page.tsx:- 8 page layout tabs:
Homepage,Repair Services,About Us,Terms & Policy,Help Center,Feedback,FAQs,Payments. - Universal Section Title and Subtitle inputs for every section.
- Tailored visual editors for story paragraphs, offering cards, contact info, policy clauses, help topics, FAQs, and payment methods.
- Live toggle visibility, drag-and-drop reordering, and instant single-click publishing to the storefront.
- 8 page layout tabs:
-
Google Analytics 4 (GA4) Integration:
google_analytics_service.py: Google Analytics Data API client authenticated via service account (credentials/google-analytics-service-account.json).GoogleAnalyticsRouter.py: Telemetry endpoints for status, 30-day traffic metrics, realtime active visitor count, acquisition source breakdown, and top visited product pages.app/(admin)/analytics/google/page.tsx: Realtime visitor ticker with live pulsing indicator, 30-day KPIs, traffic sources table, and property status.
-
Google Merchant Center Product Feed:
google_merchant_feed.py: RSS 2.0 XML product feed generator with ISO-4217 INR pricing, high-res image CDN resolution, warehouse availability (in_stock/out_of_stock), and brand mapping.GoogleMerchantRouter.py: Public XML feed endpoint (/api/v1/storefront/feed/google-merchant.xml) and status API (/api/v1/merchant/status).app/(admin)/merchant-center/page.tsx: Status dashboard with feed URL 1-click clipboard copy, 1000-product compliance verification, and manual regeneration.
-
Razorpay Payment Gateway & Audit Ledger:
RazorpayDashboardRouter.py: Net captured volume aggregation, transaction status summary (Captured/Pending/Failed), provider breakdown, and transaction ledger.app/(admin)/razorpay-dashboard/page.tsx: Net revenue cards, search and status filter bar, and 1-click CSV export.
-
Shiprocket Logistics & Courier Operations:
ShiprocketRouter.py: Multi-carrier SLA matrix (Blue Dart, Delhivery, Ekart, DTDC), serviceability simulator, and wallet balance preview in safe disabled sandbox mode.app/(admin)/logistics/page.tsx: Pincode serviceability & rates calculator, comparative SLA breakdown, and prepaid wallet card.
-
Social Media & WhatsApp Omnichannel Platform:
meta_graph_service.py: Facebook & Instagram Graph API v22.0 integration for Pages and Business accounts.SocialMediaRouter.py: Unified omnichannel publisher supporting Instagram feed/reels/stories, Facebook page updates, and OpenWA WhatsApp status updates (send-textandsend-image) via self-hosted port:8088.app/(admin)/social-media/page.tsx: Omnichannel post composer supporting "All 3 Channels (IG + FB + WA)", "WhatsApp Status", "Instagram Only", and "Facebook Only". Includes 17 live Instagram visual filters, multi-channel status indicators (Instagram ID, Facebook ID, OpenWA WhatsApp session health), and dual interactive live mobile preview mockups (Instagram Feed Post & Dark WhatsApp Status screen).
-
Enterprise Reporting Hub:
ReportExportRouter.py: High-performance streaming export for Excel (.xlsx), CSV, and PDF formats across 5 domains:- Sales & Revenue Ledger
- Inventory & Stock Valuation
- Service & Repair Jobs
- Logistics & Deliveries
- Employee Operational Activity (Strictly operational: leads handled, deals managed, tasks resolved — NO targets/incentives).
app/(admin)/reports/page.tsx: Reporting Hub with domain selector, column schema blueprints, and 1-click download buttons.
-
30-Minute Inactivity Auto-Logout:
IdleSessionManager.tsx: Automatically monitors user activity (click,mousemove,keydown,scroll). After 28 minutes of inactivity, displays an amber/red countdown modal with 2-minute countdown timer. Supports "Stay Logged In" and "Log Out Now" with cross-tab localStorage synchronization. Automatically logs out at 30 minutes. Mounted inapp/(admin)/layout.tsx.
-
Navigation & Sidebar Updates:
Sidebar.tsx: Added Google Merchant Center, Social Media, and Google Analytics toMarketing; added Razorpay Dashboard and Shiprocket Logistics toSales and Billings; and created a dedicatedReports & Intelligencegroup.
-
Storefront Customer-Facing Intelligence & Conversion Features:
components/analytics/GoogleAnalytics.tsx&lib/analytics.ts: Injected GA4 Measurement tag asynchronously into Storefrontlayout.tsxwith automated pageview tracking and e-commerce event triggers (view_item,add_to_cart,begin_checkout,purchase).app/products/[slug]/page.tsx: Embedded Google Shopping / Merchant Center schema.orgProductJSON-LD with pricing, stock status, ratings, and canonical URLs.components/pdp/ProductInteractiveGrid.tsx: Integrated live 6-digit Pincode Delivery & SLA verification widget with instant courier delivery feedback.components/FloatingButtons.tsx: Added persistent floating WhatsApp quick support and repair inquiry button (+91 90803 23589) with animated notification beacon and hover tooltip.layout/Footer.tsx: Added WhatsApp SVG icon rendering toSocialIconand configured default social connections across Instagram, Facebook, and WhatsApp.
-
3D Isometric PillarGrid Top Selling Products Visualizer:
components/dashboard/PillarGridCanvas.tsx: Interactive HTML5 2D Canvas isometric hexagonal matrix matching 21st.dev style. Features dedicated, side-by-side unobstructed positions for Top 1 and Top 2 products, visible numeric rank indicators (1through5) directly on top caps, dramatic focus isolation on hover (+28px lift and 30% background dimming), and an instant floating black HUD tooltip showing rank, title, sales volume, and INR revenue.components/dashboard/TopSellingProductsCard.tsx: Hybrid showcase card with embedded 3D isometric pillar canvas, discrete 5-tierLESS ... MORElegend, rank badges (🥇, 🥈, 🥉), dynamic volume share bars with glow effects, and formatted INR revenue.app/(admin)/dashboard/page.tsx: IntegratedTopSellingProductsCardinto the Main Overview Dashboard replacing the static list widget.
Known Issues
- None. All backend, admin, and storefront test suites, Next.js production build (70/70 pages), and live HTTP routes pass with zero errors.