# Architectural Decision Log (ADL) System
A comprehensive system for managing architectural decisions with GraphQL backend, MCP server integration, and a web-based UI.
## Architecture
- **GraphQL Backend** (Port 4000): Provides data layer with CRUD operations for ADL entries
- **MCP HTTP Server** (Port 5000): HTTP wrapper for MCP protocol, bridges UI and GraphQL
- **MCP Stdio Server**: Model Context Protocol server for AI assistant integration
- **Web UI** (Port 3000): React-based interface for managing ADL entries
### Data Flow
```
UI (Port 3000) → MCP HTTP Server (Port 5000) → GraphQL Backend (Port 4000) → JSON Database
AI Assistants → MCP Stdio Server → GraphQL Backend (Port 4000) → JSON Database
```
## Features
- Create, Read, Update, Delete architectural decision entries
- Track decision metadata (author, timestamps, status)
- Integration with SAP/LeanIX fact sheets
- Table-based UI with filtering and sorting
- Linux-compatible deployment
## Data Model
Each ADL entry contains:
- **ID**: Unique indexed key
- **Created**: Creation timestamp
- **Last Edited**: Last modification timestamp
- **Author**: Decision author name
- **Title**: Decision title
- **Decision**: Detailed decision description
- **Fact Sheets**: List of related SAP/LeanIX Fact Sheet names
- **Status**: Proposed or Approved
## Installation
```bash
# Install dependencies
npm install
# Start all services
npm start
# Or start services individually
npm run start:graphql # GraphQL server on port 4000
npm run start:mcp # MCP server (stdio)
npm run start:ui # UI server on port 3000
```
## Docker Deployment (Linux)
```bash
# Build Docker image
docker build -t adl-system .
# Run container
docker run -p 3000:3000 -p 4000:4000 -v $(pwd)/data:/app/data adl-system
```
## Usage
### Via UI
1. Navigate to http://localhost:3000
2. Use the web interface to manage ADL entries
### Via MCP Server
The MCP server exposes the following tools:
- `adl_create`: Create a new ADL entry
- `adl_read`: Read ADL entries (all or by ID)
- `adl_update`: Update an existing ADL entry
- `adl_delete`: Delete an ADL entry
### Via GraphQL
Access GraphQL Playground at http://localhost:4000/graphql
Example query:
```graphql
query {
adlEntries {
id
title
status
author
}
}
```
## License
MIT
# A D L - M C P
