docs(user-guide): add chargeback and cost centers documentation

[8nevil8]

Summary

Documents chargeback and cost centers — previously absent from the docs entirely — and brings the project budget content in line with the current UI, based on the Cost Controls walkthrough recording and its captured screens.

Writing those pages surfaced three adjacent gaps, fixed here as well: Budget Management was an Enterprise feature carrying no navigation marker and no catalog entry; the <EnterpriseFeature /> badge said nothing useful; and the docs called the offering an "Enterprise Edition license" rather than the Enterprise package.

Changes

Budget documentation

• New — Project Budgets: the unified Create Budget dialog (one total distributed across Platform/CLI/Premium Models via the DISTRIBUTION bar), projects-list Budgets column and filters, live per-category spend, project info panel fields, premium model catalog, member allocations with the ★ fixed-override marker, enforce-vs-shared-pool modes, override dialog, rebalance
• New — Chargeback & Cost Centers: Enable chargeback / Attribute to a cost center toggles and their attribution targets, cost center management, project assignment, end-to-end departmental rollout
• index.md trimmed to concepts (types, categories, priority, enforcement, routing matrix) with pointers to the new sub-pages; budget types and parameters corrected for the single-total flow
• The Budget Management sidebar category had an empty items: []; it now holds both pages
• Replaced 3 superseded screenshots with 10 current captures
• FAQ: two new entries; refreshed how-do-i-set-a-budget-for-a-project-in-codemie — it described the removed per-category Add Budget flow

Enterprise marking

• Budget Management now carries the ✨ marker on its section entry in all three places it belongs (front matter sidebar_label, sidebars.ts, landing FeatureCard), matching the CodeMie CLI pattern. Child pages keep plain labels and rely on the in-page badge
• Added a Chargeback & Cost Centers row to the Enterprise Features catalog and extended the Budget Management row, which predated the distribution flow and linked only to admin pages
• Rewrote the <EnterpriseFeature /> badge body — it read This is an enterprise feature. directly beneath a heading reading Enterprise Feature. It now states that the capability may not be enabled on a given deployment, names the platform administrator as who to ask, and links to the catalog
• Renamed "Enterprise Edition license" → Enterprise package across the badge, the catalog, and the feature configuration reference. No "Enterprise Edition", "Community Edition" or "license" wording remains under docs/ or src/

tech-writer skill

Nothing in the workflow required checking Enterprise status, which is how these pages shipped unmarked in the first place. Added gates at four points: Phase 2 research reports whether sibling pages are marked; Phase 4 asks about packaging when unclear; a new standards section documents both marking parts and the naming rule; the QA checklist gates on determining status and registering the feature in the catalog.

Testing

• Tested locally with npm start — not run; verified via production build instead (see Quality Checks)
• All pages render correctly — npm run build compiles all MDX without error
• Images display properly — all 10 referenced by relative path and emitted to build/
• Internal links work — onBrokenLinks: 'throw' and onBrokenAnchors: 'throw' are set, so a clean build proves every link and cross-page anchor resolves. The badge's JSX <Link> is not covered by that setting, so its target route and rendered href were checked against the build output separately
• Sidebar navigation works — both new IDs resolve; build fails on unknown sidebar IDs

Quality Checks

• npm run check passes (typecheck + lint + commitlint)
• No MDX compilation errors
• No raw angle brackets
• Sidebar references document IDs (not filenames)
• Images stored locally next to content (not in static/img/)
• Commit messages follow Conventional Commits
• No secrets or credentials in documentation — Gitleaks pre-commit scan reported no leaks on every commit

markdownlint: 0 errors across 570 files. cspell: 0 issues across 648 files (added chargeback / showback to the dictionary).

Additional Notes

Three items for reviewer judgment:

1. Screenshot theme mismatch. The new captures are light-theme from a build whose Administration nav shows 5 items. The retained admin-users-budget-view.png in index.md is dark-theme production with a fuller nav (Budgets management, Categories management, MCPs management, Providers management). The new pages are internally consistent, but that older image next to them is visibly a different build — worth a reshoot for uniformity.

2. Chargeback semantics are inferred. The source material describes chargeback as marking spend "for internal billing" and rolling it up to a cost center, but shows no billing report or export surface. The toggles and their attribution effect are documented; no reporting destination is claimed, because none could be sourced. If such a view exists, that section needs a paragraph.

3. Mixed link styles in the Enterprise Features catalog. The rows added or edited here use the .md relative-path form the repo's CLAUDE.md calls for; pre-existing rows use extensionless paths with an extra ../ level that Docusaurus clamps. Both build clean, but that file is now mixed — normalizing the older rows would be a reasonable separate cleanup.

Generated with AI

Co-Authored-By: codemie-ai [email protected]

[github-actions]

PR Preview Ready!

Your preview documentation is ready! Visit it here:

Preview URL: http://codemie-docs-pr-previews.s3-website.eu-central-1.amazonaws.com/pr-427/

Note: This preview URL is accessible only while connected to the company VPN.

---

This preview will be automatically updated when you push new commits to this PR.
Preview files will be deleted when the PR is closed or merged.