Justinaquino: "Consolidate webshop pages under Frappe ERPNext/Webshop index on Main_Page"

2026-03-06T12:58:51Z

"Consolidate webshop pages under Frappe ERPNext/Webshop index on Main_Page"

← Older revision		Revision as of 12:58, 6 March 2026
Line 135:		Line 135:
	=== No Backend Changes Needed ===		=== No Backend Changes Needed ===
	For discount visibility: read existing fields, enrich decorator, update templates, style with CSS. ERPNext does all calculations.		For discount visibility: read existing fields, enrich decorator, update templates, style with CSS. ERPNext does all calculations.

			----

			== Setup & Operations Guides ==

			* [[ERPNext Webshop Setup Guide]] — Installation, bulk item management, categories, and storefront configuration
			* [[ERPNext Webshop Setup and Publishing Process]] — Step-by-step publishing process for webshop items

	----		----

Justinaquino: Created Webshop index page with documentation overview

2026-03-06T12:42:33Z

Created Webshop index page with documentation overview

New page

= Comfac Webshop =

'''Open Source E-commerce Platform with Enhanced Discount Visibility & System Builder'''

----

== Overview ==

The Comfac Webshop is an open-source e-commerce platform built on the Frappe Framework and integrated with ERPNext. It enables businesses to create online stores with product catalogs, shopping carts, and order management.

This documentation covers the complete architecture, codebase, and planned enhancements for the Comfac Webshop fork.

{| class="wikitable"
|+ Key Information
|-
! Attribute !! Value
|-
| '''Base Project''' || [https://github.com/frappe/webshop Frappe Webshop]
|-
| '''Framework''' || Frappe Framework (Python 3.10+, MariaDB/PostgreSQL)
|-
| '''Dependencies''' || frappe, erpnext, payments
|-
| '''Module''' || Webshop (single module)
|-
| '''Build System''' || Flit
|-
| '''Codebase Size''' || ~172 files, ~988KB
|}

----

== Documentation Chapters ==

=== Core Architecture & Codebase ===

Understanding how the webshop works:

{| class="wikitable"
|-
! Chapter !! Title !! Description
|-
| [[Webshop-01-Architecture-Overview|01]] || '''Architecture Overview''' || Framework stack, app integration, data flow
|-
| [[Webshop-02-DocTypes|02]] || '''DocTypes''' || Custom DocTypes and ERPNext DocTypes
|-
| [[Webshop-03-Shopping-Cart-Quotation-Deep-Dive|03]] || '''Shopping Cart & Quotation Deep Dive''' || Cart-quotation relationship, hidden fields
|-
| [[Webshop-04-Product-Pages-and-Browsing|04]] || '''Product Pages & Browsing''' || /all-products, /shop-by-category
|-
| [[Webshop-05-Variant-Selector|05]] || '''Variant Selector''' || Item variants, configurator, Redis caching
|-
| [[Webshop-06-Pricing-and-Discounts|06]] || '''Pricing & Discounts''' || Price lists, pricing rules, coupon codes
|-
| [[Webshop-07-Checkout-and-Orders|07]] || '''Checkout & Orders''' || Place order flow, payment, tracking
|-
| [[Webshop-08-Templates-and-Frontend|08]] || '''Templates & Frontend''' || Jinja templates, JS, SCSS
|-
| [[Webshop-09-Hooks-and-Events|09]] || '''Hooks & Events''' || App hooks, doc_events, CRUD handlers
|}

=== Feature Requirements & Plans ===

{| class="wikitable"
|-
! Chapter !! Title !! Description !! Status
|-
| [[Webshop-10-Feature-Gap-Cart-Discounts|10]] || '''Feature Gap: Cart Discounts''' || Missing discount visibility || 🔴 Not Implemented
|-
| [[Webshop-11-Feature-Plan-System-Builder|11]] || '''Feature Plan: System Builder''' || Multi-component configurator || 🔴 Not Implemented
|}

=== Development & Deployment ===

{| class="wikitable"
|-
! Chapter !! Title !! Description
|-
| [[Webshop-12-Staging-Sandbox-Deployment|12]] || '''Staging Sandbox''' || Testing environment, Phase 0/1/2 approach
|-
| [[Webshop-13-Discount-Visibility-and-Urgency|13]] || '''Discount Visibility & Urgency''' || UI specs, urgency indicators
|-
| [[Webshop-14-Hypothesis-Discount-Deadline-Visibility|14]] || '''Implementation Hypothesis''' || Exact plan with code
|}

----

== Missing Features for Comfac ==

=== 🔴 Feature 1: Cart Discount Visibility ===

'''Status:''' Not Implemented | '''Priority:''' High | '''Effort:''' Medium

'''Problem:''' Discounts are calculated on the Quotation but hidden from customers. They only see final prices without understanding savings or offer deadlines.

'''What's Missing:'''
* Original price display with strikethrough
* Discount percentage badges
* "You save" amounts
* Offer deadline display
* Urgency indicators

'''Key Insight:''' All data already exists on the Quotation document. ERPNext populates these fields. This is purely a '''frontend/template display issue'''.

'''See:''' [[Webshop-10-Feature-Gap-Cart-Discounts|Chapter 10]] | [[Webshop-13-Discount-Visibility-and-Urgency|Chapter 13]] | [[Webshop-14-Hypothesis-Discount-Deadline-Visibility|Chapter 14]]

=== 🔴 Feature 2: System Builder ===

'''Status:''' Not Implemented | '''Priority:''' High | '''Effort:''' Large

'''Problem:''' No way to configure multi-component systems with compatibility checking and bundle pricing.

'''New DocTypes Required:'''
* System Builder Template
* Component Slot
* Compatibility Rule
* Saved Configuration

'''See:''' [[Webshop-11-Feature-Plan-System-Builder|Chapter 11]]

----

== Quick Technical Reference ==

=== The Cart IS a Quotation ===
The shopping cart is literally an ERPNext '''Quotation''' document with `order_type="Shopping Cart"`. All pricing features work automatically - we just need to display the fields.

=== Key Hidden Fields ===
Every Quotation Item already has:
* `price_list_rate` - Original price
* `rate` - Final price
* `discount_percentage` - Discount %
* `pricing_rules` - JSON of applied Pricing Rules

=== No Backend Changes Needed ===
For discount visibility: read existing fields, enrich decorator, update templates, style with CSS. ERPNext does all calculations.

----

== Resources ==

* [https://github.com/Comfac-Global-Group/comfac-webshop GitHub Repository]
* [https://github.com/frappe/webshop Base Project: Frappe Webshop]
* [https://docs.erpnext.com/docs/user/manual/en/set_up_e_commerce ERPNext E-commerce Docs]

----

'''Last Updated:''' March 2026
'''Section:''' Frappe ERPNext > Webshop

Frappe ERPNext/Webshop - Revision history

Justinaquino: "Consolidate webshop pages under Frappe ERPNext/Webshop index on Main_Page"

Justinaquino: Created Webshop index page with documentation overview