solcom / docs / agents / codebase-map · agent-doc

SOLCOM Codebase Map — Top-Level Folder TOC

Onboarding-Referenz: Welcher Ordner hat welche Verantwortung? Tabelle 1 listet alle Top-Level-Folder mit One-Liner. Tabelle 2 zeigt die 5 Custom-Module unter web/modules/custom/. Ziel: Peer-Dev findet jeden Einstiegspunkt in unter 30 Sekunden.

Top-Level Folders

Pfad Rolle
Drupal Webroot
web/ Drupal-Webroot — Core (vendor-managed), Custom-Module, Custom-Theme, Sites/Default-Config
web/modules/custom/ 5 Custom-Module (siehe Tabelle unten). Einziger Ort für projektspezifischen PHP-Code.
web/modules/contrib/ Composer-managed Contrib-Module. nicht editieren — Änderungen gehen beim nächsten composer update verloren. Patches über patches/.
web/themes/custom/byte_theme/ Tailwind-v4-SDC-Theme — npm run dev|build|format. SDC-Komponenten unter components/. Einziger Ort für projektspezifisches CSS/JS/Twig.
web/themes/contrib/ Mercury-Starterkit u. a. (Composer-managed). nicht editieren
web/sites/default/ settings.php (git-tracked) · settings.local.php gitignored (per-machine) · files/ gitignored (Uploads). Onboarding-Template: web/sites/example.settings.local.php.
Drupal-Konfiguration
config/sync/ Drupal-Config-Sync — Source-of-Truth für Content-Types, Fields, Views, Permissions. Workflow: ddev drush cex (export) / cim (import).
config/splits/ config_split-Profile. Dev-only-Module (z. B. solcom_mcp_tools) laufen nur wenn Split dev aktiv ist. Referenz: ADR-0010.
Dokumentation
docs/ HTML-First-Doku — Plans, PRDs, ADRs, Brainstorms, Reports, Context-Snapshots, Design-MAPPING/INVENTORY, Wiki. Authoring-Skill: html-doc-authoring. Begründung: ADR-0022.
docs/_templates/ 21 selbst-enthaltene Template-HTMLs (ThariqS/html-effectiveness-Clone). Basis für jedes neue Doc-File — Style-Block MUSS mitkopiert werden, kein externes CSS.
docs/index.html Galerie/Content-Catalog aller Doku-Strands (TOC + Status-Hero + Story-Funnel).
docs/LOG.html Append-only Audit-Trail. Op-Vokabular: ingest, decide, supersede, sync, migrate, lint-pass. Neuste Einträge oben.
docs/wiki/ Synthese-Entities — konsolidiertes Domain-Wissen (z. B. card-family, mittwald-stack, freelancer-feeds).
docs/adr/ Architecture Decision Records (HTML, 4-Sektionen-Schema). Aktuelle Liste: ADR-0001 bis ADR-0037.
docs/agents/ Agent-Strand-Autoritäten: skills.html, reviewers.html, domain.html, issue-tracker.html, codebase-map.html (diese Datei).
Tooling & Infrastruktur
recipes/ Drupal-Recipe-Cache (Composer-managed, regenerierbar via drupal:recipe-unpack). gitignored — kein manueller Content, keine Portability-Mechanik (Entscheidung 2026-05-17).
scripts/ Repo-eigene Helper-Scripts — z. B. ralph.sh (Mass-Implementation-Driver, ADR-0037), Migrate-Helper.
.claude/ Project-local Claude-Code-Config — skills/, agents/, hooks/, settings.json. worktrees/ + settings.local.json gitignored.
.ddev/ DDEV-Container-Konfiguration — config.yaml (shared, git-tracked) · config.local.yaml gitignored (per-machine). DDEV-Projektname: solcom.
.mcp.json MCP-Server-Registrierung. drupal-solcom lädt automatisch bei DDEV-Start und liefert tool_api_*-Tools (Entity-CRUD, Config, Canvas, Vacancies, Watchdog).
patches/ Composer-Patches für Contrib-Module. Werden via cweagans/composer-patches beim composer install angewandt.
Root-Files
composer.json / composer.lock PHP-Dependencies. Drupal ^11.3.5, PHP 8.4, MariaDB 11.8. Contrib-Module NIEMALS in-place editieren.
package.json (in byte_theme/) npm-Dependencies für das Frontend-Theme: Tailwind v4, Prettier. Liegt unter web/themes/custom/byte_theme/, nicht im Repo-Root.

Custom Module (web/modules/custom/)

Modul Doku Kern-Verantwortung
card_preview fehlt Throwaway Preview-Route für das SDC bubble-card während Figma-Sync. 1 Controller, kein Test. Kandidat für Löschung nach Go-Live.
solcom_editorial fehlt Versteckt Scheduler-Felder im Editorial-Workflow ohne gültige Moderation-Transition. 2 Hooks, Unit-Tests vorhanden.
solcom_mcp_tools fehlt MCP-Tool-Bridge für Claude Code (SDC-Katalog, Brand-Tokens, Component-Usage, Entity-CRUD, Config-Ops). 11 Services, 46 Tool-Plugins. dev-only via config_split.
solcom_project_offer README.md (7.7 KB) Spiegelt Salesforce-Project-Offers (FCSB/BH4SF) als read-only project_offer-Nodes mit URL-Writeback, Geocoding und Publikations-Fenster-Sync. Kanonische URL: /fuer-freiberufler/projektliste.
solcom_vacancy fehlt Spiegelt Personio-Vakanzen als Drupal-Nodes mit JSON-LD JobPosting Schema.org-Markup und Computed-Field für Gehaltsanzeige. Listing: /karriere-bei-solcom/offene-stellenanzeigen.