https://mediawiki.comfac.net/index.php?action=history&feed=atom&title=Webshop-11-Feature-Plan-System-Builder
Webshop-11-Feature-Plan-System-Builder - Revision history
2026-06-05T11:03:04Z
Revision history for this page on the wiki
MediaWiki 1.45.1
https://mediawiki.comfac.net/index.php?title=Webshop-11-Feature-Plan-System-Builder&diff=169&oldid=prev
Justinaquino: "Add all 14 Frappe ERPNext Webshop chapter pages from wikitext-upload"
2026-03-06T13:00:43Z
<p>"Add all 14 Frappe ERPNext Webshop chapter pages from wikitext-upload"</p>
<p><b>New page</b></p><div>= 11 - Feature Plan: System Builder =<br />
<br />
'''Parent:''' [Webshop-Index Webshop Index] <br />
'''Previous:''' [Webshop-10-Feature-Gap-Cart-Discounts 10 - Feature Gap: Cart Discounts] <br />
'''Next:''' [Webshop-12-Staging-Sandbox-Deployment 12 - Staging Sandbox Deployment] <br />
'''Source:''' [https://github.com/Comfac-Global-Group/comfac-webshop/wiki/11-Feature-Plan-System-Builder Comfac Webshop Wiki - Chapter 11]<br />
<br />
'''Status:''' 🔴 Not Implemented | '''Priority:''' High<br />
<br />
----<br />
<br />
== Vision ==<br />
<br />
A configurable product builder where customers can assemble multi-component systems (servers, desktops, maker kits, open-source hardware platforms) from a template of compatible components, with real-time pricing, compatibility enforcement, and the ability to save/load configurations.<br />
<br />
== Use Cases ==<br />
<br />
1. '''Server Builder''' - Customer selects: chassis, CPU, RAM (qty/type), storage (multiple drives), NIC, PSU, OS<br />
2. '''Desktop Builder''' - Case, motherboard, CPU, GPU, RAM, storage, PSU, peripherals<br />
3. '''Maker Kit Builder''' - Board (RPi, Arduino, etc.), sensors, actuators, enclosure, power supply<br />
4. '''Future platforms''' - Any multi-component configurable product<br />
<br />
== New DocTypes Needed ==<br />
<br />
=== System Builder Template ===<br />
<br />
- Name, description, image<br />
- Category (Server, Desktop, Maker Kit, etc.)<br />
- Child table: '''Component Slots'''<br />
- Slot name (e.g., "CPU", "RAM", "Storage Bay 1")<br />
- Required (yes/no)<br />
- Min/Max quantity<br />
- Allowed Item Group or explicit item list<br />
- Default selection (if any)<br />
<br />
=== Compatibility Rule ===<br />
<br />
- Rule name<br />
- Rule type: "Requires", "Excludes", "Max Qty", "Min Qty"<br />
- Source slot + attribute/item filter<br />
- Target slot + attribute/item filter<br />
- Error message<br />
<br />
=== Saved Configuration ===<br />
<br />
- User (Customer)<br />
- Template reference<br />
- Name (user-defined)<br />
- Child table: selected items per slot<br />
- Total price, status (draft/shared/ordered)<br />
<br />
== Integration with Existing Variant System ==<br />
<br />
Each component slot can reference:<br />
<br />
- An '''Item Group''' (e.g., "DDR5 RAM")<br />
- A '''Template Item''' (using variant attributes for selection)<br />
- Specific '''Item''' codes<br />
<br />
The existing <code>variant_selector/utils.py</code> logic for filtering valid combinations can be reused within each slot.<br />
<br />
== Compatibility Engine ==<br />
<br />
<pre><br />
For each user selection:<br />
1. Check all Compatibility Rules<br />
2. Filter available options in other slots<br />
3. Return: valid_options, warnings, errors<br />
<br />
Example rules:<br />
- CPU Socket LGA1700 REQUIRES Motherboard Socket LGA1700<br />
- RAM Type DDR5 EXCLUDES Motherboard Type DDR4<br />
- Total PSU Load <= PSU Wattage<br />
- Max 4 RAM sticks if Motherboard RAM Slots = 4<br />
<pre><br />
<br />
== Pricing ==<br />
<br />
- Each component priced individually from Price List<br />
- Bundle Pricing Rules can apply (e.g., "10% off complete system")<br />
- Show per-component price + total system price<br />
- Discounts visible per-component and total savings<br />
<br />
== Cart Integration ==<br />
<br />
When "Add System to Cart":<br />
<br />
- Create a '''Product Bundle''' or '''Packed Item''' approach<br />
- Add all components as Quotation Items, linked as a group<br />
- Or: create a single "System" line item with packed items detail<br />
<br />
== UI Flow ==<br />
<br />
<pre><br />
1. Choose Template (e.g., "1U Rack Server")<br />
2. For each slot:<br />
- Browse/filter compatible components<br />
- See price, availability, specs<br />
- Select and configure (qty, variant attributes)<br />
3. Real-time:<br />
- Compatibility checks<br />
- Running total<br />
- Power budget / capacity warnings<br />
4. Save Configuration (optional)<br />
5. Add to Cart<br />
<pre><br />
<br />
== Implementation Phases ==<br />
<br />
=== Phase 1: Foundation ===<br />
<br />
- Create System Builder Template DocType<br />
- Create Component Slot child table<br />
- Basic UI: template selection, slot browsing<br />
- Simple "add all to cart" (no compatibility engine yet)<br />
<br />
=== Phase 2: Compatibility ===<br />
<br />
- Create Compatibility Rule DocType<br />
- Build rule evaluation engine<br />
- Real-time filtering of valid options<br />
- Warning/error display<br />
<br />
=== Phase 3: Save & Share ===<br />
<br />
- Saved Configuration DocType<br />
- User dashboard for saved configs<br />
- Share via URL<br />
- Load/clone/modify<br />
<br />
=== Phase 4: Advanced ===<br />
<br />
- Power/thermal budget calculation<br />
- AI-assisted recommendations<br />
- Preset "popular configurations"<br />
- Comparison between configurations<br />
- Integration with BOM for manufacturing<br />
<br />
== Technical Challenges ==<br />
<br />
1. '''Performance''': Evaluating compatibility across many items/rules in real-time<br />
2. '''Attribute mapping''': Different items have different attributes; need a normalized way to express compatibility<br />
3. '''Cart representation''': How to group system components in a Quotation<br />
4. '''Pricing complexity''': Component discounts + bundle discounts + system-level pricing rules<br />
5. '''Stock''': All components must be available simultaneously<br />
<br />
----<br />
<br />
'''Navigation:''' [Webshop-Index Webshop Index] | [Webshop-10-Feature-Gap-Cart-Discounts Previous: 10 - Cart Discounts] | [Webshop-12-Staging-Sandbox-Deployment Next: 12 - Staging Sandbox]</div>
Justinaquino