Update public MapToSelf dashboard

README.md

@@ -1,19 +1,41 @@
----
-title: MapToSelf Dashboard
-emoji: 🚀
-colorFrom: red
-colorTo: red
-sdk: docker
-app_port: 8501
-tags:
-- streamlit
-pinned: false
-short_description: Streamlit template space
----
-
-# Welcome to Streamlit!
-
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
-
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+# MapToSelf Public Stats
+
+Public portfolio dashboard for MapToSelf.
+
+This dashboard is designed for recruiters, employers and collaborators. It shows
+only aggregated product statistics and does not expose private operational data.
+
+## Privacy
+
+The dashboard does not include:
+
+- Telegram user IDs
+- names
+- birth dates or birth places
+- prompts
+- AI answers
+- report text
+- message text
+- API keys
+- costs
+- provider or model internals
+
+It reads only `public_stats.json`, which is generated from safe aggregate SQL
+queries.
+
+## Run Locally
+
+```bash
+pip install -r requirements.txt
+streamlit run app.py
+```
+
+## Hugging Face Space
+
+Create a Streamlit Space and upload:
+
+- `app.py`
+- `requirements.txt`
+- `public_stats.json`
+
+The Space does not need access to the production database.

app.py

@@ -0,0 +1,166 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import pandas as pd
+import plotly.express as px
+import streamlit as st
+
+
+DATA_PATH = Path(__file__).with_name("public_stats.json")
+
+
+st.set_page_config(
+    page_title="MapToSelf Public Stats",
+    page_icon="MapToSelf",
+    layout="wide",
+)
+
+st.markdown(
+    """
+    <style>
+    .block-container { padding-top: 2rem; max-width: 1180px; }
+    [data-testid="stMetricValue"] { font-size: 1.75rem; }
+    .hero {
+        padding: 1.4rem 0 0.8rem 0;
+        border-bottom: 1px solid rgba(128,128,128,.2);
+        margin-bottom: 1.2rem;
+    }
+    .muted { color: #6b7280; font-size: .92rem; }
+    .pill {
+        display: inline-block;
+        padding: .24rem .58rem;
+        margin: .12rem .18rem .12rem 0;
+        border: 1px solid rgba(128,128,128,.25);
+        border-radius: 999px;
+        font-size: .86rem;
+    }
+    </style>
+    """,
+    unsafe_allow_html=True,
+)
+
+
+def load_data() -> dict:
+    if not DATA_PATH.exists():
+        st.error("public_stats.json is missing. Run export_public_stats.py first.")
+        st.stop()
+    return json.loads(DATA_PATH.read_text(encoding="utf-8"))
+
+
+def df(items: list[dict]) -> pd.DataFrame:
+    return pd.DataFrame(items or [])
+
+
+def metric_number(value: int | float | None) -> str:
+    return f"{int(value or 0):,}".replace(",", " ")
+
+
+def line_chart(data: pd.DataFrame, x: str, y: str, title: str):
+    if data.empty:
+        st.info("No data yet.")
+        return
+    fig = px.line(data, x=x, y=y, markers=True, title=title)
+    fig.update_layout(height=330, margin=dict(l=10, r=10, t=55, b=10))
+    st.plotly_chart(fig, use_container_width=True)
+
+
+def bar_chart(data: pd.DataFrame, x: str, y: str, title: str, color: str | None = None):
+    if data.empty:
+        st.info("No data yet.")
+        return
+    fig = px.bar(data, x=x, y=y, color=color, title=title)
+    fig.update_layout(height=360, margin=dict(l=10, r=10, t=55, b=10))
+    st.plotly_chart(fig, use_container_width=True)
+
+
+data = load_data()
+project = data["project"]
+metrics = data["metrics"]
+series = data["series"]
+
+st.markdown(
+    f"""
+    <div class="hero">
+      <h1>{project["name"]}</h1>
+      <p class="muted">{project["description"]}</p>
+      <p class="muted">Public portfolio dashboard. Aggregated statistics only.</p>
+    </div>
+    """,
+    unsafe_allow_html=True,
+)
+
+st.caption(f"Last updated: {data['generated_at']}")
+st.caption(data["public_note"])
+
+cols = st.columns(5)
+cols[0].metric("Users", metric_number(metrics["users_total"]))
+cols[1].metric("New users, 30d", metric_number(metrics["new_30d"]))
+cols[2].metric("Reports generated", metric_number(metrics["reports_total"]))
+cols[3].metric("GPT interactions", metric_number(metrics["gpt_calls"]))
+cols[4].metric("Child charts", metric_number(metrics["child_charts"]))
+
+cols = st.columns(4)
+cols[0].metric("New users, 7d", metric_number(metrics["new_7d"]))
+cols[1].metric("Profiles completed", metric_number(metrics["profiles_complete"]))
+cols[2].metric("Natal charts", metric_number(metrics["with_chart"]))
+cols[3].metric("Reports, 7d", metric_number(metrics["reports_7d"]))
+
+st.divider()
+
+left, right = st.columns(2)
+with left:
+    line_chart(df(series["users_by_day"]), "day", "users", "User growth over the last 30 days")
+with right:
+    bar_chart(df(series["users_by_language"]), "language", "users", "Users by language")
+
+left, right = st.columns(2)
+with left:
+    line_chart(df(series["reports_by_day"]), "day", "reports", "Reports generated over the last 30 days")
+with right:
+    reports_by_type = df(series["reports_by_type"])
+    if not reports_by_type.empty:
+        grouped_reports = (
+            reports_by_type.groupby("report_type", as_index=False)["reports"]
+            .sum()
+            .sort_values("reports", ascending=False)
+        )
+    else:
+        grouped_reports = reports_by_type
+    bar_chart(grouped_reports, "report_type", "reports", "Reports by product area")
+
+st.subheader("Language distribution")
+lang_left, lang_right = st.columns(2)
+with lang_left:
+    gpt_by_language = df(series["gpt_by_language"])
+    bar_chart(gpt_by_language, "language", "calls", "GPT interactions by language")
+with lang_right:
+    reports_lang = df(series["reports_by_type"])
+    bar_chart(reports_lang, "language", "reports", "Reports by language", color="report_type")
+
+st.subheader("GPT-supported workflows")
+workflow = df(series["gpt_by_request_language"])
+if workflow.empty:
+    st.info("No workflow data yet.")
+else:
+    bar_chart(workflow, "request_type", "calls", "GPT interactions by workflow and language", color="language")
+
+st.divider()
+
+st.subheader("What this project demonstrates")
+st.markdown(
+    """
+    - A production Telegram bot with multilingual user flows in Russian, French and English.
+    - Structured astrology calculations using Swiss Ephemeris and custom chart logic.
+    - GPT-based long-form report generation with language-aware prompts.
+    - SQLite-backed storage, safe aggregate analytics and private operations monitoring.
+    - Cloud deployment on Hetzner with systemd services and a separate public dashboard.
+    """
+)
+
+st.subheader("Stack")
+st.markdown(
+    " ".join(f'<span class="pill">{item}</span>' for item in project["stack"]),
+    unsafe_allow_html=True,
+)

public_stats.json

@@ -0,0 +1,480 @@
+{
+  "generated_at": "2026-06-13T12:54:40Z",
+  "public_note": "Aggregated portfolio statistics only. No personal data, prompts, answers, costs, IDs, birth data, or message text.",
+  "project": {
+    "name": "MapToSelf",
+    "description": "A multilingual Telegram bot that generates astrology-based self-reflection reports from natal chart data.",
+    "stack": [
+      "Python",
+      "python-telegram-bot",
+      "GPT API",
+      "SQLite",
+      "Swiss Ephemeris",
+      "Streamlit",
+      "Hetzner Cloud"
+    ],
+    "languages": [
+      "Russian",
+      "French",
+      "English"
+    ]
+  },
+  "metrics": {
+    "users_total": 29,
+    "new_7d": 25,
+    "new_30d": 29,
+    "profiles_complete": 29,
+    "with_chart": 29,
+    "reports_total": 83,
+    "reports_7d": 76,
+    "gpt_calls": 114,
+    "gpt_calls_7d": 111,
+    "child_charts": 4
+  },
+  "series": {
+    "users_by_day": [
+      {
+        "day": "2026-05-15",
+        "users": 0
+      },
+      {
+        "day": "2026-05-16",
+        "users": 0
+      },
+      {
+        "day": "2026-05-17",
+        "users": 0
+      },
+      {
+        "day": "2026-05-18",
+        "users": 1
+      },
+      {
+        "day": "2026-05-19",
+        "users": 0
+      },
+      {
+        "day": "2026-05-20",
+        "users": 0
+      },
+      {
+        "day": "2026-05-21",
+        "users": 0
+      },
+      {
+        "day": "2026-05-22",
+        "users": 0
+      },
+      {
+        "day": "2026-05-23",
+        "users": 0
+      },
+      {
+        "day": "2026-05-24",
+        "users": 0
+      },
+      {
+        "day": "2026-05-25",
+        "users": 0
+      },
+      {
+        "day": "2026-05-26",
+        "users": 0
+      },
+      {
+        "day": "2026-05-27",
+        "users": 0
+      },
+      {
+        "day": "2026-05-28",
+        "users": 0
+      },
+      {
+        "day": "2026-05-29",
+        "users": 0
+      },
+      {
+        "day": "2026-05-30",
+        "users": 0
+      },
+      {
+        "day": "2026-05-31",
+        "users": 0
+      },
+      {
+        "day": "2026-06-01",
+        "users": 1
+      },
+      {
+        "day": "2026-06-02",
+        "users": 1
+      },
+      {
+        "day": "2026-06-03",
+        "users": 0
+      },
+      {
+        "day": "2026-06-04",
+        "users": 0
+      },
+      {
+        "day": "2026-06-05",
+        "users": 0
+      },
+      {
+        "day": "2026-06-06",
+        "users": 1
+      },
+      {
+        "day": "2026-06-07",
+        "users": 1
+      },
+      {
+        "day": "2026-06-08",
+        "users": 0
+      },
+      {
+        "day": "2026-06-09",
+        "users": 17
+      },
+      {
+        "day": "2026-06-10",
+        "users": 7
+      },
+      {
+        "day": "2026-06-11",
+        "users": 0
+      },
+      {
+        "day": "2026-06-12",
+        "users": 0
+      },
+      {
+        "day": "2026-06-13",
+        "users": 0
+      }
+    ],
+    "reports_by_day": [
+      {
+        "day": "2026-05-15",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-16",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-17",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-18",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-19",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-20",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-21",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-22",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-23",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-24",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-25",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-26",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-27",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-28",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-29",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-30",
+        "reports": 0
+      },
+      {
+        "day": "2026-05-31",
+        "reports": 0
+      },
+      {
+        "day": "2026-06-01",
+        "reports": 2
+      },
+      {
+        "day": "2026-06-02",
+        "reports": 1
+      },
+      {
+        "day": "2026-06-03",
+        "reports": 3
+      },
+      {
+        "day": "2026-06-04",
+        "reports": 0
+      },
+      {
+        "day": "2026-06-05",
+        "reports": 0
+      },
+      {
+        "day": "2026-06-06",
+        "reports": 1
+      },
+      {
+        "day": "2026-06-07",
+        "reports": 1
+      },
+      {
+        "day": "2026-06-08",
+        "reports": 1
+      },
+      {
+        "day": "2026-06-09",
+        "reports": 51
+      },
+      {
+        "day": "2026-06-10",
+        "reports": 23
+      },
+      {
+        "day": "2026-06-11",
+        "reports": 0
+      },
+      {
+        "day": "2026-06-12",
+        "reports": 0
+      },
+      {
+        "day": "2026-06-13",
+        "reports": 0
+      }
+    ],
+    "users_by_language": [
+      {
+        "language": "Russian",
+        "users": 20
+      },
+      {
+        "language": "French",
+        "users": 8
+      },
+      {
+        "language": "English",
+        "users": 1
+      }
+    ],
+    "reports_by_type": [
+      {
+        "report_type": "Natal chart",
+        "language": "Russian",
+        "reports": 19
+      },
+      {
+        "report_type": "Life purpose",
+        "language": "Russian",
+        "reports": 9
+      },
+      {
+        "report_type": "Natal chart",
+        "language": "French",
+        "reports": 7
+      },
+      {
+        "report_type": "Career",
+        "language": "Russian",
+        "reports": 5
+      },
+      {
+        "report_type": "Finances",
+        "language": "Russian",
+        "reports": 5
+      },
+      {
+        "report_type": "karma",
+        "language": "Russian",
+        "reports": 5
+      },
+      {
+        "report_type": "Child chart",
+        "language": "Russian",
+        "reports": 4
+      },
+      {
+        "report_type": "Health",
+        "language": "Russian",
+        "reports": 4
+      },
+      {
+        "report_type": "Compatibility",
+        "language": "Russian",
+        "reports": 4
+      },
+      {
+        "report_type": "Career",
+        "language": "French",
+        "reports": 3
+      },
+      {
+        "report_type": "karma",
+        "language": "French",
+        "reports": 3
+      },
+      {
+        "report_type": "Life purpose",
+        "language": "French",
+        "reports": 3
+      },
+      {
+        "report_type": "Compatibility",
+        "language": "French",
+        "reports": 3
+      },
+      {
+        "report_type": "Finances",
+        "language": "French",
+        "reports": 2
+      },
+      {
+        "report_type": "Child: talents",
+        "language": "Russian",
+        "reports": 1
+      },
+      {
+        "report_type": "Forecast",
+        "language": "Russian",
+        "reports": 1
+      },
+      {
+        "report_type": "Health",
+        "language": "French",
+        "reports": 1
+      },
+      {
+        "report_type": "karma",
+        "language": "English",
+        "reports": 1
+      },
+      {
+        "report_type": "Natal chart",
+        "language": "English",
+        "reports": 1
+      },
+      {
+        "report_type": "Life purpose",
+        "language": "English",
+        "reports": 1
+      },
+      {
+        "report_type": "Relationships",
+        "language": "French",
+        "reports": 1
+      }
+    ],
+    "gpt_by_language": [
+      {
+        "language": "Russian",
+        "calls": 66,
+        "tokens": 427160
+      },
+      {
+        "language": "French",
+        "calls": 45,
+        "tokens": 337029
+      },
+      {
+        "language": "English",
+        "calls": 3,
+        "tokens": 15831
+      }
+    ],
+    "gpt_by_request_language": [
+      {
+        "request_type": "section",
+        "language": "Russian",
+        "calls": 35
+      },
+      {
+        "request_type": "dialog",
+        "language": "French",
+        "calls": 22
+      },
+      {
+        "request_type": "natal_chart",
+        "language": "Russian",
+        "calls": 19
+      },
+      {
+        "request_type": "section",
+        "language": "French",
+        "calls": 13
+      },
+      {
+        "request_type": "natal_chart",
+        "language": "French",
+        "calls": 7
+      },
+      {
+        "request_type": "child_chart",
+        "language": "Russian",
+        "calls": 4
+      },
+      {
+        "request_type": "forecast",
+        "language": "Russian",
+        "calls": 4
+      },
+      {
+        "request_type": "synastry",
+        "language": "French",
+        "calls": 3
+      },
+      {
+        "request_type": "synastry",
+        "language": "Russian",
+        "calls": 3
+      },
+      {
+        "request_type": "section",
+        "language": "English",
+        "calls": 2
+      },
+      {
+        "request_type": "child_talents",
+        "language": "Russian",
+        "calls": 1
+      },
+      {
+        "request_type": "natal_chart",
+        "language": "English",
+        "calls": 1
+      }
+    ]
+  }
+}

requirements.txt

@@ -1,3 +1,3 @@
-altair
-pandas
-streamlit
+streamlit>=1.45,<2
+pandas==2.2.2
+plotly==5.22.0