diff --git a/README.md b/README.md index 2223dad..606e2ff 100644 --- a/README.md +++ b/README.md @@ -1,75 +1,47 @@ -# 🏠 Family Hoppe — Personal Library +# 📊 Personal Portfolio Command Center -> **Central brain for Family Hoppe.** Instant access to accounts, budgets, projects, and GitHub knowledge — clean, professional, and precise. +> **Enterprise dashboard for admin oversight:** budget control, project status, and Copilot work-hour allocation by repository. --- -## 📚 Quick Navigation +## Executive Dashboard -| Section | Description | +| KPI | Current Value | Source | +|---|---:|---| +| Active Billing Accounts | 1 active, 1 planned | [Accounts](./accounts/README.md) | +| Monthly Baseline Spend | $35 current / $45 planned | [Budget Overview](./budget/README.md) | +| Open Project Portfolios | 2 (Hoppe-home, Hoppe-GitHub) | [Projects Dashboard](./projects/README.md) | +| Time Allocation Tracking | Enabled (per repo + per project) | [Tracking Ledger](./budget/tracking.md) | + +--- + +## What Matters in This Repository + +1. **Financial governance** — budget, spending limits, and variance tracking +2. **Open project visibility** — portfolio status and budget allocation by project +3. **Work-hour allocation** — coding/chat effort split by repository and project +4. **Professional reporting** — clean, auditable tables ready for operational review + +--- + +## Portfolio + Budget Snapshot + +| Portfolio | Open Projects | Monthly Budget Allocation | Hours Allocation Tracking | +|---|---:|---:|---| +| [Hoppe-home](./projects/hoppe-home.md) | 0 (to be populated) | $0 (to be allocated) | ✅ | +| [Hoppe-GitHub](./projects/hoppe-github.md) | 0 (to be populated) | $0 (to be allocated) | ✅ | +| **Total** | **0** | **$0 allocated** | **✅** | + +> Update open projects and budget allocations in [projects/README.md](./projects/README.md) and [budget/tracking.md](./budget/tracking.md). + +--- + +## Quick Navigation + +| Section | Purpose | |---|---| -| [👥 Accounts](./accounts/README.md) | GitHub accounts overview (Family Hoppe & Joern) | -| [💰 Budget](./budget/README.md) | Membership costs & spending tracker | -| [📁 Projects](./projects/README.md) | All projects under Hoppe-home & personal | -| [📖 Guides](./guides/README.md) | Copilot, GitHub, and workflow quick-reference guides | - ---- - -## 🧠 At a Glance - -### GitHub Accounts - -| Account | Role | Plan | -|---|---|---| -| [donnyandjoern-debug](https://github.com/donnyandjoern-debug) | **Family Hoppe main** — Mac / primary workspace | Copilot Pro ($10/mo) + $25/mo budget | -| Joern _(profile pending creation)_ | **Windows VS Code** — secondary workspace | Copilot Pro ($10/mo, planned) | - -### Monthly Budget Summary - -| Item | Cost | -|---|---| -| Copilot Pro — Family Hoppe main | $10 / month | -| Copilot Pro — Joern (planned) | $10 / month | -| GitHub budget (actions, packages, etc.) | $25 / month | -| **Total** | **$45 / month** | - ---- - -## 🗂 Repository Structure - -``` -personal/ -├── README.md ← You are here (main dashboard) -├── accounts/ -│ ├── README.md ← Accounts overview -│ ├── family-hoppe.md ← donnyandjoern-debug account details -│ └── joern-hoppe.md ← Joern@Hoppe.home account details -├── budget/ -│ ├── README.md ← Budget overview -│ └── tracking.md ← Monthly spend tracker -├── projects/ -│ ├── README.md ← All projects index -│ └── hoppe-home.md ← Hoppe-home org projects -└── guides/ - ├── README.md ← Guides index - ├── copilot.md ← GitHub Copilot tips & tricks - └── github-workflow.md ← GitHub workflow best practices -``` - ---- - -## 🔍 Search Tips - -GitHub's built-in search makes this library instantly searchable: -- Press **`t`** on any page to search files -- Press **`/`** to focus the global search bar -- Use `repo:donnyandjoern-debug/personal ` from any GitHub search - ---- - -## ✅ Principles - -1. **Personal data only** — all project code lives in [Hoppe-home](https://github.com/Hoppe-home) -2. **Clean & precise** — no clutter, everything has a place -3. **Both accounts supported** — brain and clean-up assistant for Family Hoppe and Joern -4. **Up-to-date** — update this library whenever memberships, projects, or budgets change +| [👥 Accounts](./accounts/README.md) | Account ownership and access model | +| [💰 Budget](./budget/README.md) | Baseline budget and monthly spend controls | +| [📈 Financial + Hours Ledger](./budget/tracking.md) | Monthly spend, project allocations, and Copilot hours | +| [🗂 Projects Dashboard](./projects/README.md) | Open projects and portfolio-level reporting | +| [📖 Guides](./guides/README.md) | Workflow standards and Copilot operating guidance | diff --git a/budget/README.md b/budget/README.md index 101ee28..9855074 100644 --- a/budget/README.md +++ b/budget/README.md @@ -1,46 +1,39 @@ -# 💰 Budget — Family Hoppe +# 💰 Financial Control Dashboard -Overview of all GitHub-related spending for Family Hoppe. +Central budget governance for project delivery across portfolios. --- -## Monthly Budget Summary +## Monthly Budget Baseline | Item | Account | Cost | Status | -|---|---|---|---| -| Copilot Pro | donnyandjoern-debug (Mac) | $10 / month | ✅ Active | -| Copilot Pro | Joern _(account pending creation)_ | $10 / month | 🟡 Planned | -| GitHub budget (Actions, Packages, Codespaces) | donnyandjoern-debug | $25 / month | ✅ Active | -| GitHub Enterprise / Corporate membership | — | TBD | 🔲 Not yet | -| **Total (current)** | | **$35 / month** | | -| **Total (when Joern active)** | | **$45 / month** | | +|---|---|---:|---| +| Copilot Pro | donnyandjoern-debug (Mac) | $10 | ✅ Active | +| Copilot Pro | Joern _(account pending creation)_ | $10 | 🟡 Planned | +| GitHub usage budget (Actions, Packages, Codespaces) | donnyandjoern-debug | $25 | ✅ Active | +| **Total (current)** | | **$35 / month** | | +| **Total (planned)** | | **$45 / month** | | --- -## Budget Breakdown +## Budget Allocation by Portfolio -### GitHub Copilot Pro — $10/month per seat -- AI code completion in VS Code -- Copilot Chat (ask questions about code) -- Copilot Coding Agent (autonomous issue resolution in the browser) -- Copilot CLI, PR summaries, and more +| Portfolio | Monthly Allocation | Actual Spend | Variance | +|---|---:|---:|---:| +| Hoppe-home | $0 | $0 | $0 | +| Hoppe-GitHub | $0 | $0 | $0 | +| **Total** | **$0** | **$0** | **$0** | -### GitHub Budget — $25/month -Used for: -- **GitHub Actions** minutes beyond the free 2,000 min/month (public repos are free) -- **GitHub Packages** storage beyond the free tier -- **Codespaces** usage (cloud dev environments) -- **GitHub Models** API calls if used beyond free quota - -### Future: Corporate Membership -- No corporate membership yet -- Will consider when project scale requires it (e.g., GitHub Advanced Security, Enterprise SSO) +> Keep project-level spend and variance updated in [tracking.md](./tracking.md). --- -## Spend Tracker +## Financial Reporting Rules -See [tracking.md](./tracking.md) for a month-by-month record. +1. Allocate monthly budget by project before work starts. +2. Track spend by repository and compare against allocation. +3. Record Copilot coding/chat hours as labor input for each project. +4. Review variance at least once per month and adjust allocations. --- diff --git a/budget/tracking.md b/budget/tracking.md index 6d9a98a..2c1c0e4 100644 --- a/budget/tracking.md +++ b/budget/tracking.md @@ -1,43 +1,48 @@ -# 📊 Monthly Spend Tracker — Family Hoppe +# 📊 Financial + Hours Tracking Ledger -Track actual GitHub spending month by month. +Single source of truth for monthly spend and Copilot work-hour allocation by repository/project. -> **Update this file** at the start of each month with the previous month's actual spend. +> Update monthly during the first week of each new month. --- -## How to Check Your GitHub Spend +## A) Monthly Financial Summary -1. Go to **GitHub.com → Settings → Billing and plans** -2. Check "Usage this month" for Actions, Packages, and Codespaces -3. Check invoices under "Payment history" +| Month | Copilot (Main) | Copilot (Joern) | GitHub Usage Spend | Total Spend | Baseline Budget | Variance | Notes | +|---|---:|---:|---:|---:|---:|---:|---| +| April 2026 | $10 | $0 | $0 | $10 | $35 | -$25 | Initial baseline month | --- -## Tracker +## B) Project Budget Allocation (by Repo) -| Month | Copilot Pro (Donny) | Copilot Pro (Joern) | GitHub Budget Used | GitHub Budget Limit | Notes | -|---|---|---|---|---|---| -| April 2026 | $10 | — | — | $25 | First tracking month | +| Month | Portfolio | Project | Repository | Budget Allocated | Actual Spend | Variance | Status | +|---|---|---|---|---:|---:|---:|---| +| April 2026 | Hoppe-home | _(add project)_ | `Hoppe-home/repo-name` | $0 | $0 | $0 | 🟢 | +| April 2026 | Hoppe-GitHub | _(add project)_ | `Hoppe-GitHub/repo-name` | $0 | $0 | $0 | 🟢 | --- -## Targets +## C) Copilot Work-Hours Allocation (Chat-Based) -| Goal | Target | -|---|---| -| Stay within GitHub budget | ≤ $25 / month | -| Activate Joern Copilot Pro | When Windows VS Code setup is complete | -| Review corporate membership need | Quarterly | +Track effort from: +- VS Code Copilot Chat sessions +- Online chat sessions (GitHub / web) + +| Month | Date | Source | Portfolio | Project | Repository | Activity Type | Hours | Session Ref | Notes | +|---|---|---|---|---|---|---|---:|---|---| +| April 2026 | 2026-04-20 | VS Code | Hoppe-home | _(add project)_ | `Hoppe-home/repo-name` | Coding / Planning / Debugging | 0.0 | Link or short ID | | +| April 2026 | 2026-04-20 | Online Chat | Hoppe-GitHub | _(add project)_ | `Hoppe-GitHub/repo-name` | Coding / Planning / Debugging | 0.0 | Link or short ID | | --- -## Notes +## D) Monthly Rollup (Hours by Repository) -- If GitHub Actions usage approaches $20/month, review which workflows are consuming the most minutes. -- Public repository Actions minutes are **free** — keep projects public where possible. -- Codespaces can be expensive; prefer local VS Code where possible. +| Month | Repository | Coding Hours | Planning Hours | Debugging Hours | Total Hours | +|---|---|---:|---:|---:|---:| +| April 2026 | `Hoppe-home/repo-name` | 0.0 | 0.0 | 0.0 | 0.0 | +| April 2026 | `Hoppe-GitHub/repo-name` | 0.0 | 0.0 | 0.0 | 0.0 | --- -[← Back to budget overview](./README.md) | [← Back to main library](../README.md) +[← Back to budget dashboard](./README.md) | [← Back to main library](../README.md) diff --git a/projects/README.md b/projects/README.md index 9e26f3d..86cf11b 100644 --- a/projects/README.md +++ b/projects/README.md @@ -1,63 +1,51 @@ -# 📁 Projects — Family Hoppe +# 📁 Project Portfolio Dashboard -All project-related work lives under the **[Hoppe-home](https://github.com/Hoppe-home)** organisation. -This page is the master index of active, paused, and completed projects. +This is the enterprise-style reporting dashboard for open projects, budget allocation, and delivery status. --- -## How Projects Are Organised +## Portfolio Overview -``` -Hoppe-home (organisation) -├── project-1/ ← Individual project repos -├── project-2/ -└── ... - -donnyandjoern-debug/personal ← This repo (personal data / brain only) -``` - -**Rule:** Code → Hoppe-home. Personal notes/reference → this repo. +| Portfolio | Owner | Open Projects | Budget Allocation | Hours Allocation | Detail | +|---|---|---:|---:|---|---| +| Hoppe-home | donnyandjoern-debug | 0 | $0 | ✅ Tracked | [View](./hoppe-home.md) | +| Hoppe-GitHub | donnyandjoern-debug | 0 | $0 | ✅ Tracked | [View](./hoppe-github.md) | +| **Total** | | **0** | **$0** | **✅** | | --- -## Active Projects +## Open Projects Dashboard -| Project | Repo | Description | Accounts | -|---|---|---|---| -| _(add projects here)_ | — | — | — | +> Use this table for active execution and budget control. + +| Project | Portfolio | Repository | Status | Monthly Budget | Budget Used | Hours (Month) | Notes | +|---|---|---|---|---:|---:|---:|---| +| _(add project)_ | Hoppe-home / Hoppe-GitHub | `org/repo` | 🟢 On Track / 🟡 At Risk / 🔴 Blocked | $0 | $0 | 0h | | --- -## Planned Projects +## Pipeline Views -| Project | Description | Priority | -|---|---|---| -| _(add planned projects here)_ | — | — | +### Planned + +| Project | Portfolio | Repository | Target Start | Priority | +|---|---|---|---|---| +| _(add planned project)_ | Hoppe-home / Hoppe-GitHub | `org/repo` | YYYY-MM-DD | High / Medium / Low | + +### Completed + +| Project | Portfolio | Repository | Completion Date | Outcome | +|---|---|---|---|---| +| _(add completed project)_ | Hoppe-home / Hoppe-GitHub | `org/repo` | YYYY-MM-DD | Delivered | --- -## Completed Projects +## Reporting Standard -| Project | Repo | Completed | -|---|---|---| -| _(add completed projects here)_ | — | — | - ---- - -## Project Guidelines - -1. All project repos belong to [Hoppe-home](https://github.com/Hoppe-home), never to personal accounts. -2. Both `donnyandjoern-debug` and `Joern@Hoppe.home` should be members of Hoppe-home to collaborate. -3. Use GitHub Issues and Projects boards to track progress. -4. Keep repos clean: descriptive names, a good README, and a license. -5. Archive repos when a project is complete and no longer maintained. - ---- - -## Related - -- [Hoppe-home org](./hoppe-home.md) — Organisation structure and members -- [Guides](../guides/README.md) — GitHub workflow best practices +1. Track every active project with a clear repo owner and status. +2. Maintain monthly budget allocation and actual spend by project. +3. Record coding/chat work hours in [budget/tracking.md](../budget/tracking.md). +4. Review dashboard weekly to keep project and budget status accurate. --- diff --git a/projects/hoppe-github.md b/projects/hoppe-github.md new file mode 100644 index 0000000..a4ebc75 --- /dev/null +++ b/projects/hoppe-github.md @@ -0,0 +1,47 @@ +# 🏢 Hoppe-GitHub Portfolio Dashboard + +Enterprise dashboard for projects tracked under the Hoppe-GitHub portfolio. + +--- + +## Portfolio Summary + +| Field | Value | +|---|---| +| Portfolio Name | Hoppe-GitHub | +| Owner | `donnyandjoern-debug` | +| Primary Purpose | Project delivery with budget and effort transparency | +| Reporting Scope | Open projects, spend allocation, and hours by repository | + +--- + +## Open Projects + +| Project | Repository | Status | Monthly Budget | Budget Used | Hours (Month) | Owner | +|---|---|---|---:|---:|---:|---| +| _(add project)_ | `Hoppe-GitHub/repo-name` | 🟢 On Track / 🟡 At Risk / 🔴 Blocked | $0 | $0 | 0h | | + +--- + +## Financial Allocation + +| Category | Amount | Notes | +|---|---:|---| +| Assigned Monthly Budget | $0 | Set at monthly planning review | +| Forecasted Spend | $0 | Sum of active project estimates | +| Actual Spend | $0 | Tracked in [budget/tracking.md](../budget/tracking.md) | +| Variance | $0 | Forecast - Actual | + +--- + +## Work-Hour Allocation (Copilot Sessions) + +| Repository | Coding Hours | Chat Hours | Total Hours | Source | +|---|---:|---:|---:|---| +| `Hoppe-GitHub/repo-name` | 0.0 | 0.0 | 0.0 | VS Code + Online Chat | + +> Keep monthly entries aligned with the central ledger in [budget/tracking.md](../budget/tracking.md). + +--- + +[← Back to projects dashboard](./README.md) | [← Back to main library](../README.md) diff --git a/projects/hoppe-home.md b/projects/hoppe-home.md index 7b14dce..9363eaf 100644 --- a/projects/hoppe-home.md +++ b/projects/hoppe-home.md @@ -1,17 +1,17 @@ -# 🏢 Hoppe-home Organisation +# 🏢 Hoppe-home Portfolio Dashboard -Details about the Hoppe-home GitHub organisation used for all Family Hoppe projects. +Enterprise dashboard for projects tracked under the Hoppe-home portfolio. --- -## Organisation Details +## Portfolio Summary | Field | Value | |---|---| +| Portfolio Name | Hoppe-home | | GitHub URL | [https://github.com/Hoppe-home](https://github.com/Hoppe-home) | -| Owner | `donnyandjoern-debug` (Family Hoppe main account) | -| Plan | Free organisation (project repos are public) | -| Purpose | All project code for Family Hoppe | +| Owner | `donnyandjoern-debug` | +| Reporting Scope | Open projects, spend allocation, and hours by repository | --- @@ -20,28 +20,44 @@ Details about the Hoppe-home GitHub organisation used for all Family Hoppe proje | Member | Role | Account | |---|---|---| | donnyandjoern-debug | Owner | Family Hoppe main (Mac) | -| Joern _(account pending creation)_ | Member | Windows VS Code (to be added) | +| Joern _(account pending creation)_ | Member | Windows VS Code (planned) | --- -## Repositories +## Open Projects -> Update this table when new repos are created in Hoppe-home. - -| Repo | Description | Status | -|---|---|---| -| _(add repos here)_ | — | — | +| Project | Repository | Status | Monthly Budget | Budget Used | Hours (Month) | Owner | +|---|---|---|---:|---:|---:|---| +| _(add project)_ | `Hoppe-home/repo-name` | 🟢 On Track / 🟡 At Risk / 🔴 Blocked | $0 | $0 | 0h | | --- -## Organisation Settings Checklist +## Financial Allocation -- [ ] Set a profile picture / avatar for Hoppe-home -- [ ] Add a description and URL to the org profile -- [ ] Add `Joern@Hoppe.home` as a member once the account is created -- [ ] Enable branch protection on `main` for all repos -- [ ] Use GitHub Projects for project management +| Category | Amount | Notes | +|---|---:|---| +| Assigned Monthly Budget | $0 | Set at monthly planning review | +| Forecasted Spend | $0 | Sum of active project estimates | +| Actual Spend | $0 | Tracked in [budget/tracking.md](../budget/tracking.md) | +| Variance | $0 | Forecast - Actual | --- -[← Back to projects](./README.md) | [← Back to main library](../README.md) +## Work-Hour Allocation (Copilot Sessions) + +| Repository | Coding Hours | Chat Hours | Total Hours | Source | +|---|---:|---:|---:|---| +| `Hoppe-home/repo-name` | 0.0 | 0.0 | 0.0 | VS Code + Online Chat | + +--- + +## Portfolio Governance Checklist + +- [ ] Keep open projects table current +- [ ] Review budget variance monthly +- [ ] Ensure all active repos have owners and status +- [ ] Align hour totals with [budget/tracking.md](../budget/tracking.md) + +--- + +[← Back to projects dashboard](./README.md) | [← Back to main library](../README.md)