From 9bc3a252d5901133c9bd0ca39e70346012163c5f Mon Sep 17 00:00:00 2001 From: ReachableCEO Date: Fri, 12 Sep 2025 10:55:29 -0500 Subject: [PATCH] KNEL: import STEP0 shared-services content (overview, questions, policies, price book, inventory template) --- src/SUMMARY.md | 7 +++++++ src/knel/internal-price-book.md | 15 +++++++++++++++ src/knel/inventory-template.md | 15 +++++++++++++++ src/knel/overview.md | 3 +++ src/knel/policies.md | 22 ++++++++++++++++++++++ src/knel/questions.md | 15 +++++++++++++++ 6 files changed, 77 insertions(+) create mode 100644 src/knel/internal-price-book.md create mode 100644 src/knel/inventory-template.md create mode 100644 src/knel/overview.md create mode 100644 src/knel/policies.md create mode 100644 src/knel/questions.md diff --git a/src/SUMMARY.md b/src/SUMMARY.md index e0ff9f9..8be98c2 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -1,3 +1,10 @@ # Summary - [Introduction](./introduction.md) + +## KNEL — Shared Services +- [Overview](./knel/overview.md) +- [Questions](./knel/questions.md) +- [Policies](./knel/policies.md) +- [Internal Price Book](./knel/internal-price-book.md) +- [Inventory Template](./knel/inventory-template.md) diff --git a/src/knel/internal-price-book.md b/src/knel/internal-price-book.md new file mode 100644 index 0000000..b7103d4 --- /dev/null +++ b/src/knel/internal-price-book.md @@ -0,0 +1,15 @@ +# KNEL — Internal Price Book (Draft) + +Intent +- Nominal, simple rates; accountability over precision; revisit after CPA review and revenue. + +Model (proposed) +- Base infra absorbed by KNEL initially; per‑LLC flat recharge starts only when revenue is material (TBD). + +SKUs (initial) +- CLD-APP-SLOT — Cloudron app slot (per deployed app) +- OIDC-IDP — OIDC identity provider (per LLC) +- GIT-ORG — Gitea organization +- MAT-PROP — Matomo property (site ID) +- DOC-SEAT — Documenso seats (bundle) +- RED-PROJ — Redmine project (per LLC) diff --git a/src/knel/inventory-template.md b/src/knel/inventory-template.md new file mode 100644 index 0000000..f2a1c21 --- /dev/null +++ b/src/knel/inventory-template.md @@ -0,0 +1,15 @@ +# KNEL — Inventory Template (STEP0) + +CSV headers (example) + +``` +app_id,app_name,biz,env,slo,cost_center,url,notes +12345,gitea,merchants-of-hope,prod,tier-2,KNEL:GIT-ORG,https://gitea.example.com/org/...,primary code hosting +12346,matomo,your-dream-name-here,prod,tier-2,KNEL:MAT-PROP,https://matomo.example.com/#idSite=...,analytics +12347,documenso,sol-calc,prod,tier-2,KNEL:DOC-SEAT,https://sign.example.com,contracts +12348,redmine,rackrental,prod,tier-3,KNEL:RED-PROJ,https://pm.example.com,project tracking +``` + +Notes +- Export nightly (CSV/JSON) from Cloudron inventory or maintain manually to start. +- Tags: `biz`, `env`, `slo`, `cost_center` support lightweight reconciliation to Dolibarr. diff --git a/src/knel/overview.md b/src/knel/overview.md new file mode 100644 index 0000000..39996ea --- /dev/null +++ b/src/knel/overview.md @@ -0,0 +1,3 @@ +# KNEL — Overview (STEP0 import) + +This section captures shared-services planning content for KNEL imported from the IBP STEP0 phase. Content is additive and public. diff --git a/src/knel/policies.md b/src/knel/policies.md new file mode 100644 index 0000000..577622d --- /dev/null +++ b/src/knel/policies.md @@ -0,0 +1,22 @@ +# KNEL — Policy Drafts (STEP0) + +Intercompany Recharge Policy (Draft) +- Purpose: keep internal billing simple; prioritize shipping. +- Base infra (~$100/mo) absorbed by KNEL until businesses have revenue; then nominal flat recharge may begin (to be confirmed with CPA). +- Monthly invoicing via Dolibarr; $0 allowed when below threshold. + +Investment Recovery Policy (Draft) +- Track larger historical balances (e.g., RackRental/Suborbital) as intercompany loans; repay before distributions. +- Initial interest 0% unless CPA advises otherwise. + +Access and Identity Policy (Draft) +- OIDC SSO is authoritative; no local accounts. Quarterly access reviews. + +Backup/DR Policy (Draft) +- Tiers and RPO/RTO targets to be confirmed; quarterly restore tests. + +Matomo Analytics Policy (Draft) +- Per-business site IDs; portfolio roll-up dashboard; 12–24 month retention. + +Documenso Templates Policy (Draft) +- Templates: JV, Intercompany Agreement, SOW, NDA (prioritization pending). diff --git a/src/knel/questions.md b/src/knel/questions.md new file mode 100644 index 0000000..411e322 --- /dev/null +++ b/src/knel/questions.md @@ -0,0 +1,15 @@ +# KNEL — Shared Services Questions (STEP0) + +Context (confirmed) +- OIDC single sign-on for all Cloudron apps. +- Matomo portfolio roll-up desired. +- CPA engaged; policies to be reviewed. +- Infra base cost ≈ $100/month; keep accounting lightweight. + +Questions (answer inline as ready) +- Historical investments: which LLCs have balances to recover (e.g., RackRental/Suborbital)? +- Pricing stance: keep base recharges at $0 until revenue, then nominal flat recharge? Any threshold? +- Access: any OIDC group/role gaps to fix now across Gitea/Redmine/Matomo/Documenso? +- Matomo portfolio KPIs to show (visits, conversions, goals, revenue proxy)? +- Documenso templates to prioritize (JV, Intercompany, SOW, NDA)? +- DR/SLOs: confirm targets by tier and quarterly restore cadence.