% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/economic_case.R
\name{gb_economic_case}
\alias{gb_economic_case}
\title{Render an appraisal as a Five Case Model economic case}
\usage{
gb_economic_case(
  appraisal,
  critical_success_factors = NULL,
  options_considered = NULL,
  non_monetised_impacts = NULL,
  recommendation = NULL,
  vfm_statement = NULL
)
}
\arguments{
\item{appraisal}{A \code{gb_appraisal} (typically from \code{gb_appraise()}
or \code{gb_compare()}).}

\item{critical_success_factors}{Character vector of CSFs.}

\item{options_considered}{Character vector of long-listed option
names.}

\item{non_monetised_impacts}{Optional data frame with columns
\code{impact}, \code{direction} (\code{"+"}/\code{"-"}), \code{materiality}
(\code{"H"}/\code{"M"}/\code{"L"}), \code{notes}.}

\item{recommendation}{Optional character: the preferred option
and rationale.}

\item{vfm_statement}{Optional character: the value-for-money
judgment.}
}
\value{
A \code{gb_economic_case} object.
}
\description{
Wraps a \code{gb_appraisal} with the structural sections HMT business
case guidance expects in the Economic Case (the second of the
five cases in the Five Case Model: Strategic, Economic,
Commercial, Financial, Management).
}
\details{
The Five Case Model is HM Treasury's standard structure for
business cases. The Economic Case is the part where Green Book
appraisal sits: monetised costs and benefits, non-monetised
impacts, switching values, sensitivity tests, value for money
judgment, recommended option. \code{gb_economic_case} wraps the
appraisal with the sections a reviewer expects to see.
}
\examples{
app <- gb_appraise(c(100, 0, 0, 0, 0), c(0, 30, 30, 30, 30))
gb_economic_case(
  app,
  critical_success_factors = c("Strategic fit", "Value for money", "Achievability"),
  options_considered = c("Do nothing", "Do minimum", "Do maximum"),
  recommendation = "Do maximum: positive NPV and BCR > 1.5"
)
}
\references{
HM Treasury (2018). Guide to Developing the Project
Business Case (Five Case Model).
}
\seealso{
\code{\link[=gb_appraise]{gb_appraise()}}, \code{\link[=gb_compare]{gb_compare()}}.

Other appraisal: 
\code{\link{gb_appraise}()},
\code{\link{gb_compare}()},
\code{\link{gb_place_based}()},
\code{\link{gb_progression}()},
\code{\link{gb_risk_register}()},
\code{\link{gb_sensitivity_ob}()},
\code{\link{gb_validate}()}
}
\concept{appraisal}
