WMS: 11850 Construction Engineering Megalab Update

dev-ai-app-dev-constructioneng-aiexperience/build/build.md

@@ -46,7 +46,9 @@ This lab assumes you have:
 
 ## Task 3: View created tables in Jupyter Lab
 
-1. Navigate back to your terminal window.
+1. Stay in JupyterLab. The file browser remains available while the
+    Launcher is open, so you do not need to return to the Terminal or
+    close the Launcher tab.
 
     ![Open Terminal](./images/terminal.png " ")
 
@@ -61,9 +63,14 @@ This lab assumes you have:
 
     ![Tables](./images/tables.png " ")
 
+3. After reviewing the setup script, close the
+    `db_setup_CONSTENG_script_2.sql` tab. You will continue the rest of
+    the lab from the Launcher and your notebook, so the script tab is
+    no longer needed.
+
 ## Task 4: Connect to Database
 
-1. Click the **+** sign on the top left to open the Launcher.
+1. Return to the existing Launcher tab.
 
     ![Open Launcher](./images/open-launcher.png " ")
 
@@ -138,7 +145,7 @@ In this task, you will:
   project details, sourcing requirements, risk level, recommended
   supplier, supplier fit score, and evaluation status.
 
-1. Copy and paste the code below into the new notebook.
+1. Copy and paste the code below into a new cell in your notebook.
 
     ```python
     <copy>
@@ -629,7 +636,7 @@ This step:
   `CE_PROJECT_CHUNKS` table so the chunks can be searched by semantic
   similarity in the next task.
 
-1. Run and review the code in a new cell:
+1. Copy the following code into a new cell.
 
     ```python
     <copy>
@@ -705,7 +712,9 @@ This step:
   use only supplier names that appear in the provided records or
   context.
 
-1. Copy the code block below to implement RAG:
+1. The following code block will perform
+    Retrieval-Augmented Generation (RAG). Copy this code block into a
+    new cell.
 
     ```python
     <copy>
@@ -850,7 +859,10 @@ Tasks:
 2. Click the **Run** button to execute the cell. The notebook will
     process the question using AI Vector Search, retrieve the most
     relevant chunks from the `CE_PROJECT_CHUNKS` table, and send the
-    retrieved context to OCI Generative AI.
+    retrieved context to OCI Generative AI. OCI Generative AI then
+    uses the retrieved project and supplier evidence to generate a
+    grounded response that summarizes the best-fit supplier and the
+    reasoning behind that recommendation.
 
     ![ask question](./images/task7.png " ")
 
@@ -898,4 +910,4 @@ Congratulations, you completed the lab.
 
 ## Acknowledgements
 * **Authors** - Francis Regalado
-* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniet Hart, July 2026
+* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniel Hart, July 2026

dev-ai-app-dev-constructioneng-aiexperience/introduction/introduction.md

@@ -55,10 +55,23 @@ This workshop assumes you have:
 * Basic knowledge of Python. 
 * Basic knowledge of Oracle Database, including how to run queries.
 
+### Architecture
+
+Below is a visual representation of the lab workflow. As a **Construction Procurement Officer**, you will review supplier submissions for construction engineering projects. **Oracle AI Database** converts your question or the project details you are reviewing into a **vector embedding**, then uses **semantic search** to find relevant information based on meaning rather than exact keyword matches. The most relevant document excerpts are provided to the AI along with your question. Using this evidence, the AI delivers a **grounded recommendation** to approve, deny, or request more information, with a clear rationale.
+
+![Diagram](./images/architecture.png =50%x*)
+
+The application utilizes key features of Oracle AI Database:
+
+* **Converged Database:** keeps transactional, analytical, AI, and operational data together.
+* **AI Vector Search:** enables semantic “meaning-based” search across documents and project data.
+* **JSON Duality Views / JSON Transform:** makes document-style JSON data easier to use alongside relational tables.
+* **Property Graph:** models relationships—for example, which supplier supports which project, requirement, risk, or evaluation.
+
 ## Learn More
 
 * [Oracle AI Database Documentation](https://docs.oracle.com/en/database/oracle/oracle-database/23/)
 
 ## Acknowledgements
 * **Authors** - Uma Kumar
-* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniet Hart, July 2026
+* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniel Hart, July 2026

dev-ai-app-dev-constructioneng-aiexperience/user-story/user-story.md

@@ -46,6 +46,8 @@ In this first example, you will review and approve a low-risk project. The first
 2. The **Downtown Mixed-Use Tower** project page opens with a project snapshot showing key procurement details, including project ID, project name, location, project phase, required trade, procurement urgency, budget range, and risk level.
     Below the snapshot, review the **Project Analysis Powered by AI** section. For this project, the overall risk score is low, and the analysis summarizes the project requirements, sourcing needs, and documentation signals used to support an approval recommendation.
 
+     >💡 **Note**: AI analysis may take a few seconds to complete. Please wait for the output to appear.
+
     ![P1001 AI generated recommendations](./images/p1001-ai.png =50%x*)
 
 3. At the bottom of the **Downtown Mixed-Use Tower** evaluation, you will find the **AI Procurement Guru**, a chatbot powered by **Oracle AI Database AI Vector Search and OCI Generative AI**.
@@ -94,15 +96,19 @@ In this first example, you will review and approve a low-risk project. The first
 
     ![P1001 PDF](./images/p1001-openpdf.png =50%x*)
 
-10. Open the downloaded PDF to review the **Final Decision Notice**. This document summarizes the approved decision for **Downtown Mixed-Use Tower**, including the selected supplier, risk score, approval rationale, and next steps.
+10. You may get a notification that the file being downloaded is insecure. Click **Keep** to download the file.
+
+     ![Keep PDF](./images/keeppdf.png =50%x*)
+
+11. Open the downloaded PDF to review the **Final Decision Notice**. This document summarizes the approved decision for **Downtown Mixed-Use Tower**, including the selected supplier, risk score, approval rationale, and next steps.
 
     ![P1001 PDF](./images/p1001-pdfv2.png =50%x*)
 
-11. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**.
+12. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**.
 
     ![Return to Dashboard](./images/p1001-dashboard.png =50%x*)
 
-12. Expand **View Approved Projects**. Confirm that project `1001`, **Downtown Mixed-Use Tower**, no longer appears in the **Pending Projects** list and now appears in the **Approved Projects** list with the status **Approved**.
+13. Expand **View Approved Projects**. Confirm that project `1001`, **Downtown Mixed-Use Tower**, no longer appears in the **Pending Projects** list and now appears in the **Approved Projects** list with the status **Approved**.
 
     ![Approved List](./images/p1001-final-approved.png =50%x*)
 
@@ -119,7 +125,7 @@ Once you select and save one of the AI-recommended supplier options:
 
 Congratulations, you have just approved your first project. Proceed to the next task.
 
-## Task 3: Demo - Project with High risk level
+## Task 3: Demo - Project with High Risk Level
 In this example, you will review a high-risk project and deny it as part of the exercise. The second project on your list is project `1003`, **Harbor Seismic Retrofit**.
 
 1. On the **Supplier Evaluation Dashboard**, go to the **Pending Projects** list. In the row for project `1003`, **Harbor Seismic Retrofit**, click **Review** to open the project details.
@@ -129,6 +135,8 @@ In this example, you will review a high-risk project and deny it as part of the
 2. The **Harbor Seismic Retrofit** project profile opens with a project snapshot showing key procurement details, including project ID, location, project phase, required trade, procurement urgency, budget range, risk level, and evaluation status.
     Below the snapshot, review the **Project Analysis Powered by AI** section. For this scenario, the project has an overall risk score of **9/10**, marked as **High Risk**. The AI analysis evaluates the project requirements and supplier evidence, then recommends a denial or new RFP if core requirements are not met. It also provides guidance on the risk factors that would need to be addressed before the project could move forward.
 
+     >💡 **Note**: AI analysis may take a few seconds to complete. Please wait for the output to appear.
+
     ![Harbor Seismic Retrofit AI generated recommendations](./images/p1003-profile.png =50%x*)
 
 3. Click **Navigate to Project Decisions**. Before reviewing the decision page, consider the AI analysis shown above: why is the system recommending denial or a new RFP for **Harbor Seismic Retrofit**?
@@ -163,15 +171,19 @@ In this example, you will review a high-risk project and deny it as part of the
 
     ![P1003 Download Recommendation](./images/p1003-download2.png =50%x*)
 
-8. Open the downloaded PDF and review the **Final Decision Notice** for **Harbor Seismic Retrofit**. The document summarizes the denied decision and provides next steps, such as submitting a new RFP for qualified seismic steel suppliers that meet the project’s compliance requirements.
+8. You may get a notification that the file being downloaded is insecure. Click **Keep** to download the file.
+
+     ![Keep PDF](./images/keeppdf2.png =50%x*)
+
+9. Open the downloaded PDF and review the **Final Decision Notice** for **Harbor Seismic Retrofit**. The document summarizes the denied decision and provides next steps, such as submitting a new RFP for qualified seismic steel suppliers that meet the project’s compliance requirements.
 
     ![Open P1003 PDF](./images/p1003-pdf.png =50%x*)
 
-9. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**.
+10. Click **Return to Dashboard** to go back to the **Supplier Evaluation Dashboard**.
 
     ![Return to Dashboard](./images/p1003-dashboard.png =50%x*)
 
-10. Expand **View Denied Projects**. Confirm that project `1003`, **Harbor Seismic Retrofit**, no longer appears in the **Pending Projects** list and now appears in the **Denied Projects** section with the status **Denied**.
+11. Expand **View Denied Projects**. Confirm that project `1003`, **Harbor Seismic Retrofit**, no longer appears in the **Pending Projects** list and now appears in the **Denied Projects** section with the status **Denied**.
 
     ![Denied List](./images/p1003-denied.png =50%x*)
 
@@ -212,6 +224,9 @@ This demonstrates how the app can apply updates to the project profile while kee
 
     ![Project Profile Updated](./images/p1004-uploadedpdf2.png)
 
+5. Click **Return to Dashboard** to return to the home page of the application.
+
+    ![return to dashboard](./images/homepage.png =50%x*)
 
 **Conclusion**:
 
@@ -254,4 +269,4 @@ By combining these Oracle AI Database capabilities, the application helps stream
 ## Acknowledgements
 * **Authors** - Linda Foinding, Francis Regalado
 * **Contributors** - Eddie Ambler, Ramona Magadan, Mark Nelson, Andy Tael, Anders Swanson, Rahul Tasker
-* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniet Hart, July 2026
+* **Last Updated By/Date** - Taylor Zheng, Uma Kumar, Deion Locklear, Daniel Hart, July 2026