# Week 1 Implementation Guide & Verification Manual

This document is your complete step-by-step guide on how to manually verify and test all the Week 1 features directly within the Odoo user interface.

---

## 0. Initial Settings Configuration (For a Fresh Database)
If you are deploying this on a brand-new database, you **must manually turn on** these advanced Odoo features before verifying the rest of the steps.

**Turn on Inventory Features:**
1. Open the **Inventory app**.
2. Go to **Configuration > Settings**.
3. Scroll to the **Products** section and turn ON **Units of Measure**.
4. Scroll to the **Traceability** section and turn ON **Lots & Serial Numbers**.
5. Once "Lots" is on, check the new box for **Expiration Dates** that appears right below it.
6. Click the purple **Save** button at the top left.

---

## 1. How to Check: Multi-Company Architecture
**Goal**: Verify that all 4 companies and their isolated warehouses exist.

**Instructions**:
1. Login to `Clickstocart` as your user.
2. Look at the top-right corner of the top navigation bar. Click on the **Company Switcher** (the building icon next to your profile picture).
3. **Verify:** You should see checkboxes for `C2C Agricorp India Pvt Ltd`, `C2C Imports & Exports`, `Clickstocart Inc CA`, and `Clickstocart Inc US`.
4. Click on the **Settings app** > **Users & Companies** > **Companies**. 
5. **Verify:** All 4 companies are listed here with their respective details.
6. Still in Settings, navigate to **Users & Companies** > **Groups**. 
7. **Verify:** Search for "Manufacturing Manager", "Warehouse Staff", etc. You will see these roles exist for assigning to future employees.
8. Open the **Inventory app** > **Configuration** > **Warehouses**. 
9. **Verify:** You should see one distinct warehouse per company (e.g., `C2C - C2C Agricorp`, `C2C - Clickstocart`).

---

## 2. How to Check: Master Data Fields (Products & Partners)
**Goal**: Verify custom fields and categorized data templates.

**Instructions (Partners/Contacts)**:
1. Open the **Contacts app**.
2. Click **New** to create a test contact.
3. In the form, look closely below the tags/categories area or in the main tabs. 
4. **Verify:** You will see a new dropdown field called **C2C Partner Category**. Click it to ensure options like `Farmer`, `Wholesaler`, `Retail Customer` exist.

**Instructions (Products)**:
1. Open the **Inventory app** > **Products** > **Products**.
2. Click **New**.
3. Under the **General Information** page, click the **Product Category** dropdown.
4. **Verify:** You will see categories explicitly created for us: `Raw Materials`, `Semi-finished Goods`, and `Finished Goods`.
5. Still on the product form, look at the bottom of the main fields.
6. **Verify:** There is a new dropdown called **Quality Grade** containing `Grade A`, `Grade B`, `Grade C`.
7. Go to the **Inventory tab** on the product form.
8. **Verify:** Under **Traceability**, ensure the **By Lots** option is available. Check the **Expiration Date** box to see the `Shelf Life` fields appear.

---

## 3. How to Check: UoM Engine
**Goal**: Test the new complex conversion engine and the new standard units.

**Instructions**:
1. Open the **Inventory app**.
2. Navigate to **Configuration** > **Units of Measure** (Check 'UoM Categories' if 'Units of Measure' isn't directly visible).
3. **Verify:** Search for `500g`, `100g`, or `Bundle (3m)`. They are fully registered in the standard weight/length systems.
4. Navigate to **Configuration** > **Conversion Rules** (Under the new "UoM Engine" section).
5. **Verify:** This is the new custom dashboard. Click **New**. You can now define a rule that says "For Category X, converting from Y to Z uses Ratio R".

---

## 4. How to Check: Batch/Expiry & QC Workflow
**Goal**: Verify that Odoo enforces FEFO (First Expired First Out) and has a location to hold quality checks.

**Instructions (QC Locations)**:
1. In the **Inventory app**, turn on Developer Mode if you can't see the Locations menu.
2. Go to **Configuration** > **Locations**.
3. **Verify:** Remove the "Internal" filter in the search bar and search for `QC Hold`. You will see it exists as an Internal Location.
4. **Verify:** Search for `Rejected/Scrap`. It exists and has the flag "Is a Scrap Location" checked.

**Instructions (FEFO Strategy)**:
1. Go to **Inventory app** > **Configuration** > **Product Categories**.
2. Open the `Raw Materials` category.
3. **Verify:** Scroll down to the Logistics section. The **Force Removal Strategy** is set to `First Expired, First Out (FEFO)`.

---

## 5. End-to-End Test: The Farmer Procurement Flow
To see everything working together, perform this exact sequence:

1. **Prep**: Create a Product named "Test Turmeric", set tracking to "By Lots", and check "Expiration Date" (give it 100 days shelf life).
2. **Purchase**: Open the **Purchase app**. Select a vendor/Farmer. Add "Test Turmeric" and click **Confirm Order**.
3. **Receipt**: Click the **Receive Products** button in the top right of the Purchase Order.
4. **Create Lot**: On the receipt line for Turmeric, you cannot validate yet. Click the **List icon (Options/Details)** on the right side of the product line. 
5. Under "Assign Serial/Lot Number", type in `LOT-001` and set an Expiration Date for tomorrow. Apply and **Validate** the receipt.
6. **QC Transfer**: Open the **Inventory app** > **Operations** > **Transfers**. Create a new internal transfer.
7. Set the Source Location as `WH/Stock` (where the goods just arrived) and the Destination Location to `QC Hold`.
8. Add the Product, select `LOT-001`, and **Validate**.

### **Congratulations!** You have just executed a full cycle of Procurement -> Quality Control with multi-stage Lot tracking and Expiry enforcement.