You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ofbiz.apache.org by ho...@apache.org on 2020/07/14 19:23:08 UTC
[ofbiz-framework] 01/11: Documented: Product (catalog) migration to
asciidoc (OFBIZ-11587)
This is an automated email from the ASF dual-hosted git repository.
holivier pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/ofbiz-framework.git
commit 1c0916694839577c9fbf2781ecbd461173404570
Author: holivier <ho...@apache.org>
AuthorDate: Tue Apr 7 14:21:58 2020 +0200
Documented: Product (catalog) migration to asciidoc
(OFBIZ-11587)
product.adoc included (by include:: ) the other files by sub-component
user-manual is updated to include it in.
---
.../docs/asciidoc/_include/product-catalogs.adoc | 107 +++++++++++++++
.../docs/asciidoc/_include/product-features.adoc | 108 +++++++++++++++
.../_include/product-image-management.adoc | 149 +++++++++++++++++++++
.../src/docs/asciidoc/_include/product-promos.adoc | 60 +++++++++
.../src/docs/asciidoc/_include/product-stores.adoc | 135 +++++++++++++++++++
.../product/src/docs/asciidoc/product.adoc | 89 ++++++++++++
docs/asciidoc/user-manual.adoc | 2 +
7 files changed, 650 insertions(+)
diff --git a/applications/product/src/docs/asciidoc/_include/product-catalogs.adoc b/applications/product/src/docs/asciidoc/_include/product-catalogs.adoc
new file mode 100644
index 0000000..39bc6be
--- /dev/null
+++ b/applications/product/src/docs/asciidoc/_include/product-catalogs.adoc
@@ -0,0 +1,107 @@
+////
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+////
+= Catalogs
+
+== Catalogs overview
+A product catalog is used to group many product categories together and forms an intermediate step in the organization between
+products, categories, and stores.
+
+The product catalog can be used to define a common look and feel for all categories in this catalog and specify
+the way different categories will behave.
+
+For example, it is very useful for stores which sell products from different manufacturer or completely different product types
+ that require differing presentations to the customer.
+
+=== Sequence from a Store to the Products
+Although the process sequence through the tabs discussed below does not correspond with the tab layout within the Catalog Manager,
+the progression of the steps is intentional.
+
+. Promotions and Price Rules cannot exist without Products.
+. Products are usually so numerous that you wish to divide them into Categories and distinguish them by their Features.
+. Categories are then the major sections of your Catalogs.
+. And Catalogs must be associated with their related Stores.
+. Therefore, when setting up your business, you need to start with the Store.
+
+All of these details are handled within the Catalog Manager.
+
+== Working with Catalogs
+To follow this topic, click on the 'Catalog Detail List' in the left-hand panel under the 'Browse Catalogs' section. +
+Then click on any catalog in the table of current catalogs presented in the main screen.
+
+You will see the top-level editing screen for that catalog. +
+Along the top of the working screen are four sub-tabs: Catalog, Stores, Parties and Catalogs. +
+Each of those are discussed as a topic below.
+
+
+=== Catalog tab
+The main Catalog tab for a product catalog is mostly for establishing the look and feel.
+
+Each catalog can have its own style sheet (CSS), its own logo, and its own content repository (the content path prefix)
+and templates prefix (where its freemarker templates are located).
+
+=== The Stores tab
+The 'Stores' tab shows a list of Stores that this Catalog is currently featured in.
+
+[NOTE]
+Stores and Catalogs do not have a one-to-one relationship: the same Store can feature multiple Catalogs,
+and the same Catalog could be featured in many Stores.
+
+=== The Parties tab
+Here you identify which Party is responsible for or assigned to work with the specific Catalog selected.
+
+The Party's Role is assigned or identified and, if appropriate, a start and/or finish date for the assignment can be specified.
+
+=== Categories tab
+The 'categories' tab shows the different product categories and their roles for this catalog.
+Specifically:
+
+* Each catalog can (should) have a 'Browse Root' category, which is used as the root category for navigation. +
+ For example, the navigation menu would start at this category and show its child categories.
+* Each catalog can also have a 'Promotions' category, which is shown first to the customer when he signs in to the site.
+* There is also a 'Default Search' category. +
+ Products in this category are used for search results first.
+* 'Quick add' categories are used to specify categories where products can be added in bulk to the cart from the same screen.
+
+== Browse Categories links
+In the left-hand panel is a section labeled 'Browse Categories.' You can click on one of the -indented- categories
+to begin editing it directly, or click on the [Choose Top Category] link to view a list of links to all Parent categories.
+
+== Catalog Administration Main Page
+The catalog administration main page has several small menus for finding catalogs, categories, or products.
+
+The first three menus allow you to edit catalogs, categories, or products by their respective IDs, or create new catalogs,
+categories, or products. +
+The last one allows you to look for a product using an ID other than its product ID, such as upc or isbn number (see below.) +
+Under these menus are two more links.
+
+* Auto create keywords
+* Fast load catalog into cache.
+
+=== Auto create keywords
+Auto create keywords will create keywords for all of the products identified with the current Catalog. +
+The keywords are based on product descriptions and are used for searching for products.
+
+=== Fast load catalog
+Fast load catalog into cache will load all products and product categories into the cache; this is good for improved
+ application performance.
+
+[NOTE]
+only basic product and category information from the first Product and Category tabs is loaded,
+so additional information such as content, associations, and pricing will still have to be retrieved from the database
+and cached later by the applications.
diff --git a/applications/product/src/docs/asciidoc/_include/product-features.adoc b/applications/product/src/docs/asciidoc/_include/product-features.adoc
new file mode 100644
index 0000000..04114f3
--- /dev/null
+++ b/applications/product/src/docs/asciidoc/_include/product-features.adoc
@@ -0,0 +1,108 @@
+////
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+////
+= Product Features
+To Sell and to Differentiate Products, Features are characteristics used to sell and to differentiate products.
+
+The Apache OFBiz catalog manager allows you to define any feature set you wish for your products. +
+Typical features include size and color.
+
+In Apache OFBiz, features are associated, or applied, to products as Standard Features, Selectable Features,
+or Distinguishing Features.
+
+== Standard features
+Standard features are features which are associated with every instance of a product.
+
+An example might be the brand name of a product -- all instances of the product share the same brand name.
+
+== Selectable features
+Selectable features are features which the customer selects one from many available choices.
+
+For example, a shirt may be available in White, Blue, Green, Yellow, Pink. +
+These colors would be selectable features of the variant product shirt, and the customer would be prompted to choose a color.
+
+Each color, though, would be a standard feature of the physical product. +
+Thus, White would be a selectable feature of the virtual product 'shirt' but a standard feature of 'white shirt.'
+
+== Distinguishing features
+Distinguishing features are features which distinguish one product from another and are used to show the customer
+which item she chose.
+
+== Working with Product Features
+* Click on Features tab.
+* Defaults to Product Features
+
+== Create and Maintain Product Features
+These screens are for creating and maintaining product features, which are features or characteristics that are available
+for products.
+
+Here you will define what features can be available for products. +
+Later, when working with the products, you will have a chance to define what features a particular product may have.
+
+== Feature Categories and Feature Groups
+Notice the sub-tabs for Feature Categories and Feature Groups.
+
+These are both used to help you organize your product features.
+
+Each feature can only belong to one category but as many groups as you need.
+
+For example, you can have :
+
+* a colors category that has colors White, Blue, Grey, Green, Yellow, Pink, Red, and Orange
+* and a sizes category that has sizes XXS, XS, S, M, L, XL, XXL.
+
+Then, you can have :
+
+* one group for shirts that would have colors White, Blue, Grey and sizes S, M, L, XL, XXL,
+* and another group for dresses that have colors Yellow, Pink, Red, Orange and sizes XXS, XS, S, M, and L.
+
+== Add Features to a Category
+Once you have created a feature category, you can click on it to add features to it.
+
+There is a link [Create new feature] which takes you to a screen to create a new product feature. +
+Below this link is a list of product features already in this category.
+
+Important fields for product features are listed below.
+
+== Feature Categories
+Click on [Feature Categories] (this is the default screen when you clicked on 'Features' above),
+and you will see a menu for editing a particular feature, if you remember its feature ID. +
+(If not, you can edit it from the feature categories below.) Next, you will see a list of feature categories and
+their parent categories.
+
+The categories' ID codes are highlighted, and you can click on one to go to the feature category.
+
+At the very bottom is a menu for creating a new feature category. +
+Here, you would enter the new feature category's name and specify a parent category for it (if it has one.)
+The category ID is automatically created for you.
+
+== Working with Feature Groups
+Click on [Feature Groups] and you will see a screen showing a list of available feature groups,
+and an option to create a new feature group at the bottom.
+
+Click on the ID of the feature group, and you will be taken to a screen which shows all the features in this group
+(if there are any) and a menu to add more features to this group.
+
+Like feature categories, the IDs of feature groups are automatically created.
+
+== Implement Feature-based Product Search
+You can associate feature categories or feature groups to a Product Category. +
+Buy doing this will provide web store customer feature based product search ability.
+
+If customers choose to search within a given category and that category has features associated with it
+then they will be displayed as selectable filtering options (based on the associated product features) on the search form.
diff --git a/applications/product/src/docs/asciidoc/_include/product-image-management.adoc b/applications/product/src/docs/asciidoc/_include/product-image-management.adoc
new file mode 100644
index 0000000..1237198
--- /dev/null
+++ b/applications/product/src/docs/asciidoc/_include/product-image-management.adoc
@@ -0,0 +1,149 @@
+////
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+////
+= Image Management
+The Image Management module manages many kind of image what user want. +
+There are various functions including 'Gallery', 'Upload', 'Approved', 'Manage' etc.
+
+Go to Catalog Component > tab Image Management.
+
+
+== How To Add Security Group For Image Management User
+There are three security groups related in the Image Management including 'IMAGEADMIN', 'IMAGEAPPROVE' and ' IMAGEUPLOAD'.
+
+=== Howto add a security group
+. Go to 'Party' component.
+. Search 'UserLogin' or 'Party Id'.
+. Click 'UserLogin' or 'Party Id'.
+. At 'User Name(s)', click 'Security Groups' button.
+. At 'Add UserLogin go to Security Group',
+ * select group 'IMAGEADMIN Image Management Admin' for use all operations in the Image Management.
+ * select 'IMAGEUPLOAD Image Management Upload': To add party's permission for uploading,
+ * select 'IMAGEAPPROVE Image Management Approve': To add party's permission for approving.
+
+=== Howto Add Role For Approve Image To Party Id
+Click partyId into party's screen already present. +
+Select the submenu 'Role(s)' to add the role to party
+
+There is Add To Role screenlet, select role 'Image Approver'(on the combobox role type Id) then click 'add' button.
+
+== Gallery
+Gallery shows all images which have approved.
+
+[NOTE]
+Everybody can access Gallery function.
+
+. Click 'Gallery' button, then choose a 'Product Id' by type or click a find icon.
+. Click 'Submit' button, then you will see all images which have approved.
+. You can click 'Share' button that generates any codes to share your images to any people.
+
+== Upload
+In this function, you can upload image files into system. +
+You can upload many image files up to 10 files.
+
+[NOTE]
+You must have Image Management Upload permission for access Upload function.
+
+. Go to 'Upload' section, Enter 'Product Id' by type or click a find icon.
+. Optional, you can specify the size of images.
+. Then click 'Browse' button to choose image file(s).
+. Click 'Upload' button.
+
+== Recently Approved
+In this function, you can see the images which have been approved for 14 days recently.
+
+[NOTE]
+You must have Image Management Admin permission for access this function.
+
+. Click 'Recently Approved' Button, then you will see the lists of recently approved product which are separated by date.
+. Click on product id to see its images with details.
+
+== Approve
+In this function, you can set the status of each image including 'Approve', 'Pending' and 'Rejected'.
+
+[NOTE]
+You must have Image Management Admin permission for access this function.
+
+. Click 'Approve' Button, then specify the status of each image.
+. Choose 'Approve' status for approve image.
+. Choose 'Reject' status for reject image..
+. Choose 'Pending' status for pending image..
+. Click 'Submit' button.
+
+The images will be approved if all image administrators approved them. +
+But if only one person rejects an image then that image will be rejected.
+
+== Rejected
+The Rejected function shows the images which have rejected.
+
+[NOTE]
+You must have Image Management Admin permission for access this function.
+
+. Click 'Rejected' button, then you specify the reason of rejection each image.
+. Then click 'Submit' button.
+
+== Manage
+You can edit image such as add frame, crop image etc. +
+You can also add caption, sort order, enable image and choose thumbnail in this function.
+
+[NOTE]
+You must have Image Management Admin permission for access this function.
+
+. Click 'Manage' Button, then you can choose action including 'Frame', 'Crop' and 'Rotate' (see below for more details).
+. Enter your image caption.
+. Sort order of image by enter order number.
+. Enable image by tick enable checkbox.
+. Select image thumbnail of product.
+. Click 'Submit' button.
+
+=== Frame
+In Frame function, you can merge your image with the frame image (transparent image file e.g.
+PNG type) together.
+
+The frame image should be larger than selected image.
+
+. Choose 'Frame' then choose the image you want to merge frame.
+. Select the frame image by browsing transparent image file, such as PNG type.
+. Click 'Upload' button to upload the frame image.
+. Enter width and height of image.
+. Optional, you click 'Preview' to see example image.
+. Click 'Create' button.
+
+=== Crop
+You can crop any images in this function.
+
+. Choose 'Crop' then choose your image.
+. Move your cursor on the image, then drag your mouse to crop image.
+. You can see the preview image in the right hand side.
+. Finally, you click 'Crop' button.
+
+=== Rotate
+You can rotate images in this function.
+
+. Choose 'Rotate' then click clockwise or counterclockwise button for ratating image.
+. 'Submit' button
+
+== Replace
+In this function, you can replace the selected image with other image.
+
+The image which you want to replace must be approved first.
+
+. Click 'Replace' button, Enter 'Product Id' by type or click a find icon.
+. Then choose the image which you want to replace.
+. Choose the other image to replace with the selected image.
+. Click 'Submit' button.
diff --git a/applications/product/src/docs/asciidoc/_include/product-promos.adoc b/applications/product/src/docs/asciidoc/_include/product-promos.adoc
new file mode 100644
index 0000000..669c96a
--- /dev/null
+++ b/applications/product/src/docs/asciidoc/_include/product-promos.adoc
@@ -0,0 +1,60 @@
+////
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+////
+= Promotions
+
+== Similar to Price Rules
+Promotions are similar to Price Rules (see Price Rules, below) but are used to record special promotional offers which
+apply to the entire order, rather than prices for a particular product.
+
+For example, the promotional manager can be used to set up rules to give customers a percentage discount if they purchase
+a minimum quantity, or to create a coupon code.
+
+[NOTE]
+Promotions are tied to specific stores, whereas price rules are applicable to all products +
+(although you can specify the website, product catalog, or category for which a price rule is applicable).
+
+== Opening Screen
+The opening screen lists all promotions which are currently available and a link for creating additional promotions; +
+click on one to go to a promotion.
+
+You will also see a series of four tabs: [Promo], [Rules], [Stores] and [Codes].
+
+== Promo tab
+At the top is general information about this promotion.
+
+Each promotion has an ID, a name and a longer descriptive text, which are shown to customers.
+
+If no text is entered, Apache OFBiz will automatically generate text for you.
+
+== Rules tab
+Rules for promotions are used to determine what actions should be taken in the promotion.
+
+Each promotion can have multiple rules, and each rule can have multiple conditions and actions.
+
+If a promotion had multiple rules, they would all be checked in sequence, and the rules whose conditions were true
+will be activated.
+This is especially helpful for complicated promotions that have multiple offers.
+
+== Stores tab
+The stores tab shows a list of product stores in which this promotion is active.
+
+You can add additional stores here or delete them.
+
+== Codes tab
+The codes tab is used to associate codes for a promotion, similar to coupon codes.
\ No newline at end of file
diff --git a/applications/product/src/docs/asciidoc/_include/product-stores.adoc b/applications/product/src/docs/asciidoc/_include/product-stores.adoc
new file mode 100644
index 0000000..723fe41
--- /dev/null
+++ b/applications/product/src/docs/asciidoc/_include/product-stores.adoc
@@ -0,0 +1,135 @@
+////
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+////
+= Product Stores
+A product store has all the information needed to sell products.
+
+It is composed of a series of catalogs, which are composed of product categories and products.
+
+Each store can have its own shipping, fulfillment, notification, promotions, payment processing, and tax calculation policies.
+
+A product store can point to several different websites, allowing the same products to be sold on multiple hosted sites or domains. +
+Alternatively, multiple stores, each with their own website, can be set up to allow different pricing and fulfillment procedures
+for, say, different countries or different market segments (wholesale versus retail.)
+
+== Main Store screen
+. Go to Catalog Manager
+. Go to Catalog Manager - Stores tab +
+ Stores tab (with a store selected) brings up
+ * Roles,
+ * Promos,
+ * Catalogs,
+ * Web Sites,
+ * Sales Tax,
+ * Shipping,
+ * Payments,
+ * Emails,
+ * Surveys,
+ * and Override tabs to perform a host of other store-related functions.
+. Select existing store
+. If none, Create New Product Store
+. Complete fields
+. Click on Update
+
+
+== Why use stores?
+The 'Stores' tab in the catalog manager as used to define all the properties of a working store,
+is a group of products sold together under the same policies.
+
+Stores greatly improve the flexibility of Apache OFBiz applications.
+
+It is possible for a company to set up multiple stores, each with its warehouses, fulfillment policies, currencies, languages,
+promotions, and look-and-feel.
+
+These stores can be web-based b2b or consumer ecommerce stores or for internal order entry.
+
+They could even be in different countries with different shipping and taxation rules.
+
+== Working with Product Stores
+When you click on 'Stores,' you will see a list of product stores that have been defined. +
+Click on one and you will see several tabs for administering different aspects of that store.
+Some of those aspects are discussed below.
+
+=== Product Store
+This very complete screen provides entry for all of the myriad choices available which define the store and establish parameters.
+
+=== Roles
+Defines parties with specific roles for this store.
+
+For an employee to be able to take orders using the internal order manager application,
+he must be defined as a 'Sales Representative' here.
+
+Restrictions are enforced through the Party Manager - SecurityGroupsList which grants rights according to party roles.
+
+=== Promos
+Shows a list of active promotions for this store.
+
+=== Catalogs
+Catalogs which are available for the current store and the sequence in which they are to be shown to the user in a navigation menu.
+
+=== Web Sites
+Websites which are related to this store. +
+This is directly used to link a store to a web application.
+
+Each web application has a configuration file called web.xml, and it is defined to reference a particular web site. +
+The web site in turn is defined to relate to a product store.
+
+Thus, by setting a store on a web site, it becomes 'live' on that web application.
+
+[NOTE]
+It is possible for a web application to have more than one store associated with it,
+ as long as the application knows how to use the correct one.
+
+=== Shipping
+This page shows the shipping options available to store customers. +
+A list of shipping options and their pricing is shown.
+
+Click on View for a shipping option shows all the settings for this shipping option. +
+At this point, this tab can only view shipping options available and can not be used to define them.
+
+=== Payments
+his is used to set up payment processing for the store.
+
+The payment processing interfaces are defined as Apache OFBiz services.
+
+Each payment method will have a series of service types available to it, such as for authorizing, capturing, and refunding payment.
+
+This page links the payment types and the services together by their purpose. +
+Thus, one service would be used for credit card authorizations, another for credit card capture, and so forth
+
+=== Emails
+This defines emails which the store would send to customers.
+
+The actual email services are either mounted in the controller, such as the order confirmation email, or from scheduled services,
+such as back order notifications.
+
+This page defines where the template for the email is located on the file system, the addresses and subject of each email,
+and a content type (which can be left blank).
+
+=== Surveys
+This page is for adding surveys to the store. +
+Surveys can be associated with certain events or with products and categories.
+
+=== Override
+Allows certain keywords to be ascendant at this store for a particular time period.
+
+=== Segments
+Identifies the Sales or Market Segments targeted for this Store.
+
+The actual assignment is made under the Marketing tab > Segment sub-tab. +
+Here under the Product Store you will see a summary table of those assignments along with links to make any additions or changes.
diff --git a/applications/product/src/docs/asciidoc/product.adoc b/applications/product/src/docs/asciidoc/product.adoc
new file mode 100644
index 0000000..3828ca5
--- /dev/null
+++ b/applications/product/src/docs/asciidoc/product.adoc
@@ -0,0 +1,89 @@
+////
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+////
+= Catalog
+
+The Catalog Manager creates or provides access to a variety of information.
+Whether Products, Catalogs, or Categories, this screen offers search tools and links to get you to the type of information
+you need or are working with quickly and accurately.
+
+The Catalog Manager application is used to manage the products, all what is purchase, sale, build, used, ... by the company.
+A product can be physical or digital.
+
+With catalog application, you can manage all data associated with Product : category, catalog, price, id, ....
+
+== Overview
+TODO
+
+=== Help for Catalog Main screen
+Down the left hand column are 4 sections:
+
+1. Search Products,
+2. Browse Catalogs,
+3. Browse Categories,
+4. Product Categories.
+
+[TIP]
+You can click on the colored '_' to close a section; +
+later, click on the colored '[]' to reopen the section.
+
+
+Each of those sections are discussed below before we begin to explore the Catalog Administration Main Page.
+
+Navigation Panel The Left-hand Navigation Panel is visible even when working under the other tabs. +
+The content displayed will vary according to what choices you have made.
+
+This document is arranged to walk you through the Navigation Panel search tools (Search Products, Browse Catalogs,
+Browse Categories, and Category Products) and links first.
+
+As you come to the desired Edit or Creation window, jump in this document to the associated 'Edit' discussion.
+
+Some symbols used as shortcuts Brackets [] Application links as found on the screens are represented in this document
+with brackets around them like [this]. When you see a bracketed item, you can know we are referring to a link or
+key or 'button' which will initiate the indicated action.
+
+Greater than symbols >> The single (>) or double (>>) greater than symbols can be read as 'takes you to' or 'leads to'
+or 'results in.' These are sometimes used in this document to indicate that from this screen, if you click on the
+[Bracketed Link], you will be taken to Next Process.
+
+Within the pop-up calendars, however, the (>>) jumps you ahead one year and the (<<) jumps you back a year.
+
+An asterisk * marks those items which must be completed on a screen before the desired action can occur.
+
+
+
+== Products
+
+
+include::_include/product-catalogs.adoc[leveloffset=+1]
+
+== Categories
+
+include::_include/product-features.adoc[leveloffset=+1]
+
+include::_include/product-promos.adoc[leveloffset=+1]
+
+== Price Rules
+
+include::_include/product-stores.adoc[leveloffset=+1]
+
+== Configurations
+
+include::_include/product-image-management.adoc[leveloffset=+1]
+
+== Miscellaneous
diff --git a/docs/asciidoc/user-manual.adoc b/docs/asciidoc/user-manual.adoc
index 48386c5..273ce2c 100644
--- a/docs/asciidoc/user-manual.adoc
+++ b/docs/asciidoc/user-manual.adoc
@@ -168,3 +168,5 @@ include::../../applications/marketing/src/docs/asciidoc/sfa.adoc[leveloffset=+2]
include::../../applications/order/src/docs/asciidoc/order.adoc[leveloffset=+2]
include::../../applications/party/src/docs/asciidoc/party.adoc[leveloffset=+2]
+
+include::../../applications/product/src/docs/asciidoc/product.adoc[leveloffset=+2]