KNEL: import STEP0 shared-services content (overview, questions, policies, price book, inventory template)

This commit is contained in:
2025-09-12 10:55:29 -05:00
parent 1c26d96fc9
commit 9bc3a252d5
6 changed files with 77 additions and 0 deletions

View File

@@ -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)

View File

@@ -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; perLLC 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)

View File

@@ -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.

3
src/knel/overview.md Normal file
View File

@@ -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.

22
src/knel/policies.md Normal file
View File

@@ -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; 1224 month retention.
Documenso Templates Policy (Draft)
- Templates: JV, Intercompany Agreement, SOW, NDA (prioritization pending).

15
src/knel/questions.md Normal file
View File

@@ -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.