Compensation, endowmnet tweaks. Added About.

This commit is contained in:
emfurst 2026-03-31 08:03:58 -04:00
commit 13fb4b8418
13 changed files with 914 additions and 17 deletions

View file

@ -0,0 +1,85 @@
"""Page: About — data sources, methodology, and limitations."""
from dash import html, dcc
def layout(_conn=None):
return html.Div([
dcc.Markdown("""
## About This Dashboard
This dashboard provides administrative cost benchmarking analytics for the
**University of Delaware** using exclusively **publicly available data**. No
internal university financial systems, personnel records, or confidential data
were used.
### Data Sources
All data is drawn from public, open-access sources:
| Source | Publisher | What We Use | Coverage |
|--------|-----------|-------------|----------|
| **IPEDS** | U.S. Dept. of Education, NCES | Institutional directory, expenses by function, staffing by occupation, enrollment, endowment, philanthropic gifts | 2005-2024 |
| **IRS Form 990** | Internal Revenue Service | Executive compensation (Schedule J), filing financials for UD and UD Research Foundation | Tax years 2015-2023 |
| **BLS CPI-U** | Bureau of Labor Statistics | Consumer Price Index for inflation adjustment (series CUUR0000SA0) | Full history |
| **UD Staff Directories** | University of Delaware public web pages | Administrative office headcounts (College of Engineering line management, Provost's Office) | Current snapshot |
### Methodology
**Executive Compensation** is extracted from IRS Form 990 Schedule J, which
reports detailed compensation for officers, directors, trustees, and key
employees of tax-exempt organizations. The University of Delaware (EIN
516000297) and UD Research Foundation (EIN 516017306) are the filing entities.
Titles are normalized to canonical roles (President, Provost, VP Finance, etc.)
using pattern matching. CAGR is computed as compound annual growth rate from
first to last available year.
**Administrative Cost Ratios** use IPEDS finance survey data. "Institutional
support" is the IPEDS functional expense category that most closely
corresponds to administrative overhead. The admin-to-faculty ratio uses IPEDS
occupational categories: OCCUPCAT 200 (instructional, research, and public
service staff) for faculty and OCCUPCAT 300 (management) for administration.
**Endowment Performance** uses IPEDS F2 (FASB) survey fields for beginning and
end-of-year endowment values, net investment return, and new gifts. The
endowment CAGR reflects total value growth including investment returns, new
gifts, and spending draws. The CIO compensation comparison uses the Chief
Investment Officer's Schedule J total compensation indexed against endowment
value. Note: the detailed endowment breakdown (investment return, new gifts,
other changes) is only available from IPEDS starting in the 2020 reporting
year. For 2005-2019, only beginning and end-of-year values are reported.
**Philanthropic Giving** uses IPEDS F2 total private gifts, grants, and
contracts. The compensation-vs-giving comparison indexes the President and VP
of Development compensation against total philanthropic revenue.
**Inflation Adjustment** uses the BLS CPI-U annual average (all items, U.S.
city average, not seasonally adjusted). CPI-adjusted values are expressed in
the most recent available year's dollars.
**Staffing** uses IPEDS Fall Staff survey occupational categories for full-time
employees only (FTPT=2).
### Limitations
- **IRS 990 coverage** depends on e-file availability. Not all years may have
filings for all entities, and XML schema variations across years can cause
individual fields to be missing.
- **IPEDS data** has a reporting lag; the most recent fiscal year may not yet
be available.
- **Endowment CAGR** reflects net growth after all inflows and outflows, not
pure investment return. It is not directly comparable to an investment
benchmark.
- **Title normalization** uses pattern matching and may misclassify titles that
don't follow common naming conventions.
- **Admin headcount** from web scraping is a point-in-time snapshot and is
limited to the pages currently targeted (College of Engineering and
Provost's Office).
- **Single institution** — this prototype covers the University of Delaware
only. Peer comparisons are planned for a future phase.
### License
This project is released under the MIT License. Copyright (c) 2026 Eric Furst.
"""),
], style={"maxWidth": "900px", "margin": "0 auto", "lineHeight": "1.6"})

View file

@ -10,6 +10,9 @@ from admin_analytics.dashboard.queries import (
query_top_earners,
query_comp_by_role,
query_comp_vs_cpi,
query_comp_cagr,
query_aggregate_comp,
query_aggregate_comp_cagr,
)
_NO_DATA = html.Div(
@ -21,6 +24,24 @@ _NO_DATA = html.Div(
_KEY_ROLES = ["PRESIDENT", "PROVOST", "VP_FINANCE", "VP_RESEARCH", "VP_ADVANCEMENT", "CFO"]
def _kpi_card(title: str, value: str, subtitle: str = "") -> html.Div:
return html.Div(
[
html.H4(title, style={"margin": "0", "color": "#666", "fontSize": "14px"}),
html.H2(value, style={"margin": "5px 0", "color": "#00539F"}),
html.P(subtitle, style={"margin": "0", "color": "#999", "fontSize": "12px"}),
],
style={
"flex": "1",
"padding": "20px",
"backgroundColor": "#f8f9fa",
"borderRadius": "8px",
"textAlign": "center",
"margin": "0 8px",
},
)
def layout(conn: duckdb.DuckDBPyConnection):
all_earners = query_top_earners(conn)
if all_earners.height == 0:
@ -31,6 +52,34 @@ def layout(conn: duckdb.DuckDBPyConnection):
{"label": str(y), "value": y} for y in years
]
# KPI cards
cagr = query_comp_cagr(conn)
agg_cagr = query_aggregate_comp_cagr(conn)
kpi_cards = []
if cagr:
kpi_cards.append(_kpi_card(
"President Compensation",
f"${cagr['end_comp']:,}",
f"Tax year {cagr['end_year']}",
))
kpi_cards.append(_kpi_card(
"President CAGR",
f"{cagr['cagr_pct']}%",
f"Annualized growth, {cagr['start_year']}-{cagr['end_year']}",
))
if agg_cagr:
kpi_cards.append(_kpi_card(
"Top-10 Total Compensation",
f"${agg_cagr['end_comp']:,}",
f"Tax year {agg_cagr['end_year']}",
))
kpi_cards.append(_kpi_card(
"Top-10 CAGR",
f"{agg_cagr['cagr_pct']}%",
f"Annualized growth, {agg_cagr['start_year']}-{agg_cagr['end_year']}",
))
kpi_row = html.Div(kpi_cards, style={"display": "flex", "marginBottom": "24px"}) if kpi_cards else html.Div()
# Compensation by role trend
role_df = query_comp_by_role(conn)
role_fig = go.Figure()
@ -61,18 +110,24 @@ def layout(conn: duckdb.DuckDBPyConnection):
mode="lines+markers", name="Top Compensation",
line={"color": "#00539F"},
))
cpi_fig.add_trace(go.Scatter(
x=cpi_pd["year"], y=cpi_pd["agg_index"],
mode="lines+markers", name="Top-10 Aggregate",
line={"color": "#E07A5F"},
))
cpi_fig.add_trace(go.Scatter(
x=cpi_pd["year"], y=cpi_pd["cpi_index"],
mode="lines+markers", name="CPI-U",
line={"color": "#FFD200", "dash": "dash"},
))
cpi_fig.update_layout(
title="Top Compensation vs CPI-U (Indexed, Base Year = 100)",
title="Compensation vs CPI-U (Indexed, Base Year = 100)",
xaxis_title="Year", yaxis_title="Index",
template="plotly_white", height=380,
)
return html.Div([
kpi_row,
html.Div(
[
html.Label("Filter by Tax Year: ", style={"fontWeight": "bold"}),
@ -136,8 +191,17 @@ def register_callbacks(app: dash.Dash, conn: duckdb.DuckDBPyConnection) -> None:
breakdown_fig = go.Figure()
if earners.height > 0:
ep = earners.to_pandas().head(10) # top 10 by total comp
short_names = [n.split(",")[0][:20] if "," in n else n.split()[-1][:20]
for n in ep["person_name"]]
_SUFFIXES = {"JR", "SR", "II", "III", "IV", "JR.", "SR."}
def _short_name(n):
if "," in n:
return n.split(",")[0][:20]
parts = n.split()
while len(parts) > 1 and parts[-1].upper().rstrip(".") in _SUFFIXES:
parts.pop()
return parts[-1][:20] if parts else n[:20]
short_names = [_short_name(n) for n in ep["person_name"]]
for comp_type, label, color in [
("base_compensation", "Base", "#00539F"),
("bonus_compensation", "Bonus", "#FFD200"),

View file

@ -0,0 +1,190 @@
"""Page: Endowment Performance."""
import duckdb
from dash import html, dcc
import plotly.graph_objects as go
from admin_analytics.dashboard.queries import (
query_endowment, query_endowment_per_student, query_cio_vs_endowment,
)
_NO_DATA = html.Div(
"No endowment data loaded. Run: admin-analytics ingest ipeds --component finance",
style={"textAlign": "center", "padding": "40px", "color": "#888"},
)
def _kpi_card(title: str, value: str, subtitle: str = "") -> html.Div:
return html.Div(
[
html.H4(title, style={"margin": "0", "color": "#666", "fontSize": "14px"}),
html.H2(value, style={"margin": "5px 0", "color": "#00539F"}),
html.P(subtitle, style={"margin": "0", "color": "#999", "fontSize": "12px"}),
],
style={
"flex": "1",
"padding": "20px",
"backgroundColor": "#f8f9fa",
"borderRadius": "8px",
"textAlign": "center",
"margin": "0 8px",
},
)
def layout(conn: duckdb.DuckDBPyConnection):
df = query_endowment(conn)
if df.height == 0:
return _NO_DATA
pd = df.to_pandas()
latest = pd.iloc[-1]
# Endowment CAGR from first to last year with data
valid = pd.dropna(subset=["endowment_eoy"])
if len(valid) >= 2:
first = valid.iloc[0]
last = valid.iloc[-1]
start_year = int(first["year"])
end_year = int(last["year"])
n_years = end_year - start_year
start_val = float(first["endowment_eoy"])
end_val = float(last["endowment_eoy"])
endow_cagr = round(((end_val / start_val) ** (1.0 / n_years) - 1) * 100, 1) if n_years > 0 and start_val > 0 else None
else:
start_year = end_year = None
endow_cagr = None
# Endowment per student
eps_df = query_endowment_per_student(conn)
eps_pd = eps_df.to_pandas() if eps_df.height > 0 else None
latest_eps = eps_pd.iloc[-1] if eps_pd is not None and len(eps_pd) > 0 else None
# KPI cards — single row
kpi_cards = [
_kpi_card(
"Endowment Value",
f"${latest['endowment_eoy'] / 1e9:.2f}B" if latest["endowment_eoy"] else "N/A",
f"End of FY {int(latest['year'])}",
),
_kpi_card(
"Endowment CAGR",
f"{endow_cagr}%" if endow_cagr is not None else "N/A",
f"FY {start_year}-{end_year}" if start_year else "",
),
]
if latest_eps is not None and latest_eps["endowment_per_student"]:
kpi_cards.append(_kpi_card(
"Endowment per Student",
f"${int(latest_eps['endowment_per_student']):,}",
f"FY {int(latest_eps['year'])}",
))
kpi_cards.append(_kpi_card(
"New Gifts to Endowment",
f"${latest['new_gifts'] / 1e6:.1f}M" if latest["new_gifts"] else "N/A",
f"FY {int(latest['year'])}",
))
kpi_row = html.Div(kpi_cards, style={"display": "flex", "marginBottom": "24px"})
# Endowment value trend
value_fig = go.Figure()
value_fig.add_trace(go.Scatter(
x=pd["year"], y=pd["endowment_eoy"] / 1e9,
mode="lines+markers", name="End-of-Year Value",
line={"color": "#00539F"},
fill="tozeroy", fillcolor="rgba(0,83,159,0.1)",
))
value_fig.update_layout(
title="Endowment Value Over Time",
xaxis_title="Year", yaxis_title="Billions $",
template="plotly_white", height=400,
)
# Investment return and new gifts bar chart
components_fig = go.Figure()
components_fig.add_trace(go.Bar(
x=pd["year"], y=pd["net_investment_return"] / 1e6,
name="Net Investment Return",
marker_color="#7FB069",
))
components_fig.add_trace(go.Bar(
x=pd["year"], y=pd["new_gifts"] / 1e6,
name="New Gifts to Endowment",
marker_color="#00539F",
))
if "other_changes" in pd.columns:
components_fig.add_trace(go.Bar(
x=pd["year"], y=pd["other_changes"] / 1e6,
name="Other Changes",
marker_color="#999",
))
components_fig.update_layout(
title="Endowment Changes by Component (Millions $)",
xaxis_title="Year", yaxis_title="Millions $",
barmode="group",
template="plotly_white", height=400,
)
# Investment return rate
rate_fig = go.Figure()
rates = pd.copy()
rates["return_pct"] = rates["net_investment_return"] * 100 / rates["endowment_boy"]
rate_fig.add_trace(go.Scatter(
x=rates["year"], y=rates["return_pct"],
mode="lines+markers", name="Return %",
line={"color": "#00539F"},
))
rate_fig.add_hline(y=0, line_dash="dot", line_color="#ccc")
rate_fig.update_layout(
title="Endowment Net Investment Return Rate (%)",
xaxis_title="Year", yaxis_title="%",
template="plotly_white", height=380,
)
# CIO compensation vs endowment growth
cio_df = query_cio_vs_endowment(conn)
cio_fig = go.Figure()
if cio_df.height > 1:
cio_pd = cio_df.to_pandas()
cio_fig.add_trace(go.Scatter(
x=cio_pd["tax_year"], y=cio_pd["cio_index"],
mode="lines+markers", name="CIO Compensation",
line={"color": "#E07A5F"},
))
cio_fig.add_trace(go.Scatter(
x=cio_pd["tax_year"], y=cio_pd["endowment_index"],
mode="lines+markers", name="Endowment Value",
line={"color": "#00539F"},
))
cio_fig.add_hline(y=100, line_dash="dot", line_color="#ccc")
cio_fig.update_layout(
title="Chief Investment Officer Compensation vs Endowment Growth (Indexed, Base Year = 100)",
xaxis_title="Year", yaxis_title="Index",
template="plotly_white", height=400,
)
# Endowment per student trend
eps_fig = go.Figure()
if eps_pd is not None and len(eps_pd) > 0:
eps_fig.add_trace(go.Scatter(
x=eps_pd["year"], y=eps_pd["endowment_per_student"],
mode="lines+markers", name="Endowment per Student",
line={"color": "#00539F"},
))
eps_fig.update_layout(
title="Endowment per Student ($)",
xaxis_title="Year", yaxis_title="$",
template="plotly_white", height=380,
)
charts = [
kpi_row,
dcc.Graph(figure=value_fig),
dcc.Graph(figure=eps_fig),
dcc.Graph(figure=components_fig),
dcc.Graph(figure=rate_fig),
]
if cio_df.height > 1:
charts.append(dcc.Graph(figure=cio_fig))
return html.Div(charts)

View file

@ -0,0 +1,132 @@
"""Page: Philanthropic Giving."""
import duckdb
from dash import html, dcc
import plotly.graph_objects as go
from admin_analytics.dashboard.queries import query_philanthropy, query_comp_vs_philanthropy
_NO_DATA = html.Div(
"No philanthropy data loaded. Run: admin-analytics ingest ipeds --component finance",
style={"textAlign": "center", "padding": "40px", "color": "#888"},
)
def _kpi_card(title: str, value: str, subtitle: str = "") -> html.Div:
return html.Div(
[
html.H4(title, style={"margin": "0", "color": "#666", "fontSize": "14px"}),
html.H2(value, style={"margin": "5px 0", "color": "#00539F"}),
html.P(subtitle, style={"margin": "0", "color": "#999", "fontSize": "12px"}),
],
style={
"flex": "1",
"padding": "20px",
"backgroundColor": "#f8f9fa",
"borderRadius": "8px",
"textAlign": "center",
"margin": "0 8px",
},
)
def layout(conn: duckdb.DuckDBPyConnection):
df = query_philanthropy(conn)
if df.height == 0:
return _NO_DATA
pd = df.to_pandas()
latest = pd.iloc[-1]
# KPI cards
kpi_row = html.Div(
[
_kpi_card(
"Total Private Gifts & Grants",
f"${latest['total_private_gifts'] / 1e6:.1f}M" if latest["total_private_gifts"] else "N/A",
f"FY {int(latest['year'])}",
),
_kpi_card(
"Gifts to Endowment",
f"${latest['endowment_gifts'] / 1e6:.1f}M" if latest["endowment_gifts"] else "N/A",
f"FY {int(latest['year'])}",
),
],
style={"display": "flex", "marginBottom": "24px"},
)
# Private gifts trend (nominal and CPI-adjusted)
gifts_fig = go.Figure()
gifts_fig.add_trace(go.Bar(
x=pd["year"], y=pd["total_private_gifts"] / 1e6,
name="Nominal",
marker_color="#00539F",
))
if "gifts_cpi_adjusted" in pd.columns and pd["gifts_cpi_adjusted"].notna().any():
gifts_fig.add_trace(go.Scatter(
x=pd["year"], y=pd["gifts_cpi_adjusted"] / 1e6,
mode="lines+markers", name="CPI-Adjusted",
line={"color": "#FFD200", "dash": "dash"},
))
gifts_fig.update_layout(
title="Total Private Gifts & Grants (Millions $)",
xaxis_title="Year", yaxis_title="Millions $",
template="plotly_white", height=420,
)
# Endowment gifts vs total gifts
split_fig = go.Figure()
pd["non_endowment_gifts"] = pd["total_private_gifts"] - pd["endowment_gifts"].fillna(0)
split_fig.add_trace(go.Bar(
x=pd["year"], y=pd["endowment_gifts"] / 1e6,
name="To Endowment",
marker_color="#00539F",
))
split_fig.add_trace(go.Bar(
x=pd["year"], y=pd["non_endowment_gifts"] / 1e6,
name="Current Use / Other",
marker_color="#7FB069",
))
split_fig.update_layout(
title="Gift Allocation: Endowment vs Current Use (Millions $)",
xaxis_title="Year", yaxis_title="Millions $",
barmode="stack",
template="plotly_white", height=400,
)
# Compensation vs philanthropy indexed chart
cvp_df = query_comp_vs_philanthropy(conn)
cvp_fig = go.Figure()
if cvp_df.height > 1:
cvp_pd = cvp_df.to_pandas()
cvp_fig.add_trace(go.Scatter(
x=cvp_pd["tax_year"], y=cvp_pd["president_index"],
mode="lines+markers", name="President Compensation",
line={"color": "#00539F"},
))
cvp_fig.add_trace(go.Scatter(
x=cvp_pd["tax_year"], y=cvp_pd["vp_adv_index"],
mode="lines+markers", name="VP Development Compensation",
line={"color": "#E07A5F"},
))
cvp_fig.add_trace(go.Scatter(
x=cvp_pd["tax_year"], y=cvp_pd["gifts_index"],
mode="lines+markers", name="Philanthropic Gifts",
line={"color": "#7FB069"},
))
cvp_fig.add_hline(y=100, line_dash="dot", line_color="#ccc")
cvp_fig.update_layout(
title="Compensation Growth vs Philanthropic Giving (Indexed, Base Year = 100)",
xaxis_title="Year", yaxis_title="Index",
template="plotly_white", height=420,
)
charts = [
kpi_row,
dcc.Graph(figure=gifts_fig),
dcc.Graph(figure=split_fig),
]
if cvp_df.height > 1:
charts.append(dcc.Graph(figure=cvp_fig))
return html.Div(charts)