lmiranda
8bb69d3556
Project Structure Cleanup: - Remove deprecated cmdb-assistant plugin - Remove development output files (test scripts, status reports) - Remove IDE-specific workspace files - Create scripts/ directory for automation - Create docs/architecture/ for Draw.io diagrams - Create docs/workflows/ for workflow documentation - Create .scratch/ directory for transient work Governance & Documentation: - Add File Creation Governance section to CLAUDE.md - Add architecture diagram specifications (component-map, agent-workflow) - Add docs/UPDATING.md with update workflow - Update CHANGELOG.md with all changes Installation Automation: - Add scripts/setup.sh for initial installation - Add scripts/post-update.sh for updates after git pull - Add /initial-setup slash command Maintenance: - Update .gitignore with scratch directory - Fix all project name references (use support-claude-mktplace) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
134 lines
5.0 KiB
Markdown
134 lines
5.0 KiB
Markdown
# Component Map - Draw.io Specification
|
|
|
|
**Target File:** `docs/architecture/component-map.drawio`
|
|
|
|
**Purpose:** Shows all plugins, MCP servers, hooks and their relationships.
|
|
|
|
---
|
|
|
|
## NODES
|
|
|
|
### Plugins (Blue - #4A90D9)
|
|
|
|
| ID | Label | Type | Color | Position |
|
|
|----|-------|------|-------|----------|
|
|
| projman | projman | rectangle | #4A90D9 | top-center |
|
|
| projman-pmo | projman-pmo | rectangle | #4A90D9 | top-right |
|
|
| project-hygiene | project-hygiene | rectangle | #4A90D9 | top-left |
|
|
|
|
### MCP Servers (Green - #7CB342)
|
|
|
|
| ID | Label | Type | Color | Position |
|
|
|----|-------|------|-------|----------|
|
|
| gitea-mcp | Gitea MCP Server | rectangle | #7CB342 | middle-left |
|
|
| wikijs-mcp | Wiki.js MCP Server | rectangle | #7CB342 | middle-right |
|
|
|
|
### External Systems (Gray - #9E9E9E)
|
|
|
|
| ID | Label | Type | Color | Position |
|
|
|----|-------|------|-------|----------|
|
|
| gitea-instance | Gitea\ngitea.hotserv.cloud | cylinder | #9E9E9E | bottom-left |
|
|
| wikijs-instance | Wiki.js\nwikijs.hotserv.cloud | cylinder | #9E9E9E | bottom-right |
|
|
|
|
### Configuration (Orange - #FF9800)
|
|
|
|
| ID | Label | Type | Color | Position |
|
|
|----|-------|------|-------|----------|
|
|
| system-config | System Config\n~/.config/claude/ | rectangle | #FF9800 | far-left |
|
|
| project-config | Project Config\n.env | rectangle | #FF9800 | far-right |
|
|
|
|
---
|
|
|
|
## EDGES
|
|
|
|
### Plugin to MCP Server Connections
|
|
|
|
| From | To | Label | Style | Arrow |
|
|
|------|----|-------|-------|-------|
|
|
| projman | gitea-mcp | uses | solid | forward |
|
|
| projman | wikijs-mcp | uses | solid | forward |
|
|
| projman-pmo | gitea-mcp | uses (company-wide) | solid | forward |
|
|
| projman-pmo | wikijs-mcp | uses (company-wide) | solid | forward |
|
|
|
|
### Plugin Dependencies
|
|
|
|
| From | To | Label | Style | Arrow |
|
|
|------|----|-------|-------|-------|
|
|
| projman-pmo | projman | depends on | dashed | forward |
|
|
|
|
### MCP Server to External System Connections
|
|
|
|
| From | To | Label | Style | Arrow |
|
|
|------|----|-------|-------|-------|
|
|
| gitea-mcp | gitea-instance | REST API | solid | forward |
|
|
| wikijs-mcp | wikijs-instance | GraphQL | solid | forward |
|
|
|
|
### Configuration Connections
|
|
|
|
| From | To | Label | Style | Arrow |
|
|
|------|----|-------|-------|-------|
|
|
| system-config | gitea-mcp | credentials | dashed | forward |
|
|
| system-config | wikijs-mcp | credentials | dashed | forward |
|
|
| project-config | gitea-mcp | repo context | dashed | forward |
|
|
| project-config | wikijs-mcp | project path | dashed | forward |
|
|
|
|
---
|
|
|
|
## GROUPS
|
|
|
|
| ID | Label | Contains | Style |
|
|
|----|-------|----------|-------|
|
|
| plugins-group | Plugins | projman, projman-pmo, project-hygiene | light blue border |
|
|
| mcp-group | Shared MCP Servers | gitea-mcp, wikijs-mcp | light green border |
|
|
| external-group | External Services | gitea-instance, wikijs-instance | light gray border |
|
|
| config-group | Configuration | system-config, project-config | light orange border |
|
|
|
|
---
|
|
|
|
## LAYOUT NOTES
|
|
|
|
```
|
|
+------------------------------------------------------------------+
|
|
| PLUGINS GROUP |
|
|
| +----------------+ +----------------+ +-------------------+ |
|
|
| | project- | | projman | | projman-pmo | |
|
|
| | hygiene | | | | | |
|
|
| +----------------+ +-------+--------+ +--------+----------+ |
|
|
| | | |
|
|
+------------------------------------------------------------------+
|
|
| |
|
|
v v
|
|
+------------------------------------------------------------------+
|
|
| MCP SERVERS GROUP |
|
|
| +-------------------+ +-------------------+ |
|
|
| | Gitea MCP Server | | Wiki.js MCP Server| |
|
|
| +--------+----------+ +---------+---------+ |
|
|
+------------------------------------------------------------------+
|
|
| |
|
|
v v
|
|
+------------------------------------------------------------------+
|
|
| EXTERNAL SERVICES GROUP |
|
|
| +-------------------+ +-------------------+ |
|
|
| | Gitea | | Wiki.js | |
|
|
| | gitea.hotserv.cloud | wikijs.hotserv.cloud |
|
|
| +-------------------+ +-------------------+ |
|
|
+------------------------------------------------------------------+
|
|
|
|
CONFIG GROUP (left side): CONFIG GROUP (right side):
|
|
+-------------------+ +-------------------+
|
|
| System Config | | Project Config |
|
|
| ~/.config/claude/ | | .env |
|
|
+-------------------+ +-------------------+
|
|
```
|
|
|
|
---
|
|
|
|
## COLOR LEGEND
|
|
|
|
| Color | Hex | Meaning |
|
|
|-------|-----|---------|
|
|
| Blue | #4A90D9 | Plugins |
|
|
| Green | #7CB342 | MCP Servers |
|
|
| Gray | #9E9E9E | External Systems |
|
|
| Orange | #FF9800 | Configuration |
|