New User Journey (#388)

* Feature/user journey step 1

* [#383] Move current case page into old-cases

* [#383] Init new case page

* [#383] Load cases data in new case page

* [#383] New cases page

* [#383] Implement new case filter

* [#383] Implement new case settings modal visual

* [#383] Handle case settings behaviour with new state management

* [#383] Handle save new case settings without segments value

* [#383] Support add segments when create case settings

* [#383] Support segments payload on update case endpoint

* [#383] Handle new case setting with segments correctly

* [#383] Breakdown case settings into components

* [#383] Initial new case detail page with sidebar

* [#383] Handle load case detail in edit case page

* [#383] Set step sidebar as fixed sidebar

* [#383] Render case title and case settings form in CaseWrapper

* [#383] Refactor the export function, static, & lib to correct place

* [#383] Load current case settings value correctly

* [#385] Refine step path and load related page

* [#385] Handle close case setting modal after saved success

* [#385] Init set income target page layout

* [#385] Refine segment tabs as a wrapper to be reused in another page

* [#385] Load region options in set an income target page

* [#385] Load income target value and source when select region

* [#385] Add segment id into form name for SetIncomeTarget

* [#385] Fix yarn lint

* [#385] Finalize set income target state update

* [#385] Load initial value for SetIncomeTarget

* [#385] Add Back/Next button on parent and send the props into children

* [#385] Handle change hh adult/child value

* [#385] Handle save SetIncomeTarget

* [#383] Handle number of farmers field on segment

* Feature/389 user journey breakdown step pages into different url (#390)

* [#389] Handle EnterIncomeData page button function

* [#389] Handle case button on UnderstandIncomeGap

* [#389] Handle case button on AssessImpactMitigationStrategies

* [#389] Handle case button on ClosingGap

* [#389] Handle EnterIncomeData right element (visuals) position in SegmentTabsWrapper

* [#389] Get commodity questions

* [#389] Add Total Income section

* [#389] Fetch and regroup driver questions to follow new design layout

* [#389] Move renderPercentageTag fn into lib file

* [#389] Initial render driver questions

* [#389] Render unit name and current/feasible value field

* [#389] Handle disable input/lock when questions breakdown

* [#389] Handle onValuesChange of income drivers

* [#389] Handle total value in section, parent, and general total income

* [#389] Handle income percentage value

* [#389] Init handle save EnterIncomeData

* [#389] Handle save EnterIncomeData value properly

* Feature/391 user journey segment page lib per page (#392)

* [#391] Move enableEditCase state into general CaseUIState

* [#391] Initial layout for EnterIncomeData visual

* [#391] Add income target card on EnterIncomeData page

* [#391] Create VisualCardWrapper component

* [#391] Render household income bar chart

* [#391] Init UnderstandIncomeGap page

* [#391] Create visuals component

* [#391] Fetch questions on wrapper

* [#391] Create dashboardData state

* [#391] Render ChartIncomeGap

* [#391] Create CompareIncomeGap visualization

* [#391] Handle new user journey when prev case doesn't have any segments yet

* [#391] Debugging with test full case data for current complete new user journey

* [#391] Fix EnterIncomeData page onLoad & onValuesChange

* [#391] Refine EnterIncomeData calculation

* [#391] Handle enableEditCase state

* [#391] Fix EnterIncomeData value & dashboardData calculation

* [#391] Add answers & benchmark into segment put endpoint obj

* [#391] Create ChartExploreIncomeDriversBreakdown

* [#393] Initial AssessImpactMitigationStrategies page

* [#391] Create biggest impact on income & monetary contribution chart

* [#393] Initial binning driver form

* [#393] Set sensitivity analysis value into state

backend/alembic/versions/2025_01_14_0721-a5f7676a8a23_alter_segment_table_add_number_of_.py

@@ -0,0 +1,29 @@
+"""alter segment table add number_of_farmers column
+
+Revision ID: a5f7676a8a23
+Revises: 4bb17002ebca
+Create Date: 2025-01-14 07:21:08.343305
+
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = "a5f7676a8a23"
+down_revision: Union[str, None] = "4bb17002ebca"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "segment", sa.Column("number_of_farmers", sa.Integer(), nullable=True)
+    )
+
+
+def downgrade() -> None:
+    op.drop_column("segment", "number_of_farmers")

backend/db/crud_case.py

@@ -79,6 +79,13 @@ def add_case(session: Session, payload: CaseBase, user: User) -> CaseDict:
         for tag_id in payload.tags:
             tag = CaseTag(tag=tag_id)
             case.case_tags.append(tag)
+    # store segments
+    if payload.segments:
+        for segment in payload.segments:
+            new_segment = Segment(
+                name=segment.name, number_of_farmers=segment.number_of_farmers
+            )
+            case.case_segments.append(new_segment)
     session.add(case)
     session.commit()
     session.flush()
@@ -245,6 +252,32 @@ def update_case(session: Session, id: int, payload: CaseBase) -> CaseDict:
                     volume_measurement_unit=val.volume_measurement_unit,
                 )
                 case.case_commodities.append(case_commodity)
+    # handle update segments
+    if payload.segments:
+        for segment in payload.segments:
+            prev_segment = (
+                session.query(Segment)
+                .filter(
+                    and_(
+                        Segment.case == case.id,
+                        Segment.id == segment.id,
+                    )
+                )
+                .first()
+            )
+            if prev_segment:
+                # update prev segment
+                prev_segment.name = segment.name
+                prev_segment.number_of_farmers = segment.number_of_farmers
+                session.commit()
+                session.flush()
+                session.refresh(prev_segment)
+            else:
+                new_segment = Segment(
+                    name=segment.name,
+                    number_of_farmers=segment.number_of_farmers,
+                )
+                case.case_segments.append(new_segment)
     session.commit()
     session.flush()
     session.refresh(case)

backend/db/crud_segment.py

@@ -3,8 +3,11 @@
 from fastapi import HTTPException, status
 
 from models.segment import (
-    Segment, SegmentBase, SegmentDict, SegmentUpdateBase,
-    SegmentWithAnswersDict
+    Segment,
+    SegmentBase,
+    SegmentDict,
+    SegmentUpdateBase,
+    SegmentWithAnswersDict,
 )
 from models.segment_answer import SegmentAnswer
 
@@ -44,7 +47,7 @@ def get_segment_by_id(session: Session, id: int) -> SegmentDict:
     if not segment:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
-            detail=f"Segment {id} not found"
+            detail=f"Segment {id} not found",
         )
     return segment
 
@@ -93,8 +96,7 @@ def delete_segment(session: Session, id: int):
     segment = get_segment_by_id(session=session, id=id)
     # delete segment answers
     segment_answers = (
-        session.query(SegmentAnswer)
-        .filter(SegmentAnswer.segment == id).all()
+        session.query(SegmentAnswer).filter(SegmentAnswer.segment == id).all()
     )
     for sa in segment_answers:
         session.delete(sa)
@@ -110,6 +112,6 @@ def get_segments_by_case_id(
     if not segments:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
-            detail=f"Segments with case {case_id} not found"
+            detail=f"Segments with case {case_id} not found",
         )
     return segments

backend/models/case.py

@@ -21,7 +21,12 @@
     SimplifiedCaseCommodityDict,
     CaseCommodityType,
 )
-from models.segment import Segment, SegmentDict, SegmentWithAnswersDict
+from models.segment import (
+    Segment,
+    SegmentDict,
+    SegmentWithAnswersDict,
+    CaseSettingSegmentPayload,
+)
 from models.case_tag import CaseTag
 
 
@@ -336,6 +341,7 @@ class CaseBase(BaseModel):
     other_commodities: Optional[List[OtherCommoditysBase]] = None
     tags: Optional[List[int]] = None
     company: Optional[int] = None
+    segments: Optional[List[CaseSettingSegmentPayload]] = None
 
 
 class PaginatedCaseResponse(BaseModel):

backend/models/segment.py

@@ -16,6 +16,7 @@ class SegmentDict(TypedDict):
     target: Optional[float]
     adult: Optional[float]
     child: Optional[float]
+    number_of_farmers: Optional[int]
 
 
 class SimplifiedSegmentDict(TypedDict):
@@ -25,6 +26,7 @@ class SimplifiedSegmentDict(TypedDict):
     target: Optional[float]
     adult: Optional[float]
     child: Optional[float]
+    number_of_farmers: Optional[int]
 
 
 class SegmentWithAnswersDict(TypedDict):
@@ -35,42 +37,45 @@ class SegmentWithAnswersDict(TypedDict):
     target: Optional[float]
     adult: Optional[float]
     child: Optional[float]
+    number_of_farmers: Optional[int]
     answers: Optional[dict]
     benchmark: Optional[LivingIncomeBenchmarkDict]
 
 
 class Segment(Base):
-    __tablename__ = 'segment'
+    __tablename__ = "segment"
 
     id = Column(Integer, primary_key=True, nullable=False)
-    case = Column(Integer, ForeignKey('case.id'))
-    region = Column(Integer, ForeignKey('region.id'), nullable=True)
+    case = Column(Integer, ForeignKey("case.id"))
+    region = Column(Integer, ForeignKey("region.id"), nullable=True)
     name = Column(String, nullable=False)
     target = Column(Float, nullable=True)
     adult = Column(Float, nullable=True)
     child = Column(Float, nullable=True)
+    number_of_farmers = Column(Integer, nullable=True)
 
     case_detail = relationship(
-        'Case',
+        "Case",
         cascade="all, delete",
         passive_deletes=True,
-        back_populates='case_segments'
+        back_populates="case_segments",
     )
     segment_answers = relationship(
-        'SegmentAnswer',
+        "SegmentAnswer",
         cascade="all, delete",
         passive_deletes=True,
-        backref='segment_detail'
+        backref="segment_detail",
     )
 
     def __init__(
         self,
         name: str,
-        case: int,
+        case: Optional[int] = None,
         region: Optional[int] = None,
         target: Optional[float] = None,
         adult: Optional[float] = None,
         child: Optional[float] = None,
+        number_of_farmers: Optional[int] = None,
         id: Optional[int] = None,
     ):
         self.id = id
@@ -80,6 +85,7 @@ def __init__(
         self.target = target
         self.adult = adult
         self.child = child
+        self.number_of_farmers = number_of_farmers
 
     def __repr__(self) -> int:
         return f"<Segment {self.id}>"
@@ -94,6 +100,7 @@ def serialize(self) -> SegmentDict:
             "target": self.target,
             "adult": self.adult,
             "child": self.child,
+            "number_of_farmers": self.number_of_farmers,
         }
 
     @property
@@ -105,6 +112,7 @@ def simplify(self) -> SimplifiedSegmentDict:
             "target": self.target,
             "adult": self.adult,
             "child": self.child,
+            "number_of_farmers": self.number_of_farmers,
         }
 
     @property
@@ -126,6 +134,7 @@ def serialize_with_answers(self) -> SegmentWithAnswersDict:
             "child": self.child,
             "answers": answers,
             "benchmark": None,
+            "number_of_farmers": self.number_of_farmers,
         }
 
 
@@ -148,3 +157,9 @@ class SegmentUpdateBase(BaseModel):
     adult: Optional[float] = None
     child: Optional[float] = None
     answers: Optional[List[SegmentAnswerBase]] = []
+
+
+class CaseSettingSegmentPayload(BaseModel):
+    name: str
+    number_of_farmers: Optional[int] = None
+    id: Optional[int] = None

backend/routes/segment.py

@@ -12,7 +12,6 @@
 from db.connection import get_session
 from models.segment import (
     SegmentBase,
-    SegmentDict,
     SegmentUpdateBase,
     SegmentWithAnswersDict,
 )
@@ -24,7 +23,7 @@
 
 @segment_route.post(
     "/segment",
-    response_model=List[SegmentDict],
+    response_model=List[SegmentWithAnswersDict],
     summary="create segment",
     name="segment:create",
     tags=["Segment"],
@@ -45,12 +44,12 @@ def create_segment(
             session=session, case_id=case_id, user_id=user.id
         )
     segments = crud_segment.add_segment(session=session, payloads=payload)
-    return [s.serialize for s in segments]
+    return [s.serialize_with_answers for s in segments]
 
 
 @segment_route.put(
     "/segment",
-    response_model=List[SegmentDict],
+    response_model=List[SegmentWithAnswersDict],
     summary="update segment",
     name="segment:update",
     tags=["Segment"],
@@ -71,7 +70,7 @@ def update_segment(
         crud_case.case_updated_by(
             session=session, case_id=case_id, user_id=user.id
         )
-    return [s.serialize for s in segments]
+    return [s.serialize_with_answers for s in segments]
 
 
 @segment_route.delete(

backend/tests/test_040_segment.py

@@ -50,6 +50,9 @@ async def test_create_segment(
                 "target": 1000.0,
                 "adult": 2.0,
                 "child": 3.0,
+                "number_of_farmers": None,
+                "answers": {},
+                "benchmark": None,
             }
         ]
         # with admin user cred
@@ -102,6 +105,9 @@ async def test_create_segment(
                 "target": 2000.0,
                 "adult": 3.0,
                 "child": 2.0,
+                "number_of_farmers": None,
+                "answers": {},
+                "benchmark": None,
             },
             {
                 "id": res[1]["id"],
@@ -111,6 +117,14 @@ async def test_create_segment(
                 "target": 3000.0,
                 "adult": 4.0,
                 "child": 2.0,
+                "number_of_farmers": None,
+                "answers": {
+                    "current-1-1": 10000.0,
+                    "current-1-2": None,
+                    "feasible-1-1": None,
+                    "feasible-1-2": None,
+                },
+                "benchmark": None,
             },
         ]
 
@@ -152,6 +166,9 @@ async def test_update_segment(
                 "target": 2000.0,
                 "adult": 4.0,
                 "child": 2.0,
+                "number_of_farmers": None,
+                "answers": {},
+                "benchmark": None,
             }
         ]
         # with admin user cred
@@ -222,6 +239,9 @@ async def test_update_segment(
                 "target": 2000.0,
                 "adult": 5.0,
                 "child": 0.0,
+                "number_of_farmers": None,
+                "answers": {},
+                "benchmark": None,
             },
             {
                 "id": 2,
@@ -231,6 +251,9 @@ async def test_update_segment(
                 "target": 2000.0,
                 "adult": 6.0,
                 "child": 0.0,
+                "number_of_farmers": None,
+                "answers": {},
+                "benchmark": None,
             },
             {
                 "id": 3,
@@ -240,5 +263,15 @@ async def test_update_segment(
                 "target": 3000.0,
                 "adult": 4.0,
                 "child": 2.0,
+                "number_of_farmers": None,
+                "answers": {
+                    "current-1-1": 10000.0,
+                    "current-1-2": None,
+                    "current-1-3": None,
+                    "feasible-1-1": None,
+                    "feasible-1-2": None,
+                    "feasible-1-3": 500.0,
+                },
+                "benchmark": None,
             },
         ]