How ziehna/clothcraftv3 works
ClothCraft is a garment storefront and operations system built around an Odoo module, with a browser frontend and a Python API service. Customers browse products, customize designs, maintain a cart, and place or track orders; staff manage stock, suppliers, and orders. Administrators also use DSS forecasting and an assistant. Odoo owns business records and validates cart operations; the DSS engine derives forecasts, restock recommendations, alerts, and health results. The graph combines documented capabilities with sampled imports and calls; some unsampled subsystem links are omitted rather than inferred.
Main entry points: Checkout.tsx Shop and checkout · main.py API application · jev_forecast_routes.py DSS routes · bundle.py Analysis bundle
Components 22
Customer storefront
- Shop and checkout
frontend/src/pages/Checkout.tsx - Design editor
frontend/src/editor/EditorStage.tsx - API client
frontend/src/api/client.ts
API service
- API application
backend/app/main.py - Cart routes
backend/app/cart_routes.py - Odoo facade
backend/app/odoo.py - Assistant routes
backend/app/chat_routes.py - DSS routes
backend/app/jev_forecast_routes.py
Odoo commerce
- Commerce models
addons/clothcraft/models/sale_order.py - Design pricing
addons/clothcraft/design_fee.py - Staff operations
addons/clothcraft/models/stock_move.py
Decision support
- DSS Odoo API
addons/clothcraft_dss/models/api_dss.py - DSS run storage
addons/clothcraft_dss/models/dss_run.py - Analysis bundle
addons/clothcraft_dss/engine/bundle.py - Canonical transforms
addons/clothcraft_dss/engine/transform.py - Demand forecasting
addons/clothcraft_dss/engine/forecast.py - AI forecast integration
addons/clothcraft_dss_ai/models/api_dss_ai.py
Administration
- Admin workspace
frontend/src/admin/AdminApp.tsx - Admin assistant UI
frontend/src/admin/assistant/useAssistant.ts - DSS workspace
frontend/src/admin/dss/ForecastPage.tsx
Other components
- Customer
- JEV service
Connections 21
- Customer → Shop and checkout: browses and buys
README.md - Shop and checkout → Design editor: customizes garments
README.md - Shop and checkout → API client: requests shop data
frontend/src/api/client.ts - API client → API application: calls API
frontend/src/api/client.ts - API application → Cart routes: mounts routes
backend/app/main.py - Cart routes → Odoo facade: calls cart methods
backend/app/cart_routes.py - Odoo facade → Commerce models: invokes Odoo API
backend/app/odoo.py - Design pricing → Commerce models: prices order design
README.md - Staff operations → Commerce models: records commerce operations
README.md - Admin workspace → Admin assistant UI: hosts assistant
- Admin assistant UI → Assistant routes: sends chat requests
frontend/src/admin/assistant/useAssistant.ts - API application → Assistant routes: mounts routes
backend/app/main.py - Admin workspace → DSS workspace: opens analytics
- DSS workspace → DSS routes: requests forecasts
- DSS routes → DSS Odoo API: reads DSS data
backend/app/jev_forecast_routes.py - DSS Odoo API → DSS run storage: uses run records
addons/clothcraft_dss/models/api_dss.py - DSS run storage → Analysis bundle: builds run bundle
addons/clothcraft_dss/models/dss_run.py - Analysis bundle → Canonical transforms: canonicalizes data
addons/clothcraft_dss/engine/bundle.py - Analysis bundle → Demand forecasting: computes forecast
addons/clothcraft_dss/engine/bundle.py - DSS routes → AI forecast integration: obtains AI forecast
- AI forecast integration → JEV service: requests analysis