feat(docs, api): Add Projects Discovery API, deploymentcenter project seed, public web docs endpoint, and minimal agent prompt template

2026-08-07 10:24:30 +02:00
parent c437bdee6f
commit a21536f495
11 changed files with 578 additions and 1 deletions
@@ -0,0 +1,42 @@
+# 📋 Minimal Agent Prompt Template (For CLAUDE.md / AGENTS.md / CursorRules)
+
+Copy & paste the following snippet into your agent system prompts or repository `CLAUDE.md` / `.cursorrules`:
+
+```markdown
+## 🐛 Central Bugtracker & Feature Logging Directive
+
+As an AI developer agent, you MUST track all unhandled errors, stack traces, planned features, and refactoring ideas in the central **Deployment Center Bugtracker**.
+
+### 1. Monitored Projects & Discovery
+Before reporting, check monitored projects via API or use the known project slug:
+- **Projects Discovery API**: `GET https://dc.mhdf.de/api/bugtracker/v1/projects.php`
+- **Known Slugs**: `deploymentcenter`, `myapp`, `polytrader`, `predictalytics`.
+*Note: If you discover a bug or issue in the Deployment Center code itself while working elsewhere, report it under `project_slug: "deploymentcenter"`.*
+
+### 2. Reporting Bugs & Ideas
+Submit reports via HTTP POST to: `https://dc.mhdf.de/api/bugtracker/v1/report.php`
+Header: `Authorization: Bearer <YOUR_AGENT_TOKEN>` (or `X-Agent-Token: <YOUR_AGENT_TOKEN>`)
+
+```json
+{
+  "project_slug": "deploymentcenter",
+  "type": "bug",
+  "title": "Short descriptive title of the error or feature",
+  "description": "Condition or context under which it occurred",
+  "error_message": "Exact exception message",
+  "stack_trace": "Complete stack trace snippet",
+  "severity": "high",
+  "push_id": "push_wf_8912",
+  "created_by": "agent:your-name"
+}
+```
+
+- **Severities**:
+  - `idea`: 💡 Quick reminder / thought for later
+  - `wishlist`: ⭐ Backlog feature request
+  - `low` / `medium` / `high` / `critical`: Standard bug severities
+
+### 3. Full API Documentation On-Demand
+If you need complete API details, token provisioning instructions, or cURL/Python examples, read:
+📄 **Documentation URL**: `https://dc.mhdf.de/docs/bugtracker.md`
+```
@@ -49,6 +49,50 @@ Header: `Authorization: Bearer <MASTER_TOKEN>`

 ---

+## 📂 1.5. Discovering Monitored Projects API
+
+Before reporting a bug or feature request, an agent can dynamically query all registered projects monitored by the Deployment Center.
+
+### Endpoint: `GET /api/bugtracker/v1/projects.php`
+
+#### Response:
+```json
+{
+  "status": "success",
+  "count": 4,
+  "projects": [
+    {
+      "id": 1,
+      "slug": "myapp",
+      "name": "My Application Deluxe",
+      "notes": "Hauptanwendung für Desktop und Server"
+    },
+    {
+      "id": 2,
+      "slug": "polytrader",
+      "name": "PolyTrader Suite Pro",
+      "notes": "Trading- und Handelssystem Client"
+    },
+    {
+      "id": 3,
+      "slug": "predictalytics",
+      "name": "Predictalytics Engine",
+      "notes": "Datenanalyse und Vorhersage Dienst"
+    },
+    {
+      "id": 4,
+      "slug": "deploymentcenter",
+      "name": "Deployment Center",
+      "notes": "Zentrale Verwaltungs- & Update-Plattform"
+    }
+  ]
+}
+```
+
+If an agent discovers an issue or refactoring opportunity in any monitored system (including `deploymentcenter` itself or external dependencies), it can fetch this project list and map the issue to the appropriate `project_slug`.
+
+---
+
 ## 🐛 2. Reporting Bugs, Features & Ideas

 ### Endpoint: `POST /api/bugtracker/v1/report.php`