Compare commits
30
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
d8b6772148 | ||
|
|
1363933387 | ||
|
|
7b21524c86 | ||
|
|
e98d38e716 | ||
|
|
1f561321f7 | ||
|
|
91180a82bf | ||
|
|
a18acf4900 | ||
|
|
be2054274d | ||
|
|
3cb93a81be | ||
|
|
e341c5938a | ||
|
|
b3d5ea6764 | ||
|
|
b29fc6a671 | ||
|
|
02b0c29f78 | ||
|
|
1de6306eea | ||
|
|
6e1fb74c68 | ||
|
|
56c05a425a | ||
|
|
ea32264b1b | ||
|
|
b51fe2af9f | ||
|
|
d526c81c19 | ||
|
|
299acf538e | ||
|
|
f83765f48a | ||
|
|
701ffd0ab6 | ||
|
|
4a1683bdda | ||
|
|
d680c75343 | ||
|
|
57c7c4911e | ||
|
|
9e1faffce7 | ||
|
|
d48b122176 | ||
|
|
86f8ee6763 | ||
|
|
2b8e03f8fa | ||
|
|
3d5855897e |
No files matched your search
@@ -0,0 +1,244 @@
|
|||||||
|
---
|
||||||
|
name: json-canvas
|
||||||
|
description: Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.
|
||||||
|
---
|
||||||
|
|
||||||
|
# JSON Canvas Skill
|
||||||
|
|
||||||
|
## File Structure
|
||||||
|
|
||||||
|
A canvas file (`.canvas`) contains two top-level arrays following the [JSON Canvas Spec 1.0](https://jsoncanvas.org/spec/1.0/):
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"nodes": [],
|
||||||
|
"edges": []
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- `nodes` (optional): Array of node objects
|
||||||
|
- `edges` (optional): Array of edge objects connecting nodes
|
||||||
|
|
||||||
|
## Common Workflows
|
||||||
|
|
||||||
|
### 1. Create a New Canvas
|
||||||
|
|
||||||
|
1. Create a `.canvas` file with the base structure `{"nodes": [], "edges": []}`
|
||||||
|
2. Generate unique 16-character hex IDs for each node (e.g., `"6f0ad84f44ce9c17"`)
|
||||||
|
3. Add nodes with required fields: `id`, `type`, `x`, `y`, `width`, `height`
|
||||||
|
4. Add edges referencing valid node IDs via `fromNode` and `toNode`
|
||||||
|
5. **Validate**: Parse the JSON to confirm it is valid. Verify all `fromNode`/`toNode` values exist in the nodes array
|
||||||
|
|
||||||
|
### 2. Add a Node to an Existing Canvas
|
||||||
|
|
||||||
|
1. Read and parse the existing `.canvas` file
|
||||||
|
2. Generate a unique ID that does not collide with existing node or edge IDs
|
||||||
|
3. Choose position (`x`, `y`) that avoids overlapping existing nodes (leave 50-100px spacing)
|
||||||
|
4. Append the new node object to the `nodes` array
|
||||||
|
5. Optionally add edges connecting the new node to existing nodes
|
||||||
|
6. **Validate**: Confirm all IDs are unique and all edge references resolve to existing nodes
|
||||||
|
|
||||||
|
### 3. Connect Two Nodes
|
||||||
|
|
||||||
|
1. Identify the source and target node IDs
|
||||||
|
2. Generate a unique edge ID
|
||||||
|
3. Set `fromNode` and `toNode` to the source and target IDs
|
||||||
|
4. Optionally set `fromSide`/`toSide` (top, right, bottom, left) for anchor points
|
||||||
|
5. Optionally set `label` for descriptive text on the edge
|
||||||
|
6. Append the edge to the `edges` array
|
||||||
|
7. **Validate**: Confirm both `fromNode` and `toNode` reference existing node IDs
|
||||||
|
|
||||||
|
### 4. Edit an Existing Canvas
|
||||||
|
|
||||||
|
1. Read and parse the `.canvas` file as JSON
|
||||||
|
2. Locate the target node or edge by `id`
|
||||||
|
3. Modify the desired attributes (text, position, color, etc.)
|
||||||
|
4. Write the updated JSON back to the file
|
||||||
|
5. **Validate**: Re-check all ID uniqueness and edge reference integrity after editing
|
||||||
|
|
||||||
|
## Nodes
|
||||||
|
|
||||||
|
Nodes are objects placed on the canvas. Array order determines z-index: first node = bottom layer, last node = top layer.
|
||||||
|
|
||||||
|
### Generic Node Attributes
|
||||||
|
|
||||||
|
| Attribute | Required | Type | Description |
|
||||||
|
|-----------|----------|------|-------------|
|
||||||
|
| `id` | Yes | string | Unique 16-char hex identifier |
|
||||||
|
| `type` | Yes | string | `text`, `file`, `link`, or `group` |
|
||||||
|
| `x` | Yes | integer | X position in pixels |
|
||||||
|
| `y` | Yes | integer | Y position in pixels |
|
||||||
|
| `width` | Yes | integer | Width in pixels |
|
||||||
|
| `height` | Yes | integer | Height in pixels |
|
||||||
|
| `color` | No | canvasColor | Preset `"1"`-`"6"` or hex (e.g., `"#FF0000"`) |
|
||||||
|
|
||||||
|
### Text Nodes
|
||||||
|
|
||||||
|
| Attribute | Required | Type | Description |
|
||||||
|
|-----------|----------|------|-------------|
|
||||||
|
| `text` | Yes | string | Plain text with Markdown syntax |
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": "6f0ad84f44ce9c17",
|
||||||
|
"type": "text",
|
||||||
|
"x": 0,
|
||||||
|
"y": 0,
|
||||||
|
"width": 400,
|
||||||
|
"height": 200,
|
||||||
|
"text": "# Hello World\n\nThis is **Markdown** content."
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Newline pitfall**: Use `\n` for line breaks in JSON strings. Do **not** use the literal `\\n` -- Obsidian renders that as the characters `\` and `n`.
|
||||||
|
|
||||||
|
### File Nodes
|
||||||
|
|
||||||
|
| Attribute | Required | Type | Description |
|
||||||
|
|-----------|----------|------|-------------|
|
||||||
|
| `file` | Yes | string | Path to file within the system |
|
||||||
|
| `subpath` | No | string | Link to heading or block (starts with `#`) |
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": "a1b2c3d4e5f67890",
|
||||||
|
"type": "file",
|
||||||
|
"x": 500,
|
||||||
|
"y": 0,
|
||||||
|
"width": 400,
|
||||||
|
"height": 300,
|
||||||
|
"file": "Attachments/diagram.png"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Link Nodes
|
||||||
|
|
||||||
|
| Attribute | Required | Type | Description |
|
||||||
|
|-----------|----------|------|-------------|
|
||||||
|
| `url` | Yes | string | External URL |
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": "c3d4e5f678901234",
|
||||||
|
"type": "link",
|
||||||
|
"x": 1000,
|
||||||
|
"y": 0,
|
||||||
|
"width": 400,
|
||||||
|
"height": 200,
|
||||||
|
"url": "https://obsidian.md"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Group Nodes
|
||||||
|
|
||||||
|
Groups are visual containers for organizing other nodes. Position child nodes inside the group's bounds.
|
||||||
|
|
||||||
|
| Attribute | Required | Type | Description |
|
||||||
|
|-----------|----------|------|-------------|
|
||||||
|
| `label` | No | string | Text label for the group |
|
||||||
|
| `background` | No | string | Path to background image |
|
||||||
|
| `backgroundStyle` | No | string | `cover`, `ratio`, or `repeat` |
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": "d4e5f6789012345a",
|
||||||
|
"type": "group",
|
||||||
|
"x": -50,
|
||||||
|
"y": -50,
|
||||||
|
"width": 1000,
|
||||||
|
"height": 600,
|
||||||
|
"label": "Project Overview",
|
||||||
|
"color": "4"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Edges
|
||||||
|
|
||||||
|
Edges connect nodes via `fromNode` and `toNode` IDs.
|
||||||
|
|
||||||
|
| Attribute | Required | Type | Default | Description |
|
||||||
|
|-----------|----------|------|---------|-------------|
|
||||||
|
| `id` | Yes | string | - | Unique identifier |
|
||||||
|
| `fromNode` | Yes | string | - | Source node ID |
|
||||||
|
| `fromSide` | No | string | - | `top`, `right`, `bottom`, or `left` |
|
||||||
|
| `fromEnd` | No | string | `none` | `none` or `arrow` |
|
||||||
|
| `toNode` | Yes | string | - | Target node ID |
|
||||||
|
| `toSide` | No | string | - | `top`, `right`, `bottom`, or `left` |
|
||||||
|
| `toEnd` | No | string | `arrow` | `none` or `arrow` |
|
||||||
|
| `color` | No | canvasColor | - | Line color |
|
||||||
|
| `label` | No | string | - | Text label |
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"id": "0123456789abcdef",
|
||||||
|
"fromNode": "6f0ad84f44ce9c17",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "a1b2c3d4e5f67890",
|
||||||
|
"toSide": "left",
|
||||||
|
"toEnd": "arrow",
|
||||||
|
"label": "leads to"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Colors
|
||||||
|
|
||||||
|
The `canvasColor` type accepts either a hex string or a preset number:
|
||||||
|
|
||||||
|
| Preset | Color |
|
||||||
|
|--------|-------|
|
||||||
|
| `"1"` | Red |
|
||||||
|
| `"2"` | Orange |
|
||||||
|
| `"3"` | Yellow |
|
||||||
|
| `"4"` | Green |
|
||||||
|
| `"5"` | Cyan |
|
||||||
|
| `"6"` | Purple |
|
||||||
|
|
||||||
|
Preset color values are intentionally undefined -- applications use their own brand colors.
|
||||||
|
|
||||||
|
## ID Generation
|
||||||
|
|
||||||
|
Generate 16-character lowercase hexadecimal strings (64-bit random value):
|
||||||
|
|
||||||
|
```
|
||||||
|
"6f0ad84f44ce9c17"
|
||||||
|
"a3b2c1d0e9f8a7b6"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Layout Guidelines
|
||||||
|
|
||||||
|
- Coordinates can be negative (canvas extends infinitely)
|
||||||
|
- `x` increases right, `y` increases down; position is the top-left corner
|
||||||
|
- Space nodes 50-100px apart; leave 20-50px padding inside groups
|
||||||
|
- Align to grid (multiples of 10 or 20) for cleaner layouts
|
||||||
|
|
||||||
|
| Node Type | Suggested Width | Suggested Height |
|
||||||
|
|-----------|-----------------|------------------|
|
||||||
|
| Small text | 200-300 | 80-150 |
|
||||||
|
| Medium text | 300-450 | 150-300 |
|
||||||
|
| Large text | 400-600 | 300-500 |
|
||||||
|
| File preview | 300-500 | 200-400 |
|
||||||
|
| Link preview | 250-400 | 100-200 |
|
||||||
|
|
||||||
|
## Validation Checklist
|
||||||
|
|
||||||
|
After creating or editing a canvas file, verify:
|
||||||
|
|
||||||
|
1. All `id` values are unique across both nodes and edges
|
||||||
|
2. Every `fromNode` and `toNode` references an existing node ID
|
||||||
|
3. Required fields are present for each node type (`text` for text nodes, `file` for file nodes, `url` for link nodes)
|
||||||
|
4. `type` is one of: `text`, `file`, `link`, `group`
|
||||||
|
5. `fromSide`/`toSide` values are one of: `top`, `right`, `bottom`, `left`
|
||||||
|
6. `fromEnd`/`toEnd` values are one of: `none`, `arrow`
|
||||||
|
7. Color presets are `"1"` through `"6"` or valid hex (e.g., `"#FF0000"`)
|
||||||
|
8. JSON is valid and parseable
|
||||||
|
|
||||||
|
If validation fails, check for duplicate IDs, dangling edge references, or malformed JSON strings (especially unescaped newlines in text content).
|
||||||
|
|
||||||
|
## Complete Examples
|
||||||
|
|
||||||
|
See [references/EXAMPLES.md](references/EXAMPLES.md) for full canvas examples including mind maps, project boards, research canvases, and flowcharts.
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [JSON Canvas Spec 1.0](https://jsoncanvas.org/spec/1.0/)
|
||||||
|
- [JSON Canvas GitHub](https://github.com/obsidianmd/jsoncanvas)
|
||||||
@@ -0,0 +1,329 @@
|
|||||||
|
# JSON Canvas Complete Examples
|
||||||
|
|
||||||
|
## Simple Canvas with Text and Connections
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"nodes": [
|
||||||
|
{
|
||||||
|
"id": "8a9b0c1d2e3f4a5b",
|
||||||
|
"type": "text",
|
||||||
|
"x": 0,
|
||||||
|
"y": 0,
|
||||||
|
"width": 300,
|
||||||
|
"height": 150,
|
||||||
|
"text": "# Main Idea\n\nThis is the central concept."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "1a2b3c4d5e6f7a8b",
|
||||||
|
"type": "text",
|
||||||
|
"x": 400,
|
||||||
|
"y": -100,
|
||||||
|
"width": 250,
|
||||||
|
"height": 100,
|
||||||
|
"text": "## Supporting Point A\n\nDetails here."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "2b3c4d5e6f7a8b9c",
|
||||||
|
"type": "text",
|
||||||
|
"x": 400,
|
||||||
|
"y": 100,
|
||||||
|
"width": 250,
|
||||||
|
"height": 100,
|
||||||
|
"text": "## Supporting Point B\n\nMore details."
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"edges": [
|
||||||
|
{
|
||||||
|
"id": "3c4d5e6f7a8b9c0d",
|
||||||
|
"fromNode": "8a9b0c1d2e3f4a5b",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "1a2b3c4d5e6f7a8b",
|
||||||
|
"toSide": "left"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "4d5e6f7a8b9c0d1e",
|
||||||
|
"fromNode": "8a9b0c1d2e3f4a5b",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "2b3c4d5e6f7a8b9c",
|
||||||
|
"toSide": "left"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Project Board with Groups
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"nodes": [
|
||||||
|
{
|
||||||
|
"id": "5e6f7a8b9c0d1e2f",
|
||||||
|
"type": "group",
|
||||||
|
"x": 0,
|
||||||
|
"y": 0,
|
||||||
|
"width": 300,
|
||||||
|
"height": 500,
|
||||||
|
"label": "To Do",
|
||||||
|
"color": "1"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "6f7a8b9c0d1e2f3a",
|
||||||
|
"type": "group",
|
||||||
|
"x": 350,
|
||||||
|
"y": 0,
|
||||||
|
"width": 300,
|
||||||
|
"height": 500,
|
||||||
|
"label": "In Progress",
|
||||||
|
"color": "3"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "7a8b9c0d1e2f3a4b",
|
||||||
|
"type": "group",
|
||||||
|
"x": 700,
|
||||||
|
"y": 0,
|
||||||
|
"width": 300,
|
||||||
|
"height": 500,
|
||||||
|
"label": "Done",
|
||||||
|
"color": "4"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "8b9c0d1e2f3a4b5c",
|
||||||
|
"type": "text",
|
||||||
|
"x": 20,
|
||||||
|
"y": 50,
|
||||||
|
"width": 260,
|
||||||
|
"height": 80,
|
||||||
|
"text": "## Task 1\n\nImplement feature X"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "9c0d1e2f3a4b5c6d",
|
||||||
|
"type": "text",
|
||||||
|
"x": 370,
|
||||||
|
"y": 50,
|
||||||
|
"width": 260,
|
||||||
|
"height": 80,
|
||||||
|
"text": "## Task 2\n\nReview PR #123",
|
||||||
|
"color": "2"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "0d1e2f3a4b5c6d7e",
|
||||||
|
"type": "text",
|
||||||
|
"x": 720,
|
||||||
|
"y": 50,
|
||||||
|
"width": 260,
|
||||||
|
"height": 80,
|
||||||
|
"text": "## Task 3\n\n~~Setup CI/CD~~"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"edges": []
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Research Canvas with Files and Links
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"nodes": [
|
||||||
|
{
|
||||||
|
"id": "1e2f3a4b5c6d7e8f",
|
||||||
|
"type": "text",
|
||||||
|
"x": 300,
|
||||||
|
"y": 200,
|
||||||
|
"width": 400,
|
||||||
|
"height": 200,
|
||||||
|
"text": "# Research Topic\n\n## Key Questions\n\n- How does X affect Y?\n- What are the implications?",
|
||||||
|
"color": "5"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "2f3a4b5c6d7e8f9a",
|
||||||
|
"type": "file",
|
||||||
|
"x": 0,
|
||||||
|
"y": 0,
|
||||||
|
"width": 250,
|
||||||
|
"height": 150,
|
||||||
|
"file": "Literature/Paper A.pdf"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "3a4b5c6d7e8f9a0b",
|
||||||
|
"type": "file",
|
||||||
|
"x": 0,
|
||||||
|
"y": 200,
|
||||||
|
"width": 250,
|
||||||
|
"height": 150,
|
||||||
|
"file": "Notes/Meeting Notes.md",
|
||||||
|
"subpath": "#Key Insights"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "4b5c6d7e8f9a0b1c",
|
||||||
|
"type": "link",
|
||||||
|
"x": 0,
|
||||||
|
"y": 400,
|
||||||
|
"width": 250,
|
||||||
|
"height": 100,
|
||||||
|
"url": "https://example.com/research"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "5c6d7e8f9a0b1c2d",
|
||||||
|
"type": "file",
|
||||||
|
"x": 750,
|
||||||
|
"y": 150,
|
||||||
|
"width": 300,
|
||||||
|
"height": 250,
|
||||||
|
"file": "Attachments/diagram.png"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"edges": [
|
||||||
|
{
|
||||||
|
"id": "6d7e8f9a0b1c2d3e",
|
||||||
|
"fromNode": "2f3a4b5c6d7e8f9a",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "1e2f3a4b5c6d7e8f",
|
||||||
|
"toSide": "left",
|
||||||
|
"label": "supports"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "7e8f9a0b1c2d3e4f",
|
||||||
|
"fromNode": "3a4b5c6d7e8f9a0b",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "1e2f3a4b5c6d7e8f",
|
||||||
|
"toSide": "left",
|
||||||
|
"label": "informs"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "8f9a0b1c2d3e4f5a",
|
||||||
|
"fromNode": "4b5c6d7e8f9a0b1c",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "1e2f3a4b5c6d7e8f",
|
||||||
|
"toSide": "left",
|
||||||
|
"toEnd": "arrow",
|
||||||
|
"color": "6"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "9a0b1c2d3e4f5a6b",
|
||||||
|
"fromNode": "1e2f3a4b5c6d7e8f",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "5c6d7e8f9a0b1c2d",
|
||||||
|
"toSide": "left",
|
||||||
|
"label": "visualized by"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Flowchart
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"nodes": [
|
||||||
|
{
|
||||||
|
"id": "a0b1c2d3e4f5a6b7",
|
||||||
|
"type": "text",
|
||||||
|
"x": 200,
|
||||||
|
"y": 0,
|
||||||
|
"width": 150,
|
||||||
|
"height": 60,
|
||||||
|
"text": "**Start**",
|
||||||
|
"color": "4"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "b1c2d3e4f5a6b7c8",
|
||||||
|
"type": "text",
|
||||||
|
"x": 200,
|
||||||
|
"y": 100,
|
||||||
|
"width": 150,
|
||||||
|
"height": 60,
|
||||||
|
"text": "Step 1:\nGather data"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "c2d3e4f5a6b7c8d9",
|
||||||
|
"type": "text",
|
||||||
|
"x": 200,
|
||||||
|
"y": 200,
|
||||||
|
"width": 150,
|
||||||
|
"height": 80,
|
||||||
|
"text": "**Decision**\n\nIs data valid?",
|
||||||
|
"color": "3"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "d3e4f5a6b7c8d9e0",
|
||||||
|
"type": "text",
|
||||||
|
"x": 400,
|
||||||
|
"y": 200,
|
||||||
|
"width": 150,
|
||||||
|
"height": 60,
|
||||||
|
"text": "Process data"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "e4f5a6b7c8d9e0f1",
|
||||||
|
"type": "text",
|
||||||
|
"x": 0,
|
||||||
|
"y": 200,
|
||||||
|
"width": 150,
|
||||||
|
"height": 60,
|
||||||
|
"text": "Request new data",
|
||||||
|
"color": "1"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "f5a6b7c8d9e0f1a2",
|
||||||
|
"type": "text",
|
||||||
|
"x": 400,
|
||||||
|
"y": 320,
|
||||||
|
"width": 150,
|
||||||
|
"height": 60,
|
||||||
|
"text": "**End**",
|
||||||
|
"color": "4"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"edges": [
|
||||||
|
{
|
||||||
|
"id": "a6b7c8d9e0f1a2b3",
|
||||||
|
"fromNode": "a0b1c2d3e4f5a6b7",
|
||||||
|
"fromSide": "bottom",
|
||||||
|
"toNode": "b1c2d3e4f5a6b7c8",
|
||||||
|
"toSide": "top"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "b7c8d9e0f1a2b3c4",
|
||||||
|
"fromNode": "b1c2d3e4f5a6b7c8",
|
||||||
|
"fromSide": "bottom",
|
||||||
|
"toNode": "c2d3e4f5a6b7c8d9",
|
||||||
|
"toSide": "top"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "c8d9e0f1a2b3c4d5",
|
||||||
|
"fromNode": "c2d3e4f5a6b7c8d9",
|
||||||
|
"fromSide": "right",
|
||||||
|
"toNode": "d3e4f5a6b7c8d9e0",
|
||||||
|
"toSide": "left",
|
||||||
|
"label": "Yes",
|
||||||
|
"color": "4"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "d9e0f1a2b3c4d5e6",
|
||||||
|
"fromNode": "c2d3e4f5a6b7c8d9",
|
||||||
|
"fromSide": "left",
|
||||||
|
"toNode": "e4f5a6b7c8d9e0f1",
|
||||||
|
"toSide": "right",
|
||||||
|
"label": "No",
|
||||||
|
"color": "1"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "e0f1a2b3c4d5e6f7",
|
||||||
|
"fromNode": "e4f5a6b7c8d9e0f1",
|
||||||
|
"fromSide": "top",
|
||||||
|
"fromEnd": "none",
|
||||||
|
"toNode": "b1c2d3e4f5a6b7c8",
|
||||||
|
"toSide": "left",
|
||||||
|
"toEnd": "arrow"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "f1a2b3c4d5e6f7a8",
|
||||||
|
"fromNode": "d3e4f5a6b7c8d9e0",
|
||||||
|
"fromSide": "bottom",
|
||||||
|
"toNode": "f5a6b7c8d9e0f1a2",
|
||||||
|
"toSide": "top"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
+11
-2
@@ -1,2 +1,11 @@
|
|||||||
# Referenz-Codebase nicht in das Wireframe-Repo pushen.
|
# Lokaler Obsidian UI-/Tab-Zustand.
|
||||||
hivegrid-cloud/
|
.obsidian/workspace.json
|
||||||
|
.obsidian/graph.json
|
||||||
|
|
||||||
|
# Temporaere lokale Preview-Labs fuer Brainstorming.
|
||||||
|
# Wenn eine Preview dauerhaft gebraucht wird, liegt eine versionierte Kopie beim passenden Ticket.
|
||||||
|
99 Temp/
|
||||||
|
|
||||||
|
# Lokale System-/Dependency-Dateien nicht ins Wireframe-Repo uebernehmen.
|
||||||
|
.DS_Store
|
||||||
|
node_modules/
|
||||||
Vendored
-237
@@ -1,237 +0,0 @@
|
|||||||
{
|
|
||||||
"main": {
|
|
||||||
"id": "b741307f012c6c82",
|
|
||||||
"type": "split",
|
|
||||||
"children": [
|
|
||||||
{
|
|
||||||
"id": "3191879d32e51458",
|
|
||||||
"type": "tabs",
|
|
||||||
"children": [
|
|
||||||
{
|
|
||||||
"id": "716943f64774c290",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "canvas",
|
|
||||||
"state": {
|
|
||||||
"file": "02 Wireframes/P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas",
|
|
||||||
"viewState": {
|
|
||||||
"x": 893.2958606826328,
|
|
||||||
"y": 1014.1714018415311,
|
|
||||||
"zoom": -0.35771249981815517
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"icon": "lucide-layout-dashboard",
|
|
||||||
"title": "WF-P2 Admin RBAC"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"direction": "vertical"
|
|
||||||
},
|
|
||||||
"left": {
|
|
||||||
"id": "c60ac6c168fcc346",
|
|
||||||
"type": "split",
|
|
||||||
"children": [
|
|
||||||
{
|
|
||||||
"id": "619cad1e354c5111",
|
|
||||||
"type": "tabs",
|
|
||||||
"children": [
|
|
||||||
{
|
|
||||||
"id": "641e6094f7934e28",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "file-explorer",
|
|
||||||
"state": {
|
|
||||||
"sortOrder": "alphabetical",
|
|
||||||
"autoReveal": false
|
|
||||||
},
|
|
||||||
"icon": "lucide-folder-closed",
|
|
||||||
"title": "Files"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"id": "1c5acae913f15f67",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "search",
|
|
||||||
"state": {
|
|
||||||
"query": "",
|
|
||||||
"matchingCase": false,
|
|
||||||
"explainSearch": false,
|
|
||||||
"collapseAll": false,
|
|
||||||
"extraContext": false,
|
|
||||||
"sortOrder": "alphabetical"
|
|
||||||
},
|
|
||||||
"icon": "lucide-search",
|
|
||||||
"title": "Search"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"id": "5e3db645e8d39109",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "bookmarks",
|
|
||||||
"state": {},
|
|
||||||
"icon": "lucide-bookmark",
|
|
||||||
"title": "Bookmarks"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"direction": "horizontal",
|
|
||||||
"width": 300
|
|
||||||
},
|
|
||||||
"right": {
|
|
||||||
"id": "9a2b29e007036e47",
|
|
||||||
"type": "split",
|
|
||||||
"children": [
|
|
||||||
{
|
|
||||||
"id": "d3ee1dedc0dff4c8",
|
|
||||||
"type": "tabs",
|
|
||||||
"children": [
|
|
||||||
{
|
|
||||||
"id": "de35e85ca527f8f4",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "backlink",
|
|
||||||
"state": {
|
|
||||||
"file": "02 Wireframes/_Templates/Wireframe Paket Template.md",
|
|
||||||
"collapseAll": false,
|
|
||||||
"extraContext": false,
|
|
||||||
"sortOrder": "alphabetical",
|
|
||||||
"showSearch": false,
|
|
||||||
"searchQuery": "",
|
|
||||||
"backlinkCollapsed": false,
|
|
||||||
"unlinkedCollapsed": true
|
|
||||||
},
|
|
||||||
"icon": "links-coming-in",
|
|
||||||
"title": "Backlinks for Wireframe Paket Template"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"id": "829c4eac50f34830",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "outgoing-link",
|
|
||||||
"state": {
|
|
||||||
"file": "02 Wireframes/_Templates/Wireframe Paket Template.md",
|
|
||||||
"linksCollapsed": false,
|
|
||||||
"unlinkedCollapsed": true
|
|
||||||
},
|
|
||||||
"icon": "links-going-out",
|
|
||||||
"title": "Outgoing links from Wireframe Paket Template"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"id": "24f2b9ae0b1c593f",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "tag",
|
|
||||||
"state": {
|
|
||||||
"sortOrder": "frequency",
|
|
||||||
"useHierarchy": true,
|
|
||||||
"showSearch": false,
|
|
||||||
"searchQuery": ""
|
|
||||||
},
|
|
||||||
"icon": "lucide-tags",
|
|
||||||
"title": "Tags"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"id": "9d900d312445f8dc",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "all-properties",
|
|
||||||
"state": {
|
|
||||||
"sortOrder": "frequency",
|
|
||||||
"showSearch": false,
|
|
||||||
"searchQuery": ""
|
|
||||||
},
|
|
||||||
"icon": "lucide-archive",
|
|
||||||
"title": "All properties"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"id": "2bb50056cef4b029",
|
|
||||||
"type": "leaf",
|
|
||||||
"state": {
|
|
||||||
"type": "outline",
|
|
||||||
"state": {
|
|
||||||
"file": "02 Wireframes/_Templates/Wireframe Paket Template.md",
|
|
||||||
"followCursor": false,
|
|
||||||
"showSearch": false,
|
|
||||||
"searchQuery": ""
|
|
||||||
},
|
|
||||||
"icon": "lucide-list",
|
|
||||||
"title": "Outline of Wireframe Paket Template"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"direction": "horizontal",
|
|
||||||
"width": 300,
|
|
||||||
"collapsed": true
|
|
||||||
},
|
|
||||||
"left-ribbon": {
|
|
||||||
"hiddenItems": {
|
|
||||||
"switcher:Open quick switcher": false,
|
|
||||||
"graph:Open graph view": false,
|
|
||||||
"canvas:Create new canvas": false,
|
|
||||||
"daily-notes:Open today's daily note": false,
|
|
||||||
"templates:Insert template": false,
|
|
||||||
"command-palette:Open command palette": false,
|
|
||||||
"bases:Create new base": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"active": "716943f64774c290",
|
|
||||||
"lastOpenFiles": [
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Login und 2FA/WF-P2 Login und 2FA.canvas",
|
|
||||||
"02 Wireframes/Screen Paket Tracker.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Signup/WF-P2 Signup.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Passwort Reset/WF-P2 Passwort Reset.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Passwort Reset/Screens/M02 Wiederherstellungscode eingeben.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Passwort Reset/Screens/M01 Admin kontaktieren.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Passwort Reset/Screens/S01 Passwort Reset anfordern.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Set Password/WF-P2 Set Password.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Workspace Auswahl/WF-P2 Workspace Auswahl.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Profil und Sicherheit/WF-P2 Profil und Sicherheit.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Signup/Screens/S03 E-Mail bestaetigen.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Signup/Screens/S02 Signup erfolgreich Workspace wird vorbereitet.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Signup/Screens/S01 Signup.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Workspace Auswahl/WF-P2 Workspace Auswahl.md",
|
|
||||||
"01 Regeln/Wireframing Playbook.md",
|
|
||||||
"01 Regeln/Obsidian Struktur.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/V01 Letzter Admin blockiert.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/D03 Rolle in Nutzung blockiert.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M02 Rolle erstellen bearbeiten.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/S02 Rollen und Berechtigungen.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M03 Mitarbeiter deaktivieren.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/D01 Rollen-Dropdown in Mitarbeiterliste.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M01 Mitarbeiter einladen.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/S01 Mitarbeiterliste.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Profil und Sicherheit/WF-P2 Profil und Sicherheit.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens/M01 Loeschung anfragen.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Profil und Sicherheit/Screens/S01 Profil Settings.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Screens/M03 2FA deaktivieren.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Screens/M02 Device Token hinzufuegen.md",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Change Password/WF-P2 Change Password.canvas",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Varianten",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Varianten",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Varianten",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Screens",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Change Password/Varianten",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Change Password/Screens",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Profil und Sicherheit/Varianten",
|
|
||||||
"02 Wireframes/P2 Auth/WF-P2 Profil und Sicherheit/Screens"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
+3
-1
@@ -15,7 +15,9 @@ Ziel: Alle Wireframe-Regeln, Pakete, Screen-Notizen, Banner, Toasts, Zustaende u
|
|||||||
| [[02 Wireframes/Screen Paket Tracker]] | Zentrale Kontrolltabelle fuer alle Flows, Screens, Canvas- und Subframe-Links. |
|
| [[02 Wireframes/Screen Paket Tracker]] | Zentrale Kontrolltabelle fuer alle Flows, Screens, Canvas- und Subframe-Links. |
|
||||||
| [[02 Wireframes/_Templates/Wireframe Paket Template]] | Vorlage fuer ein neues Wireframe-Paket. |
|
| [[02 Wireframes/_Templates/Wireframe Paket Template]] | Vorlage fuer ein neues Wireframe-Paket. |
|
||||||
| [[02 Wireframes/_Templates/Screen Template]] | Vorlage fuer eine einzelne Screen-Datei. |
|
| [[02 Wireframes/_Templates/Screen Template]] | Vorlage fuer eine einzelne Screen-Datei. |
|
||||||
| [[03 Quellen und Repo/Repo Notizen]] | Wo das Gitea-Repo liegt und wie du die Planning-Dateien aktualisierst. |
|
| [[03 Quellen und Referenzen/README]] | Quellen, Referenz-Repos und Repo-Hinweise. |
|
||||||
|
| [[04 Standards/README]] | UI-, Layout- und Subframe-Standards. |
|
||||||
|
| [[Tickets/README]] | Fertige Ticket-Handoffs und Ticket-Index. |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -18,8 +18,11 @@ Dieser Vault ist der Arbeitsbereich fuer Screens, Wireframes und Handoffs.
|
|||||||
| `01 Regeln` | dauerhafte Regeln und Arbeitsweisen |
|
| `01 Regeln` | dauerhafte Regeln und Arbeitsweisen |
|
||||||
| `02 Wireframes` | alle Wireframe-Pakete, Screen-Dateien und Canvas-Dateien |
|
| `02 Wireframes` | alle Wireframe-Pakete, Screen-Dateien und Canvas-Dateien |
|
||||||
| `02 Wireframes/_Templates` | Vorlagen fuer neue Pakete und Screens |
|
| `02 Wireframes/_Templates` | Vorlagen fuer neue Pakete und Screens |
|
||||||
| `03 Quellen und Repo` | Hinweise zum Gitea-Repo und lokalen Planning-Dateien |
|
| `03 Quellen und Referenzen` | Quellen, Referenz-Repos und Repo-Hinweise |
|
||||||
| `hivegrid-cloud` | technisches Repo mit Planning-Quellen |
|
| `03 Quellen und Referenzen/hivegrid-cloud` | mitgepushte HiveGrid-Cloud-Referenz mit Planning-Quellen |
|
||||||
|
| `04 Standards/Subframe UI Standards` | eigenes Standards-Projekt fuer dauerhafte Subframe-, Komponenten- und Layout-Standards |
|
||||||
|
| `Tickets` | Ticket-Handoff-Index |
|
||||||
|
| `Tickets/Fertige Tickets` | fertige oder handofffaehige Ticket-Zusammenfassungen |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -139,12 +142,26 @@ Qualitaetsregel:
|
|||||||
- kurze Kantenlabels mit genug Abstand
|
- kurze Kantenlabels mit genug Abstand
|
||||||
- Canvas nach dem Erstellen mit JSON-Check pruefen
|
- Canvas nach dem Erstellen mit JSON-Check pruefen
|
||||||
|
|
||||||
|
Sync-Regel:
|
||||||
|
|
||||||
|
- Jeder echte Screen braucht einen Canvas-Node.
|
||||||
|
- Wenn ein Screen umbenannt, gesplittet, geloescht oder neu angelegt wird, muessen Canvas, Screen-Datei, Paket-MD und `Screen Paket Tracker` im selben Arbeitsschritt abgeglichen werden.
|
||||||
|
- Wenn aus einer Variante ein eigener Screen wird, braucht sie einen eigenen Canvas-Node und eine eigene Tracker-Zeile.
|
||||||
|
- Ohne Davids Freigabe wird ein geplanter Split nur dokumentiert, aber nicht als neuer Subframe-Screen gebaut.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Subframe-Schutz
|
## Subframe-Schutz
|
||||||
|
|
||||||
Subframe wird nicht automatisch aus dem Tracker heraus bearbeitet.
|
Subframe wird nicht automatisch aus dem Tracker heraus bearbeitet.
|
||||||
|
|
||||||
|
Die Subframe UI Standards unter `04 Standards/Subframe UI Standards/` sind ebenfalls geschuetzt:
|
||||||
|
|
||||||
|
- Sie sind ein eigenes Standards-Projekt innerhalb dieses Repos.
|
||||||
|
- Sie werden als Referenz fuer Layout-, Komponenten- und Subframe-Konventionen genutzt.
|
||||||
|
- Sie duerfen nicht durch normale Screen-/Flow-Arbeit automatisch umgeschrieben werden.
|
||||||
|
- Aenderungen brauchen eine explizite Aufgabe oder eine vorher validierte systemweite Entscheidung.
|
||||||
|
|
||||||
Regel:
|
Regel:
|
||||||
|
|
||||||
- Bestehende Subframe-Screens bleiben unberuehrt, auch wenn sie gleich heissen.
|
- Bestehende Subframe-Screens bleiben unberuehrt, auch wenn sie gleich heissen.
|
||||||
|
|||||||
@@ -0,0 +1,480 @@
|
|||||||
|
---
|
||||||
|
kind: brainstorm
|
||||||
|
project: HiveGrid Screen Project
|
||||||
|
area: Agent Workflow
|
||||||
|
status: draft
|
||||||
|
validated: false
|
||||||
|
---
|
||||||
|
|
||||||
|
# Screen Agent Workflow - Brainstorming
|
||||||
|
|
||||||
|
Status: Draft / nicht validiert.
|
||||||
|
|
||||||
|
Diese Datei sammelt Ideen fuer die spaetere Agent-Arbeitsanweisung. Sie ist noch kein Regelwerk. Nichts aus dieser Datei gilt final, bis David die Inhalte validiert hat.
|
||||||
|
|
||||||
|
Ziel: klaeren, wie ein AI-Agent mit David an Wireframes, Flows, Screens, Canvas, Tracker und Subframe arbeiten soll.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Offene Brainstorming-Frage
|
||||||
|
|
||||||
|
Wie soll der Agent arbeiten, damit Screen-/Flow-Arbeit strukturiert, nachvollziehbar und synchron bleibt, ohne zu frueh etwas final zu bauen oder zu dokumentieren?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## BMAD-kompakt fuer Screen-Arbeit
|
||||||
|
|
||||||
|
Noch nicht validierter Arbeitsrahmen:
|
||||||
|
|
||||||
|
| Phase | Arbeitsname | Zweck | Status |
|
||||||
|
|---|---|---|---|
|
||||||
|
| B | Brief | Kontext, Ziel, Grenzen und relevante Quellen klaeren | Draft |
|
||||||
|
| M | Map | Flow, Varianten, States, Risiken und offene Entscheidungen sichtbar machen | Draft |
|
||||||
|
| A | Align | David entscheidet und validiert einzeln | Draft |
|
||||||
|
| D | Document | Nur validierte Entscheidungen synchron dokumentieren | Draft |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Validierte Richtung
|
||||||
|
|
||||||
|
| Thema | Entscheidung | Status |
|
||||||
|
|---|---|---|
|
||||||
|
| Research-Reihenfolge | Erst internes Planning/Tickets/Bestand lesen, danach gezielt externe Referenzen recherchieren, wenn offene Fragen bleiben oder der Screen es braucht. | von David validiert |
|
||||||
|
| Error-State-Verortung | Erst zentrale Error-State-Kandidatenliste im Flow-Brainstorming, danach validierte Error States bei den betroffenen Screens eintragen. | von David validiert |
|
||||||
|
| Error-State-Umsetzung | Error States werden standardmaessig dokumentiert, nicht als eigene Screens gebaut; Ausnahme nur, wenn der Error State fachlich extrem wichtig/blockierend/copy-kritisch ist. | von David validiert |
|
||||||
|
| Impact-Check bei neuem Screen/Flow | Wenn eine Aenderung vermutlich einen neuen Screen oder Flow braucht, startet der Agent einen Mini-Brainstorm mit Begruendung, Varianten und Empfehlung; erst danach entscheidet David. | von David validiert |
|
||||||
|
| Dependency-Check | Bei jedem Flow wird eine feste kurze Dependency-Liste geprueft, damit Verknuepfungen zu bestehenden Flows, zentralen Flows, Rollen/Sichtbarkeit, Error States, Canvas und Tracker sichtbar bleiben. | von David validiert |
|
||||||
|
| Planning vs. externe Referenz | Internes Planning bleibt Default. Wenn externe Referenzen ein klar besseres oder ueblicheres Pattern zeigen, muss der Agent den Widerspruch sichtbar machen und David entscheiden lassen. | von David validiert |
|
||||||
|
| Backlog | Agent sammelt aktiv Backlog-Kandidaten, aber nichts wird final als Backlog markiert, bevor David es validiert. | von David validiert |
|
||||||
|
| Subframe-Bau | Subframe wird nur nach explizitem OK fuer einen konkreten Screen oder Flow genutzt; davor bleibt die Arbeit in Obsidian. | von David validiert |
|
||||||
|
| Struktur-Sync | Jede strukturelle Aenderung wird sofort synchronisiert: Rename, Split, neuer Screen, geloeschter Screen, neuer Flow, Statuswechsel. | von David validiert |
|
||||||
|
| Commit/Push | Agent fragt vor Commit kurz nach, ausser David hat explizit gesagt, dass gemacht und gepusht werden soll. | von David validiert |
|
||||||
|
| Fragenstil | Agent gibt zuerst eigene Annahme und Empfehlung, dann eine gezielte Entscheidungsfrage. | von David validiert |
|
||||||
|
| Benennung | Agent unterscheidet Arbeitsnamen und strukturelle finale Namen. Sinnvolle Arbeitsnamen duerfen bleiben; wenn der Name strukturell wichtig oder unsicher ist, muss David validieren. | von David validiert |
|
||||||
|
| Bestand pruefen | Vor neuen Flows/Screens prueft der Agent aehnliche bestehende Flows, vorhandene Screens, wiederverwendbare Patterns und moegliche Konflikte. | von David validiert |
|
||||||
|
| Research-Ergebnisse | Research dient als Entscheidungsgrundlage. Relevante Ableitungen daraus muessen mit David abgestimmt und validiert werden, bevor sie in die Planung eingehen. | von David validiert |
|
||||||
|
| Detaillierungsgrad | Brainstorming darf ausfuehrlicher sein; finale Flow-/Screen-MDs bleiben kompakt und entscheidungsorientiert. | von David validiert |
|
||||||
|
| Scope-Fragen | Agent darf Scope-Erweiterungen aktiv vorschlagen, muss sie aber klar als Scope-Kandidat markieren und von David validieren lassen. | von David validiert |
|
||||||
|
| Screens vs. States | Canvas zeigt nur echte Screens, Modals oder Versionen davon. Toasts, Banner und reine Dokumentationsstates werden nicht als Canvas-Screen gebaut, muessen aber von David validiert und dokumentiert werden. | von David validiert |
|
||||||
|
| UX-Handoff | Agent plant keine Backend-Implementierung, nimmt aber UX-Verhalten, sichtbare Daten, Aktionen, Permissions, States und Flow-Logik vorweg und dokumentiert sie nach Davids Validierung. | von David validiert |
|
||||||
|
| Rollen/Permissions | Standardannahme ist Admin-Ansicht. Rollen/Permissions werden kurz geprueft, aber nur bei offensichtlicher Relevanz dokumentiert oder als offen/Backlog markiert. | von David validiert |
|
||||||
|
| Komponenten/Designsystem | Agent prueft vorhandene Komponenten/Patterns und richtet Screen-Dokumentation daran aus; unbekannte Komponenten werden als offene Komponentenfrage markiert. | von David validiert |
|
||||||
|
| Canvas-Lesbarkeit | Canvas ist Teil des Handoffs. Nodes und Kanten muessen lesbar, gruppiert und nachvollziehbar sein; nach strukturellen Aenderungen pruefen. | von David validiert |
|
||||||
|
| Subframe nach David-Aenderungen | Agent liest genannten Screen, fasst die fachliche Aenderung zusammen, macht Impact-Check auf direkt betroffene Screens/Flows und fragt vor weiteren Aenderungen nach. | von David validiert |
|
||||||
|
| Finale Datei | Brainstorming-Datei bleibt Herleitung/Archiv; finale Datei wird eine operative Checkliste fuer Agents. | von David validiert |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Zu klaerende Punkte
|
||||||
|
|
||||||
|
Diese Fragen muessen gemeinsam entschieden werden:
|
||||||
|
|
||||||
|
1. Wie aktiv soll der Agent fuehren?
|
||||||
|
2. Wann soll der Agent stoppen und David entscheiden lassen?
|
||||||
|
3. Welche Fragen muss der Agent immer stellen?
|
||||||
|
4. Was darf der Agent eigenstaendig dokumentieren?
|
||||||
|
5. Was darf der Agent niemals ohne Freigabe tun?
|
||||||
|
6. Wie werden offene Entscheidungen und Backlog-Punkte markiert?
|
||||||
|
7. Wann wird Subframe genutzt?
|
||||||
|
8. Wann wird committed und gepusht?
|
||||||
|
9. Wie wird verhindert, dass Canvas, Tracker, Screen-Dateien und Paket-MD auseinanderlaufen?
|
||||||
|
10. Wie kompakt soll die finale Agent-Anweisung sein?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Research: Prompt-/Context-Engineering fuer finale Agent-Datei
|
||||||
|
|
||||||
|
Status: Research-Notiz / noch nicht final validiert.
|
||||||
|
|
||||||
|
Quellenrichtung:
|
||||||
|
|
||||||
|
- OpenAI empfiehlt klare Instruktionen am Anfang, Trennung von Instruktion und Kontext sowie konkrete Ausgabe-/Formatvorgaben.
|
||||||
|
- OpenAI GPT-5.x Prompt Guidance betont outcome-first Prompts, explizite Validation Rules, Tool-/Workflow-Erwartungen und klare Definition, wann eine Aufgabe fertig ist.
|
||||||
|
- Anthropic betont klare, strukturierte Prompts, explizite Tool-Nutzung, XML/strukturierte Abschnitte und Context Engineering fuer laenger laufende Agents.
|
||||||
|
- Anthropic Constitutional-AI-Arbeiten zeigen als allgemeines Muster, dass schriftliche Prinzipien/Regeln Verhalten steuern koennen; fuer uns bedeutet das: die finale Datei muss wie eine kleine Arbeitsverfassung funktionieren, nicht wie lose Notizen.
|
||||||
|
|
||||||
|
Ableitung fuer unsere finale Agent-Datei:
|
||||||
|
|
||||||
|
1. **Finale Datei darf kein Brainstorming-Mix sein**
|
||||||
|
- keine offenen Diskussionen in der operativen Datei
|
||||||
|
- nur validierte Regeln
|
||||||
|
- offene Themen separat als Backlog/Offen markieren
|
||||||
|
|
||||||
|
2. **Outcome zuerst**
|
||||||
|
- direkt am Anfang: Was soll der Agent erreichen?
|
||||||
|
- nicht zuerst lange Historie
|
||||||
|
- klarer Satz: Agent fuehrt David durch Screen-/Flow-Planung und haelt Artefakte synchron
|
||||||
|
|
||||||
|
3. **Instruktionshierarchie sichtbar machen**
|
||||||
|
- `MUST` / `NEVER` / `DEFAULT` / `WHEN` klar trennen
|
||||||
|
- harte Regeln vor optionalen Hinweisen
|
||||||
|
- keine widerspruechlichen Regeln in verschiedenen Abschnitten
|
||||||
|
|
||||||
|
4. **Fester Ablauf**
|
||||||
|
- Brief
|
||||||
|
- Map
|
||||||
|
- Align
|
||||||
|
- Document
|
||||||
|
- Sync
|
||||||
|
- After-Change Impact Check
|
||||||
|
|
||||||
|
5. **Checklisten statt Fliesstext**
|
||||||
|
- kurze Listen, die Agenten abarbeiten koennen
|
||||||
|
- klare Entscheidungspunkte
|
||||||
|
- klare Stop-Regeln
|
||||||
|
|
||||||
|
6. **Output Contracts**
|
||||||
|
- fuer Brainstorming: Optionen + Empfehlung + David-Entscheidung
|
||||||
|
- fuer Error States: Tabelle mit Ort, UI-Form/Komponente, Bauen?, Empfehlung, Entscheidung
|
||||||
|
- fuer Dependencies: kurze Checkliste
|
||||||
|
- fuer Sync: betroffene Artefakte
|
||||||
|
|
||||||
|
7. **Grenzen klar markieren**
|
||||||
|
- Subframe nur nach OK
|
||||||
|
- keine Backend-Implementierung planen
|
||||||
|
- keine Screens/Flows finalisieren ohne David
|
||||||
|
- keine fremden lokalen Aenderungen committen
|
||||||
|
|
||||||
|
8. **Beispiele sparsam einsetzen**
|
||||||
|
- ein kleines Beispiel fuer Mini-Brainstorm
|
||||||
|
- ein kleines Beispiel fuer Error-State-Tabelle
|
||||||
|
- keine langen Beispiel-Flows
|
||||||
|
|
||||||
|
9. **Finale Datei soll kurz bleiben**
|
||||||
|
- operative Datei wahrscheinlich 1.5-3 Seiten Markdown
|
||||||
|
- Brainstorming-Datei bleibt Archiv
|
||||||
|
|
||||||
|
10. **Validierungs- und Done-Kriterien**
|
||||||
|
- Agent ist erst fertig, wenn validierte Entscheidungen dokumentiert und Sync geprueft sind
|
||||||
|
- bei Unsicherheit: David fragen
|
||||||
|
- bei neuer Screen-/Flow-Vermutung: Mini-Brainstorm statt direkt bauen
|
||||||
|
|
||||||
|
Noch von David zu validieren:
|
||||||
|
|
||||||
|
- Soll die finale Datei `MUST` / `NEVER` / `DEFAULT` / `WHEN` als explizite Labels verwenden?
|
||||||
|
- Soll die finale Datei eine kurze Beispielsektion enthalten?
|
||||||
|
- Soll `BMAD` als sichtbarer Begriff bleiben oder nur als interner Ablauf genutzt werden?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notizen aus der aktuellen Arbeitsweise
|
||||||
|
|
||||||
|
- Flows werden einzeln behandelt.
|
||||||
|
- Screens werden einzeln validiert.
|
||||||
|
- Subframe darf nicht ohne konkrete Freigabe veraendert werden.
|
||||||
|
- Neue, umbenannte, geloeschte oder gesplittete Screens muessen in Paket-MD, Screen-Datei, Tracker und Canvas synchron bleiben.
|
||||||
|
- Backlog-Punkte muessen sichtbar bleiben.
|
||||||
|
- Bestehende Nutzer-Anpassungen duerfen nicht rueckgaengig gemacht werden.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input von David - Agent-Aufgabe
|
||||||
|
|
||||||
|
Status: Brainstorming / nicht final validiert.
|
||||||
|
|
||||||
|
Der Agent soll zuerst das bestehende System verstehen:
|
||||||
|
|
||||||
|
- grosses Planning und Tickets als primaere Referenz lesen
|
||||||
|
- bestehende Flow- und Screen-Pakete pruefen
|
||||||
|
- vor neuen Flows/Screens nach aehnlichen bestehenden Flows, vorhandenen Screens und wiederverwendbaren Patterns suchen
|
||||||
|
- vorhandene Komponenten/Patterns pruefen, wenn sie fuer den Screen relevant sind
|
||||||
|
- vorhandene Entscheidungen, Backlog-Punkte und Dependencies erkennen
|
||||||
|
- pruefen, ob neue Flows mit bestehenden Flows kollidieren, sie erweitern oder mit ihnen verknuepft werden muessen
|
||||||
|
- bei jedem Flow eine kurze Dependency-Liste pruefen
|
||||||
|
|
||||||
|
Der Agent soll recherchieren und Referenzen einbeziehen:
|
||||||
|
|
||||||
|
- erst internes Planning/Tickets/Bestand lesen
|
||||||
|
- danach im Internet nach vergleichbaren UI-/Flow-Beispielen suchen, wenn offene Fragen bleiben oder der Screen es braucht
|
||||||
|
- Referenzen von David aufnehmen und in die Diskussion einordnen
|
||||||
|
- herausarbeiten, was normalerweise auf so einem Screen steht
|
||||||
|
- herausarbeiten, welche Aktionen, Zustaende, Modals und Folgeflows typischerweise gebraucht werden
|
||||||
|
- internes Planning bleibt Default; externe Patterns duerfen Planning nicht stillschweigend ueberschreiben
|
||||||
|
- wenn externe Referenzen klar bessere oder ueblichere Loesungen zeigen, muss der Agent den Widerspruch sichtbar machen und David entscheiden lassen
|
||||||
|
- relevante Research-Ableitungen muessen mit David abgestimmt und validiert werden, bevor sie in die Planung uebernommen werden
|
||||||
|
|
||||||
|
Der Agent soll David aktiv durch UI-Entscheidungen fuehren:
|
||||||
|
|
||||||
|
- nachfragen, ob bestimmte Funktionen in den Screen gehoeren
|
||||||
|
- sichtbar machen, was eventuell fehlt
|
||||||
|
- Alternativen und Empfehlungen formulieren
|
||||||
|
- eigene Annahme und Empfehlung nennen, bevor eine Entscheidungsfrage gestellt wird
|
||||||
|
- kleine UI-Entscheidungen einzeln klaeren
|
||||||
|
- nicht stillschweigend finalisieren, wenn Entscheidungen offen sind
|
||||||
|
- jede Entscheidung muss von David validiert werden
|
||||||
|
- potenzielle Scope-Erweiterungen als `Scope-Kandidat` markieren und validieren lassen
|
||||||
|
- Backlog-Kandidaten aktiv vorschlagen, aber erst nach Davids Validierung final als Backlog markieren
|
||||||
|
- fuer jeden Kandidaten klar unterscheiden: Screen, Modal, Version, Inline-State, Toast, Banner oder nur Dokumentation
|
||||||
|
- Toasts, Banner und Dokumentationsstates muessen validiert werden, werden aber nicht automatisch in Canvas als eigener Screen dargestellt
|
||||||
|
|
||||||
|
Benennungsrichtung:
|
||||||
|
|
||||||
|
- Arbeitsnamen duerfen pragmatisch verwendet werden, wenn sie sinnvoll und eindeutig sind.
|
||||||
|
- Wenn ein Name Auswirkungen auf Screen-Datei, Canvas, Tracker, Subframe oder Flow-Struktur hat, muss der Agent besonders vorsichtig sein.
|
||||||
|
- Wenn der Agent unsicher ist oder mehrere Benennungen moeglich sind, fragt er David.
|
||||||
|
- Strukturrelevante Renames muessen sofort synchronisiert werden.
|
||||||
|
|
||||||
|
Der Agent soll nach Validierung dokumentieren:
|
||||||
|
|
||||||
|
- Brainstorming und Entscheidungen in Obsidian strukturieren
|
||||||
|
- Brainstorming darf ausfuehrlicher sein als finale Dateien
|
||||||
|
- finale Flow-/Screen-MDs sollen kompakt, lesbar und entscheidungsorientiert bleiben
|
||||||
|
- Screen-Kandidaten erst nach Ruecksprache ableiten
|
||||||
|
- validierte Inhalte in Paket-MD, Screen-Dateien, Tracker und Canvas synchron halten
|
||||||
|
- strukturelle Aenderungen sofort in allen betroffenen Artefakten synchronisieren: Paket-MD, Screen-Dateien, Tracker, Canvas, Subframe-Link/Flow-Verweis
|
||||||
|
- Canvas nach strukturellen Aenderungen auf Lesbarkeit, Gruppierung, Kantenlabels und nachvollziehbare Verdrahtung pruefen
|
||||||
|
- sichtbare Daten, Aktionen, Sidebar-/Tab-/Listeninhalte, Permissions, States, Flow-Logik und offene UX-/Dev-Fragen dokumentieren
|
||||||
|
- keine Backend-Implementierung festlegen, aber klar beschreiben, wie es aus Nutzersicht funktionieren soll
|
||||||
|
- vorhandene Komponenten/Patterns benennen, wenn sie fuer den Screen relevant sind
|
||||||
|
- unbekannte oder fehlende Komponenten als offene Komponentenfrage markieren
|
||||||
|
- spaetere Aenderungen von David in Obsidian oder Subframe erkennen bzw. aufnehmen und in Obsidian nachziehen
|
||||||
|
- Error States erst nach Validierung in die MD aufnehmen
|
||||||
|
- bei jeder spaeteren Screen-Aenderung pruefen, ob Error States neu entstehen, wegfallen, sich verschieben oder anders dargestellt werden muessen
|
||||||
|
- bei spaeteren Obsidian-Aenderungen von David pruefen, ob Formulierung, Struktur und betroffene Screen-Dateien konsistent sind
|
||||||
|
- bei spaeteren Subframe-Aenderungen von David die relevanten geaenderten Screens per MCP lesen, fachlich abgleichen und Obsidian nachziehen
|
||||||
|
|
||||||
|
Backlog-Richtung:
|
||||||
|
|
||||||
|
- Agent sammelt aktiv, was fuer spaeter relevant sein koennte.
|
||||||
|
- Agent markiert Backlog-Kandidaten zuerst als Kandidat/offen.
|
||||||
|
- David validiert, ob es wirklich Backlog, raus, spaeter oder direkt Teil des Scopes ist.
|
||||||
|
- Erst danach wird ein Punkt final in die Backlog-/V2-Liste uebernommen.
|
||||||
|
|
||||||
|
Commit-/Push-Richtung:
|
||||||
|
|
||||||
|
- Vor Commit kurz Rueckfrage, wenn David nicht bereits klar gesagt hat, dass committed/gepusht werden soll.
|
||||||
|
- Wenn David explizit `mach und push` oder sinngemaess sagt, darf der Agent den validierten Arbeitsblock committen und pushen.
|
||||||
|
- Immer gezielt stagen; keine fremden lokalen Aenderungen mitnehmen.
|
||||||
|
- Vor Commit `git status --short` und Diff pruefen.
|
||||||
|
|
||||||
|
Subframe kommt erst spaeter:
|
||||||
|
|
||||||
|
- erst nach Planung und Validierung
|
||||||
|
- nur nach explizitem OK fuer konkreten Screen oder Flow
|
||||||
|
- ohne OK keine neuen Subframe-Screens, keine Edits und keine Loeschungen
|
||||||
|
- bestehende Nutzer-Anpassungen in Subframe respektieren
|
||||||
|
- wenn David Subframe-Aenderungen meldet, muss der Agent die Planung entsprechend abgleichen
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Error-State-Pflicht
|
||||||
|
|
||||||
|
Status: Brainstorming / Richtung von David bestaetigt.
|
||||||
|
|
||||||
|
Der Agent muss selbststaendig eine Error-State-Liste fuehren, bevor final dokumentiert wird.
|
||||||
|
|
||||||
|
Diese Liste muss mindestens pruefen:
|
||||||
|
|
||||||
|
- Was kann fehlschlagen?
|
||||||
|
- Was blockiert den Nutzer?
|
||||||
|
- Was muss inline korrigiert werden?
|
||||||
|
- Was braucht ein Modal?
|
||||||
|
- Was braucht einen eigenen Screen?
|
||||||
|
- Was reicht als Toast oder Banner?
|
||||||
|
- Welche Error States sind sicherheitskritisch, rechtlich kritisch oder copy-kritisch?
|
||||||
|
- Welche Error States gehoeren in einen anderen Flow?
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Error States werden aktiv gesammelt.
|
||||||
|
- David validiert jeden relevanten Error State.
|
||||||
|
- Erst validierte Error States werden in die Paket-MD oder Screen-Dateien uebernommen.
|
||||||
|
- Nicht validierte Error States bleiben als offene Kandidaten oder Backlog markiert.
|
||||||
|
- Error States werden normalerweise dokumentiert, nicht als eigene Screens gebaut.
|
||||||
|
- Ein einzelnes Feld kann mehrere Error States haben; daraus entstehen nicht automatisch mehrere Screens.
|
||||||
|
- Eigene Error-Screens entstehen nur, wenn der Zustand fachlich extrem wichtig, blockierend, sicherheitskritisch, rechtlich relevant oder copy-kritisch ist.
|
||||||
|
- Bei jeder spaeteren Screen-Aenderung muss gefragt werden: Hat diese Aenderung Einfluss auf Error States?
|
||||||
|
- Wenn ein Screen entfernt, ein Button ergaenzt, ein Schritt verschoben oder ein Flow verknuepft wird, muessen betroffene Error States geprueft und ggf. angepasst werden.
|
||||||
|
- Error States brauchen spaeter eine konkrete UI-Komponenten-Zuordnung aus dem vorhandenen Component-/Pattern-Set.
|
||||||
|
- Der Agent darf keine nicht vorhandenen Error-Komponenten erfinden, sondern muss vorhandene Komponenten/Patterns nutzen oder als offene Komponentenfrage markieren.
|
||||||
|
- Viele Error States koennen fuer Development ableitbar bleiben und muessen nicht als einzelne Screens vorgebaut werden.
|
||||||
|
- Wichtig ist, dass relevante Error-Richtung, UI-Form/Komponente und Copy-/Verhaltensnotiz dokumentiert und von David validiert sind.
|
||||||
|
|
||||||
|
Validierungsformat als Richtung:
|
||||||
|
|
||||||
|
| Ereignis | Ort/Screen | UI-Form/Komponente | Bauen? | Empfehlung | David-Entscheidung |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| - | - | Inline / Banner / Toast / Modal / Screen / nur Dokumentation / offene Komponentenfrage | ja / nein | - | offen / validiert / raus / spaeter |
|
||||||
|
|
||||||
|
Noch zu brainstormen:
|
||||||
|
|
||||||
|
- Welche Error-State-Komponenten und Patterns existieren?
|
||||||
|
- Welche UI-Form darf fuer welchen Error-Typ genutzt werden?
|
||||||
|
- Welche Error States duerfen nur dokumentiert werden?
|
||||||
|
- Welche Error States brauchen sichtbare Copy im Screen?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Spaetere Aenderungen durch David
|
||||||
|
|
||||||
|
Status: Brainstorming / Richtung von David bestaetigt.
|
||||||
|
|
||||||
|
Wenn David in Obsidian etwas aendert und den Agent darauf hinweist:
|
||||||
|
|
||||||
|
- Agent liest die betroffenen Dateien.
|
||||||
|
- Agent prueft, ob die Aenderung sprachlich, strukturell und fachlich konsistent ist.
|
||||||
|
- Wenn Screens betroffen sind, prueft der Agent die zugehoerigen Screen-Dateien.
|
||||||
|
- Wenn weitere Screens betroffen sein koennten, fragt der Agent nach, bevor er diese bearbeitet.
|
||||||
|
- Agent macht einen gezielten Impact-Check: Dependencies, Error States, Folgeaktionen, Backlog, Tracker, Canvas.
|
||||||
|
|
||||||
|
Wenn David in Subframe etwas aendert und den Agent darauf hinweist:
|
||||||
|
|
||||||
|
- Agent liest die von David genannten Screens per MCP.
|
||||||
|
- Agent vergleicht fachlich, was sich fuer den Flow geaendert hat.
|
||||||
|
- Agent fasst die fachlich relevante Aenderung kurz zusammen.
|
||||||
|
- Agent dokumentiert keine reine Aenderungshistorie.
|
||||||
|
- Agent zieht nur relevante Planungsinhalte nach: neue Buttons, geaenderte Aktionen, neue/entfallene States, neue Screens, geaenderte Namen, geaenderte Routes, geaenderte Dependencies.
|
||||||
|
- Agent prueft, ob durch die Subframe-Aenderung neue Fragen entstehen, z. B. ob ein Button einen neuen Screen, ein Modal, einen Toast oder einen Error State braucht.
|
||||||
|
- Wenn die Aenderung weitere Screens betrifft, fragt der Agent nach, bevor er diese Screens bearbeitet.
|
||||||
|
- Wenn durch eine Aenderung vermutlich ein neuer Screen oder Flow noetig wird, legt der Agent nichts direkt an. Er startet zuerst einen Mini-Brainstorm:
|
||||||
|
- Warum koennte ein neuer Screen/Flow noetig sein?
|
||||||
|
- Welche Varianten gibt es?
|
||||||
|
- Welche Empfehlung hat der Agent?
|
||||||
|
- Welche Entscheidung trifft David?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependency-Check
|
||||||
|
|
||||||
|
Status: von David als Richtung validiert.
|
||||||
|
|
||||||
|
Bei jedem Flow prueft der Agent kurz:
|
||||||
|
|
||||||
|
- Startet dieser Flow einen anderen Flow?
|
||||||
|
- Wird dieser Flow von einem anderen Flow gestartet?
|
||||||
|
- Nutzt oder beruehrt er zentrale Auth-/Account-/Admin-Flows?
|
||||||
|
- Aendert er Berechtigungen, Rollen oder Sichtbarkeit?
|
||||||
|
- Erzeugt oder veraendert er Error States in anderen Flows?
|
||||||
|
- Gibt es bestehende Screens, Modals oder States, die wiederverwendet werden koennen?
|
||||||
|
- Muss Canvas oder Tracker mit einem anderen Flow verlinkt werden?
|
||||||
|
- Gibt es eine Kollision mit bestehenden Namen, Screens, Routen oder Subframe-Seiten?
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Der Check bleibt kurz.
|
||||||
|
- Wenn eine Dependency relevant ist, wird sie im Brainstorming markiert.
|
||||||
|
- Wenn daraus ein neuer Screen/Flow entstehen koennte, startet der Agent zuerst einen Mini-Brainstorm und fragt David.
|
||||||
|
- Keine stillen Verknuepfungen und keine stillen neuen Screens.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Canvas- und Screen-Abgrenzung
|
||||||
|
|
||||||
|
Status: von David als Richtung validiert.
|
||||||
|
|
||||||
|
Canvas bildet nur ab:
|
||||||
|
|
||||||
|
- echte Screens
|
||||||
|
- echte Modals
|
||||||
|
- echte Versionen/Varianten eines Screens oder Modals, wenn sie als eigener Arbeitsmoment gelten
|
||||||
|
|
||||||
|
Canvas bildet normalerweise nicht als eigenen Screen ab:
|
||||||
|
|
||||||
|
- Toasts
|
||||||
|
- Banner
|
||||||
|
- Inline-States
|
||||||
|
- reine Dokumentation
|
||||||
|
- normale Field-Validation
|
||||||
|
- kleine Error States, die Development aus dem Form-/Input-Pattern ableiten kann
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Auch nicht gebaute States muessen validiert werden, wenn sie fuer UX, Copy, Fehlerverhalten oder Development relevant sind.
|
||||||
|
- Der Agent dokumentiert sie bei Flow oder Screen, aber legt keine Canvas-Nodes dafuer an.
|
||||||
|
- Jede echte Version, die als eigener Screen/Modal gelten soll, braucht eigene Screen-Datei, Tracker-Zeile und Canvas-Node.
|
||||||
|
- Der Agent muss kurz begruenden, warum ein Kandidat Screen, Modal, Version, Toast, Banner, Inline-State oder nur Dokumentation ist.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## UX-Handoff statt Backend-Planung
|
||||||
|
|
||||||
|
Status: von David als Richtung validiert.
|
||||||
|
|
||||||
|
Der Agent plant nicht, wie etwas technisch im Backend umgesetzt wird.
|
||||||
|
|
||||||
|
Der Agent soll aber aus UX-/Produkt-Sicht vorwegnehmen und dokumentieren:
|
||||||
|
|
||||||
|
- welche Daten sichtbar sind
|
||||||
|
- welche Daten in Sidebars, Listen, Tabellen, Tabs, Modals und Details stehen
|
||||||
|
- welche Aktionen verfuegbar sind
|
||||||
|
- was beim Klick auf Buttons passiert
|
||||||
|
- welche Rollen/Permissions etwas sehen oder ausfuehren duerfen
|
||||||
|
- welche States, Error States und leeren Zustaende es gibt
|
||||||
|
- wie ein Flow startet, weitergeht, verzweigt und endet
|
||||||
|
- welche anderen Flows beruehrt oder gestartet werden
|
||||||
|
- welche Fragen fuer Development offen bleiben
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Es wird beschrieben, wie es fuer Nutzer funktionieren soll.
|
||||||
|
- Technische Umsetzung bleibt Development.
|
||||||
|
- Research und Davids Entscheidungen klaeren, was in die UX gehoert.
|
||||||
|
- Alles Relevante wird erst nach Davids Validierung final dokumentiert.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Rollen und Permissions
|
||||||
|
|
||||||
|
Status: von David als Richtung validiert.
|
||||||
|
|
||||||
|
Standardannahme:
|
||||||
|
|
||||||
|
- Screens werden erstmal als Admin-Ansicht geplant.
|
||||||
|
- Der Agent soll Rollen/Permissions kurz mitdenken, aber nicht jeden Flow dadurch aufblaehen.
|
||||||
|
|
||||||
|
Dokumentiert wird nur, wenn:
|
||||||
|
|
||||||
|
- offensichtlich nicht jeder Zugriff haben sollte
|
||||||
|
- Admin vs. Nicht-Admin sichtbar andere UX erzeugt
|
||||||
|
- eine Aktion besonders kritisch ist
|
||||||
|
- eine Permission-Frage fuer spaeter offen bleibt
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Offensichtliche Rechtefragen als offene Frage oder Backlog markieren.
|
||||||
|
- Keine vollstaendige Permission-Matrix pro Flow erzwingen.
|
||||||
|
- Wenn ein Flow explizit RBAC/Permissions behandelt, gelten natuerlich die detaillierteren Regeln des jeweiligen Flow-Pakets.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Komponenten und Designsystem
|
||||||
|
|
||||||
|
Status: von David als Richtung validiert.
|
||||||
|
|
||||||
|
Der Agent soll vorhandene Komponenten und UI-Patterns beruecksichtigen.
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Vor neuen oder komplexeren Screens pruefen, ob passende Komponenten/Patterns existieren.
|
||||||
|
- Screen-Dokumentation an vorhandenen Komponenten/Patterns ausrichten.
|
||||||
|
- Keine Komponenten erfinden, wenn nicht klar ist, dass es sie gibt.
|
||||||
|
- Wenn eine Komponente gebraucht wird, aber unklar ist, ob sie existiert, als offene Komponentenfrage markieren.
|
||||||
|
- Error-State-Komponenten spaeter separat brainstormen und danach fuer Error-State-Dokumentation nutzen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Canvas-Lesbarkeit
|
||||||
|
|
||||||
|
Status: von David als Richtung validiert.
|
||||||
|
|
||||||
|
Canvas ist Teil des Handoffs, nicht nur eine Ablage.
|
||||||
|
|
||||||
|
Regelrichtung:
|
||||||
|
|
||||||
|
- Nodes muessen lesbar angeordnet sein.
|
||||||
|
- Kanten duerfen nicht unnoetig unlesbar kreuzen.
|
||||||
|
- Kantenlabels sollen kurz und verstaendlich sein.
|
||||||
|
- Zusammenhaengende Bereiche sollen gruppiert werden.
|
||||||
|
- Dokumentierte States/Backlog duerfen getrennt vom Hauptflow stehen.
|
||||||
|
- Nach strukturellen Aenderungen muss Canvas auf JSON-Validitaet und Lesbarkeit geprueft werden.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Ergebnis spaeter
|
||||||
|
|
||||||
|
Nach der Brainstorming-Session soll daraus eine kompakte, validierte Agent-Anweisung entstehen, z. B.:
|
||||||
|
|
||||||
|
- `01 Regeln/Screen Agent Workflow.md`
|
||||||
|
- plus kurzer Verweis in `AI README.md`
|
||||||
|
- Brainstorming-Datei bleibt als Herleitung/Archiv bestehen.
|
||||||
|
- Finale Datei wird kurz, operativ und checklistenartig.
|
||||||
@@ -0,0 +1,301 @@
|
|||||||
|
---
|
||||||
|
kind: rule
|
||||||
|
project: HiveGrid Screen Project
|
||||||
|
area: Agent Workflow
|
||||||
|
status: active
|
||||||
|
validated: true
|
||||||
|
---
|
||||||
|
|
||||||
|
# Screen Agent Workflow
|
||||||
|
|
||||||
|
Use this file for all HiveGrid screen, flow, Canvas, tracker and Subframe planning work.
|
||||||
|
|
||||||
|
Outcome: The agent guides David through UX screen/flow planning, validates every decision with David, documents only validated outcomes, and keeps Obsidian, Tracker, Canvas and Subframe references synchronized.
|
||||||
|
|
||||||
|
This file is the operative checklist. `Screen Agent Workflow - Brainstorming.md` is only the archive and must not override this file.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## MUST
|
||||||
|
|
||||||
|
- MUST read the relevant Planning, tickets, existing flow package, screen files, tracker and Canvas before proposing changes.
|
||||||
|
- MUST check for similar existing flows, screens, reusable patterns and naming conflicts before creating a new flow or screen.
|
||||||
|
- MUST use internal Planning as the default source of truth.
|
||||||
|
- MUST use external research only as decision support, and validate relevant research-derived ideas with David before they enter planning.
|
||||||
|
- MUST use `04 Standards/Subframe UI Standards/` as reference for already validated Subframe, component and layout standards when relevant.
|
||||||
|
- MUST give an assumption and recommendation before asking David a decision question.
|
||||||
|
- MUST have David validate every product, UX, screen, state, backlog, scope and research-derived decision.
|
||||||
|
- MUST keep one small flow or screen package in focus at a time.
|
||||||
|
- MUST maintain Error-State candidates for every flow and validate them with David.
|
||||||
|
- MUST document UX behavior: visible data, actions, states, permissions, dependencies and flow logic.
|
||||||
|
- MUST avoid backend implementation decisions; Development decides technical implementation.
|
||||||
|
- MUST sync structural changes immediately across package MD, screen files, tracker, Canvas and Subframe links.
|
||||||
|
- MUST keep Canvas readable: grouped, labeled, non-confusing and JSON-valid.
|
||||||
|
- MUST ask before committing, unless David explicitly said to commit/push or clearly asked to "mach und push".
|
||||||
|
- MUST create or update a `Tickets/` handoff file when a ticket is finished or ready for handoff.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## NEVER
|
||||||
|
|
||||||
|
- NEVER finalize unvalidated decisions.
|
||||||
|
- NEVER silently create, delete, rename or split screens.
|
||||||
|
- NEVER build or edit Subframe without explicit OK for the concrete screen or flow.
|
||||||
|
- NEVER edit `04 Standards/Subframe UI Standards/` during normal screen work unless David explicitly asks for standards work or validates a systemwide rule that belongs there.
|
||||||
|
- NEVER overwrite or revert David's manual changes in Obsidian or Subframe.
|
||||||
|
- NEVER let external examples override internal Planning without making the conflict visible and asking David.
|
||||||
|
- NEVER create Canvas nodes for normal Toasts, Banners, Inline States, field validation or pure documentation states.
|
||||||
|
- NEVER invent unavailable components; mark them as open component questions.
|
||||||
|
- NEVER commit unrelated local changes such as `.obsidian/workspace.json` or unrelated Canvas edits.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## DEFAULTS
|
||||||
|
|
||||||
|
- DEFAULT view is Admin unless the flow clearly requires a non-admin variant.
|
||||||
|
- DEFAULT for roles/permissions: think about them briefly, document only if visibly relevant or risky.
|
||||||
|
- DEFAULT for Error States: document them, do not build individual screens for every field error.
|
||||||
|
- DEFAULT for Backlog: collect candidates, but only mark final Backlog after David validates.
|
||||||
|
- DEFAULT for working names: keep sensible names, but validate if the name affects files, Canvas, Tracker, Subframe or flow structure.
|
||||||
|
- DEFAULT for final MDs: compact, decision-oriented and readable.
|
||||||
|
- DEFAULT for Brainstorming/Draft files: more detailed is allowed.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Workflow
|
||||||
|
|
||||||
|
### 1. Brief
|
||||||
|
|
||||||
|
Before proposing screens:
|
||||||
|
|
||||||
|
- Identify ticket/module, user goal, flow start and flow end.
|
||||||
|
- Read relevant Planning, tickets, existing package MDs, screen files, tracker and Canvas.
|
||||||
|
- Check whether this is a new flow, existing flow change, screen, modal, state or documentation-only item.
|
||||||
|
- Check similar flows/screens and possible reuse.
|
||||||
|
- Mark assumptions and unknowns.
|
||||||
|
|
||||||
|
### 2. Map
|
||||||
|
|
||||||
|
Build the working map before final decisions:
|
||||||
|
|
||||||
|
- Happy path.
|
||||||
|
- Branches and blockers.
|
||||||
|
- Screen candidates.
|
||||||
|
- Modal candidates.
|
||||||
|
- Toast/Banner/Inline/documentation states.
|
||||||
|
- Error-State candidates.
|
||||||
|
- Dependency candidates.
|
||||||
|
- Scope candidates.
|
||||||
|
- Backlog candidates.
|
||||||
|
- Component/pattern questions.
|
||||||
|
|
||||||
|
Do not finalize this map without David.
|
||||||
|
|
||||||
|
### 3. Align
|
||||||
|
|
||||||
|
Present decisions in small validated chunks.
|
||||||
|
|
||||||
|
Use this pattern when there are alternatives:
|
||||||
|
|
||||||
|
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| A | - | - | - | - |
|
||||||
|
| B | - | - | - | - |
|
||||||
|
|
||||||
|
Then get David's decision:
|
||||||
|
|
||||||
|
| Entscheidung | Status | Notiz |
|
||||||
|
|---|---|---|
|
||||||
|
| - | genommen / spaeter / raus / unklar / Backlog | - |
|
||||||
|
|
||||||
|
For every screen/state candidate, clarify:
|
||||||
|
|
||||||
|
- Is it a Screen, Modal, Version, Inline State, Toast, Banner or documentation-only?
|
||||||
|
- Does it need Canvas?
|
||||||
|
- Does it need a screen file?
|
||||||
|
- Does it need Subframe?
|
||||||
|
- Does David validate it?
|
||||||
|
|
||||||
|
### 4. Document
|
||||||
|
|
||||||
|
Only document validated outcomes as final planning.
|
||||||
|
|
||||||
|
Document:
|
||||||
|
|
||||||
|
- Goal and user task.
|
||||||
|
- Visible data.
|
||||||
|
- Actions and button outcomes.
|
||||||
|
- UX flow logic.
|
||||||
|
- States and validated Error States.
|
||||||
|
- Dependencies.
|
||||||
|
- Component/pattern notes.
|
||||||
|
- Scope decisions.
|
||||||
|
- Validated Backlog.
|
||||||
|
- Open questions.
|
||||||
|
|
||||||
|
Do not write backend architecture or implementation details.
|
||||||
|
|
||||||
|
### 5. Sync
|
||||||
|
|
||||||
|
For every structural change, update all relevant artifacts in the same work block:
|
||||||
|
|
||||||
|
- Package MD.
|
||||||
|
- Screen file.
|
||||||
|
- `02 Wireframes/Screen Paket Tracker.md`.
|
||||||
|
- Canvas.
|
||||||
|
- Subframe link/flow reference, if applicable.
|
||||||
|
|
||||||
|
Then check:
|
||||||
|
|
||||||
|
- Search for old names/paths/links with `rg`.
|
||||||
|
- Validate changed Canvas JSON.
|
||||||
|
- Check Canvas readability.
|
||||||
|
- Run `git status --short`.
|
||||||
|
- Stage only intended files.
|
||||||
|
|
||||||
|
### 5b. Ticket Handoff
|
||||||
|
|
||||||
|
When a ticket is finished, ready for external ticket-system handoff, or David asks for a ticket summary:
|
||||||
|
|
||||||
|
- Create or update one Markdown file in `Tickets/Fertige Tickets/`.
|
||||||
|
- Use the same structure as `Tickets/Fertige Tickets/D-P2 Auth Wireframes.md`.
|
||||||
|
- Name it clearly after the ticket and area, for example `Tickets/Fertige Tickets/D-P2 Auth Wireframes.md`.
|
||||||
|
- Include ticket id, area, status, repo link, central tracker link and working area.
|
||||||
|
- Summarize what was done, what David validated and what remains Backlog/Open.
|
||||||
|
- Link every relevant flow package MD, Canvas and Subframe flow.
|
||||||
|
- Link relevant screen files.
|
||||||
|
- Keep detail truth in the package MDs and tracker; the ticket file is the handoff index.
|
||||||
|
- Before finalizing, verify local links point to existing files.
|
||||||
|
- If the ticket changes after the handoff file exists, update the same ticket file instead of creating a duplicate.
|
||||||
|
|
||||||
|
### 6. After-Change Impact Check
|
||||||
|
|
||||||
|
When David says he changed something in Obsidian:
|
||||||
|
|
||||||
|
- Read the affected files.
|
||||||
|
- Check wording, structure and affected screen files.
|
||||||
|
- Check whether related screens need edits.
|
||||||
|
- Ask before editing further screens.
|
||||||
|
|
||||||
|
When David says he changed something in Subframe:
|
||||||
|
|
||||||
|
- Read the named screen(s) via MCP when MCP is available.
|
||||||
|
- Summarize only the fachlich relevant change.
|
||||||
|
- Do not create a changelog.
|
||||||
|
- Update Obsidian only for relevant planning changes.
|
||||||
|
|
||||||
|
Always ask:
|
||||||
|
|
||||||
|
- Does this create or remove an Error State?
|
||||||
|
- Does this create or remove a dependency?
|
||||||
|
- Does this change a button outcome?
|
||||||
|
- Does this create a new Modal, Toast, Banner, Screen or Flow?
|
||||||
|
- Does this affect Canvas, Tracker or Subframe links?
|
||||||
|
|
||||||
|
If a new screen or flow might be needed, do not create it directly. Start a Mini-Brainstorm first.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Error States
|
||||||
|
|
||||||
|
The agent is responsible for finding Error-State candidates. David validates them.
|
||||||
|
|
||||||
|
Default: Error States are documented, not built as separate screens.
|
||||||
|
|
||||||
|
Own Error Screens only when the state is:
|
||||||
|
|
||||||
|
- blockierend
|
||||||
|
- fachlich extrem wichtig
|
||||||
|
- security-critical
|
||||||
|
- legally/copy critical
|
||||||
|
- a new mental step for the user
|
||||||
|
|
||||||
|
Use this table:
|
||||||
|
|
||||||
|
| Ereignis | Ort/Screen | UI-Form/Komponente | Bauen? | Empfehlung | David-Entscheidung |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| - | - | Inline / Banner / Toast / Modal / Screen / Dokumentation / offene Komponentenfrage | ja / nein | - | offen / validiert / raus / spaeter |
|
||||||
|
|
||||||
|
Rules:
|
||||||
|
|
||||||
|
- One field can have multiple Error States.
|
||||||
|
- Do not create several screens for normal input validation.
|
||||||
|
- Assign existing components/patterns when known.
|
||||||
|
- If the component is unknown, mark `offene Komponentenfrage`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependency Check
|
||||||
|
|
||||||
|
For every flow, quickly check:
|
||||||
|
|
||||||
|
- Does this flow start another flow?
|
||||||
|
- Is this flow started by another flow?
|
||||||
|
- Does it touch central Auth, Account, Admin or Settings flows?
|
||||||
|
- Does it change roles, permissions or visibility?
|
||||||
|
- Does it create or change Error States in another flow?
|
||||||
|
- Can an existing screen, modal or state be reused?
|
||||||
|
- Should Canvas or Tracker link to another flow?
|
||||||
|
- Are there name, route, screen or Subframe conflicts?
|
||||||
|
|
||||||
|
If a dependency could create a new screen/flow, start a Mini-Brainstorm and ask David.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Canvas Rules
|
||||||
|
|
||||||
|
Canvas shows:
|
||||||
|
|
||||||
|
- real Screens
|
||||||
|
- real Modals
|
||||||
|
- real Versions/Variants when they are own work moments
|
||||||
|
|
||||||
|
Canvas does not show as own nodes:
|
||||||
|
|
||||||
|
- Toasts
|
||||||
|
- Banners
|
||||||
|
- normal Inline States
|
||||||
|
- field validation
|
||||||
|
- documentation-only states
|
||||||
|
|
||||||
|
Still validate and document relevant non-Canvas states with David.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Subframe Rules
|
||||||
|
|
||||||
|
Subframe is used only after David explicitly approves a concrete screen or flow.
|
||||||
|
|
||||||
|
Before Subframe work:
|
||||||
|
|
||||||
|
- Validated screen list exists.
|
||||||
|
- Screen purpose is clear.
|
||||||
|
- Existing Subframe screens are checked if needed.
|
||||||
|
- Existing David changes are respected.
|
||||||
|
|
||||||
|
After Subframe work:
|
||||||
|
|
||||||
|
- Update screen file frontmatter/link.
|
||||||
|
- Update package MD.
|
||||||
|
- Update tracker.
|
||||||
|
- Update Canvas if structure changed.
|
||||||
|
- Verify Dialog/Modal screens use real Dialog/Page Layout patterns, not simulated cards.
|
||||||
|
- For every Modal/Dialog screen, explicitly instruct Subframe to use `DialogLayout` -> `Dialog` -> `Dialog.Content`; never accept a fake modal built from `Card`, an absolute overlay, blur background or a full page wrapper.
|
||||||
|
- Before handoff, read the page with `get_page_info` and confirm the JSX imports `Dialog` and contains `Dialog.Content`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Done Criteria
|
||||||
|
|
||||||
|
The agent is done only when:
|
||||||
|
|
||||||
|
- David validated the relevant decisions.
|
||||||
|
- Validated decisions are documented.
|
||||||
|
- Error-State candidates were considered and validated or left open.
|
||||||
|
- Dependencies were checked.
|
||||||
|
- Structural changes are synced across files.
|
||||||
|
- Canvas is valid and readable if changed.
|
||||||
|
- Subframe links are updated if Subframe was used.
|
||||||
|
- Ticket handoff in `Tickets/` is created/updated when the ticket is finished or handed off.
|
||||||
|
- Git status was checked.
|
||||||
|
- Commit/push handling follows David's instruction.
|
||||||
@@ -101,6 +101,7 @@ Screen-Listen entstehen aus dem Brainstorming. Sie werden nicht vorab automatisc
|
|||||||
- vorhandene D0-Komponenten und Archetypen dokumentieren
|
- vorhandene D0-Komponenten und Archetypen dokumentieren
|
||||||
- keine unnoetigen Sonderkomponenten erfinden
|
- keine unnoetigen Sonderkomponenten erfinden
|
||||||
- kein Subframe-Bau ohne ausdrueckliche Freigabe von David
|
- kein Subframe-Bau ohne ausdrueckliche Freigabe von David
|
||||||
|
- neue, geloeschte, umbenannte oder gesplittete Screens immer in Screen-Dateien, Paket-MD, Tracker und Canvas synchron halten
|
||||||
|
|
||||||
7. **Markdown-Paket schreiben**
|
7. **Markdown-Paket schreiben**
|
||||||
- Screen-Liste
|
- Screen-Liste
|
||||||
@@ -264,6 +265,48 @@ Regeln:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 2f. Screen-Aenderungs- und Sync-Regel
|
||||||
|
|
||||||
|
Jede Aenderung an Screen-Struktur, Screen-Namen oder Screen-Zuschnitt muss als synchroner Paket-Update behandelt werden. Das gilt auch, wenn nur in Subframe oder nur in der Planung gearbeitet wurde.
|
||||||
|
|
||||||
|
Pflichtablauf bei jeder Screen-Aenderung:
|
||||||
|
|
||||||
|
1. **Bestand pruefen**
|
||||||
|
- Aktuellen Subframe-Flow per MCP lesen, wenn der Flow bereits in Subframe existiert.
|
||||||
|
- Aktuelle Screen-Dateien, Paket-MD, `Screen Paket Tracker` und Canvas-Datei pruefen.
|
||||||
|
- Vorhandene lokale Aenderungen respektieren; nichts ungefragt zuruecksetzen.
|
||||||
|
|
||||||
|
2. **Screen-Entscheidung klaeren**
|
||||||
|
- Ist es derselbe Screen mit anderem Namen?
|
||||||
|
- Ist es ein Zustand innerhalb eines Screens?
|
||||||
|
- Ist es eine Variante zur Auswahl?
|
||||||
|
- Oder ist es ein eigener Screen mit eigener Nutzeraufgabe?
|
||||||
|
- Wenn aus einer Variante ein eigener Screen werden soll, muss David das vorher validieren.
|
||||||
|
|
||||||
|
3. **Synchron eintragen**
|
||||||
|
- Screen-Datei: Frontmatter `screen`, Titel, Ziel, Route, Subframe-Link.
|
||||||
|
- Paket-MD: Flowbeschreibung, Screen Validation Gate, validierte Screen-Liste, Subframe-Grid, Screen-Pakete, Handoff-Check.
|
||||||
|
- `Screen Paket Tracker`: Name, Status, Route/Ort, MD-Link, Subframe-Link, Canvas-Link.
|
||||||
|
- Canvas: eigener Node fuer jeden echten Screen; Kanten und Labels passend aktualisieren.
|
||||||
|
- Subframe: nur nach Freigabe Screens anlegen, loeschen, umbenennen oder bearbeiten.
|
||||||
|
|
||||||
|
4. **Abgleich vor Abschluss**
|
||||||
|
- `rg` nach alten Screen-Namen und toten Subframe-Links ausfuehren.
|
||||||
|
- Subframe-Flow erneut lesen, wenn Subframe geaendert wurde.
|
||||||
|
- Canvas-Datei als JSON validieren, wenn sie geaendert wurde.
|
||||||
|
- `git diff --name-only` pruefen und dem Nutzer sagen, was bewusst nicht geaendert wurde.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- Ein Subframe-Screen ohne Tracker-/Canvas-Eintrag ist ein Fehler.
|
||||||
|
- Ein Canvas-Screen ohne Screen-Datei oder Tracker-Zeile ist ein Fehler.
|
||||||
|
- Eine Screen-Datei mit geloeschtem oder falschem Subframe-Link ist ein Fehler.
|
||||||
|
- Mehrere reale Einstiegssituationen duerfen nur dann als eine Screen-Datei bleiben, wenn David sie explizit als Zustandsvarianten desselben Screens validiert.
|
||||||
|
- Wenn zwei Einstiegssituationen eigene Screens sind, brauchen sie eigene Screen-Namen, eigene Tracker-Zeilen und eigene Canvas-Nodes.
|
||||||
|
- Vor David-Freigabe wird ein geplanter Split nur als offene Entscheidung oder Backlog notiert, nicht stillschweigend gebaut.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 2d. Screen Validation Gate
|
## 2d. Screen Validation Gate
|
||||||
|
|
||||||
Bevor ein Screen in einen Flow eingebaut wird, muss er einzeln validiert werden.
|
Bevor ein Screen in einen Flow eingebaut wird, muss er einzeln validiert werden.
|
||||||
|
|||||||
@@ -0,0 +1,48 @@
|
|||||||
|
---
|
||||||
|
kind: backlog
|
||||||
|
ticket: D-D0b
|
||||||
|
area: Layout Standards
|
||||||
|
status: Offen
|
||||||
|
stand: 2026-07-02
|
||||||
|
---
|
||||||
|
|
||||||
|
# D-D0b Backlog
|
||||||
|
|
||||||
|
Diese Datei sammelt Folgepunkte aus `D-D0b Layout Standards`, die nicht Teil des abgeschlossenen ersten Standards-Durchgangs sind.
|
||||||
|
|
||||||
|
Die Punkte sind nicht blockierend fuer den aktuellen Handoff.
|
||||||
|
|
||||||
|
## Layout / Responsive
|
||||||
|
|
||||||
|
| Thema | Warum spaeter? | Status |
|
||||||
|
|---|---|---|
|
||||||
|
| Mobile Layout Standards | Mobile wurde in D-D0b bewusst nicht validiert. Padding, Breakpoints, mobile App-Shell und mobile Dialogverhalten brauchen eine eigene Runde. | Backlog |
|
||||||
|
| Drawer / Side Panel Breitenregeln | Drawer wurden begrifflich abgegrenzt, aber noch nicht mit festen Breiten, Padding und Responsiveness validiert. | Backlog |
|
||||||
|
| Toolbar-zu-Tabelle-Abstand | Nur relevant, wenn Table-/Toolbar-Komponenten den Abstand nicht bereits sauber abdecken. | Beobachten |
|
||||||
|
|
||||||
|
## Komponenten / Semantik
|
||||||
|
|
||||||
|
| Thema | Warum spaeter? | Status |
|
||||||
|
|---|---|---|
|
||||||
|
| Button-/Action-Semantik | Klaeren, wann Actions Primary, Secondary, Destructive oder Positive sind. Destructive ist eindeutig rot, Confirm aber nicht automatisch gruen. | Backlog |
|
||||||
|
| Error-/Result-Dialog-Komponenten | Spaeter klaeren, welche blockierenden Fehler als `Result Dialog`, `Confirm Dialog` oder eigene Error-Dialog-Variante laufen. Normale Bereichsfehler bleiben inline. | Backlog |
|
||||||
|
| No-Permission-Komponente | No Permission ist fachlich als inline State geklaert, aber lokal noch nicht als eigene Komponenten-MD finalisiert. | Backlog |
|
||||||
|
| Table No-Permission State | Klaeren, ob die bestehende Table-Komponente eine eigene No-Permission-State-Variante braucht. | Backlog |
|
||||||
|
| Fill Buttons fuer XS/S Dialoge | Fuer XS/S-Dialoge mit genau zwei Actions koennte eine Fill-Buttons-Variante sinnvoll sein. Noch nicht validiert. | Optional |
|
||||||
|
|
||||||
|
## Standards / Research
|
||||||
|
|
||||||
|
| Thema | Warum spaeter? | Status |
|
||||||
|
|---|---|---|
|
||||||
|
| Weitere IBM-Carbon-Spacing-Inspiration | Carbon wurde fuer D-D0b als Referenz genutzt, ist aber keine harte Regelquelle. Weitere Details nur bei konkretem Bedarf. | Backlog |
|
||||||
|
| Accessibility-Regeln | Wichtig, aber nicht Teil des ersten Layout-Standards-Durchgangs. | Backlog |
|
||||||
|
| Vollstaendige Komponenten-Dokumentation | Erst noetig, wenn eine Komponente echte Regeln oder Ausnahmen braucht. | Backlog |
|
||||||
|
|
||||||
|
## Nicht in D-D0b aufnehmen
|
||||||
|
|
||||||
|
Diese Themen gehoeren nicht in D-D0b:
|
||||||
|
|
||||||
|
- Farben, Shadows und Radius, solange sie groesstenteils in Subframe gepflegt werden.
|
||||||
|
- Fachliche Feature-Flows.
|
||||||
|
- Backend-/Datenmodell-Logik.
|
||||||
|
- Vollstaendige App-Shell-Definition.
|
||||||
@@ -0,0 +1,240 @@
|
|||||||
|
---
|
||||||
|
kind: final-planning
|
||||||
|
ticket: D-D0b
|
||||||
|
area: Layout Standards
|
||||||
|
status: Abgeschlossen
|
||||||
|
stand: 2026-07-03
|
||||||
|
---
|
||||||
|
|
||||||
|
# D-D0b Layout Standards
|
||||||
|
|
||||||
|
## Kurzfassung
|
||||||
|
|
||||||
|
D-D0b definiert die ersten systemweiten Layout- und Composition-Standards fuer HiveGrid-Screens. Das Ticket ist abgeschlossen und die validierten Regeln wurden in die dauerhaften Subframe UI Standards uebertragen.
|
||||||
|
|
||||||
|
Source of Truth fuer spaetere Screen-Arbeit:
|
||||||
|
|
||||||
|
- [Subframe UI Standards / Layout-Regeln](<../../../04 Standards/Subframe UI Standards/Layout/README.md>)
|
||||||
|
- [Subframe UI Standards / Entscheidungen](<../../../04 Standards/Subframe UI Standards/02_Entscheidungen.md>)
|
||||||
|
- [D-D0b Backlog](<D-D0b Backlog.md>)
|
||||||
|
|
||||||
|
HTML-Preview:
|
||||||
|
|
||||||
|
- Versionierte Referenz: [D-D0b Layout Preview](<Preview/index.html>)
|
||||||
|
- Separate Full-Page-Vorschau: [D-D0b Full Page Preview](<Preview/preview.html>)
|
||||||
|
- Lokale Arbeitskopien fuer Self-Hosting: `99 Temp/D-D0b Layout Preview/index.html` und `99 Temp/D-D0b Layout Preview/preview.html`
|
||||||
|
- Die versionierte Preview liegt bewusst im D-D0b-Ordner, damit sie zusammen mit den Layout-Entscheidungen auffindbar bleibt.
|
||||||
|
- Die Full-Page-Preview enthaelt einen ausklappbaren Standards-Drawer und optionale Rule-Hints, damit sichtbar ist, welche Regel an welcher Stelle der realistischen Beispielseite angewendet wird.
|
||||||
|
- Die Preview ist visuelle Referenz, aber kein Source of Truth.
|
||||||
|
- `99 Temp/` ist per `.gitignore` ausgeschlossen.
|
||||||
|
- Wenn Regeln spaeter abweichen, gelten die Markdown-Standards, nicht die HTML-Preview.
|
||||||
|
|
||||||
|
## Scope
|
||||||
|
|
||||||
|
Fokus:
|
||||||
|
|
||||||
|
- Layout-Raster und erlaubte Abstandswerte.
|
||||||
|
- Page-, Card-, Surface- und Grid-Abstaende.
|
||||||
|
- Text-Rhythmus fuer Page- und Section-Header.
|
||||||
|
- Dialog- und Fullscreen-Dialog-Groessen.
|
||||||
|
- Dialog-interne Gaps.
|
||||||
|
- Ownership-Grenzen fuer Buttons, Formulare, Tabellen und States.
|
||||||
|
|
||||||
|
Nicht Fokus:
|
||||||
|
|
||||||
|
- Konkrete Fachflows.
|
||||||
|
- Backend-/Datenmodell-Logik.
|
||||||
|
- App-Shell-Definition.
|
||||||
|
- Vollstaendige Komponenten-Spezifikation.
|
||||||
|
- Mobile Layout Standards.
|
||||||
|
|
||||||
|
## Entscheidungsuebersicht
|
||||||
|
|
||||||
|
| ID | Thema | Status | Ergebnis |
|
||||||
|
|---|---|---|---|
|
||||||
|
| D01 | Grundraster / Spacing Scale | Validiert | 8px-Rhythmus mit erlaubten Standardwerten |
|
||||||
|
| D02 | Page, Card und Grid Padding | Validiert | Page 24px, Card/Surface 16px, Grid/Card Gap 16px |
|
||||||
|
| D03 | Text-Rhythmus | Validiert | Token-aware: 0 / 24 / 0 / 12 |
|
||||||
|
| D04 | Button Ownership | Geklaert | Button-Details kommen aus der Button-Komponente |
|
||||||
|
| D05 | Form Layout Gap | Validiert | Komplette Field-Komponenten stehen 16px auseinander |
|
||||||
|
| D06 | Table Ownership | Geklaert | Tabellen-Dichte kommt aus der Table-Komponente |
|
||||||
|
| D07 | Dialoge | Validiert | XS 420, S 560, M 720, L 1200; Fullscreen max 2512 |
|
||||||
|
| D08 | Dialog Internal Gaps | Validiert | Balanced: 8 / 16 / 24 / 8 |
|
||||||
|
| D09 | States / Component Ownership | Geklaert | Empty/Error/No-Permission sind inline Komponenten-Zustaende |
|
||||||
|
|
||||||
|
## Validierte Standards
|
||||||
|
|
||||||
|
### D01 Grundraster / Spacing Scale
|
||||||
|
|
||||||
|
HiveGrid nutzt einen 8px-Rhythmus als Hauptstandard.
|
||||||
|
|
||||||
|
Erlaubte Standardwerte:
|
||||||
|
|
||||||
|
`4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96`
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- `8px` ist die Basislogik fuer normale Layout-Gaps und Paddings.
|
||||||
|
- `4px`, `12px` und `20px` sind erlaubte Zwischenwerte fuer kompakte UI-Situationen, Field-Anatomy, kleine Icon-/Text-Abstaende oder feinere visuelle Gewichtung.
|
||||||
|
- `2px` ist kein normaler Layout-Abstand und darf nur fuer technische Feinkorrekturen wie Border-, Focus- oder Icon-Feintuning genutzt werden.
|
||||||
|
- Werte wie `6px`, `10px`, `14px`, `28px`, `36px` oder `44px` werden nicht als Standard neu eingefuehrt. Sie duerfen nur vorkommen, wenn eine bestehende Komponente, ein vorhandener Token oder eine technische Vorgabe sie bereits mitbringt.
|
||||||
|
|
||||||
|
### D02 Page, Card und Grid Padding
|
||||||
|
|
||||||
|
Validierte Standards:
|
||||||
|
|
||||||
|
- `Page Padding Standard`: 24px.
|
||||||
|
- `Page Padding Minimum`: 24px.
|
||||||
|
- `Card / Surface Padding Standard`: 16px.
|
||||||
|
- `Detail-/Editor-Surface Padding Standard`: 16px.
|
||||||
|
- `Grid / Card Gap Standard`: 16px.
|
||||||
|
- `Grid / Card Gap kompakter Sonderfall`: 12px fuer enge oder sehr dichte Teilbereiche.
|
||||||
|
- `Section Gap Standard`: 24px fuer groessere inhaltliche Bereiche.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- Standard Desktop Pages und kompakte Settings Pages nutzen bei diesen Basiswerten dieselbe Spacing-Logik.
|
||||||
|
- Page Padding gehoert dem Page-/Content-Container nach der App Shell.
|
||||||
|
- Card/Surface Padding gehoert der Card-, Surface- oder Panel-Komponente.
|
||||||
|
- Kompakte Momente reduzieren nicht das Page Padding, sondern nur lokale Gaps/Abstaende innerhalb dichter UI-Bereiche.
|
||||||
|
- 32px Innenabstand ist kein frei zu verwendender Surface-Standard. Ausnahme: Die Subframe-`Dialog`-Komponente darf eine eigene 32px-Padding-Variante besitzen.
|
||||||
|
|
||||||
|
### D03 Text-Rhythmus
|
||||||
|
|
||||||
|
D03 definiert vertikale Gaps zwischen Page-/Section-Textbloecken und Content. Diese Regel gilt nur zusammen mit 150%-Texttokens fuer beschreibende Texte.
|
||||||
|
|
||||||
|
Validierte Standards:
|
||||||
|
|
||||||
|
- `Page Title -> Page Description`: 0px.
|
||||||
|
- `Page Header -> erster Content`: 24px.
|
||||||
|
- `Section Title -> Section Description`: 0px.
|
||||||
|
- `Section Description -> Section Content`: 12px.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- `0px` ist ein bewusst definierter Gap. Es bedeutet: Kein zusaetzlicher Auto-Layout-Abstand zwischen Titel und Beschreibung.
|
||||||
|
- Page- und Section-Beschreibungen muessen 150%-Texttokens nutzen, auch wenn sie gerade nur eine Zeile lang sind.
|
||||||
|
- Die 150%-Line-height erzeugt bereits optische Hoehe im Textblock. Deshalb wird zwischen Titel und Beschreibung kein zusaetzlicher Gap addiert.
|
||||||
|
- D03-Gaps werden zwischen gerenderten Textboxen gemessen, nicht zwischen einzelnen Buchstaben oder optischen Glyphen.
|
||||||
|
- Wenn eine Beschreibung durch kleinere Breite von einer auf zwei Zeilen springt, wird nur der Textblock hoeher. Der Gap zum naechsten Content bleibt gleich.
|
||||||
|
- `0`-Line-height-Tokens duerfen nicht fuer Texte genutzt werden, die umbrechen koennen.
|
||||||
|
- `0`-Line-height-Tokens bleiben fuer garantierte Einzeiler reserviert, z. B. Button Label, Badge, Tab, kurze Navigation oder kompakte Tabellenzellen mit Truncation.
|
||||||
|
|
||||||
|
### D04 Button Component Ownership
|
||||||
|
|
||||||
|
Button-Hoehen, Button-Innenpadding und Button-Varianten werden ueber die Button-Komponente abgedeckt.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- Fuer Standardaktionen in Screens wird die Default-Variante der Button-Komponente genutzt.
|
||||||
|
- Die Default-Variante entspricht `Medium` und ist 36px hoch.
|
||||||
|
- Screen-Layouts sollen Button-Hoehen oder Button-Padding nicht manuell nachbauen.
|
||||||
|
- Action-Semantik wie Primary, Secondary, Destructive oder Positive wird separat validiert.
|
||||||
|
|
||||||
|
### D05 Form Layout Gap
|
||||||
|
|
||||||
|
Validierte Regel:
|
||||||
|
|
||||||
|
- Komplette Formular-Field-Komponenten stehen standardmaessig 16px auseinander.
|
||||||
|
- 12px bleibt ein kompakter Sonderfall fuer sehr dichte Teilbereiche.
|
||||||
|
- 24px wird fuer bewusst getrennte Formular-Sections genutzt, nicht als Standardabstand zwischen einzelnen Feldern.
|
||||||
|
|
||||||
|
Komponenten-Ownership:
|
||||||
|
|
||||||
|
- Label/Input-Abstand, Help-/Description-Text, Error-/Message-Abstand und Input-Padding gehoeren zur jeweiligen Form-Input-Komponente.
|
||||||
|
- Wenn ein Screen gebaut wird, soll die vorhandene Field-Anatomy der Komponente genutzt werden.
|
||||||
|
- Beschreibungen/Hilfetexte werden ueber die entsprechenden Komponentenfelder/Props/Slots ausgefuellt, nicht als manuelle Textbloecke neben das Input gebaut.
|
||||||
|
|
||||||
|
### D06 Table Layout Ownership
|
||||||
|
|
||||||
|
Row Height, Cell Padding, Header-Dichte und Tabellenvarianten werden ueber die Table-Komponente abgedeckt.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- Screen-Layouts sollen Tabellen-Padding oder Row-Hoehen nicht manuell nachbauen.
|
||||||
|
- IBM Carbon dient als Referenz: Data Tables haben mehrere Row Sizes (`xs 24px`, `sm 32px`, `md 40px`, `lg 48px`, `xl 64px`), Column Padding von 16px und die Header Row soll zur Tabellen-Row-Groesse passen.
|
||||||
|
- Fuer HiveGrid gilt: Table-Komponente verwenden und deren passende Dichte waehlen, statt in einzelnen Screens eigene Tabellenwerte zu definieren.
|
||||||
|
|
||||||
|
### D07 Dialog, Fullscreen Dialog und Drawer
|
||||||
|
|
||||||
|
Pattern-Definition:
|
||||||
|
|
||||||
|
- `Page`: eigener Ort in der App. Wird genutzt fuer Bereiche, in denen laenger gearbeitet wird, die eigene Navigation/Subnavigation haben oder spaeter direkt adressierbar sein sollen.
|
||||||
|
- `Dialog`: temporaeres Overlay ueber der aktuellen Page. Blockiert den Hintergrund, hat einen klaren Abschluss und fuehrt den User danach zur vorherigen Page zurueck.
|
||||||
|
- `Fullscreen Dialog`: temporaeres Overlay wie ein Dialog, aber fast oder ganz viewportfuellend. Keine normale Page.
|
||||||
|
- `Drawer / Side Panel`: seitliches Overlay oder Panel, meistens rechts, wenn der Kontext sichtbar bleiben soll.
|
||||||
|
|
||||||
|
Zentrierte Dialoge:
|
||||||
|
|
||||||
|
- `XS`: 420px.
|
||||||
|
- `S`: 560px.
|
||||||
|
- `M`: 720px.
|
||||||
|
- `L`: 1200px max.
|
||||||
|
|
||||||
|
Fullscreen Dialog:
|
||||||
|
|
||||||
|
- `width: calc(100vw - 48px)`.
|
||||||
|
- `max-width: 2512px`.
|
||||||
|
- `height: calc(100vh - 48px)`.
|
||||||
|
- 24px aeusserer Rand pro Seite auf Desktop.
|
||||||
|
- Auf breiteren Monitoren bleibt der Fullscreen Dialog zentriert und skaliert nicht unendlich.
|
||||||
|
|
||||||
|
Dialog Padding:
|
||||||
|
|
||||||
|
- `16px` als Default.
|
||||||
|
- `32px` als groessere/ruhigere Variante fuer Dialoge, die bewusst mehr Innenraum brauchen.
|
||||||
|
- Diese Werte sollen ueber die Dialog-Komponente bzw. deren Varianten kommen, nicht durch freie Padding-Overrides im Screen.
|
||||||
|
|
||||||
|
### D08 Dialog Internal Gaps
|
||||||
|
|
||||||
|
Die Subframe-`Dialog`-Komponente nutzt fuer normale Dialog-Innenabstaende die `Balanced`-Logik:
|
||||||
|
|
||||||
|
- `Title -> Description`: 8px.
|
||||||
|
- `Field / Form Row Gap`: 16px.
|
||||||
|
- `Section Gap innerhalb Dialog`: 24px.
|
||||||
|
- `Footer Button Gap`: 8px.
|
||||||
|
- Footer Actions sind standardmaessig rechts ausgerichtet.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- Diese Werte beschreiben Gaps zwischen gerenderten Bloecken, nicht manuelle Text-Margins.
|
||||||
|
- Mehrzeiliger Text nutzt den jeweiligen 150%-Texttoken. Dadurch wird der Textblock hoeher; es wird kein zusaetzlicher Sonder-Gap oberhalb oder unterhalb des Texts addiert.
|
||||||
|
- Eine `Fill Buttons`-Variante fuer XS/S-Dialoge mit genau zwei Actions bleibt optional und muss separat validiert werden, falls sie gebraucht wird.
|
||||||
|
- Destructive/positive Action-Farben werden nicht allein aus `Cancel/Confirm` abgeleitet. Sie muessen semantisch zur Aktion passen und werden separat als Button-/Action-Regel validiert.
|
||||||
|
|
||||||
|
### D09 States / Component Ownership
|
||||||
|
|
||||||
|
States sind inline Inhaltszustaende, keine Modale.
|
||||||
|
|
||||||
|
Regeln:
|
||||||
|
|
||||||
|
- Empty, Error und No-Permission ersetzen inline den betroffenen Inhaltsbereich.
|
||||||
|
- Empty State und Error State sind bereits im Komponenten-Index vorhanden.
|
||||||
|
- Normale Bereichsfehler sollen ueber State-/Alert-/Partial-page-failure-Komponenten abgedeckt werden.
|
||||||
|
- Blockierende Error-/Result-Dialoge werden spaeter separat als Overlay-/Feedback-Komponenten geklaert.
|
||||||
|
|
||||||
|
## Anwendung fuer neue Screens
|
||||||
|
|
||||||
|
Beim Erstellen neuer Screens gilt:
|
||||||
|
|
||||||
|
- Die validierten Standards aus [Subframe UI Standards / Layout-Regeln](<../../../04 Standards/Subframe UI Standards/Layout/README.md>) verwenden.
|
||||||
|
- Komponenten-Defaults verwenden, wenn sie den validierten Standard bereits abbilden.
|
||||||
|
- Padding oder Gap nicht pseudomaessig nachbauen, wenn die zuständige Komponente dafuer bereits eine Eigenschaft, Variante oder Auto-Layout-Struktur hat.
|
||||||
|
- Modale in Subframe als echte Dialog-Komponenten bauen, nicht als Fake-Modal auf einer normalen Page.
|
||||||
|
- Page-/Section-Beschreibungen als 150%-Texttokens setzen, wenn sie umbrechen koennen.
|
||||||
|
- `0px` bei D03 bewusst als definierten Gap behandeln und nicht aus Versehen durch 4px/8px ersetzen.
|
||||||
|
- Backlog-Themen nicht in Screens erzwingen, solange sie nicht validiert sind.
|
||||||
|
|
||||||
|
## Backlog
|
||||||
|
|
||||||
|
Offene Folgepunkte stehen in [D-D0b Backlog](<D-D0b Backlog.md>).
|
||||||
|
|
||||||
|
## Externe Referenzen
|
||||||
|
|
||||||
|
- Carbon 2x Grid: https://carbondesignsystem.com/elements/2x-grid/overview/
|
||||||
|
- Carbon Spacing: https://carbondesignsystem.com/elements/spacing/overview/
|
||||||
|
- Carbon Typography: https://carbondesignsystem.com/elements/typography/overview/
|
||||||
|
- Carbon Modal Usage: https://carbondesignsystem.com/components/modal/usage/
|
||||||
|
- Carbon Forms Pattern: https://carbondesignsystem.com/patterns/forms-pattern/
|
||||||
|
- Carbon Data Table Usage: https://carbondesignsystem.com/components/data-table/usage/
|
||||||
|
- Carbon Data Table Style: https://carbondesignsystem.com/components/data-table/style/
|
||||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
+4
-4
@@ -7,9 +7,9 @@ id: D01
|
|||||||
screen: Rollen-Dropdown in Mitarbeiterliste
|
screen: Rollen-Dropdown in Mitarbeiterliste
|
||||||
typ: Inline-Zustand
|
typ: Inline-Zustand
|
||||||
umsetzung: Nur dokumentieren
|
umsetzung: Nur dokumentieren
|
||||||
status: In Subframe
|
status: Validiert
|
||||||
route: in S01
|
route: in S01, kein eigener Subframe-Screen
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/design/80f691a7-e8a9-4502-be74-69795066e105/edit"
|
subframe: "-"
|
||||||
---
|
---
|
||||||
|
|
||||||
# D01 - Rollen-Dropdown in Mitarbeiterliste
|
# D01 - Rollen-Dropdown in Mitarbeiterliste
|
||||||
@@ -58,7 +58,7 @@ Inline Select / Dropdown in Tabelle.
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
-
|
- Kein eigener Subframe-Screen. Das Dropdown ist direkt in `S01 Mitarbeiterliste` enthalten; dieser D01-Eintrag dokumentiert nur das geoeffnete Inline-Verhalten.
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ typ: Admin Blocker
|
|||||||
umsetzung: Nur dokumentieren
|
umsetzung: Nur dokumentieren
|
||||||
status: In Subframe
|
status: In Subframe
|
||||||
route: von S02/M02
|
route: von S02/M02
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/design/99f96d31-4cb5-4d7c-a252-3f8bef9f1b59/edit"
|
subframe: "https://app.subframe.com/f023064a5ca0/design/0363300b-6455-4fd9-9102-659d0a66b0ea/edit"
|
||||||
---
|
---
|
||||||
|
|
||||||
# D03 - Rolle in Nutzung blockiert
|
# D03 - Rolle in Nutzung blockiert
|
||||||
@@ -52,7 +52,9 @@ Text: `Diese Rolle kann nicht geloescht werden, solange Mitarbeiter zugewiesen s
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
-
|
- Umsetzung als echtes Subframe-Dialog-Modal: `DialogLayout` -> `Dialog` -> `Dialog.Content`.
|
||||||
|
- Kein Fake-Modal ueber einer Rollenliste, kein Blur-/Overlay-Hintergrund als eigene Page.
|
||||||
|
- Subframe: [D03 Rolle in Nutzung blockiert](<https://app.subframe.com/f023064a5ca0/design/0363300b-6455-4fd9-9102-659d0a66b0ea/edit>)
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
|
|||||||
@@ -27,7 +27,7 @@ A5 Modal / Invite Form.
|
|||||||
- E-Mail-Adresse, Pflichtfeld
|
- E-Mail-Adresse, Pflichtfeld
|
||||||
- optional Name
|
- optional Name
|
||||||
- optional Abteilung
|
- optional Abteilung
|
||||||
- Rolle, Pflichtauswahl mit Default/Seed-Rollen
|
- Rolle, Pflichtauswahl mit `Admin` und selbst angelegten Rollen
|
||||||
- aktueller Workspace
|
- aktueller Workspace
|
||||||
|
|
||||||
## Aktionen
|
## Aktionen
|
||||||
@@ -64,7 +64,8 @@ A5 Modal / Invite Form.
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
- Umsetzung als echtes Subframe-Modal mit `DialogLayout`-Root, nicht als nachgebautes Overlay ueber einer duplizierten Mitarbeiterliste.
|
- Umsetzung als echtes Subframe-Dialog-Modal: `DialogLayout` -> `Dialog` -> `Dialog.Content`.
|
||||||
|
- Kein Fake-Modal per `Card`, duplizierter Mitarbeiterliste oder manuell nachgebautem Overlay.
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,105 @@
|
|||||||
|
---
|
||||||
|
kind: screen
|
||||||
|
project: HiveGrid Screen Project
|
||||||
|
ticket: D-P2
|
||||||
|
package: WF-P2 Admin RBAC
|
||||||
|
id: M02
|
||||||
|
screen: Rolle bearbeiten
|
||||||
|
typ: Grosses Modal
|
||||||
|
umsetzung: Bauen
|
||||||
|
status: In Subframe
|
||||||
|
route: von S02 Bearbeiten, M04A Rolle anlegen oder M04B Rolle duplizieren
|
||||||
|
subframe: "https://app.subframe.com/f023064a5ca0/design/9a9873e3-d790-4373-b8c2-fadd3b82cbe6/edit"
|
||||||
|
---
|
||||||
|
|
||||||
|
# M02 - Rolle bearbeiten
|
||||||
|
|
||||||
|
## Ziel
|
||||||
|
|
||||||
|
Der Admin bearbeitet eine vorhandene eigene Rolle oder konfiguriert nach M04A/M04B die Berechtigungen einer neu angelegten bzw. duplizierten Rolle. Die Systemrolle `Admin` ist geschuetzt.
|
||||||
|
|
||||||
|
## Pattern / Archetyp
|
||||||
|
|
||||||
|
Grosses Modal / Role Editor.
|
||||||
|
|
||||||
|
## Daten
|
||||||
|
|
||||||
|
- Rollenname
|
||||||
|
- Beschreibung
|
||||||
|
- Typ als Information: Systemrolle oder Eigene Rolle
|
||||||
|
- Permission-Bereiche als Arbeitsgeruest
|
||||||
|
- konkrete Permission-Zeilen nach Beispielmuster
|
||||||
|
|
||||||
|
## Aktionen
|
||||||
|
|
||||||
|
- von `M04A`: neue Rolle mit Basisdaten uebernehmen
|
||||||
|
- von `M04B`: duplizierte Rolle mit Basisdaten und kopierten Berechtigungen uebernehmen
|
||||||
|
- bei `Bearbeiten`: direkt den grossen Permission-Editor oeffnen
|
||||||
|
- speichern
|
||||||
|
- abbrechen / Modal schliessen
|
||||||
|
- Rolle loeschen, wenn erlaubt
|
||||||
|
- Permission-Auswahl aendern
|
||||||
|
- Permission suchen
|
||||||
|
- Sidebar-Bereich oeffnen
|
||||||
|
|
||||||
|
## Layout / Inhalt
|
||||||
|
|
||||||
|
1. Grosser Modal-Flow ueber S02, mit Schliessen-Icon.
|
||||||
|
2. Entry `Bearbeiten`: direkt in den grossen Permission-Editor springen.
|
||||||
|
3. Entry `Rolle anlegen`: kommt aus `M04A Rolle anlegen` mit Basisdaten.
|
||||||
|
4. Entry `Duplizieren`: kommt aus `M04B Rolle duplizieren` mit Basisdaten und kopierten Berechtigungen.
|
||||||
|
5. Im grossen Editor steht oben der Bereich `Rolle` mit Rollenname, Beschreibung, Bereich/Kategorie und Typ-Info; diese Daten bleiben dort bearbeitbar.
|
||||||
|
6. Links steht eine Sidebar nach Apple-Settings-Muster: Suchfeld oben, darunter Bereiche.
|
||||||
|
7. Die Suche durchsucht alle Permissions und filtert bereichsuebergreifend.
|
||||||
|
8. Hauptbereich scrollt von `Rolle` zu `Allgemein` und weiter in einzelne Rechtebereiche.
|
||||||
|
9. Rechtebereiche: Allgemein, Mitarbeiter, Rollen und Berechtigungen, Workspace Settings, Abrechnung, Audit & Sicherheit, Integrationen/API, Dateien, Aufgaben.
|
||||||
|
10. Footer mit `Speichern` und `Abbrechen`.
|
||||||
|
|
||||||
|
## Permission-Zeilenmuster
|
||||||
|
|
||||||
|
Eine Permission wird konkret vorgebaut, damit das Muster klar ist:
|
||||||
|
|
||||||
|
| Element | Inhalt |
|
||||||
|
|---|---|
|
||||||
|
| Ueberschrift | `Mitarbeiter ansehen` |
|
||||||
|
| Beschreibung | `Darf Mitarbeiterliste und Mitarbeiterprofile im Workspace lesen.` |
|
||||||
|
| Control | Toggle-Switch `An/Aus` |
|
||||||
|
|
||||||
|
Verhalten:
|
||||||
|
|
||||||
|
- `Aus`: kein Zugriff.
|
||||||
|
- `An`: Zugriff ist erlaubt.
|
||||||
|
- Abstufungen wie `Read-only` oder `Bearbeiten` koennen spaeter als Advanced Control ergaenzt werden, wenn die Permission nicht binaer ist.
|
||||||
|
- Weitere Permissions werden Development-seitig nach diesem Muster ergaenzt.
|
||||||
|
|
||||||
|
## Zustaende
|
||||||
|
|
||||||
|
| Zustand | Beschreibung | Umsetzung |
|
||||||
|
|---|---|---|
|
||||||
|
| Neue Rolle bearbeiten | nach M04A atomare Permissions setzen | Bauen |
|
||||||
|
| Rolle bearbeiten | direkt im Permission-Editor mit vorhandenen Werten | Bauen |
|
||||||
|
| Rolle duplizieren | nach M04B mit vorausgefuellten Basisdaten und kopierten Berechtigungen in den Editor | Bauen |
|
||||||
|
| Vorlage verwenden | WIP-Vorlage kann als Startpunkt fuer eigene Rolle dienen | Nur dokumentieren |
|
||||||
|
| Admin-Rolle | kritische Felder/Loeschen geschuetzt | Nur dokumentieren |
|
||||||
|
| Rollenname existiert | Inline-Fehler am Namen | Nur dokumentieren |
|
||||||
|
| Rolle in Nutzung loeschen | Loeschen blockiert | D03 |
|
||||||
|
|
||||||
|
## Permissions / Gates
|
||||||
|
|
||||||
|
- Nur Admins oder Rollen mit Rollen-/Berechtigungsverwaltung.
|
||||||
|
- Systemrolle `Admin` darf nicht geloescht werden.
|
||||||
|
|
||||||
|
## Subframe
|
||||||
|
|
||||||
|
- Finale Subframe-Seite fuer Umsetzung: `M02 Rolle bearbeiten`.
|
||||||
|
- Umsetzung als echtes grosses Subframe-Modal mit `DialogLayout` + `Dialog.Content`, nicht als freie Page-Shell.
|
||||||
|
- Der Screen enthaelt realistischere Permission-Vorlagen: laengere Beschreibungen, Accordion-Untergruppen, erweiterte Einstellungen und Zugriffsstufen wie `Kein Zugriff`, `Nur lesen`, `Voller Zugriff`.
|
||||||
|
- Die alten M02-Referenzvarianten wurden aus Subframe geloescht, damit der Admin-RBAC-Flow clean bleibt.
|
||||||
|
|
||||||
|
| Screen | Subframe |
|
||||||
|
|---|---|
|
||||||
|
| M02 Rolle bearbeiten | [Subframe](<https://app.subframe.com/f023064a5ca0/design/9a9873e3-d790-4373-b8c2-fadd3b82cbe6/edit>) |
|
||||||
|
|
||||||
|
## Notizen
|
||||||
|
|
||||||
|
Die Permission-Bundles sind fuer v1 ein Arbeitsgeruest, kein finaler Rechtekatalog. Wichtig ist das UI-Muster und der Einstieg fuer Development.
|
||||||
@@ -1,92 +0,0 @@
|
|||||||
---
|
|
||||||
kind: screen
|
|
||||||
project: HiveGrid Screen Project
|
|
||||||
ticket: D-P2
|
|
||||||
package: WF-P2 Admin RBAC
|
|
||||||
id: M02
|
|
||||||
screen: Rolle erstellen/bearbeiten
|
|
||||||
typ: Grosses Modal
|
|
||||||
umsetzung: Bauen
|
|
||||||
status: In Subframe
|
|
||||||
route: von S02
|
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/design/3d51deee-0d41-456f-a507-ccfc284e6e0a/edit"
|
|
||||||
---
|
|
||||||
|
|
||||||
# M02 - Rolle erstellen/bearbeiten
|
|
||||||
|
|
||||||
## Ziel
|
|
||||||
|
|
||||||
Der Admin erstellt eine eigene Rolle oder bearbeitet eine vorhandene/Seed-Rolle und sieht, wie Berechtigungen pro Bereich gesetzt werden.
|
|
||||||
|
|
||||||
## Pattern / Archetyp
|
|
||||||
|
|
||||||
Grosses Modal / Role Editor.
|
|
||||||
|
|
||||||
## Daten
|
|
||||||
|
|
||||||
- Rollenname
|
|
||||||
- Beschreibung
|
|
||||||
- Typ: Systemrolle, Seed-Rolle, Eigene Rolle
|
|
||||||
- optional Vorlage
|
|
||||||
- Permission-Bereiche als Arbeitsgeruest
|
|
||||||
- konkrete Permission-Zeilen nach Beispielmuster
|
|
||||||
|
|
||||||
## Aktionen
|
|
||||||
|
|
||||||
- speichern
|
|
||||||
- abbrechen / Modal schliessen
|
|
||||||
- Rolle loeschen, wenn erlaubt
|
|
||||||
- Permission-Auswahl aendern
|
|
||||||
- Permission suchen
|
|
||||||
- Sidebar-Bereich oeffnen
|
|
||||||
|
|
||||||
## Layout / Inhalt
|
|
||||||
|
|
||||||
1. Grosses Modal ueber S02, mit Schliessen-Icon.
|
|
||||||
2. Kopfbereich mit Rollenname, Beschreibung und optional Vorlage.
|
|
||||||
3. Globale Suche ueber alle Permissions.
|
|
||||||
4. Linke Sidebar mit Bereichen: Ueberblick, Mitarbeiter, Rollen und Berechtigungen, Workspace Settings, Abrechnung, Audit & Sicherheit, Integrationen/API, CRM/Kunden, Leads/Vertrieb, Projekte/Auftraege, Aufgaben/Dateien, Kommunikation/Support.
|
|
||||||
5. Startzustand `Ueberblick`: scrollbare Liste aller Bereiche und Permissions.
|
|
||||||
6. Footer mit `Speichern` und `Abbrechen`.
|
|
||||||
|
|
||||||
## Permission-Zeilenmuster
|
|
||||||
|
|
||||||
Eine Permission wird konkret vorgebaut, damit das Muster klar ist:
|
|
||||||
|
|
||||||
| Element | Inhalt |
|
|
||||||
|---|---|
|
|
||||||
| Ueberschrift | `Mitarbeiter ansehen` |
|
|
||||||
| Beschreibung | `Darf Mitarbeiterliste und Mitarbeiterprofile im Workspace lesen.` |
|
|
||||||
| Control | Segmented Control `Aus`, `Read-only`, `Bearbeiten` |
|
|
||||||
|
|
||||||
Verhalten:
|
|
||||||
|
|
||||||
- `Aus`: kein Zugriff.
|
|
||||||
- `Read-only`: lesen, aber nicht bearbeiten.
|
|
||||||
- `Bearbeiten`: lesen und aendern.
|
|
||||||
- Binaere Permissions koennen spaeter als einfacher Toggle `Aus/An` umgesetzt werden.
|
|
||||||
- Weitere Permissions werden Development-seitig nach diesem Muster ergaenzt.
|
|
||||||
|
|
||||||
## Zustaende
|
|
||||||
|
|
||||||
| Zustand | Beschreibung | Umsetzung |
|
|
||||||
|---|---|---|
|
|
||||||
| Neue Rolle | leere Felder + Permission-Auswahl | Bauen |
|
|
||||||
| Rolle bearbeiten | vorhandene Werte vorausgefuellt | Bauen |
|
|
||||||
| Seed-Rolle bearbeiten | Seed-Rolle ist editierbar | Bauen |
|
|
||||||
| Admin-Rolle | kritische Felder/Loeschen geschuetzt | Nur dokumentieren |
|
|
||||||
| Rollenname existiert | Inline-Fehler am Namen | Nur dokumentieren |
|
|
||||||
| Rolle in Nutzung loeschen | Loeschen blockiert | D03 |
|
|
||||||
|
|
||||||
## Permissions / Gates
|
|
||||||
|
|
||||||
- Nur Admins oder Rollen mit Rollen-/Berechtigungsverwaltung.
|
|
||||||
- Systemrolle `Admin` darf nicht geloescht werden.
|
|
||||||
|
|
||||||
## Subframe
|
|
||||||
|
|
||||||
- Umsetzung als echtes grosses Subframe-Modal mit `DialogLayout` + `Dialog.Content`, nicht als freie Page-Shell.
|
|
||||||
|
|
||||||
## Notizen
|
|
||||||
|
|
||||||
Die Permission-Bundles sind fuer v1 ein Arbeitsgeruest, kein finaler Rechtekatalog. Wichtig ist das UI-Muster und der Einstieg fuer Development.
|
|
||||||
@@ -64,7 +64,8 @@ A5 Confirm-Modal.
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
- Umsetzung als echtes Subframe-Confirm-Modal mit `DialogLayout`-Root, ohne duplizierte Mitarbeiterliste oder manuell nachgebauten Overlay-Hintergrund.
|
- Umsetzung als echtes Subframe-Confirm-Modal: `DialogLayout` -> `Dialog` -> `Dialog.Content`.
|
||||||
|
- Kein Fake-Modal per freiem Container, duplizierter Mitarbeiterliste oder manuell nachgebautem Overlay-Hintergrund.
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,85 @@
|
|||||||
|
---
|
||||||
|
kind: screen
|
||||||
|
project: HiveGrid Screen Project
|
||||||
|
ticket: D-P2
|
||||||
|
package: WF-P2 Admin RBAC
|
||||||
|
id: M04A
|
||||||
|
screen: Rolle anlegen
|
||||||
|
typ: Modal Step
|
||||||
|
umsetzung: Bauen
|
||||||
|
status: In Subframe
|
||||||
|
route: von S02 CTA Rolle anlegen
|
||||||
|
subframe: "https://app.subframe.com/f023064a5ca0/design/479ee52d-8d73-46e9-9a9b-a8798a22d764/edit"
|
||||||
|
---
|
||||||
|
|
||||||
|
# M04A - Rolle anlegen
|
||||||
|
|
||||||
|
## Ziel
|
||||||
|
|
||||||
|
Der Admin klaert die Basisdaten einer komplett neuen eigenen Rolle, bevor er in den grossen Permission-Editor wechselt.
|
||||||
|
|
||||||
|
## Pattern / Archetyp
|
||||||
|
|
||||||
|
Modal Step / Create Role Basics.
|
||||||
|
|
||||||
|
## Daten
|
||||||
|
|
||||||
|
- Rollenname
|
||||||
|
- Beschreibung
|
||||||
|
- Bereich/Kategorie, z. B. Team, Verwaltung, Operativ
|
||||||
|
- optionaler Vorlagenbereich als Work in Progress
|
||||||
|
|
||||||
|
## Aktionen
|
||||||
|
|
||||||
|
- `Weiter zu Berechtigungen` -> M02 Rolle bearbeiten
|
||||||
|
- `Abbrechen`
|
||||||
|
- Modal schliessen
|
||||||
|
- optionale Vorlage als WIP-Platzhalter ansehen, falls spaeter verfuegbar
|
||||||
|
|
||||||
|
## Layout / Inhalt
|
||||||
|
|
||||||
|
1. Modal ueber `S02 Rollen und Berechtigungen`, mit Schliessen-Icon.
|
||||||
|
2. Headline: `Rolle anlegen`.
|
||||||
|
3. Kurztext: Die Basisdaten helfen, die Rolle spaeter in der Rollenliste und im Editor eindeutig zuzuordnen.
|
||||||
|
4. Formular:
|
||||||
|
- Rollenname als Pflichtfeld.
|
||||||
|
- Beschreibung als optionales Textfeld.
|
||||||
|
- Bereich/Kategorie als Select.
|
||||||
|
5. Optionaler Bereich `Vorlage verwenden`:
|
||||||
|
- sichtbar als WIP/Platzhalter.
|
||||||
|
- keine Vorlage wird als feste Seed-Rolle angelegt.
|
||||||
|
- Vorlagen dienen spaeter nur als Startpunkt fuer eigene Rollen.
|
||||||
|
6. Footer:
|
||||||
|
- Primaer: `Weiter zu Berechtigungen`.
|
||||||
|
- Sekundaer: `Abbrechen`.
|
||||||
|
|
||||||
|
## Zustaende
|
||||||
|
|
||||||
|
| Zustand | Beschreibung | Umsetzung |
|
||||||
|
|---|---|---|
|
||||||
|
| Neue Rolle | leeres Formular fuer eigene Rolle | Bauen |
|
||||||
|
| Rollenname fehlt | Inline-Fehler am Namen | Bauen |
|
||||||
|
| Rollenname existiert | Inline-Fehler am Namen | Nur dokumentieren |
|
||||||
|
| Vorlage verwenden | WIP-Vorlagenbereich als spaeterer Startpunkt | Nur dokumentieren |
|
||||||
|
|
||||||
|
## Permissions / Gates
|
||||||
|
|
||||||
|
- Nur Admins oder Rollen mit Rollen-/Berechtigungsverwaltung.
|
||||||
|
- Systemrolle `Admin` wird hier nicht erstellt.
|
||||||
|
|
||||||
|
## Subframe
|
||||||
|
|
||||||
|
- Existierende Subframe-Seite fuer `M04A Rolle anlegen`.
|
||||||
|
- Wird als echter Modal-Step im Admin-RBAC-Flow genutzt.
|
||||||
|
- Dialog-QA: Varianten muessen `DialogLayout` -> `Dialog` -> `Dialog.Content` nutzen; keine simulierten Overlay-/Card-Modals.
|
||||||
|
- Subframe-Stand: M04A ist optisch an den M04B-Duplikat-Screen angeglichen, aber ohne Duplikat-Modus.
|
||||||
|
|
||||||
|
| Screen | Subframe |
|
||||||
|
|---|---|
|
||||||
|
| M04A Rolle anlegen | [Subframe](<https://app.subframe.com/f023064a5ca0/design/479ee52d-8d73-46e9-9a9b-a8798a22d764/edit>) |
|
||||||
|
|
||||||
|
## Notizen
|
||||||
|
|
||||||
|
Dieser Screen ist nur fuer den Einstieg `Rolle anlegen`. `Duplizieren` ist ein eigener Screen `M04B Rolle duplizieren`; `Bearbeiten` geht weiterhin direkt nach `M02 Rolle bearbeiten`.
|
||||||
|
|
||||||
|
Design-Stand: Layout, Abstaende, Footer und Dialog-Struktur entsprechen dem final angepassten M04B-Duplikat-Screen. Inhalte bleiben Create-Mode: keine Quellrolle, kein `Kopie von ...`, kein Hinweis auf kopierte Berechtigungen.
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
---
|
||||||
|
kind: screen
|
||||||
|
project: HiveGrid Screen Project
|
||||||
|
ticket: D-P2
|
||||||
|
package: WF-P2 Admin RBAC
|
||||||
|
id: M04B
|
||||||
|
screen: Rolle duplizieren
|
||||||
|
typ: Modal Step
|
||||||
|
umsetzung: Bauen
|
||||||
|
status: In Subframe
|
||||||
|
route: von S02 Zeilenaktion Duplizieren
|
||||||
|
subframe: "https://app.subframe.com/f023064a5ca0/design/610d08e6-5c6a-44d3-9b29-220664393ea0/edit"
|
||||||
|
---
|
||||||
|
|
||||||
|
# M04B - Rolle duplizieren
|
||||||
|
|
||||||
|
## Ziel
|
||||||
|
|
||||||
|
Der Admin nutzt eine bestehende eigene Rolle als Startpunkt, passt die Basisdaten an und landet danach im grossen Permission-Editor mit kopierten Berechtigungen.
|
||||||
|
|
||||||
|
## Pattern / Archetyp
|
||||||
|
|
||||||
|
Modal Step / Duplicate Role Basics.
|
||||||
|
|
||||||
|
## Daten
|
||||||
|
|
||||||
|
- Quellrolle
|
||||||
|
- Rollenname, vorausgefuellt z. B. als `Kopie von ...`
|
||||||
|
- Beschreibung
|
||||||
|
- Bereich/Kategorie, aus Quellrolle uebernommen
|
||||||
|
- Hinweis, dass Berechtigungen aus der Quellrolle kopiert und im naechsten Schritt angepasst werden
|
||||||
|
|
||||||
|
## Aktionen
|
||||||
|
|
||||||
|
- `Weiter zu Berechtigungen` -> M02 Rolle bearbeiten
|
||||||
|
- `Abbrechen`
|
||||||
|
- Modal schliessen
|
||||||
|
|
||||||
|
## Layout / Inhalt
|
||||||
|
|
||||||
|
1. Modal ueber `S02 Rollen und Berechtigungen`, mit Schliessen-Icon.
|
||||||
|
2. Headline: `Rolle duplizieren`.
|
||||||
|
3. Hinweisblock: `Basisdaten und Berechtigungen werden aus [Quellrolle] uebernommen.`
|
||||||
|
4. Formular:
|
||||||
|
- Rollenname als Pflichtfeld.
|
||||||
|
- Beschreibung als optionales Textfeld.
|
||||||
|
- Bereich/Kategorie als Select.
|
||||||
|
5. Footer:
|
||||||
|
- Primaer: `Weiter zu Berechtigungen`.
|
||||||
|
- Sekundaer: `Abbrechen`.
|
||||||
|
|
||||||
|
## Zustaende
|
||||||
|
|
||||||
|
| Zustand | Beschreibung | Umsetzung |
|
||||||
|
|---|---|---|
|
||||||
|
| Rolle duplizieren | Formular mit Werten aus Quellrolle vorausgefuellt | Bauen |
|
||||||
|
| Rollenname fehlt | Inline-Fehler am Namen | Bauen |
|
||||||
|
| Rollenname existiert | Inline-Fehler am Namen | Nur dokumentieren |
|
||||||
|
| Quellrolle nicht mehr verfuegbar | kleiner Fehlerhinweis mit `Schliessen` | Nur dokumentieren |
|
||||||
|
|
||||||
|
## Permissions / Gates
|
||||||
|
|
||||||
|
- Nur Admins oder Rollen mit Rollen-/Berechtigungsverwaltung.
|
||||||
|
- Systemrolle `Admin` darf nicht dupliziert werden.
|
||||||
|
|
||||||
|
## Subframe
|
||||||
|
|
||||||
|
- Existierende Subframe-Seite fuer `M04B Rolle duplizieren`.
|
||||||
|
- Wird als eigener Modal-Step im Admin-RBAC-Flow genutzt.
|
||||||
|
- Dialog-QA: Varianten muessen `DialogLayout` -> `Dialog` -> `Dialog.Content` nutzen; keine simulierten Overlay-/Card-Modals.
|
||||||
|
|
||||||
|
| Screen | Subframe |
|
||||||
|
|---|---|
|
||||||
|
| M04B Rolle duplizieren | [Subframe](<https://app.subframe.com/f023064a5ca0/design/610d08e6-5c6a-44d3-9b29-220664393ea0/edit>) |
|
||||||
|
|
||||||
|
## Notizen
|
||||||
|
|
||||||
|
Dieser Screen ist nur fuer den Einstieg `Duplizieren`. Nach `Weiter zu Berechtigungen` nutzt der Admin `M02 Rolle bearbeiten`, um kopierte Berechtigungen atomar anzupassen.
|
||||||
@@ -34,7 +34,7 @@ A2 List + A6 Settings.
|
|||||||
## Aktionen
|
## Aktionen
|
||||||
|
|
||||||
- `Mitarbeiter einladen` -> M01
|
- `Mitarbeiter einladen` -> M01
|
||||||
- Rolle direkt in der Tabellenzeile aendern -> D01
|
- Rolle direkt in der Tabellenzeile aendern; Verhalten ist als D01 dokumentiert, aber kein eigener Screen
|
||||||
- `Rollen und Berechtigungen bearbeiten` -> S02
|
- `Rollen und Berechtigungen bearbeiten` -> S02
|
||||||
- Zeilenaktion `Deaktivieren` -> M03
|
- Zeilenaktion `Deaktivieren` -> M03
|
||||||
- ggf. `Einladung erneut senden`
|
- ggf. `Einladung erneut senden`
|
||||||
@@ -48,6 +48,14 @@ A2 List + A6 Settings.
|
|||||||
5. Tabelle mit Spalten: Mitarbeiter, Abteilung, Rolle, Status, 2FA, Aktionen.
|
5. Tabelle mit Spalten: Mitarbeiter, Abteilung, Rolle, Status, 2FA, Aktionen.
|
||||||
6. Aktionen rechts als 3-Punkte-Menue.
|
6. Aktionen rechts als 3-Punkte-Menue.
|
||||||
|
|
||||||
|
## Rollen-Dropdown in der Tabelle
|
||||||
|
|
||||||
|
- Das Rollen-Dropdown ist Bestandteil von S01 und kein eigener Subframe-Screen.
|
||||||
|
- Es zeigt die aktuelle Rolle und verfuegbare Rollen.
|
||||||
|
- Unterhalb der Rollen steht `Rollen und Berechtigungen bearbeiten`.
|
||||||
|
- Dieser Eintrag fuehrt zu S02, Tab `Rollen und Berechtigungen`.
|
||||||
|
- Kritische Rollenwechsel, z. B. letzter Admin verliert Adminrechte, werden ueber V01 blockiert.
|
||||||
|
|
||||||
## Toasts / Action-Feedback
|
## Toasts / Action-Feedback
|
||||||
|
|
||||||
- Einladung gesendet: Toast.
|
- Einladung gesendet: Toast.
|
||||||
@@ -71,7 +79,7 @@ A2 List + A6 Settings.
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
-
|
- Rollen-Dropdown ist in S01 enthalten; keine separate D01-Subframe-Seite.
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
|
|||||||
@@ -16,7 +16,7 @@ subframe: "https://app.subframe.com/f023064a5ca0/design/87c24709-4f22-4181-8543-
|
|||||||
|
|
||||||
## Ziel
|
## Ziel
|
||||||
|
|
||||||
Der Admin verwaltet Systemrolle, Seed-Rollen und eigene Rollen in einer kompakten Rollen-Tabelle.
|
Der Admin verwaltet die Systemrolle `Admin` und selbst angelegte Rollen in einer kompakten Rollen-Tabelle.
|
||||||
|
|
||||||
## Pattern / Archetyp
|
## Pattern / Archetyp
|
||||||
|
|
||||||
@@ -25,17 +25,17 @@ A2 List + A6 Settings.
|
|||||||
## Daten
|
## Daten
|
||||||
|
|
||||||
- Rollenliste
|
- Rollenliste
|
||||||
- Typ: Systemrolle, Seed-Rolle, Eigene Rolle
|
- Typ: Systemrolle, Eigene Rolle
|
||||||
- Beschreibung
|
- Beschreibung
|
||||||
- Mitgliederanzahl / Avatar-Stack
|
- Mitgliederanzahl / Avatar-Stack
|
||||||
- Status: Aktiv, Pruefen
|
- Status: Aktiv, Pruefen
|
||||||
- Permission-Bundles als Arbeitsgeruest
|
- Permission-Bereiche als Arbeitsgeruest
|
||||||
|
|
||||||
## Aktionen
|
## Aktionen
|
||||||
|
|
||||||
- `Rolle anlegen` -> M02
|
- `Rolle anlegen` -> M04A Rolle anlegen mit Basisdaten
|
||||||
- Zeilenaktion `Bearbeiten` -> M02
|
- Zeilenaktion `Bearbeiten` -> M02 direkt im grossen Permission-Editor
|
||||||
- Zeilenaktion `Duplizieren` -> M02 mit kopierter Rolle
|
- Zeilenaktion `Duplizieren` -> M04B Rolle duplizieren mit kopierter Rolle
|
||||||
- Zeilenaktion `Loeschen`
|
- Zeilenaktion `Loeschen`
|
||||||
- bei Rolle in Nutzung -> D03
|
- bei Rolle in Nutzung -> D03
|
||||||
|
|
||||||
@@ -43,7 +43,7 @@ A2 List + A6 Settings.
|
|||||||
|
|
||||||
1. Header `Rollen und Berechtigungen` mit CTA `Rolle anlegen`.
|
1. Header `Rollen und Berechtigungen` mit CTA `Rolle anlegen`.
|
||||||
2. Toolbar mit Suche nach Rollenname und Beschreibung.
|
2. Toolbar mit Suche nach Rollenname und Beschreibung.
|
||||||
3. Filter: Typ, Permission-Bundle, In Nutzung.
|
3. Filter: Typ, Permission-Bereich, In Nutzung.
|
||||||
4. Tabelle mit Spalten: Rolle, Beschreibung, Typ, Mitglieder, Status, Aktionen.
|
4. Tabelle mit Spalten: Rolle, Beschreibung, Typ, Mitglieder, Status, Aktionen.
|
||||||
5. Aktionen rechts pro Zeile als 3-Punkte-Menue.
|
5. Aktionen rechts pro Zeile als 3-Punkte-Menue.
|
||||||
6. Nur eine sichtbare Systemrolle: `Admin`.
|
6. Nur eine sichtbare Systemrolle: `Admin`.
|
||||||
@@ -51,8 +51,8 @@ A2 List + A6 Settings.
|
|||||||
## Rollen / Beispiele
|
## Rollen / Beispiele
|
||||||
|
|
||||||
- Admin als einzige Systemrolle.
|
- Admin als einzige Systemrolle.
|
||||||
- Seed-Rollen: Geschaeftsfuehrer, Projektleiter, Verwaltung, Vertriebler, Kundensupporter, Monteur.
|
|
||||||
- Eigene Rollen koennen frei benannt werden.
|
- Eigene Rollen koennen frei benannt werden.
|
||||||
|
- Rollen-Vorlagen fuer neue Rollen sind Work in Progress und erscheinen nicht als feste Rollen in der Liste.
|
||||||
|
|
||||||
## Zustaende
|
## Zustaende
|
||||||
|
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ typ: Admin Blocker
|
|||||||
umsetzung: Nur dokumentieren
|
umsetzung: Nur dokumentieren
|
||||||
status: In Subframe
|
status: In Subframe
|
||||||
route: von S01/M03/Rollenwechsel
|
route: von S01/M03/Rollenwechsel
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/design/3e05bfb3-3842-4008-964e-f4c68dea0d9e/edit"
|
subframe: "https://app.subframe.com/f023064a5ca0/design/c1fd0142-76ad-402d-8eae-25ce9281d298/edit"
|
||||||
---
|
---
|
||||||
|
|
||||||
# V01 - Letzter Admin blockiert
|
# V01 - Letzter Admin blockiert
|
||||||
@@ -54,7 +54,9 @@ Text: `Dieser Workspace braucht mindestens einen Admin. Weise zuerst einem ander
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
-
|
- Umsetzung als echtes Subframe-Dialog-Modal: `DialogLayout` -> `Dialog` -> `Dialog.Content`.
|
||||||
|
- Kein Fake-Modal ueber einer Rollen-/Settings-Liste, kein Blur-/Overlay-Hintergrund als eigene Page.
|
||||||
|
- Subframe: [V01 Letzter Admin blockiert](<https://app.subframe.com/f023064a5ca0/design/c1fd0142-76ad-402d-8eae-25ce9281d298/edit>)
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
|
|||||||
@@ -1,32 +1,38 @@
|
|||||||
{
|
{
|
||||||
"nodes":[
|
"nodes":[
|
||||||
{"id":"group-main","type":"group","x":-120,"y":-680,"width":4000,"height":1440,"label":"Admin RBAC Hauptflow"},
|
{"id":"group-main","type":"group","x":-120,"y":-680,"width":4280,"height":1440,"label":"Admin RBAC Hauptflow"},
|
||||||
{"id":"group-notes","type":"group","x":-120,"y":900,"width":4000,"height":430,"label":"Dokumentierte Zustaende und Backlog"},
|
{"id":"group-notes","type":"group","x":-120,"y":900,"width":4280,"height":430,"label":"Dokumentierte Zustaende und Backlog"},
|
||||||
{"id":"d01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/D01 Rollen-Dropdown in Mitarbeiterliste.md","x":780,"y":440,"width":440,"height":230},
|
|
||||||
{"id":"m03","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M03 Mitarbeiter deaktivieren.md","x":780,"y":45,"width":440,"height":230},
|
|
||||||
{"id":"m01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M01 Mitarbeiter einladen.md","x":780,"y":-360,"width":440,"height":230},
|
|
||||||
{"id":"s02","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/S02 Rollen und Berechtigungen.md","x":1560,"y":440,"width":440,"height":230},
|
{"id":"s02","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/S02 Rollen und Berechtigungen.md","x":1560,"y":440,"width":440,"height":230},
|
||||||
{"id":"note-seed","type":"text","text":"# Seed-Rollen\n\nAdmin als einzige Systemrolle.\n\nSeed-Rollen: Geschaeftsfuehrer, Projektleiter, Verwaltung, Vertriebler, Kundensupporter, Monteur.\n\nSeed-Rollen sind editierbar.","x":1520,"y":1020,"width":520,"height":240},
|
|
||||||
{"id":"note-backlog","type":"text","text":"# Backlog / V2\n\nReassign beim Deaktivieren, Rollen-Loeschen mit Ersatzrolle, Gruppen, Rechtekatalog, Rollen-Audit, Review-Zyklus, Rechte-Matrix, Bulk-Aktionen, erweiterter Admin-Schutz.","x":3200,"y":1020,"width":600,"height":240},
|
|
||||||
{"id":"d03","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/D03 Rolle in Nutzung blockiert.md","x":3280,"y":440,"width":440,"height":230},
|
|
||||||
{"id":"note-permission","type":"text","text":"# Permission-Muster\n\nIm Rollen-Modal wird eine konkrete Permission-Zeile vorgebaut:\n\n`Mitarbeiter ansehen`\nBeschreibung darunter\nControl: `Aus / Read-only / Bearbeiten`\n\nFinaler Rechtekatalog liegt bei Development.","x":2360,"y":1010,"width":560,"height":260},
|
|
||||||
{"id":"m02","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M02 Rolle erstellen bearbeiten.md","x":2420,"y":440,"width":440,"height":230},
|
|
||||||
{"id":"note-navigation","type":"text","text":"# Navigation\n\nS01 ist der Einstieg unter `Settings -> Mitarbeiter`.\n\nDer Rollen-Tab S02 ist direkt ueber die Settings-Tabs erreichbar und zusaetzlich ueber den Dropdown-Eintrag `Rollen und Berechtigungen bearbeiten`.","x":-40,"y":1020,"width":520,"height":240},
|
|
||||||
{"id":"s01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/S01 Mitarbeiterliste.md","x":0,"y":45,"width":440,"height":230},
|
{"id":"s01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/S01 Mitarbeiterliste.md","x":0,"y":45,"width":440,"height":230},
|
||||||
{"id":"v01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/V01 Letzter Admin blockiert.md","x":2440,"y":-360,"width":440,"height":230}
|
{"id":"note-seed","type":"text","text":"# Rollenmodell\n\nAdmin ist die einzige Start-/Systemrolle.\n\nWeitere Rollen werden vom Admin selbst angelegt.\n\nRollen-Vorlagen sind Work in Progress und werden nicht als feste Rollen in der Liste gezeigt.","x":1520,"y":1020,"width":520,"height":240},
|
||||||
|
{"id":"m04a","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M04A Rolle anlegen.md","x":2120,"y":-110,"width":440,"height":230},
|
||||||
|
{"id":"m04b","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M04B Rolle duplizieren.md","x":2980,"y":-110,"width":440,"height":230},
|
||||||
|
{"id":"d03","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/D03 Rolle in Nutzung blockiert.md","x":3600,"y":440,"width":440,"height":230},
|
||||||
|
{"id":"note-navigation","type":"text","text":"# Navigation\n\nS01 ist der Einstieg unter `Settings -> Mitarbeiter`.\n\nDer Rollen-Tab S02 ist direkt ueber die Settings-Tabs erreichbar und zusaetzlich ueber den Dropdown-Eintrag `Rollen und Berechtigungen bearbeiten`.","x":-40,"y":1020,"width":520,"height":240},
|
||||||
|
{"id":"m02","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M02 Rolle bearbeiten.md","x":2680,"y":440,"width":440,"height":230},
|
||||||
|
{"id":"note-d01","type":"text","text":"# D01 Rollen-Dropdown\n\nKein eigener Screen.\n\nDas Dropdown ist direkt in S01 enthalten:\n- Rolle wechseln\n- `Rollen und Berechtigungen bearbeiten` fuehrt zu S02\n- letzter Admin wird ueber V01 blockiert","x":720,"y":1015,"width":500,"height":250},
|
||||||
|
{"id":"note-backlog","type":"text","text":"# Backlog / V2\n\nReassign beim Deaktivieren, Rollen-Loeschen mit Ersatzrolle, Gruppen, Rechtekatalog, Rollen-Audit, Review-Zyklus, Rechte-Matrix, Bulk-Aktionen, erweiterter Admin-Schutz.","x":3520,"y":1020,"width":600,"height":240},
|
||||||
|
{"id":"note-permission","type":"text","text":"# Permission-Muster\n\nIm Rollen-Modal wird eine konkrete Permission-Zeile vorgebaut:\n\n`Mitarbeiter ansehen`\nBeschreibung darunter\nControl: Toggle `An/Aus`\n\nRead-only/Bearbeiten bleibt spaeteres Advanced Control, falls ein Recht nicht binaer ist.\n\nFinaler Rechtekatalog liegt bei Development.","x":2620,"y":1000,"width":560,"height":280},
|
||||||
|
{"id":"v01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/V01 Letzter Admin blockiert.md","x":2120,"y":-440,"width":440,"height":230},
|
||||||
|
{"id":"m01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M01 Mitarbeiter einladen.md","x":1000,"y":-360,"width":440,"height":230},
|
||||||
|
{"id":"m03","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Admin RBAC/Screens/M03 Mitarbeiter deaktivieren.md","x":1000,"y":5,"width":440,"height":230}
|
||||||
],
|
],
|
||||||
"edges":[
|
"edges":[
|
||||||
{"id":"edge-s01-m01","fromNode":"s01","fromSide":"right","toNode":"m01","toSide":"left","label":"Mitarbeiter einladen"},
|
{"id":"edge-s01-m01","fromNode":"s01","fromSide":"right","toNode":"m01","toSide":"left","label":"Mitarbeiter einladen"},
|
||||||
{"id":"edge-s01-m03","fromNode":"s01","fromSide":"right","toNode":"m03","toSide":"left","label":"deaktivieren"},
|
{"id":"edge-s01-m03","fromNode":"s01","fromSide":"right","toNode":"m03","toSide":"left","label":"deaktivieren"},
|
||||||
{"id":"edge-s01-d01","fromNode":"s01","fromSide":"right","toNode":"d01","toSide":"left","label":"Rolle wechseln"},
|
{"id":"edge-s01-d01","fromNode":"s01","fromSide":"right","toNode":"note-d01","toSide":"top","label":"Rolle wechseln inline"},
|
||||||
{"id":"edge-d01-s02","fromNode":"d01","fromSide":"right","toNode":"s02","toSide":"left","label":"Rollen bearbeiten"},
|
{"id":"edge-s01-s02","fromNode":"s01","fromSide":"right","toNode":"s02","toSide":"left","label":"Rollen bearbeiten"},
|
||||||
{"id":"edge-s02-m02","fromNode":"s02","fromSide":"right","toNode":"m02","toSide":"left","label":"anlegen/bearbeiten"},
|
{"id":"edge-s02-m02","fromNode":"s02","fromSide":"right","toNode":"m02","toSide":"left","label":"bearbeiten"},
|
||||||
{"id":"edge-m03-v01","fromNode":"m03","fromSide":"right","toNode":"v01","toSide":"left","label":"letzter Admin"},
|
{"id":"edge-m03-v01","fromNode":"m03","fromSide":"right","toNode":"v01","toSide":"left","label":"letzter Admin"},
|
||||||
{"id":"edge-d01-v01","fromNode":"d01","fromSide":"right","toNode":"v01","toSide":"left","label":"Admin entfernen"},
|
{"id":"edge-s01-v01-role","fromNode":"s01","fromSide":"right","toNode":"v01","toSide":"left","label":"Admin entfernen"},
|
||||||
{"id":"edge-m02-d03","fromNode":"m02","fromSide":"right","toNode":"d03","toSide":"left","label":"Rolle in Nutzung"},
|
{"id":"edge-m02-d03","fromNode":"m02","fromSide":"right","toNode":"d03","toSide":"left","label":"Rolle in Nutzung"},
|
||||||
{"id":"edge-m02-permission","fromNode":"m02","fromSide":"bottom","toNode":"note-permission","toSide":"top","label":"Permission UI"},
|
{"id":"edge-m02-permission","fromNode":"m02","fromSide":"bottom","toNode":"note-permission","toSide":"top","label":"Permission UI"},
|
||||||
{"id":"edge-s02-seed","fromNode":"s02","fromSide":"bottom","toNode":"note-seed","toSide":"top","label":"Rollenmodell"},
|
{"id":"edge-s02-seed","fromNode":"s02","fromSide":"bottom","toNode":"note-seed","toSide":"top","label":"Rollenmodell"},
|
||||||
{"id":"edge-d03-backlog","fromNode":"d03","fromSide":"bottom","toNode":"note-backlog","toSide":"top","label":"spaeter"},
|
{"id":"edge-d03-backlog","fromNode":"d03","fromSide":"bottom","toNode":"note-backlog","toSide":"top","label":"spaeter"},
|
||||||
{"id":"edge-s01-navigation","fromNode":"s01","fromSide":"bottom","toNode":"note-navigation","toSide":"top","label":"Settings-Tabs"}
|
{"id":"edge-s01-navigation","fromNode":"s01","fromSide":"bottom","toNode":"note-navigation","toSide":"top","label":"Settings-Tabs"},
|
||||||
|
{"id":"edge-s02-m04a","fromNode":"s02","fromSide":"right","toNode":"m04a","toSide":"left","label":"Rolle anlegen"},
|
||||||
|
{"id":"edge-s02-m04b","fromNode":"s02","fromSide":"right","toNode":"m04b","toSide":"left","label":"duplizieren"},
|
||||||
|
{"id":"edge-m04a-m02","fromNode":"m04a","fromSide":"right","toNode":"m02","toSide":"left","label":"weiter"},
|
||||||
|
{"id":"edge-m04b-m02","fromNode":"m04b","fromSide":"bottom","toNode":"m02","toSide":"top","label":"weiter mit Kopie"}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
@@ -78,7 +78,8 @@ Wie schneiden wir RBAC so, dass es genug fuer Dev/Handoff ist, aber nicht zu ein
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Settings-Struktur statt separatem Admin-Center | genommen | bestehende Route ist `Settings -> Roles & Permissions` |
|
| Settings-Struktur statt separatem Admin-Center | genommen | bestehende Route ist `Settings -> Roles & Permissions` |
|
||||||
| Gruppen raus | genommen | Gruppen werden in diesem Paket nicht gebaut |
|
| Gruppen raus | genommen | Gruppen werden in diesem Paket nicht gebaut |
|
||||||
| Vorgebaute Rollen | genommen | Admin startet mit sinnvollen Seed-Rollen |
|
| Startrollen | genommen | Zum Start gibt es nur die Systemrolle `Admin`; weitere Rollen legt der Admin selbst an |
|
||||||
|
| Rollen-Vorlagen | WIP | Beim Erstellen koennen spaeter Vorlagen angeboten werden, sind aber noch nicht final |
|
||||||
| Eigene Rollen anlegen und benennen | genommen | Rollen-Editor erlaubt Custom Roles |
|
| Eigene Rollen anlegen und benennen | genommen | Rollen-Editor erlaubt Custom Roles |
|
||||||
| Rollen-Editor als eigener Arbeitsmoment | genommen | Permission-Bundles + Advanced brauchen Raum |
|
| Rollen-Editor als eigener Arbeitsmoment | genommen | Permission-Bundles + Advanced brauchen Raum |
|
||||||
| Kein separater Berechtigungen-Tab | genommen | Berechtigungen sind fuer Admins Teil des Tabs `Rollen und Berechtigungen` |
|
| Kein separater Berechtigungen-Tab | genommen | Berechtigungen sind fuer Admins Teil des Tabs `Rollen und Berechtigungen` |
|
||||||
@@ -90,12 +91,12 @@ Wie schneiden wir RBAC so, dass es genug fuer Dev/Handoff ist, aber nicht zu ein
|
|||||||
|
|
||||||
1. Admin oeffnet Mitarbeiterliste.
|
1. Admin oeffnet Mitarbeiterliste.
|
||||||
2. Admin laedt Nutzer ein und weist eine oder mehrere Rollen zu.
|
2. Admin laedt Nutzer ein und weist eine oder mehrere Rollen zu.
|
||||||
3. Admin nutzt vorgebaute Rollen oder erstellt eine eigene Rolle mit eigenem Namen.
|
3. Admin nutzt `Admin` als geschuetzte Systemrolle oder erstellt eine eigene Rolle mit eigenem Namen.
|
||||||
4. Wenn ein Nutzer deaktiviert wird, bestaetigt der Admin eine kurze Sicherheitsfrage.
|
4. Wenn ein Nutzer deaktiviert wird, bestaetigt der Admin eine kurze Sicherheitsfrage.
|
||||||
|
|
||||||
### Varianten / Branches
|
### Varianten / Branches
|
||||||
|
|
||||||
- Rolle erstellen: Name, Beschreibung und Permission-Bundles auswaehlen.
|
- Rolle anlegen: Name, Beschreibung und Permission-Bundles auswaehlen.
|
||||||
- Rolle bearbeiten: Permission-Bundles anpassen.
|
- Rolle bearbeiten: Permission-Bundles anpassen.
|
||||||
- Rolle loeschen: nur moeglich, wenn keine Mitarbeiter zugewiesen sind; sonst kleines Blocker-Modal und manuelle Umzuweisung.
|
- Rolle loeschen: nur moeglich, wenn keine Mitarbeiter zugewiesen sind; sonst kleines Blocker-Modal und manuelle Umzuweisung.
|
||||||
- Nutzer deaktivieren: kurzes Confirm-Modal; Status wird danach `Deaktiviert`.
|
- Nutzer deaktivieren: kurzes Confirm-Modal; Status wird danach `Deaktiviert`.
|
||||||
@@ -134,8 +135,8 @@ Wie schneiden wir RBAC so, dass es genug fuer Dev/Handoff ist, aber nicht zu ein
|
|||||||
| Rollen-Dropdown in Mitarbeiterliste | direkte Rollenzuweisung und Sprung zum Tab `Rollen und Berechtigungen` | Nur dokumentieren |
|
| Rollen-Dropdown in Mitarbeiterliste | direkte Rollenzuweisung und Sprung zum Tab `Rollen und Berechtigungen` | Nur dokumentieren |
|
||||||
| Mitarbeiter deaktivieren | einfache Sicherheitsbestaetigung | Bauen |
|
| Mitarbeiter deaktivieren | einfache Sicherheitsbestaetigung | Bauen |
|
||||||
| Deaktivieren mit Reassign | spaetere Uebertragung offener Verantwortlichkeiten | Backlog |
|
| Deaktivieren mit Reassign | spaetere Uebertragung offener Verantwortlichkeiten | Backlog |
|
||||||
| Rollen und Berechtigungen | vorgebaute und eigene Rollen verwalten | Bauen |
|
| Rollen und Berechtigungen | Systemrolle `Admin` und eigene Rollen verwalten | Bauen |
|
||||||
| Rolle erstellen/bearbeiten | eigene Rollen anlegen/benennen, Seed-Rollen bearbeiten, Permission-Bundles setzen | In S02 loesen |
|
| Rolle anlegen/bearbeiten | eigene Rollen anlegen/benennen und atomar Permissions setzen | In S02 loesen |
|
||||||
| Rechtebereiche im Tab `Rollen und Berechtigungen` | erklaert Berechtigungen im Kontext der Rolle | In S02 loesen |
|
| Rechtebereiche im Tab `Rollen und Berechtigungen` | erklaert Berechtigungen im Kontext der Rolle | In S02 loesen |
|
||||||
| Rolle loeschen mit Ersatzrolle | verhindert Rechteverlust | Backlog |
|
| Rolle loeschen mit Ersatzrolle | verhindert Rechteverlust | Backlog |
|
||||||
| Letzter Admin blockiert | Sicherheitsblocker | Validiert |
|
| Letzter Admin blockiert | Sicherheitsblocker | Validiert |
|
||||||
@@ -149,15 +150,9 @@ Wie schneiden wir RBAC so, dass es genug fuer Dev/Handoff ist, aber nicht zu ein
|
|||||||
| Typ | Rolle | Zweck | Notiz |
|
| Typ | Rolle | Zweck | Notiz |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| Systemrolle | Admin | Vollzugriff auf Mitarbeiter, Rollen, Workspace-Settings und kritische Admin-Funktionen | einzige sichtbare Systemrolle |
|
| Systemrolle | Admin | Vollzugriff auf Mitarbeiter, Rollen, Workspace-Settings und kritische Admin-Funktionen | einzige sichtbare Systemrolle |
|
||||||
| Seed-Rolle | Geschaeftsfuehrer | Leitung, voller fachlicher Ueberblick, Team/Rechte/Billing | bearbeitbare Startrolle |
|
| Custom Role | frei benennbar | Admin legt eigene Rolle an | Name, Beschreibung, Bereich und Permission-Bereiche |
|
||||||
| Seed-Rolle | Projektleiter | Projekte, Aufgaben, Teamueberblick, operative Steuerung | bearbeitbare Startrolle |
|
|
||||||
| Seed-Rolle | Verwaltung | Buero, Stammdaten, Rechnungen, Mitglieder-Ueberblick | bearbeitbare Startrolle |
|
|
||||||
| Seed-Rolle | Vertriebler | Leads, Angebote, Kundenkommunikation | bearbeitbare Startrolle |
|
|
||||||
| Seed-Rolle | Kundensupporter | Kundenanfragen, Kommunikation, Servicefaelle | bearbeitbare Startrolle |
|
|
||||||
| Seed-Rolle | Monteur | zugewiesene Auftraege/Tasks mobil bearbeiten | bearbeitbare Startrolle |
|
|
||||||
| Custom Role | frei benennbar | Admin legt eigene Rolle an | Name, Beschreibung, Permission-Bundles |
|
|
||||||
|
|
||||||
Notiz: Die sechs Seed-Rollen sind fachliche Startpunkte und sollen direkt bearbeitbar sein. Admins koennen zusaetzlich eigene Rollen anlegen und benennen.
|
Notiz: Es gibt in v1 keine sichtbaren vordefinierten Rollen ausser `Admin`. Vorlagen wie Geschaeftsfuehrer, Projektleiter, Verwaltung, Vertriebler, Kundensupporter oder Monteur koennen spaeter beim Erstellen einer Rolle angeboten werden, sind aber Work in Progress und nicht Teil der initialen Rollenliste.
|
||||||
|
|
||||||
### Permission-Bundles fuer den Editor
|
### Permission-Bundles fuer den Editor
|
||||||
|
|
||||||
@@ -178,16 +173,16 @@ Die folgenden Bundles sind nur ein Arbeitsgeruest fuer Planung und Wireframe. Si
|
|||||||
| Aufgaben/Dateien | Tasks, Dokumente, Uploads, Freigaben | fachliches Modul, ggf. spaeter |
|
| Aufgaben/Dateien | Tasks, Dokumente, Uploads, Freigaben | fachliches Modul, ggf. spaeter |
|
||||||
| Kommunikation/Support | Anfragen, Chat, Telefonie/Support-Kontext | fachliches Modul, ggf. spaeter |
|
| Kommunikation/Support | Anfragen, Chat, Telefonie/Support-Kontext | fachliches Modul, ggf. spaeter |
|
||||||
|
|
||||||
### Grober Rollenzuschnitt
|
### Rollen-Vorlagen WIP
|
||||||
|
|
||||||
| Rolle | Permission-Richtung |
|
| Vorlage | Permission-Richtung | Status |
|
||||||
|---|---|
|
|---|---|---|
|
||||||
| Geschaeftsfuehrer | fast alles, inklusive Mitarbeiter, Rollen, Workspace Settings, Abrechnung, Audit |
|
| Geschaeftsfuehrer | fast alles, inklusive Mitarbeiter, Rollen, Workspace Settings, Abrechnung, Audit | WIP, nicht in v1-Rollenliste |
|
||||||
| Projektleiter | Projekte/Auftraege, Aufgaben/Dateien, Team-Ueberblick, Mitglieder nur lesen |
|
| Projektleiter | Projekte/Auftraege, Aufgaben/Dateien, Team-Ueberblick, Mitglieder nur lesen | WIP |
|
||||||
| Verwaltung | Mitarbeiter lesen, Workspace/Account-Basis, Abrechnung/Rechnungen, Kunden-/Projekt-Ueberblick |
|
| Verwaltung | Mitarbeiter lesen, Workspace/Account-Basis, Abrechnung/Rechnungen, Kunden-/Projekt-Ueberblick | WIP |
|
||||||
| Vertriebler | CRM/Kunden, Leads/Vertrieb, Angebote, eigene Pipeline |
|
| Vertriebler | CRM/Kunden, Leads/Vertrieb, Angebote, eigene Pipeline | WIP |
|
||||||
| Kundensupporter | Kundenkommunikation, Supportfaelle, lesender Projekt-/Kundenkontext |
|
| Kundensupporter | Kundenkommunikation, Supportfaelle, lesender Projekt-/Kundenkontext | WIP |
|
||||||
| Monteur | eigene/zugewiesene Auftraege, Aufgaben, Dateien, mobile Ausfuehrung |
|
| Monteur | eigene/zugewiesene Auftraege, Aufgaben, Dateien, mobile Ausfuehrung | WIP |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -211,11 +206,13 @@ Wir validieren einzeln und legen erst danach Screen-Dateien/Canvas an.
|
|||||||
|
|
||||||
1. `S01 Mitarbeiterliste`
|
1. `S01 Mitarbeiterliste`
|
||||||
2. `M01 Mitarbeiter einladen`
|
2. `M01 Mitarbeiter einladen`
|
||||||
3. `D01 Rollen-Dropdown in Mitarbeiterliste`
|
3. Rollen-Dropdown innerhalb `S01 Mitarbeiterliste` pruefen; D01 bleibt nur Dokumentation, kein eigener Subframe-Screen
|
||||||
4. `M03 Mitarbeiter deaktivieren`
|
4. `M03 Mitarbeiter deaktivieren`
|
||||||
5. `S02 Rollen und Berechtigungen`
|
5. `S02 Rollen und Berechtigungen`
|
||||||
6. `M02 Rolle erstellen/bearbeiten`
|
6. `M04A Rolle anlegen`
|
||||||
7. `D03 Rolle in Nutzung blockiert`
|
7. `M04B Rolle duplizieren`
|
||||||
|
8. `M02 Rolle bearbeiten`
|
||||||
|
9. `D03 Rolle in Nutzung blockiert`
|
||||||
|
|
||||||
### S01 Mitarbeiterliste
|
### S01 Mitarbeiterliste
|
||||||
|
|
||||||
@@ -283,13 +280,13 @@ Layout:
|
|||||||
1. Header: `Rollen und Berechtigungen`, CTA `Rolle anlegen`.
|
1. Header: `Rollen und Berechtigungen`, CTA `Rolle anlegen`.
|
||||||
2. Toolbar:
|
2. Toolbar:
|
||||||
- Suchfeld: Rollenname, Beschreibung.
|
- Suchfeld: Rollenname, Beschreibung.
|
||||||
- Filter `Typ`: Systemrolle, Seed-Rolle, Eigene Rolle.
|
- Filter `Typ`: Systemrolle, Eigene Rolle.
|
||||||
- Filter `Permission-Bundle`: z. B. Mitarbeiter, Abrechnung, Projekte.
|
- Filter `Permission-Bereich`: z. B. Mitarbeiter, Abrechnung, Dateien, Aufgaben.
|
||||||
- Filter `In Nutzung`: mit Mitgliedern / ohne Mitglieder.
|
- Filter `In Nutzung`: mit Mitgliedern / ohne Mitglieder.
|
||||||
3. Tabelle:
|
3. Tabelle:
|
||||||
- Rolle.
|
- Rolle.
|
||||||
- Beschreibung.
|
- Beschreibung.
|
||||||
- Typ: System, Seed-Rolle, Eigene Rolle.
|
- Typ: Systemrolle, Eigene Rolle.
|
||||||
- Mitglieder: Avatar-Stack oder Anzahl.
|
- Mitglieder: Avatar-Stack oder Anzahl.
|
||||||
- Status: Aktiv, Pruefen.
|
- Status: Aktiv, Pruefen.
|
||||||
- Aktionen: 3-Punkte-Menue rechts.
|
- Aktionen: 3-Punkte-Menue rechts.
|
||||||
@@ -299,7 +296,9 @@ Layout:
|
|||||||
- bei Systemrolle `Admin` keine Loeschen-Aktion.
|
- bei Systemrolle `Admin` keine Loeschen-Aktion.
|
||||||
5. Rollen-Bearbeitung:
|
5. Rollen-Bearbeitung:
|
||||||
- passiert in diesem Tab/Subpage-Kontext.
|
- passiert in diesem Tab/Subpage-Kontext.
|
||||||
- aus `Bearbeiten`, `Duplizieren` oder `Rolle anlegen` oeffnet sich ein sehr grosses Modal.
|
- `Rolle anlegen` oeffnet M04A mit Basisdaten.
|
||||||
|
- `Bearbeiten` oeffnet M02 direkt im grossen Permission-Editor.
|
||||||
|
- `Duplizieren` oeffnet M04B mit vorausgefuellten Basisdaten.
|
||||||
- das Modal ist nicht aus der Mitarbeiterliste heraus erreichbar, sondern nur aus `Rollen und Berechtigungen`.
|
- das Modal ist nicht aus der Mitarbeiterliste heraus erreichbar, sondern nur aus `Rollen und Berechtigungen`.
|
||||||
6. Rechtebereiche:
|
6. Rechtebereiche:
|
||||||
- werden beim Bearbeiten einer Rolle angezeigt.
|
- werden beim Bearbeiten einer Rolle angezeigt.
|
||||||
@@ -312,44 +311,112 @@ Layout:
|
|||||||
- Aktion: `Verstanden`; Admin weist Mitglieder danach manuell einer anderen Rolle zu.
|
- Aktion: `Verstanden`; Admin weist Mitglieder danach manuell einer anderen Rolle zu.
|
||||||
- Ersatzrolle/Bulk-Reassign bleibt Backlog.
|
- Ersatzrolle/Bulk-Reassign bleibt Backlog.
|
||||||
|
|
||||||
### M02 Rolle erstellen/bearbeiten
|
### M04A Rolle anlegen
|
||||||
|
|
||||||
Ziel: Admin erstellt eine eigene Rolle oder passt eine vorhandene/Seed-Rolle an, ohne die Rollen-Subpage zu verlassen.
|
Ziel: Admin klaert bei einer komplett neuen eigenen Rolle zuerst Name, Beschreibung und Bereich, bevor die atomaren Berechtigungen gesetzt werden.
|
||||||
|
|
||||||
|
Einstieg:
|
||||||
|
|
||||||
|
1. `Rolle anlegen` aus S02 oeffnet M04A mit leerem Formular.
|
||||||
|
2. `Bearbeiten` nutzt M04A nicht und springt direkt in M02.
|
||||||
|
3. `Duplizieren` nutzt M04A nicht, sondern M04B.
|
||||||
|
|
||||||
Layout:
|
Layout:
|
||||||
|
|
||||||
1. Sehr grosses Modal ueber dem Tab `Rollen und Berechtigungen`.
|
1. Modal-Step ueber `S02 Rollen und Berechtigungen`, mit Schliessen-Icon.
|
||||||
|
2. Headline: `Rolle anlegen`.
|
||||||
|
3. Formular:
|
||||||
|
- Rollenname als Pflichtfeld.
|
||||||
|
- Beschreibung als optionales Textfeld.
|
||||||
|
- Bereich/Kategorie als Select, z. B. Team, Verwaltung, Operativ.
|
||||||
|
4. Optionaler Bereich `Vorlage verwenden`:
|
||||||
|
- nur als Work-in-Progress-Platzhalter.
|
||||||
|
- Vorlagen sind keine Seed-Rollen und erscheinen nicht in der Rollenliste.
|
||||||
|
5. Footer:
|
||||||
|
- `Weiter zu Berechtigungen` fuehrt zu M02.
|
||||||
|
- `Abbrechen` schliesst den Modal-Step.
|
||||||
|
|
||||||
|
Subframe:
|
||||||
|
|
||||||
|
- M04A ist der bestehende Subframe-Screen fuer `Rolle anlegen`.
|
||||||
|
- Der Screen bleibt als Dialog/Modal-Step ueber S02 gedacht.
|
||||||
|
|
||||||
|
### M04B Rolle duplizieren
|
||||||
|
|
||||||
|
Ziel: Admin nutzt eine bestehende eigene Rolle als Startpunkt, passt die Basisdaten an und landet danach im grossen Permission-Editor mit kopierten Berechtigungen.
|
||||||
|
|
||||||
|
Einstieg:
|
||||||
|
|
||||||
|
1. `Duplizieren` aus dem Zeilenmenue in S02 oeffnet M04B mit vorausgefuellten Basisdaten.
|
||||||
|
2. `Rolle anlegen` nutzt M04B nicht, sondern M04A.
|
||||||
|
3. `Bearbeiten` nutzt M04B nicht und springt direkt in M02.
|
||||||
|
|
||||||
|
Layout:
|
||||||
|
|
||||||
|
1. Modal-Step ueber `S02 Rollen und Berechtigungen`, mit Schliessen-Icon.
|
||||||
|
2. Headline: `Rolle duplizieren`.
|
||||||
|
3. Hinweisblock: Basisdaten und Berechtigungen werden aus der Quellrolle kopiert.
|
||||||
|
4. Formular:
|
||||||
|
- Rollenname als Pflichtfeld, vorausgefuellt z. B. als `Kopie von ...`.
|
||||||
|
- Beschreibung als optionales Textfeld.
|
||||||
|
- Bereich/Kategorie als Select.
|
||||||
|
5. Footer:
|
||||||
|
- `Weiter zu Berechtigungen` fuehrt zu M02.
|
||||||
|
- `Abbrechen` schliesst den Modal-Step.
|
||||||
|
|
||||||
|
Subframe:
|
||||||
|
|
||||||
|
- M04B ist der bestehende Subframe-Screen fuer `Rolle duplizieren`.
|
||||||
|
- Der Screen bleibt als Dialog/Modal-Step ueber S02 gedacht.
|
||||||
|
|
||||||
|
### M02 Rolle bearbeiten
|
||||||
|
|
||||||
|
Ziel: Admin bearbeitet die Basisdaten und Berechtigungen einer vorhandenen oder gerade angelegten eigenen Rolle, ohne die Rollen-Subpage zu verlassen. Die Systemrolle `Admin` ist geschuetzt.
|
||||||
|
|
||||||
|
Einstiege:
|
||||||
|
|
||||||
|
1. `Bearbeiten` auf einer bestehenden Rolle oeffnet direkt den grossen Permission-Editor.
|
||||||
|
- Der Admin landet sofort im Editor, oben im Bereich `Rolle`.
|
||||||
|
- Rollenname, Beschreibung und Bereich/Kategorie bleiben dort weiterhin editierbar.
|
||||||
|
2. `Rolle anlegen` kommt aus M04A und uebergibt die Basisdaten in den Editor.
|
||||||
|
3. `Duplizieren` kommt aus M04B, mit vorausgefuellten Basisdaten und kopierten Berechtigungen.
|
||||||
|
|
||||||
|
Layout:
|
||||||
|
|
||||||
|
1. Sehr grosser Modal-Flow ueber dem Tab `Rollen und Berechtigungen`.
|
||||||
2. Modal kann jederzeit geschlossen werden.
|
2. Modal kann jederzeit geschlossen werden.
|
||||||
3. Kopfbereich:
|
3. Im Editor steht oben der Bereich `Rolle`:
|
||||||
- Rollenname.
|
- Rollenname.
|
||||||
- Beschreibung.
|
- Beschreibung.
|
||||||
- optional: Start aus Vorlage.
|
- Bereich/Kategorie der Rolle, z. B. Team, Verwaltung, Operativ.
|
||||||
- optional: Standardrolle fuer neue Nutzer.
|
- Typ als Information: `Systemrolle` oder `Eigene Rolle`; nicht frei umstellbar.
|
||||||
4. Globale Berechtigungs-Suche:
|
- diese Daten koennen auch nach M04A/M04B weiterhin bearbeitet werden.
|
||||||
- Suchfeld oben im Modal.
|
4. Linke Sidebar:
|
||||||
|
- oben links sitzt die globale Suche, aehnlich Apple-Einstellungen.
|
||||||
|
- darunter stehen die Bereiche als Navigation.
|
||||||
|
- Beispiele: Rolle, Allgemein, Mitarbeiter, Rollen und Berechtigungen, Workspace Settings, Abrechnung, Audit & Sicherheit, Integrationen/API, Dateien, Aufgaben.
|
||||||
|
- Klick springt zum jeweiligen Bereich im scrollbaren Modal.
|
||||||
|
5. Globale Berechtigungs-Suche:
|
||||||
|
- Suchfeld links ueber der Sidebar.
|
||||||
- durchsucht alle Berechtigungen/Rechtebereiche ueber alle Module hinweg.
|
- durchsucht alle Berechtigungen/Rechtebereiche ueber alle Module hinweg.
|
||||||
- filtert die sichtbaren Treffer bereichsuebergreifend.
|
- filtert die sichtbaren Treffer bereichsuebergreifend.
|
||||||
- Treffer bleiben ihren Bereichsueberschriften zugeordnet, damit Kontext erhalten bleibt.
|
- Treffer bleiben ihren Bereichsueberschriften zugeordnet, damit Kontext erhalten bleibt.
|
||||||
5. Linke Sidebar:
|
6. Hauptbereich:
|
||||||
- zeigt die Rechtebereiche/Module als Navigation.
|
- startet oben mit `Rolle`.
|
||||||
- Beispiele: Ueberblick, Mitarbeiter, Rollen und Berechtigungen, Workspace Settings, Abrechnung, Audit & Sicherheit, Integrationen/API, CRM/Kunden, Leads/Vertrieb, Projekte/Auftraege, Aufgaben/Dateien, Kommunikation/Support.
|
- darunter folgen `Allgemein` und die weiteren Rechtebereiche.
|
||||||
- Klick springt zum jeweiligen Bereich im Modal.
|
|
||||||
6. Startzustand `Ueberblick`:
|
|
||||||
- ist initial aktiv.
|
|
||||||
- zeigt eine scrollbare Liste aller Berechtigungen/Rechtebereiche.
|
|
||||||
- die Bereichsueberschriften entsprechen den Eintraegen in der linken Sidebar.
|
- die Bereichsueberschriften entsprechen den Eintraegen in der linken Sidebar.
|
||||||
- Admin kann bis ganz nach unten scrollen.
|
- Admin kann durch alle Bereiche nach unten scrollen.
|
||||||
7. Rechtebereiche:
|
7. Permission-Abschnitte:
|
||||||
- jeder Bereich hat Toggle/Checkboxen, um Berechtigungen an- oder auszuschalten.
|
- jeder Bereich hat einzelne Zeilen mit Toggle-Switches, um Berechtigungen an- oder auszuschalten.
|
||||||
- Bereich kann eine Kurzbeschreibung enthalten.
|
- Bereich kann eine Kurzbeschreibung enthalten.
|
||||||
- einzelne technische Rechte koennen als Advanced Details aufgeklappt werden, falls noetig.
|
- einzelne technische Rechte koennen als Advanced Details aufgeklappt werden, falls noetig.
|
||||||
8. Permission-Zeilenmuster:
|
8. Permission-Zeilenmuster:
|
||||||
- eine Beispiel-Permission wird im Wireframe konkret vorgebaut.
|
- eine Beispiel-Permission wird im Wireframe konkret vorgebaut.
|
||||||
- Aufbau: links Ueberschrift, darunter kurze Beschreibung; rechts die Zugriffsauswahl.
|
- Aufbau als Tabelle/Liste wie in der Referenz: links Setting/Permission, mittig Beschreibung, rechts Enable/Disable.
|
||||||
- Beispiel-Ueberschrift: `Mitarbeiter ansehen`.
|
- Beispiel-Ueberschrift: `Mitarbeiter ansehen`.
|
||||||
- Beispiel-Beschreibung: `Darf Mitarbeiterliste und Mitarbeiterprofile im Workspace lesen.`
|
- Beispiel-Beschreibung: `Darf Mitarbeiterliste und Mitarbeiterprofile im Workspace lesen.`
|
||||||
- Control: Segmented Control `Aus`, `Read-only`, `Bearbeiten`; alternativ Toggle `Aus/An`, wenn die Permission nur binaer ist.
|
- Control: Toggle-Switch `An/Aus`.
|
||||||
- `Read-only` steht fuer lesenden Zugriff ohne Bearbeiten/Aendern.
|
- Wenn ein Recht Abstufungen braucht, kann spaeter `Read-only/Bearbeiten` als Detail/Advanced Control ergaenzt werden.
|
||||||
- weitere Permissions koennen Development-seitig nach diesem Muster ergaenzt werden.
|
- weitere Permissions koennen Development-seitig nach diesem Muster ergaenzt werden.
|
||||||
9. Footer:
|
9. Footer:
|
||||||
- Speichern.
|
- Speichern.
|
||||||
@@ -365,7 +432,9 @@ Layout:
|
|||||||
| D01 | Rollen-Dropdown in Mitarbeiterliste | nein | ja | Validiert | direkte Rollenauswahl; Bearbeiten fuehrt in `Rollen und Berechtigungen` |
|
| D01 | Rollen-Dropdown in Mitarbeiterliste | nein | ja | Validiert | direkte Rollenauswahl; Bearbeiten fuehrt in `Rollen und Berechtigungen` |
|
||||||
| M03 | Mitarbeiter deaktivieren | ja | ja | Validiert | kleines Confirm-Modal, kein Reassign |
|
| M03 | Mitarbeiter deaktivieren | ja | ja | Validiert | kleines Confirm-Modal, kein Reassign |
|
||||||
| S02 | Rollen und Berechtigungen | ja | ja | Validiert | Rollen-Tabelle nach Referenz, 3-Punkte-Menue, nur Systemrolle Admin |
|
| S02 | Rollen und Berechtigungen | ja | ja | Validiert | Rollen-Tabelle nach Referenz, 3-Punkte-Menue, nur Systemrolle Admin |
|
||||||
| M02 | Rolle erstellen/bearbeiten | ja | ja, Permissions | Validiert | grosses Modal mit Sidebar, Ueberblick, globaler Suche und Rechte-Toggles |
|
| M04A | Rolle anlegen | ja | ja | Validiert | eigener Basisdaten-Step fuer neue Rollen vor dem Permission-Editor |
|
||||||
|
| M04B | Rolle duplizieren | ja | ja | Validiert | eigener Basisdaten-Step fuer duplizierte Rollen mit Quellrollen-Kontext |
|
||||||
|
| M02 | Rolle bearbeiten | ja | ja, Permissions | Validiert | grosses Modal mit Sidebar, Ueberblick, globaler Suche und Rechte-Toggles |
|
||||||
| D03 | Rolle in Nutzung blockiert | nein | ja | Validiert | Loeschen nur ohne Mitglieder; sonst kleines Blocker-Modal, Ersatzrolle/Bulk-Reassign im Backlog |
|
| D03 | Rolle in Nutzung blockiert | nein | ja | Validiert | Loeschen nur ohne Mitglieder; sonst kleines Blocker-Modal, Ersatzrolle/Bulk-Reassign im Backlog |
|
||||||
| V01 | Letzter Admin blockiert | ja | ja, Sicherheitsblocker | Validiert | kleiner Blocker-State im jeweiligen Kontext |
|
| V01 | Letzter Admin blockiert | ja | ja, Sicherheitsblocker | Validiert | kleiner Blocker-State im jeweiligen Kontext |
|
||||||
|
|
||||||
@@ -391,16 +460,18 @@ Layout:
|
|||||||
|
|
||||||
## 9. Validierte Screen-Liste
|
## 9. Validierte Screen-Liste
|
||||||
|
|
||||||
Alle aktiven Screen-Kandidaten sind von David validiert. Seed-Rollen und Permission-Bundles sind als v1-Arbeitsfassung dokumentiert; der finale Rechtekatalog wird im Development ausgearbeitet.
|
Alle aktiven Screen-Kandidaten sind von David validiert. Das Rollenmodell startet nur mit `Admin` plus eigenen Rollen; Vorlagen und finaler Rechtekatalog werden spaeter ausgearbeitet.
|
||||||
|
|
||||||
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| S01 | Mitarbeiterliste | Admin List | Bauen | `Settings -> Mitarbeiter`, Tab `Mitarbeiter` | Validiert |
|
| S01 | Mitarbeiterliste | Admin List | Bauen | `Settings -> Mitarbeiter`, Tab `Mitarbeiter` | Validiert |
|
||||||
| M01 | Mitarbeiter einladen | Modal | Bauen | von S01 | Validiert |
|
| M01 | Mitarbeiter einladen | Modal | Bauen | von S01 | Validiert |
|
||||||
| D01 | Rollen-Dropdown in Mitarbeiterliste | Inline-Zustand | Nur dokumentieren | in S01 | Validiert |
|
| D01 | Rollen-Dropdown in Mitarbeiterliste | Inline-Zustand in S01 | Nur dokumentieren | in S01, kein eigener Subframe-Screen | Validiert |
|
||||||
| M03 | Mitarbeiter deaktivieren | Confirm Modal | Bauen | von S01 | Validiert |
|
| M03 | Mitarbeiter deaktivieren | Confirm Modal | Bauen | von S01 | Validiert |
|
||||||
| S02 | Rollen und Berechtigungen | Settings Subpage | Bauen | `Settings -> Mitarbeiter`, Tab `Rollen und Berechtigungen` | Validiert |
|
| S02 | Rollen und Berechtigungen | Settings Subpage | Bauen | `Settings -> Mitarbeiter`, Tab `Rollen und Berechtigungen` | Validiert |
|
||||||
| M02 | Rolle erstellen/bearbeiten | Grosses Modal | Bauen | von S02 | Validiert |
|
| M04A | Rolle anlegen | Modal Step | Bauen | von S02 CTA Rolle anlegen | Subframe: Rolle anlegen |
|
||||||
|
| M04B | Rolle duplizieren | Modal Step | Bauen | von S02 Zeilenaktion Duplizieren | Subframe: Rolle duplizieren |
|
||||||
|
| M02 | Rolle bearbeiten | Grosses Modal | Bauen | von S02 Bearbeiten oder M04A/M04B | Finale Subframe-Seite: M02 Rolle bearbeiten |
|
||||||
| D03 | Rolle in Nutzung blockiert | Admin Blocker | Nur dokumentieren | von S02/M02 | Validiert |
|
| D03 | Rolle in Nutzung blockiert | Admin Blocker | Nur dokumentieren | von S02/M02 | Validiert |
|
||||||
| V01 | Letzter Admin blockiert | Admin Blocker | Nur dokumentieren | von S01/M03/Rollenwechsel | Validiert |
|
| V01 | Letzter Admin blockiert | Admin Blocker | Nur dokumentieren | von S01/M03/Rollenwechsel | Validiert |
|
||||||
|
|
||||||
@@ -410,14 +481,28 @@ Alle aktiven Screen-Kandidaten sind von David validiert. Seed-Rollen und Permiss
|
|||||||
|
|
||||||
```text
|
```text
|
||||||
S01 Mitarbeiterliste -> M01 Mitarbeiter einladen
|
S01 Mitarbeiterliste -> M01 Mitarbeiter einladen
|
||||||
S01 Mitarbeiterliste -> D01 Rollen-Dropdown
|
|
||||||
S01 Mitarbeiterliste -> M03 Mitarbeiter deaktivieren
|
S01 Mitarbeiterliste -> M03 Mitarbeiter deaktivieren
|
||||||
S01 Mitarbeiterliste -> V01 Letzter Admin blockiert
|
S01 Mitarbeiterliste -> V01 Letzter Admin blockiert
|
||||||
S01 Mitarbeiterliste -> S02 Rollen und Berechtigungen via Dropdown-Eintrag
|
S01 Mitarbeiterliste -> Rolle wechseln inline
|
||||||
S02 Rollen und Berechtigungen -> M02 Rolle erstellen/bearbeiten
|
S01 Mitarbeiterliste -> S02 Rollen und Berechtigungen via Dropdown-Eintrag `Rollen und Berechtigungen bearbeiten`
|
||||||
|
S02 Rollen und Berechtigungen -> M04A Rolle anlegen via Rolle anlegen
|
||||||
|
S02 Rollen und Berechtigungen -> M04B Rolle duplizieren via Duplizieren
|
||||||
|
M04A Rolle anlegen -> M02 Rolle bearbeiten
|
||||||
|
M04B Rolle duplizieren -> M02 Rolle bearbeiten
|
||||||
|
S02 Rollen und Berechtigungen -> M02 Rolle bearbeiten via Bearbeiten
|
||||||
S02 Rollen und Berechtigungen -> D03 Rolle in Nutzung blockiert
|
S02 Rollen und Berechtigungen -> D03 Rolle in Nutzung blockiert
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Subframe-Stand M02/M04A/M04B
|
||||||
|
|
||||||
|
`M02 Rolle bearbeiten` ist die finale Subframe-Seite fuer die Umsetzung. Die alten M02-Referenzvarianten wurden aus Subframe geloescht, damit der Admin-RBAC-Flow clean bleibt. Fuer den M04-Split werden die bestehenden Subframe-Seiten getrennt referenziert: M04A fuer `Rolle anlegen`, M04B fuer `Rolle duplizieren`. Aktueller Subframe-Stand im Admin-RBAC-Flow:
|
||||||
|
|
||||||
|
| Screen | Subframe |
|
||||||
|
|---|---|
|
||||||
|
| M02 Rolle bearbeiten | [Subframe](<https://app.subframe.com/f023064a5ca0/design/9a9873e3-d790-4373-b8c2-fadd3b82cbe6/edit>) |
|
||||||
|
| M04A Rolle anlegen | [Subframe](<https://app.subframe.com/f023064a5ca0/design/479ee52d-8d73-46e9-9a9b-a8798a22d764/edit>) |
|
||||||
|
| M04B Rolle duplizieren | [Subframe](<https://app.subframe.com/f023064a5ca0/design/610d08e6-5c6a-44d3-9b29-220664393ea0/edit>) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 11. Screen-Pakete
|
## 11. Screen-Pakete
|
||||||
@@ -429,7 +514,9 @@ S02 Rollen und Berechtigungen -> D03 Rolle in Nutzung blockiert
|
|||||||
| D01 | [[Screens/D01 Rollen-Dropdown in Mitarbeiterliste]] |
|
| D01 | [[Screens/D01 Rollen-Dropdown in Mitarbeiterliste]] |
|
||||||
| M03 | [[Screens/M03 Mitarbeiter deaktivieren]] |
|
| M03 | [[Screens/M03 Mitarbeiter deaktivieren]] |
|
||||||
| S02 | [[Screens/S02 Rollen und Berechtigungen]] |
|
| S02 | [[Screens/S02 Rollen und Berechtigungen]] |
|
||||||
| M02 | [[Screens/M02 Rolle erstellen bearbeiten]] |
|
| M04A | [[Screens/M04A Rolle anlegen]] |
|
||||||
|
| M04B | [[Screens/M04B Rolle duplizieren]] |
|
||||||
|
| M02 | [[Screens/M02 Rolle bearbeiten]] |
|
||||||
| D03 | [[Screens/D03 Rolle in Nutzung blockiert]] |
|
| D03 | [[Screens/D03 Rolle in Nutzung blockiert]] |
|
||||||
| V01 | [[Screens/V01 Letzter Admin blockiert]] |
|
| V01 | [[Screens/V01 Letzter Admin blockiert]] |
|
||||||
|
|
||||||
@@ -447,7 +534,7 @@ Diese Punkte sind bewusst nicht Teil der v1-Screen-Liste, sollen aber fuer spaet
|
|||||||
| Rechtekatalog als eigener Tab | Alle technischen Berechtigungen unabhaengig von Rollen durchsuchen/erklaeren | v1 zeigt Rechte nur im Rollen-Editor |
|
| Rechtekatalog als eigener Tab | Alle technischen Berechtigungen unabhaengig von Rollen durchsuchen/erklaeren | v1 zeigt Rechte nur im Rollen-Editor |
|
||||||
| Rollen-Audit | Historie, wer Rollen/Rechte geaendert hat | Audit-Viewer nicht Teil dieses Pakets |
|
| Rollen-Audit | Historie, wer Rollen/Rechte geaendert hat | Audit-Viewer nicht Teil dieses Pakets |
|
||||||
| Rollen-Review / Needs Review | Rollen markieren, die geprueft werden muessen, inkl. Review-Zyklus | Status `Pruefen` ist UI-vorbereitet, Prozess spaeter |
|
| Rollen-Review / Needs Review | Rollen markieren, die geprueft werden muessen, inkl. Review-Zyklus | Status `Pruefen` ist UI-vorbereitet, Prozess spaeter |
|
||||||
| Rollen-Templates erweitern | weitere branchenspezifische Seed-Rollen oder Workspace-Templates | aktuelle Seed-Rollen reichen fuer v1 |
|
| Rollen-Vorlagen ausarbeiten | branchenspezifische Rollen-Vorlagen fuer neue Rollen definieren | Vorlagen sind aktuell Work in Progress und nicht Teil der initialen Rollenliste |
|
||||||
| Rechte-Matrix | Vergleich mehrerer Rollen nebeneinander | fuer v1 zu breit/technisch |
|
| Rechte-Matrix | Vergleich mehrerer Rollen nebeneinander | fuer v1 zu breit/technisch |
|
||||||
| Bulk-Aktionen | mehrere Mitarbeiter gleichzeitig einladen, deaktivieren oder Rollen zuweisen | spaeter, wenn Teamlisten groesser werden |
|
| Bulk-Aktionen | mehrere Mitarbeiter gleichzeitig einladen, deaktivieren oder Rollen zuweisen | spaeter, wenn Teamlisten groesser werden |
|
||||||
| Admin-Schutz erweitert | detaillierte Regeln fuer Selbst-Deaktivierung, letzter Admin, kritische Rollenwechsel | v1 dokumentiert Blocker, genaue Policy spaeter mit Dev/Security |
|
| Admin-Schutz erweitert | detaillierte Regeln fuer Selbst-Deaktivierung, letzter Admin, kritische Rollenwechsel | v1 dokumentiert Blocker, genaue Policy spaeter mit Dev/Security |
|
||||||
@@ -459,8 +546,8 @@ Diese Punkte sind bewusst nicht Teil der v1-Screen-Liste, sollen aber fuer spaet
|
|||||||
- [x] Paket ist angelegt.
|
- [x] Paket ist angelegt.
|
||||||
- [x] D-P2 Admin-Screens sind geprueft.
|
- [x] D-P2 Admin-Screens sind geprueft.
|
||||||
- [x] Gruppen sind fuer dieses Paket rausgenommen.
|
- [x] Gruppen sind fuer dieses Paket rausgenommen.
|
||||||
- [x] Vorgebaute Rollen plus eigene Rollen sind als Richtung notiert.
|
- [x] `Admin` als einzige Startrolle plus eigene Rollen sind als Richtung notiert.
|
||||||
- [x] Seed-Rollen- und Permission-Bundle-Vorschlag ist dokumentiert.
|
- [x] Rollen-Vorlagen sind als Work in Progress dokumentiert.
|
||||||
- [x] Permission-Bundles sind als Arbeitsgeruest markiert, nicht als finaler Rechtekatalog.
|
- [x] Permission-Bundles sind als Arbeitsgeruest markiert, nicht als finaler Rechtekatalog.
|
||||||
- [x] Permission-Zeilenmuster fuer das Rollen-Modal ist dokumentiert.
|
- [x] Permission-Zeilenmuster fuer das Rollen-Modal ist dokumentiert.
|
||||||
- [x] Grober Screen-Aufbau mit Suche/Filtern ist dokumentiert.
|
- [x] Grober Screen-Aufbau mit Suche/Filtern ist dokumentiert.
|
||||||
@@ -468,14 +555,18 @@ Diese Punkte sind bewusst nicht Teil der v1-Screen-Liste, sollen aber fuer spaet
|
|||||||
- [x] M01 Mitarbeiter einladen ist validiert.
|
- [x] M01 Mitarbeiter einladen ist validiert.
|
||||||
- [x] Rollen-Dropdown in S01 und Sprung zu `Rollen und Berechtigungen` sind dokumentiert.
|
- [x] Rollen-Dropdown in S01 und Sprung zu `Rollen und Berechtigungen` sind dokumentiert.
|
||||||
- [x] S02 Rollen und Berechtigungen ist validiert.
|
- [x] S02 Rollen und Berechtigungen ist validiert.
|
||||||
- [x] M02 Rolle erstellen/bearbeiten ist validiert.
|
- [x] M04A Rolle anlegen ist als eigener Screen vermerkt.
|
||||||
|
- [x] M04B Rolle duplizieren ist als eigener Screen vermerkt.
|
||||||
|
- [x] M02 Rolle bearbeiten ist validiert.
|
||||||
- [x] M03 Mitarbeiter deaktivieren ist validiert.
|
- [x] M03 Mitarbeiter deaktivieren ist validiert.
|
||||||
- [x] D03 Rolle in Nutzung blockiert ist validiert.
|
- [x] D03 Rolle in Nutzung blockiert ist validiert.
|
||||||
- [x] V01 Letzter Admin blockiert ist validiert.
|
- [x] V01 Letzter Admin blockiert ist validiert.
|
||||||
- [x] Reassign ist in den Backlog gelegt.
|
- [x] Reassign ist in den Backlog gelegt.
|
||||||
- [x] Backlog/V2-Liste ist dokumentiert.
|
- [x] Backlog/V2-Liste ist dokumentiert.
|
||||||
- [x] Seed-Rollen und Permission-Bundles sind fuer v1 ausreichend benannt.
|
- [x] Permission-Bundles sind fuer v1 als UI-Arbeitsgeruest ausreichend benannt.
|
||||||
- [x] David hat die Kandidaten validiert.
|
- [x] David hat die Kandidaten validiert.
|
||||||
- [x] Screen-Dateien sind angelegt.
|
- [x] Screen-Dateien sind angelegt und nach Screen-Zuschnitt synchronisiert.
|
||||||
- [x] Canvas ist angelegt.
|
- [x] Canvas ist angelegt und nach M04-Split synchronisiert.
|
||||||
- [ ] Subframe-Link ist eingetragen.
|
- [x] M01/M02/M03/M04A/M04B/D03/V01 sind auf echte Subframe-Dialog-Struktur geprueft: `DialogLayout` -> `Dialog` -> `Dialog.Content`.
|
||||||
|
- [x] Subframe-Links sind eingetragen.
|
||||||
|
- [x] M04A ist visuell an den final angepassten M04B-Duplikat-Screen angeglichen, aber ohne Duplikat-Modus.
|
||||||
@@ -6,8 +6,8 @@ package: WF-P2 Konto loeschen
|
|||||||
id: M01
|
id: M01
|
||||||
screen: Loeschung anfragen
|
screen: Loeschung anfragen
|
||||||
typ: Modal
|
typ: Modal
|
||||||
umsetzung: Bauen
|
umsetzung: Spaeter
|
||||||
status: In Subframe
|
status: Backlog
|
||||||
route: von S01
|
route: von S01
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/design/e8454b77-b5bc-4c80-b035-bde4318793e7/edit"
|
subframe: "https://app.subframe.com/f023064a5ca0/design/e8454b77-b5bc-4c80-b035-bde4318793e7/edit"
|
||||||
---
|
---
|
||||||
@@ -16,7 +16,9 @@ subframe: "https://app.subframe.com/f023064a5ca0/design/e8454b77-b5bc-4c80-b035-
|
|||||||
|
|
||||||
## Ziel
|
## Ziel
|
||||||
|
|
||||||
Der Nutzer bestaetigt bewusst, dass er eine Loeschungsanfrage stellen moechte.
|
Dieser Modal-Screen ist als Backlog-Referenz geparkt. Spaeter bestaetigt der Nutzer hier bewusst, dass er eine Account/Konto-Loeschungsanfrage stellen moechte.
|
||||||
|
|
||||||
|
> Backlog-Hinweis: Der Screen wird erst weiter geplant, wenn `Workspace Settings` und die genaue Trennung von Account/Konto-Loeschung vs. Workspace-Loeschung validiert sind.
|
||||||
|
|
||||||
## Pattern / Archetyp
|
## Pattern / Archetyp
|
||||||
|
|
||||||
@@ -30,7 +32,7 @@ A5 Confirm-Modal.
|
|||||||
|
|
||||||
## Aktionen
|
## Aktionen
|
||||||
|
|
||||||
- Anfrage senden
|
- spaeter: Anfrage senden
|
||||||
- abbrechen
|
- abbrechen
|
||||||
|
|
||||||
## Banner / Hinweise
|
## Banner / Hinweise
|
||||||
@@ -47,9 +49,9 @@ A5 Confirm-Modal.
|
|||||||
|
|
||||||
| Zustand | Beschreibung | Umsetzung |
|
| Zustand | Beschreibung | Umsetzung |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Confirm | Erklaerung + Anfrage senden | Bauen |
|
| Confirm | Erklaerung + Anfrage senden | Backlog |
|
||||||
| Laden | Anfrage wird gesendet | Wiederverwenden |
|
| Laden | Anfrage wird gesendet | Backlog/Wiederverwenden |
|
||||||
| Anfrage fehlgeschlagen | Banner/Inline mit Retry | Nur dokumentieren |
|
| Anfrage fehlgeschlagen | Banner/Inline mit Retry | Backlog |
|
||||||
|
|
||||||
## Permissions / Gates
|
## Permissions / Gates
|
||||||
|
|
||||||
@@ -57,8 +59,9 @@ A5 Confirm-Modal.
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
-
|
- Existierender Subframe-Screen bleibt als geparkte Referenz.
|
||||||
|
- Nicht als aktiver v1-Screen weiterbauen, bis der Workflow neu validiert ist.
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
Kein Countdown, keine Confirm-Phrase und kein Reauth-Step in v1. Diese Komplexitaet liegt im Backlog fuer den spaeteren echten Loeschprozess.
|
Kein Countdown, keine Confirm-Phrase und kein Reauth-Step jetzt. Diese Komplexitaet liegt im Backlog fuer den spaeteren echten Loeschprozess.
|
||||||
+15
-12
@@ -6,8 +6,8 @@ package: WF-P2 Konto loeschen
|
|||||||
id: S01
|
id: S01
|
||||||
screen: Settings -> Workspaces / Loeschbereich
|
screen: Settings -> Workspaces / Loeschbereich
|
||||||
typ: Settings
|
typ: Settings
|
||||||
umsetzung: Bauen
|
umsetzung: Spaeter
|
||||||
status: In Subframe
|
status: Backlog
|
||||||
route: /settings/workspaces
|
route: /settings/workspaces
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/design/7f54d6e5-df2f-4163-bb36-1310062b2429/edit"
|
subframe: "https://app.subframe.com/f023064a5ca0/design/7f54d6e5-df2f-4163-bb36-1310062b2429/edit"
|
||||||
---
|
---
|
||||||
@@ -16,7 +16,9 @@ subframe: "https://app.subframe.com/f023064a5ca0/design/7f54d6e5-df2f-4163-bb36-
|
|||||||
|
|
||||||
## Ziel
|
## Ziel
|
||||||
|
|
||||||
Der Nutzer findet im Settings-Bereich `Workspaces` den minimalen Einstieg, um eine Loeschungsanfrage zu stellen.
|
Dieser Screen ist als Backlog-Referenz geparkt. Der Nutzer soll spaeter im noch zu planenden Settings-Bereich `Workspaces` einen Einstieg fuer Account/Konto-Loeschung finden koennen.
|
||||||
|
|
||||||
|
> Backlog-Hinweis: Der gesamte Konto-Loeschworkflow wird aktuell nicht weitergebaut. `Workspace Settings` existieren noch nicht als validierter Bereich.
|
||||||
|
|
||||||
## Pattern / Archetyp
|
## Pattern / Archetyp
|
||||||
|
|
||||||
@@ -30,14 +32,14 @@ A6 Settings / Workspace Settings.
|
|||||||
|
|
||||||
## Aktionen
|
## Aktionen
|
||||||
|
|
||||||
- Loeschung anfragen -> M01
|
- spaeter: Loeschung anfragen -> M01
|
||||||
- Status einer bestehenden Anfrage ansehen
|
- spaeter: Status einer bestehenden Anfrage ansehen
|
||||||
- Settings verlassen
|
- Settings verlassen
|
||||||
|
|
||||||
## Banner / Hinweise
|
## Banner / Hinweise
|
||||||
|
|
||||||
- Klar formulieren: Es wird eine Anfrage gestellt, keine sofortige Loeschung ausgefuehrt.
|
- Klar formulieren: Es wird eine Anfrage gestellt, keine sofortige Loeschung ausgefuehrt.
|
||||||
- Workspaces-Bereich ist v1 minimal; weitere Workspace-Settings kommen spaeter.
|
- Workspaces-Bereich ist noch nicht gebaut; weitere Workspace-Settings kommen spaeter.
|
||||||
|
|
||||||
## Toasts / Action-Feedback
|
## Toasts / Action-Feedback
|
||||||
|
|
||||||
@@ -48,10 +50,10 @@ A6 Settings / Workspace Settings.
|
|||||||
|
|
||||||
| Zustand | Beschreibung | Umsetzung |
|
| Zustand | Beschreibung | Umsetzung |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Keine Anfrage | CTA `Loeschung anfragen` sichtbar | Bauen |
|
| Keine Anfrage | CTA `Loeschung anfragen` sichtbar | Backlog |
|
||||||
| Anfrage offen | Status/Banner statt erneuter CTA | Nur dokumentieren |
|
| Anfrage offen | Status/Banner statt erneuter CTA | Backlog |
|
||||||
| Keine Berechtigung | CTA verborgen oder deaktiviert | Nur dokumentieren |
|
| Keine Berechtigung | CTA verborgen oder deaktiviert | Backlog |
|
||||||
| Anfrage fehlgeschlagen | Banner mit Retry | Nur dokumentieren |
|
| Anfrage fehlgeschlagen | Banner mit Retry | Backlog |
|
||||||
|
|
||||||
## Permissions / Gates
|
## Permissions / Gates
|
||||||
|
|
||||||
@@ -60,8 +62,9 @@ A6 Settings / Workspace Settings.
|
|||||||
|
|
||||||
## Subframe
|
## Subframe
|
||||||
|
|
||||||
-
|
- Existierender Subframe-Screen bleibt als geparkte Referenz.
|
||||||
|
- Nicht als aktiver v1-Screen weiterbauen, bis Workspace Settings validiert sind.
|
||||||
|
|
||||||
## Notizen
|
## Notizen
|
||||||
|
|
||||||
Dieser Screen ist bewusst der minimale Start eines spaeter groesseren Workspace-Settings-Bereichs.
|
Account/Konto-Loeschung und Workspace-Loeschung sind getrennte Workflows. Dieser Screen darf spaeter nicht beide unklar vermischen.
|
||||||
@@ -1,12 +1,12 @@
|
|||||||
{
|
{
|
||||||
"nodes":[
|
"nodes":[
|
||||||
{"id":"group-main","type":"group","x":-80,"y":-100,"width":1260,"height":420,"label":"Loeschungsanfrage"},
|
{"id":"group-main","type":"group","x":-80,"y":-60,"width":1440,"height":420,"label":"Backlog / geparkte Konto-Loeschung"},
|
||||||
{"id":"group-notes","type":"group","x":-80,"y":560,"width":1260,"height":360,"label":"Dokumentierte Zustaende"},
|
{"id":"group-notes","type":"group","x":-80,"y":560,"width":1440,"height":360,"label":"Backlog-Hinweise"},
|
||||||
{"id":"s01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md","x":0,"y":0,"width":420,"height":200},
|
{"id":"s01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md","x":0,"y":0,"width":420,"height":200},
|
||||||
{"id":"m01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens/M01 Loeschung anfragen.md","x":640,"y":0,"width":420,"height":200},
|
{"id":"note-permission","type":"text","text":"# Trennung\n\nAccount/Konto loeschen und Workspace loeschen sind zwei unterschiedliche Workflows.\n\nNicht in einem Screen vermischen.","x":0,"y":680,"width":420,"height":200},
|
||||||
{"id":"note-request","type":"text","text":"# Anfrage statt Loeschung\n\nV1 fuehrt keine direkte technische Loeschung aus.\n\nNach M01: Toast + Status `Anfrage offen` in S01.","x":0,"y":680,"width":420,"height":200},
|
{"id":"note-request","type":"text","text":"# Backlog\n\nDer gesamte Konto-Loeschworkflow ist geparkt.\n\nBestehende Screens sind nur Referenz und werden nicht als aktueller v1-Scope weitergebaut.","x":860,"y":680,"width":420,"height":200},
|
||||||
{"id":"note-permission","type":"text","text":"# Berechtigung\n\nCTA ist permission-gated.\n\nNormale Rollen sehen keinen aktiven Loeschungs-CTA oder nur disabled state.","x":540,"y":680,"width":420,"height":200},
|
{"id":"m01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 Konto loeschen/Screens/M01 Loeschung anfragen.md","x":860,"y":0,"width":420,"height":200},
|
||||||
{"id":"note-backlog","type":"text","text":"# Backlog\n\nVoller Loeschprozess, Datenexport-Step, Reauth, Confirm Phrase und Workspace-Loeschungsdetails spaeter.","x":1080,"y":680,"width":420,"height":200}
|
{"id":"note-backlog","type":"text","text":"# Voraussetzung\n\nErst wieder aufnehmen, wenn Workspace Settings gebaut/validiert sind.\n\nDanach Flow neu mit David validieren.","x":1440,"y":680,"width":420,"height":200}
|
||||||
],
|
],
|
||||||
"edges":[
|
"edges":[
|
||||||
{"id":"edge-s01-m01","fromNode":"s01","fromSide":"right","toNode":"m01","toSide":"left","label":"Loeschung anfragen"},
|
{"id":"edge-s01-m01","fromNode":"s01","fromSide":"right","toNode":"m01","toSide":"left","label":"Loeschung anfragen"},
|
||||||
@@ -14,4 +14,4 @@
|
|||||||
{"id":"edge-s01-permission","fromNode":"s01","fromSide":"bottom","toNode":"note-permission","toSide":"top","label":"Permission"},
|
{"id":"edge-s01-permission","fromNode":"s01","fromSide":"bottom","toNode":"note-permission","toSide":"top","label":"Permission"},
|
||||||
{"id":"edge-m01-request","fromNode":"m01","fromSide":"bottom","toNode":"note-request","toSide":"top","label":"Feedback"}
|
{"id":"edge-m01-request","fromNode":"m01","fromSide":"bottom","toNode":"note-request","toSide":"top","label":"Feedback"}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
@@ -3,26 +3,26 @@ kind: wireframe-package
|
|||||||
project: HiveGrid Screen Project
|
project: HiveGrid Screen Project
|
||||||
ticket: D-P2
|
ticket: D-P2
|
||||||
package: WF-P2 Konto loeschen
|
package: WF-P2 Konto loeschen
|
||||||
typ: Settings Request Flow
|
typ: Settings Backlog Flow
|
||||||
status: In Subframe
|
status: Backlog
|
||||||
subframe: "https://app.subframe.com/f023064a5ca0/flow/6fec2ec6-eab5-4e25-9c9a-90da47a5047a/edit"
|
subframe: "https://app.subframe.com/f023064a5ca0/flow/6fec2ec6-eab5-4e25-9c9a-90da47a5047a/edit"
|
||||||
canvas: WF-P2 Konto loeschen.canvas
|
canvas: WF-P2 Konto loeschen.canvas
|
||||||
---
|
---
|
||||||
|
|
||||||
# WF-P2 Konto loeschen
|
# WF-P2 Konto loeschen
|
||||||
|
|
||||||
Status: In Subframe
|
Status: Backlog
|
||||||
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/6fec2ec6-eab5-4e25-9c9a-90da47a5047a/edit
|
Subframe-Link (geparkte Referenz): https://app.subframe.com/f023064a5ca0/flow/6fec2ec6-eab5-4e25-9c9a-90da47a5047a/edit
|
||||||
Canvas: [[WF-P2 Konto loeschen.canvas]]
|
Canvas: [[WF-P2 Konto loeschen.canvas]]
|
||||||
Stand: 2026-06-23
|
Stand: 2026-06-26
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1. Kurzfassung
|
## 1. Kurzfassung
|
||||||
|
|
||||||
Dieses Paket plant fuer v1 keinen echten Loesch-Wizard, sondern eine schlanke Loeschungsanfrage aus `Settings -> Workspaces`.
|
Dieses gesamte Paket ist Backlog. Account/Konto loeschen und Workspace loeschen sind zwei getrennte Workflows und werden nicht im aktuellen v1-Schnitt weitergebaut.
|
||||||
|
|
||||||
Der Nutzer bzw. Admin loescht nicht direkt selbst. Er kann eine Anfrage stellen, den Account bzw. Workspace loeschen zu lassen. Was genau operativ geloescht wird und wie der spaetere Workspace-Loeschprozess aussieht, bleibt Backlog. Wichtig fuer v1 ist nur: Der Einstieg existiert versteckt im Settings-Bereich `Workspaces`, die Aktion ist klar als Anfrage formuliert und wird nicht als sofortige Loeschung dargestellt.
|
Die bestehenden Screens bleiben als geparkte Referenz erhalten, sind aber keine aktive Umsetzung. Der spaetere Einstieg liegt wahrscheinlich in `Workspace Settings`; dieser Settings-Bereich ist noch nicht gebaut und muss zuerst separat geplant/validiert werden.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -31,13 +31,13 @@ Der Nutzer bzw. Admin loescht nicht direkt selbst. Er kann eine Anfrage stellen,
|
|||||||
| Frage | Antwort |
|
| Frage | Antwort |
|
||||||
|---|---|
|
|---|---|
|
||||||
| Welches Ticket/Modul ist betroffen? | D-P2 Auth / Account Lifecycle / Settings |
|
| Welches Ticket/Modul ist betroffen? | D-P2 Auth / Account Lifecycle / Settings |
|
||||||
| Was soll der Nutzer am Ende schaffen? | Eine Loeschungsanfrage fuer Account/Workspace stellen oder bewusst abbrechen |
|
| Was soll der Nutzer am Ende schaffen? | Spaeter eine Account/Konto-Loeschanfrage stellen oder bewusst abbrechen |
|
||||||
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | schlanker Settings-Request-Flow |
|
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Backlog-Dokumentation mit geparkten Referenzscreens |
|
||||||
| Welche Planning-Quellen wurden geprueft? | D-P2, Settings-Entscheidung, Workspace-Settings-Entscheidung |
|
| Welche Planning-Quellen wurden geprueft? | D-P2, Settings-Entscheidung, Workspace-Settings-Entscheidung |
|
||||||
| Was ist sicher im Scope? | Settings-Unterpunkt `Workspaces`, Loeschungsanfrage-CTA, Sicherheits-/Erklaerungsmodal, Anfrage absenden, Feedback |
|
| Was ist sicher im Scope? | Backlog-Marker, Trennung von Account/Konto-Loeschung und Workspace-Loeschung, spaetere Revalidierung |
|
||||||
| Was ist sicher nicht im Scope? | direkte technische Loeschung, vollstaendiger DSGVO-Wizard, detaillierter Export-Flow, Billing-/Legal-Abwicklung, vollstaendige Workspace-Settings |
|
| Was ist sicher nicht im Scope? | aktuelle v1-Umsetzung, direkte technische Loeschung, vollstaendiger DSGVO-Wizard, detaillierter Export-Flow, Billing-/Legal-Abwicklung, vollstaendige Workspace-Settings |
|
||||||
| Gibt es Admin/Normalrolle-Unterschiede? | wahrscheinlich ja; Loeschungsanfrage ist mindestens permission-gated, Details spaeter mit Admin/RBAC klaeren |
|
| Gibt es Admin/Normalrolle-Unterschiede? | wahrscheinlich ja; Details spaeter mit Admin/RBAC klaeren |
|
||||||
| Welche Annahmen sind noch unsicher? | finale Copy: `Account loeschen anfragen` vs. `Workspace loeschen anfragen`; konkrete Berechtigung |
|
| Welche Annahmen sind noch unsicher? | finaler Startpunkt, konkrete Berechtigung, genaue Trennung Account/Konto vs. Workspace |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -47,13 +47,13 @@ Der Nutzer bzw. Admin loescht nicht direkt selbst. Er kann eine Anfrage stellen,
|
|||||||
|---|---|
|
|---|---|
|
||||||
| Ticket/Modul | D-P2 Auth / Settings |
|
| Ticket/Modul | D-P2 Auth / Settings |
|
||||||
| Nutzerrolle | Admin oder berechtigte Rolle |
|
| Nutzerrolle | Admin oder berechtigte Rolle |
|
||||||
| Admin-Variante | kann Loeschungsanfrage aus `Settings -> Workspaces` starten |
|
| Admin-Variante | spaeter klaeren |
|
||||||
| Normale Rolle | sieht keinen Einstieg oder keinen aktiven CTA |
|
| Normale Rolle | spaeter klaeren |
|
||||||
| Startpunkt | `Settings -> Workspaces` |
|
| Startpunkt | vermutlich zukuenftige `Workspace Settings`, noch nicht gebaut |
|
||||||
| Ziel | Loeschungsanfrage absenden |
|
| Ziel | Backlog vormerken, nicht bauen |
|
||||||
| Haupt-Archetyp | A6 Settings + A5 Modal |
|
| Haupt-Archetyp | A6 Settings + A5 Modal |
|
||||||
| Bespoke-Anteil | nein |
|
| Bespoke-Anteil | nein |
|
||||||
| Out of scope | direkte Account-/Workspace-Loeschung, mehrstufiger Wizard, vollstaendiger Datenexport, Workspace-Verwaltung im Detail |
|
| Out of scope | aktuelle Screen-Arbeit, direkte Account-/Workspace-Loeschung, mehrstufiger Wizard, vollstaendiger Datenexport, Workspace-Verwaltung im Detail |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -61,38 +61,39 @@ Der Nutzer bzw. Admin loescht nicht direkt selbst. Er kann eine Anfrage stellen,
|
|||||||
|
|
||||||
### Flow-Frage
|
### Flow-Frage
|
||||||
|
|
||||||
Wie kann Loeschung in v1 vorhanden sein, ohne einen grossen irreversiblen Loesch-Wizard zu bauen?
|
Welche Loeschthemen muessen fuer spaeter getrennt vorgemerkt werden, ohne jetzt einen Workspace-Settings-Screen zu bauen?
|
||||||
|
|
||||||
### UX-Varianten
|
### UX-Varianten
|
||||||
|
|
||||||
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|
||||||
|---|---|---|---|---|
|
|---|---|---|---|---|
|
||||||
| A | Voller Wizard: Erklaerung -> Export -> Reauth -> Confirm | maximal kontrolliert | fuer v1 zu schwer und noch fachlich unklar | raus/backlog |
|
| A | Voller Wizard: Erklaerung -> Export -> Reauth -> Confirm | maximal kontrolliert | fuer jetzt zu schwer und noch fachlich unklar | Backlog |
|
||||||
| B | Settings -> Workspaces mit CTA `Loeschung anfragen`, danach Sicherheitsmodal | schlank, klar, keine direkte Loeschung | Details muessen spaeter operationalisiert werden | genommen |
|
| B | Settings -> Workspaces mit CTA `Loeschung anfragen`, danach Sicherheitsmodal | schlank, klar, keine direkte Loeschung | Settings-Bereich ist noch nicht gebaut | Backlog/geparkt |
|
||||||
| C | Nur Backlog, gar kein Screen | keine Komplexitaet | Nutzer findet keinen Einstieg | raus |
|
| C | Nur Backlog, gar kein aktiver Screen | keine falsche v1-Erwartung | Nutzer findet vorerst keinen Einstieg | genommen |
|
||||||
|
|
||||||
### Entscheidung
|
### Entscheidung
|
||||||
|
|
||||||
| Entscheidung | Status | Notiz |
|
| Entscheidung | Status | Notiz |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Loeschung nur als Anfrage | genommen | keine sofortige technische Loeschung in v1 |
|
| Account/Konto-Loeschung | Backlog | eigener spaeterer Workflow |
|
||||||
| Einstieg unter Settings -> Workspaces | genommen | Workspaces-Bereich wird spaeter mehr enthalten; v1 minimal |
|
| Workspace-Loeschung | Backlog | eigener spaeterer Workflow in [[../WF-P2 Workspace loeschen/WF-P2 Workspace loeschen.md]] |
|
||||||
| Settings/Workspaces minimal bauen | genommen | zunaechst nur Loeschungsbereich dokumentieren |
|
| Einstieg unter Settings -> Workspaces | Backlog/Klaeren | Workspace Settings sind noch nicht gebaut |
|
||||||
| Erklaerung im Modal | genommen | keine eigene Wizard-Seite |
|
| Settings/Workspaces minimal bauen | Raus fuer jetzt | erst nach separater Workspace-Settings-Planung |
|
||||||
| Datenexport als Hinweis/sekundare Option | genommen | kein eigener Export-Step in v1 |
|
| Erklaerung im Modal | Backlog | spaeter entscheiden, ob Modal oder Wizard |
|
||||||
| Workspace-Loeschprozess Detail | Backlog | spaeter eigener Flow aus Workspace-Einstellungen |
|
| Datenexport als Hinweis/sekundare Option | Backlog | kein eigener Export-Step jetzt |
|
||||||
| Voller DSGVO-/Countdown-Wizard | Backlog | nicht Teil dieses schlanken v1-Scopes |
|
| Voller DSGVO-/Countdown-Wizard | Backlog | spaeter klaeren |
|
||||||
| Direkte Loeschung | raus | Nutzer stellt Anfrage, System/Team bearbeitet |
|
| Direkte Loeschung | Raus | Nutzer stellt voraussichtlich Anfrage, System/Team bearbeitet |
|
||||||
|
|
||||||
### Happy Path
|
### Geparkter Happy Path
|
||||||
|
|
||||||
1. Berechtigter Nutzer oeffnet `Settings -> Workspaces`.
|
Dieser Ablauf ist nur als Referenz geparkt und muss spaeter neu validiert werden:
|
||||||
2. Nutzer klickt im Loeschbereich auf `Loeschung anfragen`.
|
|
||||||
3. Modal fragt, ob der Nutzer sicher ist, und erklaert kurz die Konsequenzen.
|
1. Berechtigter Nutzer oeffnet den zukuenftigen Settings-Bereich.
|
||||||
4. Modal weist darauf hin, dass es eine Anfrage ist und keine sofortige Loeschung.
|
2. Nutzer startet `Account/Konto loeschen anfragen`.
|
||||||
5. Optionaler Hinweis: Vor der Loeschung koennen Daten exportiert/angefordert werden.
|
3. UI erklaert Konsequenzen und macht klar, dass es eine Anfrage ist.
|
||||||
6. Nutzer sendet die Anfrage ab.
|
4. Optionaler Hinweis: Vor der Loeschung koennen Daten exportiert/angefordert werden.
|
||||||
7. System zeigt Feedback: Anfrage wurde uebermittelt.
|
5. Nutzer sendet die Anfrage ab.
|
||||||
|
6. System zeigt Feedback: Anfrage wurde uebermittelt.
|
||||||
|
|
||||||
### Varianten / Branches
|
### Varianten / Branches
|
||||||
|
|
||||||
@@ -112,12 +113,12 @@ Wie kann Loeschung in v1 vorhanden sein, ohne einen grossen irreversiblen Loesch
|
|||||||
|
|
||||||
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|
||||||
|---|---|---|---|---|
|
|---|---|---|---|---|
|
||||||
| Loeschung anfragen | Modal | ja | ja | bewusst als Anfrage formulieren |
|
| Loeschung anfragen | Modal/Wizard | ja | Backlog | bewusst als Anfrage formulieren |
|
||||||
| Erklaerung | Modal-Inhalt | nein | ja | kurz, keine Rechtsberatung |
|
| Erklaerung | Modal- oder Wizard-Inhalt | nein | Backlog | kurz, keine Rechtsberatung |
|
||||||
| Datenexport | Hinweis/sekundare Aktion | nein | nur dokumentieren | kein eigener Step |
|
| Datenexport | Hinweis/sekundare Aktion | nein | Backlog | kein eigener Step jetzt |
|
||||||
| Anfrage gesendet | Toast/Feedback | nein | pruefen | Status sichtbar machen |
|
| Anfrage gesendet | Toast/Feedback | nein | Backlog | Status spaeter klaeren |
|
||||||
| Keine Berechtigung | hidden/disabled state | ja | nur dokumentieren | kein eigener Screen |
|
| Keine Berechtigung | hidden/disabled state | ja | Backlog | kein eigener Screen jetzt |
|
||||||
| Anfrage bereits offen | Status im Settings-Bereich | nein | pruefen | verhindert doppelte Anfrage |
|
| Anfrage bereits offen | Status im Settings-Bereich | nein | Backlog | verhindert doppelte Anfrage |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -125,12 +126,12 @@ Wie kann Loeschung in v1 vorhanden sein, ohne einen grossen irreversiblen Loesch
|
|||||||
|
|
||||||
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Settings -> Workspaces / Loeschbereich | Einstieg in den minimalen Workspace-Settings-Bereich | Bauen |
|
| Settings -> Workspaces / Loeschbereich | Einstieg in den spaeteren Workspace-Settings-Bereich | Backlog/geparkt |
|
||||||
| Loeschung anfragen Modal | Sicherheits- und Erklaerungsstep | Bauen |
|
| Loeschung anfragen Modal | Sicherheits- und Erklaerungsstep | Backlog/geparkt |
|
||||||
| Anfrage gesendet | Feedback/Status | Pruefen, vermutlich Toast + Status reicht |
|
| Anfrage gesendet | Feedback/Status | Backlog |
|
||||||
| Keine Berechtigung | Permission State | Nur dokumentieren |
|
| Keine Berechtigung | Permission State | Backlog |
|
||||||
| Datenexport Hinweis | DSGVO-relevanter Hinweis | Nur dokumentieren / im Modal integrieren |
|
| Datenexport Hinweis | DSGVO-relevanter Hinweis | Backlog |
|
||||||
| Voller Datenexport-Step | zu gross fuer v1 | Backlog |
|
| Voller Datenexport-Step | zu gross fuer den aktuellen Schnitt | Backlog |
|
||||||
| Direkte Loeschung | nicht gewollt | Raus |
|
| Direkte Loeschung | nicht gewollt | Raus |
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -139,20 +140,20 @@ Wie kann Loeschung in v1 vorhanden sein, ohne einen grossen irreversiblen Loesch
|
|||||||
|
|
||||||
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| S01 | Settings -> Workspaces / Loeschbereich | ja | ja, neuer Settings-Unterpunkt | Bauen | minimaler Workspaces-Bereich mit Loeschungsanfrage |
|
| S01 | Settings -> Workspaces / Loeschbereich | ja | ja, neuer Settings-Unterpunkt | Backlog | Workspace Settings fehlen noch |
|
||||||
| M01 | Loeschung anfragen | ja | ja, destruktive Anfrage | Bauen | Modal mit Sicher-Abfrage, Erklaerung, Datenexport-Hinweis |
|
| M01 | Loeschung anfragen | ja | ja, destruktive Anfrage | Backlog | erst nach Workspace-Settings-Klaerung weiter planen |
|
||||||
| D01 | Anfrage gesendet | nein | nein | Nur dokumentieren | Toast plus Status im S01 reicht |
|
| D01 | Anfrage gesendet | nein | nein | Backlog | Toast/Status spaeter klaeren |
|
||||||
| D02 | Keine Berechtigung | nein | nein | Nur dokumentieren | CTA verborgen/deaktiviert |
|
| D02 | Keine Berechtigung | nein | nein | Backlog | Permission-Zustand spaeter klaeren |
|
||||||
| D03 | Datenexport Hinweis | nein | ja, Compliance-Hinweis | In M01 integrieren | kein eigener Screen |
|
| D03 | Datenexport Hinweis | nein | ja, Compliance-Hinweis | Backlog | kein eigener Screen jetzt |
|
||||||
| D04 | Workspace-Loeschprozess Detail | ja | ja, eigener Scope | Backlog | spaeter aus Workspace-Einstellungen |
|
| D04 | Workspace-Loeschprozess Detail | ja | ja, eigener Scope | Backlog | spaeter aus Workspace-Einstellungen |
|
||||||
|
|
||||||
### Copy-kritische Zustaende
|
### Copy-kritische Zustaende
|
||||||
|
|
||||||
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| Anfrage statt Loeschung | ja | UI darf keine sofortige Loeschung versprechen |
|
| Anfrage statt Loeschung | Backlog | UI darf keine sofortige Loeschung versprechen |
|
||||||
| Erklaerung | ja | Nutzer muss Konsequenzen verstehen |
|
| Erklaerung | Backlog | Nutzer muss Konsequenzen verstehen |
|
||||||
| Datenexport-Hinweis | ja, integriert | Nutzer soll wissen, dass Datenexport vor Loeschung relevant ist |
|
| Datenexport-Hinweis | Backlog | Nutzer soll wissen, dass Datenexport vor Loeschung relevant ist |
|
||||||
|
|
||||||
### Blockierende Error States
|
### Blockierende Error States
|
||||||
|
|
||||||
@@ -168,11 +169,11 @@ Wie kann Loeschung in v1 vorhanden sein, ohne einen grossen irreversiblen Loesch
|
|||||||
|
|
||||||
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| S01 | Settings -> Workspaces / Loeschbereich | Settings | Bauen | `/settings/workspaces` | Validiert |
|
| S01 | Settings -> Workspaces / Loeschbereich | Settings | Backlog/geparkt | spaeter | Backlog |
|
||||||
| M01 | Loeschung anfragen | Modal | Bauen | von S01 | Validiert |
|
| M01 | Loeschung anfragen | Modal | Backlog/geparkt | spaeter | Backlog |
|
||||||
| D01 | Anfrage gesendet | Toast/Status | Nur dokumentieren | nach M01 | Validiert |
|
| D01 | Anfrage gesendet | Toast/Status | Backlog | spaeter | Backlog |
|
||||||
| D02 | Keine Berechtigung | Permission State | Nur dokumentieren | in S01 | Validiert |
|
| D02 | Keine Berechtigung | Permission State | Backlog | spaeter | Backlog |
|
||||||
| D03 | Datenexport Hinweis | Modal Content | In M01 integrieren | in M01 | Validiert |
|
| D03 | Datenexport Hinweis | Modal Content | Backlog | spaeter | Backlog |
|
||||||
| D04 | Workspace-Loeschprozess Detail | Backlog | Backlog | spaeter | Backlog |
|
| D04 | Workspace-Loeschprozess Detail | Backlog | Backlog | spaeter | Backlog |
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -180,7 +181,8 @@ Wie kann Loeschung in v1 vorhanden sein, ohne einen grossen irreversiblen Loesch
|
|||||||
## 8. Subframe-Grid
|
## 8. Subframe-Grid
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Settings -> S01 Workspaces / Loeschbereich
|
[Backlog / geparkt]
|
||||||
|
Spaetere Workspace Settings -> S01 Workspaces / Loeschbereich
|
||||||
S01 -> M01 Loeschung anfragen
|
S01 -> M01 Loeschung anfragen
|
||||||
M01 -> D01 Anfrage gesendet (Toast/Status)
|
M01 -> D01 Anfrage gesendet (Toast/Status)
|
||||||
S01 -> D02 Keine Berechtigung (hidden/disabled)
|
S01 -> D02 Keine Berechtigung (hidden/disabled)
|
||||||
@@ -200,8 +202,8 @@ S01 -> D02 Keine Berechtigung (hidden/disabled)
|
|||||||
## 10. Handoff-Check
|
## 10. Handoff-Check
|
||||||
|
|
||||||
- [x] Paket ist angelegt.
|
- [x] Paket ist angelegt.
|
||||||
- [x] Scope wurde auf Loeschungsanfrage reduziert.
|
- [x] Gesamter Flow ist als Backlog markiert.
|
||||||
- [x] Voller Loesch-/Export-Wizard ist Backlog.
|
- [x] Account/Konto-Loeschen und Workspace-Loeschen sind als getrennte Workflows dokumentiert.
|
||||||
- [x] Settings -> Workspaces ist als Startpunkt dokumentiert.
|
- [x] Bestehende Subframe-Screens sind nur geparkte Referenz.
|
||||||
- [x] David hat die Kandidaten validiert.
|
- [ ] Workspace Settings sind gebaut/validiert.
|
||||||
- [ ] Subframe-Link ist eingetragen.
|
- [ ] Flow spaeter neu mit David validieren, bevor neue Screens gebaut werden.
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
{
|
||||||
|
"nodes":[
|
||||||
|
{"id":"group-main","type":"group","x":-80,"y":-100,"width":1260,"height":420,"label":"Backlog / Workspace loeschen"},
|
||||||
|
{"id":"note-scope","type":"text","text":"# Backlog\n\nWorkspace loeschen ist ein eigener Workflow.\n\nAktuell keine Subframe-Screens bauen.","x":0,"y":0,"width":420,"height":220},
|
||||||
|
{"id":"note-dependency","type":"text","text":"# Voraussetzung\n\nErst planen, wenn Workspace Settings als Bereich gebaut und validiert sind.","x":540,"y":0,"width":420,"height":220},
|
||||||
|
{"id":"note-separation","type":"text","text":"# Trennung\n\nNicht mit Account/Konto loeschen vermischen.\n\nBeide Flows separat mit David validieren.","x":1080,"y":0,"width":420,"height":220}
|
||||||
|
],
|
||||||
|
"edges":[]
|
||||||
|
}
|
||||||
@@ -0,0 +1,75 @@
|
|||||||
|
---
|
||||||
|
kind: wireframe-package
|
||||||
|
project: HiveGrid Screen Project
|
||||||
|
ticket: D-P2
|
||||||
|
package: WF-P2 Workspace loeschen
|
||||||
|
typ: Settings Backlog Flow
|
||||||
|
status: Backlog
|
||||||
|
subframe: ""
|
||||||
|
canvas: WF-P2 Workspace loeschen.canvas
|
||||||
|
---
|
||||||
|
|
||||||
|
# WF-P2 Workspace loeschen
|
||||||
|
|
||||||
|
Status: Backlog
|
||||||
|
Subframe-Link: -
|
||||||
|
Canvas: [[WF-P2 Workspace loeschen.canvas]]
|
||||||
|
Stand: 2026-06-26
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Kurzfassung
|
||||||
|
|
||||||
|
Workspace loeschen ist ein eigener Workflow und nicht identisch mit Account/Konto loeschen.
|
||||||
|
|
||||||
|
Dieser Flow ist aktuell nur als Backlog-Paket angelegt. Der Einstieg liegt spaeter wahrscheinlich in `Workspace Settings`, aber dieser Settings-Bereich ist noch nicht gebaut und muss zuerst separat geplant/validiert werden.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Intent Check
|
||||||
|
|
||||||
|
| Frage | Antwort |
|
||||||
|
|---|---|
|
||||||
|
| Welches Ticket/Modul ist betroffen? | D-P2 Auth / Settings / Workspace Lifecycle |
|
||||||
|
| Was soll der Nutzer am Ende schaffen? | Spaeter eine Workspace-Loeschung oder Workspace-Loeschanfrage starten |
|
||||||
|
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Backlog-Workflow |
|
||||||
|
| Welche Planning-Quellen wurden geprueft? | D-P2, Workspace-Auswahl, Workspace-Settings-Notizen, Konto-Loeschen-Abgrenzung |
|
||||||
|
| Was ist sicher im Scope? | Nur Backlog-Marker und klare Trennung von Account/Konto-Loeschung |
|
||||||
|
| Was ist sicher nicht im Scope? | aktuelle Subframe-Screens, finaler Loesch-Wizard, operative Loeschlogik, Billing/Legal/Export-Details |
|
||||||
|
| Gibt es Admin/Normalrolle-Unterschiede? | wahrscheinlich ja; fuer v1 grundsaetzlich Admin-Ansicht, Details spaeter klaeren |
|
||||||
|
| Welche Annahmen sind noch unsicher? | genauer Settings-Ort, Berechtigung, Copy, ob Anfrage oder mehrstufiger Wizard |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Abgrenzung
|
||||||
|
|
||||||
|
| Workflow | Bedeutung | Status |
|
||||||
|
|---|---|---|
|
||||||
|
| Account/Konto loeschen | Nutzerkonto bzw. persoenliches Profil entfernen/anfragen | Backlog in [[../WF-P2 Konto loeschen/WF-P2 Konto loeschen.md]] |
|
||||||
|
| Workspace loeschen | Tenant/Workspace entfernen/anfragen | Dieses Backlog-Paket |
|
||||||
|
|
||||||
|
Diese beiden Flows duerfen spaeter verknuepft sein, muessen aber getrennt geplant und validiert werden.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Backlog-Kandidaten
|
||||||
|
|
||||||
|
| Kandidat | Warum eventuell noetig? | Status |
|
||||||
|
|---|---|---|
|
||||||
|
| Workspace Settings / Loeschbereich | Einstieg in den spaeteren Workspace-Settings-Bereich | Backlog |
|
||||||
|
| Workspace-Loeschung anfragen | Destruktiver Confirm-/Request-Step | Backlog |
|
||||||
|
| Anfrage gesendet | Toast/Status nach Absenden | Backlog |
|
||||||
|
| Keine Berechtigung | Permission State fuer nicht berechtigte Rollen | Backlog |
|
||||||
|
| Workspace hat Abhaengigkeiten | Billing, aktive Nutzer, offene Prozesse, Integrationen | Backlog |
|
||||||
|
| Letzter/primaerer Admin | Schutz vor unklarer Verantwortlichkeit | Backlog |
|
||||||
|
| Datenexport / Legal-Hinweis | Compliance-relevante Erklaerung | Backlog |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Handoff-Check
|
||||||
|
|
||||||
|
- [x] Eigenes Backlog-Paket ist angelegt.
|
||||||
|
- [x] Workflow ist von Account/Konto loeschen getrennt.
|
||||||
|
- [x] Keine Subframe-Screens fuer diesen Flow gebaut.
|
||||||
|
- [ ] Workspace Settings sind gebaut/validiert.
|
||||||
|
- [ ] Flow spaeter einzeln mit David brainstormen und validieren.
|
||||||
@@ -33,7 +33,8 @@ Diese Datei ist der erste Ort, um zu sehen:
|
|||||||
| WF-P2 Change Password | D-P2 / Auth-Core | Auth | In Subframe | [MD](<P2 Auth/WF-P2 Change Password/WF-P2 Change Password.md>) | [Canvas](<P2 Auth/WF-P2 Change Password/WF-P2 Change Password.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/04767909-3c2f-4236-92a8-b08eaa3f51b7/edit>) | Review | Neue Seiten erstellt; Reauth-Zubringer zu `WF-P2 Set Password` |
|
| WF-P2 Change Password | D-P2 / Auth-Core | Auth | In Subframe | [MD](<P2 Auth/WF-P2 Change Password/WF-P2 Change Password.md>) | [Canvas](<P2 Auth/WF-P2 Change Password/WF-P2 Change Password.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/04767909-3c2f-4236-92a8-b08eaa3f51b7/edit>) | Review | Neue Seiten erstellt; Reauth-Zubringer zu `WF-P2 Set Password` |
|
||||||
| WF-P2 2FA Verwalten | D-P2 / Auth-Core | Auth | In Subframe | [MD](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.md>) | [Canvas](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/4de27a18-0e2f-43de-b39b-01a94b0c93b8/edit>) | Review | Neue Seiten erstellt; eigenstaendiger 2FA-Verwalten-Flow |
|
| WF-P2 2FA Verwalten | D-P2 / Auth-Core | Auth | In Subframe | [MD](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.md>) | [Canvas](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/4de27a18-0e2f-43de-b39b-01a94b0c93b8/edit>) | Review | Neue Seiten erstellt; eigenstaendiger 2FA-Verwalten-Flow |
|
||||||
| WF-P2 Admin RBAC | D-P2 | Auth/Admin | In Subframe | [MD](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.md>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/42c54a17-9c08-4db3-9306-1449f5b874e4/edit>) | Review | Neue Seiten erstellt; Permission-Bundles als Arbeitsgeruest; Gruppen/Reassign raus |
|
| WF-P2 Admin RBAC | D-P2 | Auth/Admin | In Subframe | [MD](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.md>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/42c54a17-9c08-4db3-9306-1449f5b874e4/edit>) | Review | Neue Seiten erstellt; Permission-Bundles als Arbeitsgeruest; Gruppen/Reassign raus |
|
||||||
| WF-P2 Konto loeschen | D-P2 | Auth/Settings | In Subframe | [MD](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.md>) | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/6fec2ec6-eab5-4e25-9c9a-90da47a5047a/edit>) | Review | Neue Seiten erstellt; schlanke Loeschungsanfrage unter Settings -> Workspaces |
|
| WF-P2 Konto loeschen | D-P2 | Auth/Settings | Backlog | [MD](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.md>) | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) | [Subframe](<https://app.subframe.com/f023064a5ca0/flow/6fec2ec6-eab5-4e25-9c9a-90da47a5047a/edit>) | Backlog | Gesamter Account/Konto-Loeschflow geparkt; bestehende Screens nur Referenz |
|
||||||
|
| WF-P2 Workspace loeschen | D-P2 | Auth/Settings | Backlog | [MD](<P2 Auth/WF-P2 Workspace loeschen/WF-P2 Workspace loeschen.md>) | [Canvas](<P2 Auth/WF-P2 Workspace loeschen/WF-P2 Workspace loeschen.canvas>) | - | Backlog | Eigener Workflow; erst planen, wenn Workspace Settings gebaut/validiert sind |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -87,16 +88,18 @@ Diese Datei ist der erste Ort, um zu sehen:
|
|||||||
| D04 | MFA-Aenderung Benachrichtigung | WF-P2 2FA Verwalten | E-Mail/Toast | Nur dokumentieren | Validiert | nach Setup/Remove/Disable | [MD](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.md>) | - | [Canvas](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.canvas>) |
|
| D04 | MFA-Aenderung Benachrichtigung | WF-P2 2FA Verwalten | E-Mail/Toast | Nur dokumentieren | Validiert | nach Setup/Remove/Disable | [MD](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.md>) | - | [Canvas](<P2 Auth/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.canvas>) |
|
||||||
| S01 | Mitarbeiterliste | WF-P2 Admin RBAC | Admin List | Bauen | In Subframe | `Settings -> Mitarbeiter`, Tab `Mitarbeiter` | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/S01 Mitarbeiterliste.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/a9571d72-15e0-4897-968b-1f700ee4bfbc/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| S01 | Mitarbeiterliste | WF-P2 Admin RBAC | Admin List | Bauen | In Subframe | `Settings -> Mitarbeiter`, Tab `Mitarbeiter` | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/S01 Mitarbeiterliste.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/a9571d72-15e0-4897-968b-1f700ee4bfbc/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| M01 | Mitarbeiter einladen | WF-P2 Admin RBAC | Modal | Bauen | In Subframe | von S01 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M01 Mitarbeiter einladen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/0338fed6-2624-4e92-9d42-0b959fafe8c2/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| M01 | Mitarbeiter einladen | WF-P2 Admin RBAC | Modal | Bauen | In Subframe | von S01 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M01 Mitarbeiter einladen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/0338fed6-2624-4e92-9d42-0b959fafe8c2/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| D01 | Rollen-Dropdown in Mitarbeiterliste | WF-P2 Admin RBAC | Inline-Zustand | Nur dokumentieren | In Subframe | in S01 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/D01 Rollen-Dropdown in Mitarbeiterliste.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/80f691a7-e8a9-4502-be74-69795066e105/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| D01 | Rollen-Dropdown in Mitarbeiterliste | WF-P2 Admin RBAC | Inline-Zustand in S01 | Nur dokumentieren | Validiert | in S01, kein eigener Subframe-Screen | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/D01 Rollen-Dropdown in Mitarbeiterliste.md>) | - | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| M03 | Mitarbeiter deaktivieren | WF-P2 Admin RBAC | Confirm Modal | Bauen | In Subframe | von S01 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M03 Mitarbeiter deaktivieren.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/11e3f3dc-451b-4abb-aedf-3aad63704c51/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| M03 | Mitarbeiter deaktivieren | WF-P2 Admin RBAC | Confirm Modal | Bauen | In Subframe | von S01 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M03 Mitarbeiter deaktivieren.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/11e3f3dc-451b-4abb-aedf-3aad63704c51/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| S02 | Rollen und Berechtigungen | WF-P2 Admin RBAC | Settings Subpage | Bauen | In Subframe | `Settings -> Mitarbeiter`, Tab `Rollen und Berechtigungen` | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/S02 Rollen und Berechtigungen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/87c24709-4f22-4181-8543-e21ff169c4d5/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| S02 | Rollen und Berechtigungen | WF-P2 Admin RBAC | Settings Subpage | Bauen | In Subframe | `Settings -> Mitarbeiter`, Tab `Rollen und Berechtigungen` | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/S02 Rollen und Berechtigungen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/87c24709-4f22-4181-8543-e21ff169c4d5/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| M02 | Rolle erstellen/bearbeiten | WF-P2 Admin RBAC | Grosses Modal | Bauen | In Subframe | von S02 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M02 Rolle erstellen bearbeiten.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/3d51deee-0d41-456f-a507-ccfc284e6e0a/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| M04A | Rolle anlegen | WF-P2 Admin RBAC | Modal Step | Bauen | In Subframe | Neue Rolle mit leerem Formular; an M04B-Stil angeglichen, ohne Duplikat-Modus | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M04A Rolle anlegen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/479ee52d-8d73-46e9-9a9b-a8798a22d764/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| D03 | Rolle in Nutzung blockiert | WF-P2 Admin RBAC | Admin Blocker | Nur dokumentieren | In Subframe | von S02/M02 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/D03 Rolle in Nutzung blockiert.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/99f96d31-4cb5-4d7c-a252-3f8bef9f1b59/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| M04B | Rolle duplizieren | WF-P2 Admin RBAC | Modal Step | Bauen | In Subframe | Quellrolle kopieren; Duplikat-Modus | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M04B Rolle duplizieren.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/610d08e6-5c6a-44d3-9b29-220664393ea0/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| V01 | Letzter Admin blockiert | WF-P2 Admin RBAC | Admin Blocker | Nur dokumentieren | In Subframe | von S01/M03/Rollenwechsel | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/V01 Letzter Admin blockiert.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/3e05bfb3-3842-4008-964e-f4c68dea0d9e/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
| M02 | Rolle bearbeiten | WF-P2 Admin RBAC | Grosses Modal | Bauen | In Subframe | Finale Seite: Rolle bearbeiten | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/M02 Rolle bearbeiten.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/9a9873e3-d790-4373-b8c2-fadd3b82cbe6/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| S01 | Settings -> Workspaces / Loeschbereich | WF-P2 Konto loeschen | Settings | Bauen | In Subframe | `/settings/workspaces` | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/7f54d6e5-df2f-4163-bb36-1310062b2429/edit>) | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
| D03 | Rolle in Nutzung blockiert | WF-P2 Admin RBAC | Admin Blocker | Nur dokumentieren | In Subframe | von S02/M02 | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/D03 Rolle in Nutzung blockiert.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/0363300b-6455-4fd9-9102-659d0a66b0ea/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| M01 | Loeschung anfragen | WF-P2 Konto loeschen | Modal | Bauen | In Subframe | von S01 | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/M01 Loeschung anfragen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/e8454b77-b5bc-4c80-b035-bde4318793e7/edit>) | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
| V01 | Letzter Admin blockiert | WF-P2 Admin RBAC | Admin Blocker | Nur dokumentieren | In Subframe | von S01/M03/Rollenwechsel | [MD](<P2 Auth/WF-P2 Admin RBAC/Screens/V01 Letzter Admin blockiert.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/c1fd0142-76ad-402d-8eae-25ce9281d298/edit>) | [Canvas](<P2 Auth/WF-P2 Admin RBAC/WF-P2 Admin RBAC.canvas>) |
|
||||||
| D01 | Anfrage gesendet | WF-P2 Konto loeschen | Toast/Status | Nur dokumentieren | Validiert | nach M01 | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md>) | - | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
| S01 | Settings -> Workspaces / Loeschbereich | WF-P2 Konto loeschen | Settings | Spaeter | Backlog | spaeter `Settings -> Workspaces` | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/7f54d6e5-df2f-4163-bb36-1310062b2429/edit>) | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
||||||
| D02 | Keine Berechtigung | WF-P2 Konto loeschen | Permission State | Nur dokumentieren | Validiert | in S01 | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md>) | - | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
| M01 | Loeschung anfragen | WF-P2 Konto loeschen | Modal | Spaeter | Backlog | von zukuenftigem Settings-Einstieg | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/M01 Loeschung anfragen.md>) | [Subframe](<https://app.subframe.com/f023064a5ca0/design/e8454b77-b5bc-4c80-b035-bde4318793e7/edit>) | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
||||||
|
| D01 | Anfrage gesendet | WF-P2 Konto loeschen | Toast/Status | Nur dokumentieren | Backlog | nach M01 | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md>) | - | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
||||||
|
| D02 | Keine Berechtigung | WF-P2 Konto loeschen | Permission State | Nur dokumentieren | Backlog | in S01 | [MD](<P2 Auth/WF-P2 Konto loeschen/Screens/S01 Settings Workspaces Loeschbereich.md>) | - | [Canvas](<P2 Auth/WF-P2 Konto loeschen/WF-P2 Konto loeschen.canvas>) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -134,21 +137,24 @@ Diese Datei ist der erste Ort, um zu sehen:
|
|||||||
| WF-P2 2FA Verwalten | Eigenstaendiger Flow | Genommen | 2FA verwalten wird als separater wiederverwendbarer Flow geplant. | UI kann modal sein; fachlich eigener Flow |
|
| WF-P2 2FA Verwalten | Eigenstaendiger Flow | Genommen | 2FA verwalten wird als separater wiederverwendbarer Flow geplant. | UI kann modal sein; fachlich eigener Flow |
|
||||||
| WF-P2 2FA Verwalten | Schlanker 2FA-Flow | Genommen | 2FA-Code-Eingaben sind Inline-Zustaende; nur Verwaltung, Device/Token hinzufuegen und Deaktivieren sind eigene Modals. | Device entfernen nur Row-Action + Confirm |
|
| WF-P2 2FA Verwalten | Schlanker 2FA-Flow | Genommen | 2FA-Code-Eingaben sind Inline-Zustaende; nur Verwaltung, Device/Token hinzufuegen und Deaktivieren sind eigene Modals. | Device entfernen nur Row-Action + Confirm |
|
||||||
| WF-P2 Admin RBAC | Gruppen | Raus | Gruppen sind nicht Teil des RBAC-Pakets. | Falls spaeter noetig, eigener Settings-Bereich |
|
| WF-P2 Admin RBAC | Gruppen | Raus | Gruppen sind nicht Teil des RBAC-Pakets. | Falls spaeter noetig, eigener Settings-Bereich |
|
||||||
| WF-P2 Admin RBAC | Rollenmodell | Genommen | Es gibt vorgebaute Rollen und Admins koennen eigene Rollen anlegen und benennen. | Wichtig fuer Rollen-Editor |
|
| WF-P2 Admin RBAC | Rollenmodell | Genommen | Zum Start gibt es nur die Systemrolle `Admin`; Admins koennen eigene Rollen anlegen und benennen. | Vordefinierte Rollen sind raus |
|
||||||
| WF-P2 Admin RBAC | Seed-Rollen | Genommen | Geschaeftsfuehrer, Projektleiter, Verwaltung, Vertriebler, Kundensupporter, Monteur als bearbeitbare Startrollen. | fuer v1 ausreichend; Namen koennen spaeter angepasst werden |
|
| WF-P2 Admin RBAC | Rollen-Vorlagen | WIP | Beim Erstellen einer Rolle koennen spaeter Vorlagen angeboten werden, sie sind aber noch nicht final. | In v1 nur als vorbereiteter/disabled Bereich dokumentieren |
|
||||||
|
| WF-P2 Admin RBAC | Rollen-Editor Einstieg | Genommen | Neue Rolle startet in M04A `Rolle anlegen`; Duplizieren startet in M04B `Rolle duplizieren`; Bearbeiten springt direkt in M02 `Rolle bearbeiten`. | M04A und M04B sind eigene Screen-Dateien und eigene Canvas-Nodes |
|
||||||
|
| WF-P2 Admin RBAC | M04-Split | Genommen | `Rolle anlegen` und `Duplizieren` werden als zwei eigene Screens gefuehrt. | Umsetzung synchronisiert: Screen-Dateien, Tracker-Zeilen, Canvas-Nodes und bestehende Subframe-Seiten |
|
||||||
| WF-P2 Admin RBAC | Settings-Aufteilung | Genommen | `Settings -> Mitarbeiter` wird Oberpunkt; Tabs: `Mitarbeiter`, `Rollen und Berechtigungen`. | Sichtbarer Wireframe-Einstieg; technische Route spaeter abstimmen |
|
| WF-P2 Admin RBAC | Settings-Aufteilung | Genommen | `Settings -> Mitarbeiter` wird Oberpunkt; Tabs: `Mitarbeiter`, `Rollen und Berechtigungen`. | Sichtbarer Wireframe-Einstieg; technische Route spaeter abstimmen |
|
||||||
| WF-P2 Admin RBAC | Rollenzuweisung | Genommen | In der Mitarbeiterliste gibt es pro Mitarbeiter ein Rollen-Dropdown; Bearbeiten fuehrt zu `Rollen und Berechtigungen`. | Kein eigenes Rollen-Modal aus S01 |
|
| WF-P2 Admin RBAC | Rollenzuweisung | Genommen | In der Mitarbeiterliste gibt es pro Mitarbeiter ein Rollen-Dropdown; Bearbeiten fuehrt zu `Rollen und Berechtigungen`. | Kein eigenes Rollen-Modal aus S01 |
|
||||||
| WF-P2 Admin RBAC | Berechtigungen | Genommen | Kein separater Berechtigungen-Tab; Rechtebereiche leben im Tab `Rollen und Berechtigungen` beim Bearbeiten einer Rolle. | Macht das Paket kompakter |
|
| WF-P2 Admin RBAC | Berechtigungen | Genommen | Kein separater Berechtigungen-Tab; Rechtebereiche leben im Tab `Rollen und Berechtigungen` beim Bearbeiten einer Rolle. | Macht das Paket kompakter |
|
||||||
| WF-P2 Admin RBAC | Permission-Bundles | Genommen | Bundles bleiben Arbeitsgeruest; im Rollen-Modal wird eine Permission-Zeile mit Ueberschrift, Beschreibung und Zugriffsauswahl vorgebaut. | Finaler Rechtekatalog liegt bei Development |
|
| WF-P2 Admin RBAC | Permission-Bundles | Genommen | Bundles bleiben Arbeitsgeruest; im Rollen-Modal wird eine Permission-Zeile mit Ueberschrift, Beschreibung und Toggle `An/Aus` vorgebaut. | Finaler Rechtekatalog liegt bei Development |
|
||||||
| WF-P2 Admin RBAC | Systemrolle | Genommen | In der UI gibt es nur eine sichtbare Systemrolle: `Admin`. | Andere technische Rollen nicht als normale Screen-Rolle fuehren |
|
| WF-P2 Admin RBAC | Systemrolle | Genommen | In der UI gibt es nur eine sichtbare Systemrolle: `Admin`. | Andere technische Rollen nicht als normale Screen-Rolle fuehren |
|
||||||
| WF-P2 Admin RBAC | Suche/Filter | Genommen | Mitarbeiter-Screen bekommt Suche plus Filter nach Rolle, Abteilung, Status und 2FA; Rollen-Screen bekommt Suche plus Filter nach Typ, Bundle und Nutzung. | Im Paket dokumentiert |
|
| WF-P2 Admin RBAC | Suche/Filter | Genommen | Mitarbeiter-Screen bekommt Suche plus Filter nach Rolle, Abteilung, Status und 2FA; Rollen-Screen bekommt Suche plus Filter nach Typ, Bundle und Nutzung. | Im Paket dokumentiert |
|
||||||
| WF-P2 Admin RBAC | Deaktivierung | Genommen | V1 hat nur ein kleines Confirm-Modal; danach Status `Deaktiviert`. | Reassign offener Verantwortlichkeiten ist Backlog |
|
| WF-P2 Admin RBAC | Deaktivierung | Genommen | V1 hat nur ein kleines Confirm-Modal; danach Status `Deaktiviert`. | Reassign offener Verantwortlichkeiten ist Backlog |
|
||||||
| WF-P2 Admin RBAC | Rollen-Loeschen | Genommen | Rollen koennen nur geloescht werden, wenn keine Mitarbeiter zugewiesen sind; sonst kleines Blocker-Modal. | Ersatzrolle/Bulk-Reassign ist Backlog |
|
| WF-P2 Admin RBAC | Rollen-Loeschen | Genommen | Rollen koennen nur geloescht werden, wenn keine Mitarbeiter zugewiesen sind; sonst kleines Blocker-Modal. | Ersatzrolle/Bulk-Reassign ist Backlog |
|
||||||
|
| WF-P2 Admin RBAC | M04A Visual Sync | Genommen | M04A `Rolle anlegen` ist optisch an Davids finalen M04B-Duplikat-Screen angeglichen, aber ohne Duplikat-Modus. | Paketdatei und Screen-Datei dokumentieren aktuellen Subframe-Stand |
|
||||||
| WF-P2 Admin RBAC | Deaktivieren mit Reassign | Backlog | Offene Aufgaben/Projekte/Verantwortlichkeiten werden spaeter uebertragen. | Nicht Teil der aktuellen Screen-Liste |
|
| WF-P2 Admin RBAC | Deaktivieren mit Reassign | Backlog | Offene Aufgaben/Projekte/Verantwortlichkeiten werden spaeter uebertragen. | Nicht Teil der aktuellen Screen-Liste |
|
||||||
| WF-P2 Admin RBAC | V2-Backlog | Dokumentiert | Reassign, Rollen-Loeschen mit Ersatzrolle, Gruppen, Rechtekatalog, Rollen-Audit, Rollen-Review, Templates, Rechte-Matrix, Bulk-Aktionen, erweiterter Admin-Schutz. | Details im Paket-Backlog |
|
| WF-P2 Admin RBAC | V2-Backlog | Dokumentiert | Reassign, Rollen-Loeschen mit Ersatzrolle, Gruppen, Rechtekatalog, Rollen-Audit, Rollen-Review, ausgearbeitete Vorlagen, Rechte-Matrix, Bulk-Aktionen, erweiterter Admin-Schutz. | Details im Paket-Backlog |
|
||||||
| WF-P2 Konto loeschen | Loeschungsanfrage statt direkter Loeschung | Genommen | V1 stellt nur eine Anfrage, keine sofortige technische Loeschung. | Einstieg unter Settings -> Workspaces |
|
| WF-P2 Konto loeschen | Gesamter Account/Konto-Loeschflow | Backlog | Account/Konto-Loeschen wird geparkt und nicht als aktueller v1-Flow weitergebaut. | Konto loeschen und Workspace loeschen sind zwei getrennte Workflows |
|
||||||
| WF-P2 Konto loeschen | Settings -> Workspaces | Genommen | Minimaler Workspaces-Bereich enthaelt Loeschungsanfrage. | Spaeter kann dort mehr Workspace-Verwaltung hinzukommen |
|
| WF-P2 Workspace loeschen | Eigener Workspace-Loeschflow | Backlog | Workspace/Tenant-Loeschen wird als eigener Workflow vorgemerkt. | Startpunkt spaeter in Workspace Settings; Settings sind noch nicht gebaut |
|
||||||
| WF-P2 Konto loeschen | Voller Loesch-/Export-Wizard | Backlog | Erklaerung und Datenexport-Hinweis werden in v1 im Modal integriert. | Kein mehrstufiger Wizard jetzt |
|
| WF-P2 Konto/Workspace loeschen | Voller Loesch-/Export-Wizard | Backlog | Erklaerung, Datenexport, Reauth, Confirm Phrase, Countdown und operative Bearbeitung spaeter klaeren. | Kein mehrstufiger Wizard jetzt |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -170,9 +176,10 @@ Diese Liste sammelt Punkte, die in einzelnen Paketen als `Backlog`, `Spaeter` od
|
|||||||
| WF-P2 Profil und Sicherheit | Security / Sessions | Backlog | Eigene Seite fuer aktive Sessions, Trust Devices und Session-Verwaltung |
|
| WF-P2 Profil und Sicherheit | Security / Sessions | Backlog | Eigene Seite fuer aktive Sessions, Trust Devices und Session-Verwaltung |
|
||||||
| WF-P2 Profil und Sicherheit | Ueberall abmelden / Session einzeln abmelden | Backlog | Gehoert zur spaeteren Security/Sessions-Seite |
|
| WF-P2 Profil und Sicherheit | Ueberall abmelden / Session einzeln abmelden | Backlog | Gehoert zur spaeteren Security/Sessions-Seite |
|
||||||
| WF-P2 2FA Verwalten | Trust Devices / aktive Sessions | Backlog | Nicht Teil des 2FA-Verwalten-Modals, sondern spaeter Security/Sessions |
|
| WF-P2 2FA Verwalten | Trust Devices / aktive Sessions | Backlog | Nicht Teil des 2FA-Verwalten-Modals, sondern spaeter Security/Sessions |
|
||||||
| WF-P2 Konto loeschen | Echter Loeschprozess | Backlog | Workspace-/Account-Loeschprozess mit operativer Bearbeitung spaeter ausarbeiten |
|
| WF-P2 Konto loeschen | Account/Konto-Loeschworkflow | Backlog | Gesamter Flow geparkt; spaeter getrennt von Workspace-Loeschen planen |
|
||||||
| WF-P2 Konto loeschen | Voller DSGVO-/Export-Wizard | Backlog | Datenexport-Step, Reauth, Confirm Phrase, Countdown und Legal/Billing-Details spaeter |
|
| WF-P2 Workspace loeschen | Workspace-Loeschworkflow | Backlog | Eigener Workflow fuer Tenant/Workspace-Loeschung; Startpunkt erst nach Workspace-Settings-Klaerung |
|
||||||
| WF-P2 Konto loeschen | Workspace-Settings ausbauen | Backlog | Minimaler Workspaces-Bereich enthaelt v1 nur Loeschungsanfrage |
|
| WF-P2 Konto/Workspace loeschen | Voller DSGVO-/Export-Wizard | Backlog | Datenexport-Step, Reauth, Confirm Phrase, Countdown und Legal/Billing-Details spaeter |
|
||||||
|
| WF-P2 Workspace Settings | Workspace-Settings ausbauen | Backlog | Voraussetzung fuer Konto-/Workspace-Loeschflows; Bereich ist noch nicht gebaut |
|
||||||
| WF-P2 Admin RBAC | V2-Backlog | Dokumentiert | Reassign, Rollen-Loeschen mit Ersatzrolle, Gruppen, Rechtekatalog, Rollen-Audit, Rollen-Review, Templates, Rechte-Matrix, Bulk-Aktionen, erweiterter Admin-Schutz |
|
| WF-P2 Admin RBAC | V2-Backlog | Dokumentiert | Reassign, Rollen-Loeschen mit Ersatzrolle, Gruppen, Rechtekatalog, Rollen-Audit, Rollen-Review, Templates, Rechte-Matrix, Bulk-Aktionen, erweiterter Admin-Schutz |
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -183,6 +190,8 @@ Diese Pakete sind angelegt, aber noch nicht validiert. Naechster Schritt ist jew
|
|||||||
|
|
||||||
| Kandidat | Ticket | Bereich | Status | Notiz |
|
| Kandidat | Ticket | Bereich | Status | Notiz |
|
||||||
|---|---|---|---|---|
|
|---|---|---|---|---|
|
||||||
|
| WF-P2 Konto loeschen | D-P2 | Account Lifecycle / Settings | Backlog | Erst wieder aufnehmen, wenn klar ist, wo Account-Loeschung in Settings lebt |
|
||||||
|
| WF-P2 Workspace loeschen | D-P2 | Workspace Settings | Backlog | Erst planen, wenn Workspace Settings als Bereich gebaut/validiert sind |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -199,6 +208,7 @@ Diese Pakete sind angelegt, aber noch nicht validiert. Naechster Schritt ist jew
|
|||||||
| In Subframe | validierte Screens werden gebaut |
|
| In Subframe | validierte Screens werden gebaut |
|
||||||
| Review | gebaut, aber noch nicht final geprueft |
|
| Review | gebaut, aber noch nicht final geprueft |
|
||||||
| Fertig | bereit fuer Handoff |
|
| Fertig | bereit fuer Handoff |
|
||||||
|
| Backlog | bewusst geparkt; nicht bauen, bis David den Flow neu priorisiert und validiert |
|
||||||
|
|
||||||
Regel: Kein Paket geht zu `In Subframe`, bevor es `Validiert` ist.
|
Regel: Kein Paket geht zu `In Subframe`, bevor es `Validiert` ist.
|
||||||
|
|
||||||
@@ -212,6 +222,7 @@ Regel: Kein Paket geht zu `In Subframe`, bevor es `Validiert` ist.
|
|||||||
| Wiederverwenden | vorhandenes Pattern/Archetyp reicht |
|
| Wiederverwenden | vorhandenes Pattern/Archetyp reicht |
|
||||||
| Nur dokumentieren | kein Frame, aber im Markdown beschreiben |
|
| Nur dokumentieren | kein Frame, aber im Markdown beschreiben |
|
||||||
| Spaeter | bewusst noch nicht jetzt |
|
| Spaeter | bewusst noch nicht jetzt |
|
||||||
|
| Backlog | bewusst geparkt; nur als Merker/Referenz fuehren |
|
||||||
| Raus | nicht im Scope |
|
| Raus | nicht im Scope |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -0,0 +1,18 @@
|
|||||||
|
# Quellen und Referenzen
|
||||||
|
|
||||||
|
Dieser Bereich sammelt Quellen, Referenz-Repos und Repo-Hinweise.
|
||||||
|
|
||||||
|
Hier liegt Kontext, der fuer Wireframe- und UX-Planung gelesen werden kann, aber nicht selbst der aktive Screen-Arbeitsbereich ist.
|
||||||
|
|
||||||
|
## Inhalt
|
||||||
|
|
||||||
|
| Pfad | Zweck |
|
||||||
|
|---|---|
|
||||||
|
| `hivegrid-cloud/` | mitgepushte HiveGrid-Cloud-Referenz inklusive Planning, Ticket-Docs und Code-Kontext |
|
||||||
|
| [[Repo Notizen]] | Hinweise zum Aktualisieren und Nutzen der HiveGrid-Cloud-Referenz |
|
||||||
|
|
||||||
|
## Regel
|
||||||
|
|
||||||
|
Quellen duerfen fuer Planung und Research genutzt werden.
|
||||||
|
|
||||||
|
Produkt- oder UX-Entscheidungen werden trotzdem erst in den Wireframe-Paketen dokumentiert, nachdem David sie validiert hat.
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
# Repo Notizen
|
||||||
|
|
||||||
|
Die mitgepushte HiveGrid-Cloud-Referenz liegt hier:
|
||||||
|
|
||||||
|
```text
|
||||||
|
03 Quellen und Referenzen/hivegrid-cloud
|
||||||
|
```
|
||||||
|
|
||||||
|
Wichtige Planning-Dateien aus dem Repo:
|
||||||
|
|
||||||
|
- `03 Quellen und Referenzen/hivegrid-cloud/.planning/SCREEN-MAP.md`
|
||||||
|
- `03 Quellen und Referenzen/hivegrid-cloud/.planning/DESIGNER-FIRST-PLAYBOOK.md`
|
||||||
|
- `03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/`
|
||||||
|
|
||||||
|
Repo aktualisieren:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "/Users/davidbertram/Desktop/Subframe/HiveGrid-Screen-Project/03 Quellen und Referenzen/hivegrid-cloud"
|
||||||
|
git pull --ff-only
|
||||||
|
```
|
||||||
|
|
||||||
|
Hinweis: Diese Referenz ist fuer die Wireframe-Arbeit vor allem auf Lesen/Pullen ausgelegt. Relevante Planning-Aenderungen werden im Hauptrepo mitgepusht.
|
||||||
|
|
||||||
|
Alter lokaler Backup-Ordner:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/Users/davidbertram/Desktop/HiveGrid-Backups/
|
||||||
|
```
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
.git
|
||||||
|
.tc
|
||||||
|
.claude
|
||||||
|
.codex
|
||||||
|
.cursor
|
||||||
|
.idea
|
||||||
|
.vscode
|
||||||
|
.agents
|
||||||
|
.planning
|
||||||
|
cli-tokens
|
||||||
|
node_modules
|
||||||
|
**/node_modules
|
||||||
|
.pnpm-store
|
||||||
|
pnpm-store
|
||||||
|
|
||||||
|
*.log
|
||||||
|
.DS_Store
|
||||||
|
.env
|
||||||
|
.env.*
|
||||||
|
!.env.example
|
||||||
|
|
||||||
|
# Repository docs and generated verification artifacts are not Docker build inputs.
|
||||||
|
/docs
|
||||||
|
.cache
|
||||||
|
**/.cache
|
||||||
|
.eslintcache
|
||||||
|
**/.eslintcache
|
||||||
|
.turbo
|
||||||
|
**/.turbo
|
||||||
|
.vite
|
||||||
|
**/.vite
|
||||||
|
.next
|
||||||
|
**/.next
|
||||||
|
.react-router
|
||||||
|
**/.react-router
|
||||||
|
coverage
|
||||||
|
**/coverage
|
||||||
|
.nyc_output
|
||||||
|
**/.nyc_output
|
||||||
|
tmp
|
||||||
|
temp
|
||||||
|
reports
|
||||||
|
**/reports
|
||||||
|
playwright-report
|
||||||
|
test-results
|
||||||
|
blob-report
|
||||||
|
**/playwright-report
|
||||||
|
**/test-results
|
||||||
|
**/blob-report
|
||||||
|
*.tsbuildinfo
|
||||||
|
|
||||||
|
public/build
|
||||||
|
/build
|
||||||
|
/apps/*/build
|
||||||
|
apps/*/dist
|
||||||
|
packages/*/dist
|
||||||
|
|
||||||
|
README.md
|
||||||
@@ -0,0 +1,484 @@
|
|||||||
|
# Branding (optional overrides; defaultBrandTokens is used when these are unset)
|
||||||
|
# BRAND_PRODUCT_NAME=Acme Ops
|
||||||
|
# BRAND_SITE_URL=https://acme.example
|
||||||
|
# BRAND_SUPPORT_EMAIL=support@acme.example
|
||||||
|
# BRAND_SUPPORT_FROM_NAME=Acme Support
|
||||||
|
# BRAND_LEGAL_IMPRINT_URL=https://acme.example/imprint
|
||||||
|
# BRAND_LEGAL_PRIVACY_URL=https://acme.example/privacy
|
||||||
|
# BRAND_LEGAL_TERMS_URL=https://acme.example/terms
|
||||||
|
# BRAND_LOGO_URL=/android-chrome-512x512.png
|
||||||
|
# BRAND_FAVICON_URL=/favicon.ico
|
||||||
|
# BRAND_MAIL_PRIMARY=#2563eb
|
||||||
|
# BRAND_MAIL_PRIMARY_TEXT=#ffffff
|
||||||
|
# BRAND_MAIL_BACKGROUND=#f6f8fb
|
||||||
|
# BRAND_MAIL_LINK=#2563eb
|
||||||
|
|
||||||
|
# Core
|
||||||
|
APP_NAME=HiveGrid
|
||||||
|
# DATABASE_URL: pooled connection for application traffic. Point at PgBouncer
|
||||||
|
# on port 6432 in environments where the pooler is deployed and append
|
||||||
|
# `?pgbouncer=true&connection_limit=10` so Prisma disables prepared-statement
|
||||||
|
# caching (transaction-mode pooling cannot keep them). DIRECT_URL (below) is
|
||||||
|
# the unpooled connection used by `prisma migrate`. See docs/ops/pgbouncer.md.
|
||||||
|
DATABASE_URL="postgres://user:pass@localhost:6432/hivegrid?pgbouncer=true&connection_limit=10"
|
||||||
|
# SESSION_SECRET signs the session cookie. Min 32 bytes of entropy recommended (openssl rand -hex 32).
|
||||||
|
SESSION_SECRET=
|
||||||
|
# CRYPTO_SECRET is the AES key for stored workflow credentials. Use a SEPARATE secret from SESSION_SECRET.
|
||||||
|
CRYPTO_SECRET=
|
||||||
|
# Local dev: include the vite port so cross-host redirects (login -> app/admin host)
|
||||||
|
# keep :3000 — routing derives app.localhost:3000 etc. and hostMatches tolerates it.
|
||||||
|
APP_BASE_DOMAIN=localhost:3000
|
||||||
|
WEB_APP_HOST=app.localhost:3000
|
||||||
|
# Public app origin used for embed snippets, mail links, and worker-to-web callbacks.
|
||||||
|
# APP_URL=http://app.localhost:3000
|
||||||
|
ADMIN_APP_HOST=admin.localhost:3000
|
||||||
|
API_HOST=api.localhost:3000
|
||||||
|
# MCP runs as its own public connector host, not below app/api.
|
||||||
|
MCP_HOST=0.0.0.0
|
||||||
|
MCP_PORT=8080
|
||||||
|
MCP_ALLOWED_HOSTS=mcp.hivegrid.de,staging-mcp.hivegrid.de,localhost,127.0.0.1,::1
|
||||||
|
MCP_ALLOWED_ORIGINS=https://mcp.hivegrid.de,https://staging-mcp.hivegrid.de,http://localhost,http://127.0.0.1
|
||||||
|
# Public MCP resource origin and OAuth authorization-server origin. Set staging to
|
||||||
|
# https://staging-mcp.hivegrid.de and https://staging-app.hivegrid.de.
|
||||||
|
MCP_RESOURCE_URL=http://mcp.localhost:8080
|
||||||
|
MCP_AUTHORIZATION_SERVER_URL=http://app.localhost:3000
|
||||||
|
# Optional dedicated HMAC secret for hash-only MCP OAuth codes/tokens. When unset,
|
||||||
|
# API_KEY_HASH_SECRET is reused so web and mcp agree on token lookup.
|
||||||
|
MCP_OAUTH_TOKEN_HASH_SECRET=
|
||||||
|
# APP_PROTOCOL=http
|
||||||
|
|
||||||
|
# Legacy API/auth tokens
|
||||||
|
API_ACCESS_TOKEN=
|
||||||
|
JWT_SECRET=
|
||||||
|
# Temporary cutover switch for plaintext API-key lookup. Secure-by-default: ships
|
||||||
|
# disabled. Set to `true` ONLY during the hash-metadata backfill window, then set
|
||||||
|
# back to `false` once the backfill is verified.
|
||||||
|
API_KEY_LEGACY_PLAINTEXT_FALLBACK=false
|
||||||
|
# Stable HMAC secret for legacy API-key hash lookup/backfill. Keep unchanged once deployed.
|
||||||
|
API_KEY_HASH_SECRET=
|
||||||
|
|
||||||
|
# Local development
|
||||||
|
# Set to true only for disposable local databases when you want sample tenants/users.
|
||||||
|
# SEED_DEMO_DATA=true
|
||||||
|
# DEMO_USER is read only when NODE_ENV=development.
|
||||||
|
# DEMO_USER=admin@email.com:password
|
||||||
|
# Production seed bootstrap credentials. Required for `NODE_ENV=production pnpm seed`.
|
||||||
|
# SEED_ADMIN_EMAIL=admin@example.com
|
||||||
|
# SEED_ADMIN_PASSWORD=replace-with-production-bootstrap-password
|
||||||
|
# WEBHOOKS_URL=https://...ngrok-free.app
|
||||||
|
|
||||||
|
# S3-compatible storage. HiveGrid prod/staging nutzt Hetzner Object Storage (ADR-009),
|
||||||
|
# Endpoint-Format z.B. https://nbg1.your-objectstorage.com (S3-API identisch; ebenso nutzbar: Wasabi, Backblaze B2, MinIO, AWS S3).
|
||||||
|
# Werte gehoeren in die Coolify-Secrets je Umgebung, nicht ins Repo. Leave STORAGE_ENDPOINT empty to use local filesystem (STORAGE_LOCAL_ROOT).
|
||||||
|
STORAGE_ENDPOINT=
|
||||||
|
STORAGE_REGION=
|
||||||
|
STORAGE_BUCKET=
|
||||||
|
STORAGE_ACCESS_KEY_ID=
|
||||||
|
STORAGE_SECRET_ACCESS_KEY=
|
||||||
|
STORAGE_SESSION_TOKEN=
|
||||||
|
STORAGE_PUBLIC_BASE_URL=
|
||||||
|
# Set to true for providers that require path-style bucket addressing (MinIO, some Wasabi regions).
|
||||||
|
# Leave false for AWS S3 default virtual-hosted style.
|
||||||
|
STORAGE_FORCE_PATH_STYLE=false
|
||||||
|
|
||||||
|
# Billing
|
||||||
|
# Lago is self-hosted and used for billing plans, seats, subscriptions and invoices.
|
||||||
|
# Do not append /api/v1; the gateway adds it.
|
||||||
|
LAGO_API_URL=
|
||||||
|
LAGO_API_KEY=
|
||||||
|
LAGO_WEBHOOK_SECRET=
|
||||||
|
LAGO_TIMEOUT_MS=10000
|
||||||
|
# Mollie is used only as payment processor. Keep test/live keys in the secret store.
|
||||||
|
MOLLIE_API_KEY=
|
||||||
|
MOLLIE_PROFILE_ID=
|
||||||
|
MOLLIE_TIMEOUT_MS=10000
|
||||||
|
|
||||||
|
# Worker delivery credentials for queued transactional email (hivegrid.email -> Mailjet)
|
||||||
|
MAILJET_API_KEY=
|
||||||
|
MAILJET_SECRET_KEY=
|
||||||
|
MAILJET_FROM_EMAIL=
|
||||||
|
# MAILJET_FROM_NAME=
|
||||||
|
# Inbound Mailjet event webhook Basic-Auth password (api runtime). Callback URL: https://mailjet:SECRET@api.example.com/v1/email-sequences/mailjet/webhooks
|
||||||
|
# MAILJET_WEBHOOK_SECRET=
|
||||||
|
SUPPORT_EMAIL=
|
||||||
|
COMPANY_NAME=
|
||||||
|
COMPANY_ADDRESS=
|
||||||
|
|
||||||
|
# Contact and newsletter
|
||||||
|
INTEGRATIONS_CONTACT_FORMSPREE=
|
||||||
|
|
||||||
|
# Analytics (First-Party-Ingestion-Token; Google Analytics wurde EU-sterilisiert entfernt — R-P1a)
|
||||||
|
ANALYTICS_TOKEN=
|
||||||
|
|
||||||
|
# Self-hosted captcha. mCaptcha remains the compatibility default; set
|
||||||
|
# CAPTCHA_PROVIDER=cap to use Cap Standalone (see infra/cap/README.md).
|
||||||
|
# Public bits (instance URL + per-surface sitekeys) are safe to expose; secrets
|
||||||
|
# are server-only. Verification fails open by default (CAPTCHA_FAIL_OPEN).
|
||||||
|
CAPTCHA_PROVIDER=mcaptcha
|
||||||
|
CAP_INSTANCE_URL=
|
||||||
|
CAP_SITE_SECRET=
|
||||||
|
CAP_SITE_SECRET_LOGIN=
|
||||||
|
CAP_SITE_SECRET_FORMS=
|
||||||
|
CAP_SITE_SECRET_BOOKING=
|
||||||
|
CAP_SITEKEY_LOGIN=
|
||||||
|
CAP_SITEKEY_FORMS=
|
||||||
|
CAP_SITEKEY_BOOKING=
|
||||||
|
MCAPTCHA_INSTANCE_URL=
|
||||||
|
MCAPTCHA_ACCOUNT_SECRET=
|
||||||
|
MCAPTCHA_SITEKEY_LOGIN=
|
||||||
|
MCAPTCHA_SITEKEY_FORMS=
|
||||||
|
MCAPTCHA_SITEKEY_BOOKING=
|
||||||
|
CAPTCHA_FAIL_OPEN=true
|
||||||
|
AUTH_MAGIC_LINK_ENABLED=false
|
||||||
|
AUTH_MAGIC_LINK_TOKEN_TTL_MINUTES=15
|
||||||
|
|
||||||
|
# Optional notification-provider diagnostics
|
||||||
|
NOTIFICATIONS_NOVU_API_KEY=
|
||||||
|
|
||||||
|
# Queue and browser-backed workers
|
||||||
|
WORKER_ENABLED=false
|
||||||
|
# Worker queue group — one of general | mail | import | webhook | plugin. Required when
|
||||||
|
# WORKER_ENABLED=true. Each docker-compose / K8s replica sets exactly one group
|
||||||
|
# and that determines which BullMQ queues the process subscribes to. See
|
||||||
|
# docs/ops/worker-queues.md.
|
||||||
|
# WORKER_QUEUE_GROUP=general
|
||||||
|
# General worker workflow-trigger executor. Mode `http` uses the signed web
|
||||||
|
# bridge and falls back to APP_URL when URL is unset. Mode `hybrid` canaries the
|
||||||
|
# worker-native runner with HTTP fallback. Mode `native` is opt-in for supported
|
||||||
|
# safe-core workflows: manual/event triggers, if/switch, httpRequest, log,
|
||||||
|
# alertUser, doNothing, rowGet, iterator, variable, email, and single-boundary
|
||||||
|
# waitForInput continuation resumes.
|
||||||
|
# WORKFLOW_TRIGGER_EXECUTOR_MODE=http
|
||||||
|
# WORKFLOW_TRIGGER_EXECUTOR_URL=
|
||||||
|
# API_ACCESS_TOKEN must match the web runtime token when http/hybrid mode is used.
|
||||||
|
# WORKFLOW_TRIGGER_EXECUTOR_TIMEOUT_MS=30000
|
||||||
|
# WORKFLOW_TRIGGER_OUTBOX_ENABLED=true
|
||||||
|
# WORKFLOW_TRIGGER_OUTBOX_CONCURRENCY=5
|
||||||
|
# WORKFLOW_TRIGGER_OUTBOX_REQUIRED=false
|
||||||
|
# Per-group concurrency (only the matching group's value is read at runtime).
|
||||||
|
# Defaults: general=10, mail=5, import=1, webhook=20, plugin=5.
|
||||||
|
# WORKER_CONCURRENCY_GENERAL=10
|
||||||
|
# WORKER_CONCURRENCY_MAIL=5
|
||||||
|
# WORKER_CONCURRENCY_IMPORT=1
|
||||||
|
# WORKER_CONCURRENCY_WEBHOOK=20
|
||||||
|
# WORKER_CONCURRENCY_PLUGIN=5
|
||||||
|
# Health HTTP port for /healthz and /readyz (per-worker). Defaults to 9100;
|
||||||
|
# the five-service worker layout uses 9101-9105.
|
||||||
|
# WORKER_HEALTH_PORT=9100
|
||||||
|
# WORKER_HEALTH_HOST=0.0.0.0
|
||||||
|
# Redis connection pool size advisory (forwarded to ioredis). Defaults differ
|
||||||
|
# per group: general/mail=4, import=2, webhook=8, plugin=4.
|
||||||
|
# WORKER_REDIS_POOL_SIZE=
|
||||||
|
EXPORT_RETENTION_QUEUE_ENABLED=false
|
||||||
|
IMPORT_QUEUE_ENABLED=false
|
||||||
|
# Outbox dispatcher (transactional outbox pattern; see docs/architecture/outbox-pattern.md).
|
||||||
|
# Defaults: off in dev so workers without Redis can still boot. Set true on staging+prod.
|
||||||
|
OUTBOX_DISPATCHER_ENABLED=false
|
||||||
|
OUTBOX_DISPATCHER_REQUIRED=false
|
||||||
|
OUTBOX_DISPATCH_BATCH_SIZE=100
|
||||||
|
OUTBOX_DISPATCH_CONCURRENCY=10
|
||||||
|
OUTBOX_DISPATCH_INTERVAL_MS=1000
|
||||||
|
OUTBOX_MAX_RETRIES=6
|
||||||
|
# Daily worker-general maintenance that purges DONE outbox rows after the replay/debug window.
|
||||||
|
OUTBOX_DONE_RETENTION_HOURS=720
|
||||||
|
OUTBOX_DONE_RETENTION_BATCH_SIZE=1000
|
||||||
|
BULLMQ_REDIS_URL=redis://localhost:6379/0
|
||||||
|
# REDIS_URL is a fallback only when BULLMQ_REDIS_URL is absent; keep it commented if a platform injects it.
|
||||||
|
# REDIS_URL=redis://localhost:6379/0
|
||||||
|
# Two-tier cache pub/sub invalidation (subscription + tenant; entitlements piggy-back on subscription).
|
||||||
|
# Set CACHE_INVALIDATION_ENABLED=false to disable cross-replica pub/sub (emergency switch — L1 TTL becomes
|
||||||
|
# the only consistency mechanism). See docs/architecture/two-tier-cache.md.
|
||||||
|
CACHE_INVALIDATION_ENABLED=true
|
||||||
|
CACHE_L1_TTL_SECONDS=300
|
||||||
|
# API idempotency-key storage backend. Default "prisma" keeps reservations in Postgres (multi-replica-safe).
|
||||||
|
# Set "shared-store" to back them with Redis instead (keeps the primary DB cooler; Redis TTL handles eviction).
|
||||||
|
IDEMPOTENCY_BACKEND=prisma
|
||||||
|
# Headless browser runtime (Playwright/Puppeteer-as-a-service) used by worker-backed browser sessions.
|
||||||
|
# Leave empty for local dev; set in production when workflow steps need real browser automation.
|
||||||
|
BROWSER_RUNTIME_URL=
|
||||||
|
BROWSER_RUNTIME_API_KEY=
|
||||||
|
BROWSER_SESSION_TIMEOUT_MS=60000
|
||||||
|
|
||||||
|
# IP enrichment providers used by audit/log enrichment. Pick ONE; if both are set IPStack is preferred.
|
||||||
|
# IPStack (ipstack.com) — paid tiers required for HTTPS and bulk lookups.
|
||||||
|
IPSTACK_API_KEY=
|
||||||
|
# ipapi.is — alternative provider with similar response shape; free tier available.
|
||||||
|
IPAPIIS_API_KEY=
|
||||||
|
PORTAL_SERVER_URL=
|
||||||
|
PORTAL_SERVER_FLY_TOKEN=
|
||||||
|
|
||||||
|
# Meilisearch — full-text search engine consumed by packages/search and the
|
||||||
|
# search-indexer worker job. MEILI_API_KEY is the SaaS-scoped client key the app
|
||||||
|
# authenticates with; it is a server-side secret — never expose it to browsers.
|
||||||
|
# Local dev uses the docker-compose meilisearch service whose master key defaults
|
||||||
|
# to `devkey`, so the app key is `devkey` too. Production injects a scoped key
|
||||||
|
# (infra STANDARDS §4 / docs/deploy/meilisearch.md, docs/features/search.md).
|
||||||
|
MEILI_URL=http://localhost:7700
|
||||||
|
MEILI_API_KEY=devkey
|
||||||
|
# MEILI_ENV=development
|
||||||
|
# Toggle search backend hot-path strategy. `meilisearch` (default) goes
|
||||||
|
# through the wrapper with automatic SQL-LIKE fallback on connection
|
||||||
|
# errors; `sql` forces every read onto the legacy fallback (emergency
|
||||||
|
# switch). See docs/features/search.md#rollback.
|
||||||
|
# SEARCH_BACKEND=meilisearch
|
||||||
|
|
||||||
|
# Dynamic site API keys
|
||||||
|
# SITE_KEY_EXAMPLE_SITE=
|
||||||
|
|
||||||
|
# Production/runtime platform
|
||||||
|
# NODE_ENV=production
|
||||||
|
# DIRECT_URL: unpooled Postgres URL (port 5432, bypasses PgBouncer). Required
|
||||||
|
# by `prisma migrate` / `db push` so prepared statements survive. Apps still
|
||||||
|
# use DATABASE_URL (above) for runtime queries. See docs/ops/pgbouncer.md.
|
||||||
|
# DIRECT_URL="postgres://user:pass@localhost:5432/hivegrid"
|
||||||
|
# DATABASE_READ_URL: optional Postgres read-replica used by getReadDbClient()
|
||||||
|
# for hot-read paths (CRM/KB listings, dashboards, public sites/portals).
|
||||||
|
# When unset or empty, getReadDbClient() falls back to DATABASE_URL so single-
|
||||||
|
# DB dev and self-hosted setups work without any code change. Point at the
|
||||||
|
# replica (or a PgBouncer-fronted replica) in staging/production. Replication
|
||||||
|
# is eventually consistent — see docs/architecture/rw-split.md.
|
||||||
|
# DATABASE_READ_URL="postgres://read_user:pass@replica.localhost:5432/hivegrid"
|
||||||
|
# SERVER_URL=https://app.example.com
|
||||||
|
# VERCEL_URL=
|
||||||
|
|
||||||
|
# Observability (opt-in; leave commented to keep the safe noop reporter and disabled tracing)
|
||||||
|
# SENTRY_DSN=https://public@sentry.example/1
|
||||||
|
# API (apps/api) and Worker (apps/worker) — independent DSNs so the two
|
||||||
|
# processes report to separate Sentry projects (hivegrid-api / hivegrid-worker).
|
||||||
|
# SENTRY_DSN_API=https://public-api@sentry.example/3
|
||||||
|
# SENTRY_DSN_WORKER=https://public-worker@sentry.example/4
|
||||||
|
# SENTRY_ENVIRONMENT=production
|
||||||
|
# SENTRY_RELEASE=
|
||||||
|
# SENTRY_TRACES_SAMPLE_RATE=0.1
|
||||||
|
# SENTRY_PROFILES_SAMPLE_RATE=0.0
|
||||||
|
# OpenTelemetry (opt-in; leave commented to keep the api/worker OTel bootstrap as a no-op).
|
||||||
|
# Endpoint examples: sentry-relay (broken on Sentry 25.12.1 self-hosted upstream nginx, see B-005),
|
||||||
|
# OTel collector (http://otel-collector:4318/v1/traces), Tempo, Jaeger.
|
||||||
|
# OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318/v1/traces
|
||||||
|
# Comma-separated key=value headers forwarded with every OTLP export.
|
||||||
|
# OTEL_EXPORTER_OTLP_HEADERS=x-sentry-auth=Sentry sentry_key=<public-key>
|
||||||
|
# OTEL_SERVICE_NAME=hivegrid-api
|
||||||
|
# OTEL_TRACES_SAMPLER=parentbased_traceidratio
|
||||||
|
# OTEL_TRACES_SAMPLER_ARG=0.1
|
||||||
|
# OTEL_LOG_LEVEL=debug
|
||||||
|
# Browser-side OTel (Vite-bundled). VITE_OTEL_EXPORTER_OTLP_ENDPOINT must be
|
||||||
|
# CORS-reachable from the user agent; gateway/relay MUST be rate-limited.
|
||||||
|
# VITE_OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.example.com/v1/traces
|
||||||
|
# VITE_OTEL_SERVICE_NAME=hivegrid-web
|
||||||
|
# Web (apps/web) — separate Sentry project from the API/Worker stack.
|
||||||
|
# SENTRY_DSN_WEB=https://public-web@sentry.example/2
|
||||||
|
# VITE_SENTRY_DSN_WEB=https://public-web@sentry.example/2
|
||||||
|
# VITE_SENTRY_RELEASE=
|
||||||
|
# VITE_SENTRY_TRACES_SAMPLE_RATE=0.1
|
||||||
|
# VITE_SENTRY_REPLAYS_SESSION_SAMPLE_RATE=0.1
|
||||||
|
# VITE_SENTRY_REPLAYS_ON_ERROR_SAMPLE_RATE=1.0
|
||||||
|
# Sentry source-map upload + release tagging (CI-only; never commit the auth token).
|
||||||
|
# Required by .github/workflows/_sentry-release.yml and the @sentry/vite-plugin step.
|
||||||
|
# SENTRY_AUTH_TOKEN=
|
||||||
|
# SENTRY_ORG=
|
||||||
|
# SENTRY_PROJECT=hivegrid-web
|
||||||
|
# SENTRY_URL=https://sentry.saas-ctrl.com
|
||||||
|
|
||||||
|
# Asset CDN (opt-in; leave commented to keep origin-relative asset URLs).
|
||||||
|
# When set at build time, Vite emits all asset URLs prefixed with this origin
|
||||||
|
# so the CDN (Bunny.net by default — see docs/ops/asset-cdn.md) can pull from
|
||||||
|
# the app server and serve users from the edge. Local dev ignores the var.
|
||||||
|
# ASSET_CDN_URL=https://cdn.hivegrid.de
|
||||||
|
# Bunny.net pull-zone id used by the post-deploy purge step. CI-only.
|
||||||
|
# BUNNY_PULL_ZONE_ID=
|
||||||
|
# Bunny.net account-level API key for cache-purge calls. CI-only.
|
||||||
|
# BUNNY_API_KEY=
|
||||||
|
|
||||||
|
# Password policy (auth.password.errors.* messages; defaults match OWASP 2024).
|
||||||
|
# Override at deploy time to relax or tighten without a code deploy.
|
||||||
|
# AUTH_PASSWORD_MIN_LENGTH=12
|
||||||
|
# AUTH_PASSWORD_REQUIRE_UPPER=true
|
||||||
|
# AUTH_PASSWORD_REQUIRE_LOWER=true
|
||||||
|
# AUTH_PASSWORD_REQUIRE_DIGIT=true
|
||||||
|
# AUTH_PASSWORD_REQUIRE_SPECIAL=false
|
||||||
|
# AUTH_PASSWORD_HIBP_CHECK=true
|
||||||
|
# AUTH_PASSWORD_HIBP_MAX_OCCURRENCES=0
|
||||||
|
|
||||||
|
# Prometheus metrics + /status endpoints (api, worker, web).
|
||||||
|
# When METRICS_ENABLED=true both endpoints are mounted; /status is public,
|
||||||
|
# /metrics requires Authorization: Bearer $METRICS_TOKEN.
|
||||||
|
# METRICS_ENABLED=false
|
||||||
|
# METRICS_TOKEN=
|
||||||
|
# Worker admin HTTP server (only opened when METRICS_ENABLED=true).
|
||||||
|
# Keep it on a private network — Prometheus only.
|
||||||
|
# WORKER_ADMIN_PORT=9100
|
||||||
|
# WORKER_ADMIN_HOST=0.0.0.0
|
||||||
|
# Region tag surfaced in /status. Falls back to FLY_REGION when unset.
|
||||||
|
# APP_REGION=
|
||||||
|
|
||||||
|
# Backup CLI (@hivegrid/cli). See docs/operations/backup.md for the full runbook.
|
||||||
|
# BACKUP_S3_ENDPOINT=https://s3.example.com
|
||||||
|
# BACKUP_S3_REGION=us-east-1
|
||||||
|
# BACKUP_S3_BUCKET=hivegrid-backups
|
||||||
|
# BACKUP_S3_ACCESS_KEY_ID=
|
||||||
|
# BACKUP_S3_SECRET_ACCESS_KEY=
|
||||||
|
# BACKUP_S3_SESSION_TOKEN=
|
||||||
|
# BACKUP_S3_FORCE_PATH_STYLE=true
|
||||||
|
# Encryption: age (default), gpg, or none. age REQUIRES BACKUP_AGE_PUBLIC_KEY.
|
||||||
|
# BACKUP_ENCRYPTION=age
|
||||||
|
# Public-key recipient for age encryption (operator generates via `age-keygen`).
|
||||||
|
# BACKUP_AGE_PUBLIC_KEY=age1exampleexampleexampleexampleexampleexampleexampleexample
|
||||||
|
# Identity file used for `backup:restore` and `backup:verify` decryption.
|
||||||
|
# BACKUP_AGE_IDENTITY_FILE=/secrets/age-backup.key
|
||||||
|
# GPG fallback key id (only used when BACKUP_ENCRYPTION=gpg).
|
||||||
|
# BACKUP_GPG_RECIPIENT=
|
||||||
|
# Retention policy (most-recent kept per classification).
|
||||||
|
# BACKUP_RETENTION_DAILY=7
|
||||||
|
# BACKUP_RETENTION_WEEKLY=4
|
||||||
|
# BACKUP_RETENTION_MONTHLY=12
|
||||||
|
# Set to true to include a ClickHouse BACKUP statement in `backup:create`.
|
||||||
|
# BACKUP_INCLUDE_CLICKHOUSE=false
|
||||||
|
|
||||||
|
# Embeddable form widget (Phase 05 #58 — packages/form-widget).
|
||||||
|
# FORM_WIDGET_CDN_URL serves /embed/widget.js. Falls back to APP_URL when unset.
|
||||||
|
# Captcha on form submissions uses the shared self-hosted captcha provider
|
||||||
|
# configured at the top of this file, opt-in per form AND gated behind the
|
||||||
|
# `form-widget-turnstile` feature flag. See docs/features/form-widget.md.
|
||||||
|
# FORM_WIDGET_CDN_URL=https://forms.example.com
|
||||||
|
|
||||||
|
# Marketing-funnel (Phase 05 #78 — apps/web/public/embed/marketing.js).
|
||||||
|
# MARKETING_ALLOWED_ORIGINS is a CSV of origins (with `*.host` wildcards
|
||||||
|
# allowed) from which the public `/api/leads/capture` endpoint accepts
|
||||||
|
# submissions. Fail-closed: empty list rejects all browser submissions.
|
||||||
|
# MARKETING_RATE_LIMIT_PER_MIN is the per-IP submission limit (default 5).
|
||||||
|
# Captcha is the shared self-hosted captcha provider; flag is gated via
|
||||||
|
# the `marketing-funnel-turnstile` feature flag.
|
||||||
|
# See docs/features/marketing-funnel.md.
|
||||||
|
# MARKETING_ALLOWED_ORIGINS=https://marketing.example.com,https://*.example.com
|
||||||
|
# MARKETING_RATE_LIMIT_PER_MIN=5
|
||||||
|
|
||||||
|
# Marketing-funnel Phase 2 (Phase 05 #79 — self-service conversion +
|
||||||
|
# outbound webhooks + attribution reports).
|
||||||
|
# LEAD_CONVERSION_SECRET is the HMAC key (min 32 bytes) signing the
|
||||||
|
# `/register?leadId=…&token=…&plan=…` deep-links produced by
|
||||||
|
# `signLeadToken` and verified by the register loader. Rotate by setting a
|
||||||
|
# new value; old tokens become invalid after 7 days (default TTL).
|
||||||
|
# LEAD_CONVERSION_ENABLED=false short-circuits both the deep-link
|
||||||
|
# pre-fill flow and the admin "Convert to Tenant" button without rolling
|
||||||
|
# back the migration — useful for emergency disable.
|
||||||
|
# MARKETING_WEBHOOKS_ENABLED=false freezes the apps/worker
|
||||||
|
# `outbox.marketing` queue — outbox events accumulate so they replay
|
||||||
|
# automatically after the flip back to true (raise outbox retention if
|
||||||
|
# you plan a long pause).
|
||||||
|
# See docs/features/marketing-funnel.md.
|
||||||
|
# LEAD_CONVERSION_SECRET=
|
||||||
|
# LEAD_CONVERSION_ENABLED=true
|
||||||
|
# MARKETING_WEBHOOKS_ENABLED=true
|
||||||
|
|
||||||
|
# Marketing-Funnel Phase 3 — email-sequence engine (Phase 05 #80).
|
||||||
|
# MARKETING_TOKEN_SECRET signs the unsubscribe tokens embedded in every
|
||||||
|
# sequence email's `List-Unsubscribe` header. Falls back to
|
||||||
|
# LEAD_CONVERSION_SECRET when unset — both must be at least 32 bytes
|
||||||
|
# (`openssl rand -hex 32`).
|
||||||
|
# MARKETING_SEQUENCES_ENABLED must be set to true before apps/worker starts
|
||||||
|
# the `email-sequence.step` queue, trigger handler, or sequence cron producers.
|
||||||
|
# Keep this unset or false in production until the delayed producer, renderer,
|
||||||
|
# and mail-send adapter follow-ups are wired and verified.
|
||||||
|
# See docs/features/email-sequences.md.
|
||||||
|
# MARKETING_TOKEN_SECRET=
|
||||||
|
# MARKETING_SEQUENCES_ENABLED=false
|
||||||
|
|
||||||
|
# Realtime collaboration (Phase 05 #59 — apps/hocuspocus + Novel-Editor).
|
||||||
|
# HOCUSPOCUS_AUTH_SECRET signs the 15-min JWTs the web app issues via
|
||||||
|
# `/api/collab/token`. The Hocuspocus container verifies them in
|
||||||
|
# `onAuthenticate`; secret must match across web + hocuspocus deploys.
|
||||||
|
# Min 32 bytes of entropy (`openssl rand -hex 32`).
|
||||||
|
# VITE_HOCUSPOCUS_URL is the public WebSocket URL the browser connects to
|
||||||
|
# (e.g. `wss://collab.example.com`). When unset, the Novel-Editor mounts
|
||||||
|
# without collab extensions — graceful single-user fallback.
|
||||||
|
# HOCUSPOCUS_URL is the server-internal WebSocket endpoint exposed by the
|
||||||
|
# hocuspocus container (defaults to ws://hocuspocus:1234 in docker).
|
||||||
|
# HOCUSPOCUS_MAX_PAYLOAD_BYTES caps the Y.js state we persist per doc.
|
||||||
|
# Activation also requires the `realtime-collab-enabled` feature flag.
|
||||||
|
# See docs/features/realtime-collab.md.
|
||||||
|
# HOCUSPOCUS_AUTH_SECRET=
|
||||||
|
# VITE_HOCUSPOCUS_URL=wss://collab.example.com
|
||||||
|
# HOCUSPOCUS_URL=ws://hocuspocus:1234
|
||||||
|
# HOCUSPOCUS_PORT=1234
|
||||||
|
# HOCUSPOCUS_HOST=0.0.0.0
|
||||||
|
# HOCUSPOCUS_MAX_PAYLOAD_BYTES=10485760
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Admin-Panel SSO via Authentik (Phase 09 #82 — apps/web/app/modules/admin-sso)
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# AUTHENTIK_ISSUER_URL is the OIDC issuer published by the Authentik
|
||||||
|
# `hivegrid-admin-panel` provider (matches the `iss` claim in ID-tokens).
|
||||||
|
# Typically `https://auth.<domain>/application/o/hivegrid-admin-panel/`.
|
||||||
|
# AUTHENTIK_ADMIN_CLIENT_ID must equal the blueprint client_id
|
||||||
|
# (`hivegrid-admin-panel` per infra/authentik/bootstrap/blueprints/03-*).
|
||||||
|
# AUTHENTIK_ADMIN_CLIENT_SECRET is fetched from the Authentik admin UI
|
||||||
|
# after the blueprint applies; rotate via Authentik then redeploy.
|
||||||
|
# AUTHENTIK_ADMIN_REDIRECT_URI is the exact callback URI registered with
|
||||||
|
# the Authentik provider — must match the deployed admin host.
|
||||||
|
# AUTHENTIK_ADMIN_POST_LOGOUT_REDIRECT_URI is the URI Authentik redirects
|
||||||
|
# the browser to after end_session_endpoint; default falls back to the
|
||||||
|
# admin login page with `?logged_out=1`.
|
||||||
|
#
|
||||||
|
# ADMIN_FALLBACK_LOGIN_ENABLED gates the email/password emergency path.
|
||||||
|
# When `false` (default) the admin login page hides the password form
|
||||||
|
# entirely. ADMIN_FALLBACK_LOGIN_EMAILS is a comma-separated allowlist of
|
||||||
|
# admin emails that may use the fallback when the flag is on — keep it
|
||||||
|
# short (1-2 bootstrap accounts max). Each fallback login emits an
|
||||||
|
# `admin.login.fallback.success` audit event tagged severity=warn.
|
||||||
|
# See docs/operations/admin-sso.md.
|
||||||
|
# AUTHENTIK_ISSUER_URL=https://auth.example.com/application/o/hivegrid-admin-panel/
|
||||||
|
# AUTHENTIK_ADMIN_CLIENT_ID=hivegrid-admin-panel
|
||||||
|
# AUTHENTIK_ADMIN_CLIENT_SECRET=
|
||||||
|
# AUTHENTIK_ADMIN_REDIRECT_URI=https://admin.example.com/auth/admin/callback
|
||||||
|
# AUTHENTIK_ADMIN_POST_LOGOUT_REDIRECT_URI=https://admin.example.com/login?logged_out=1
|
||||||
|
# ADMIN_FALLBACK_LOGIN_ENABLED=false
|
||||||
|
# ADMIN_FALLBACK_LOGIN_EMAILS=
|
||||||
|
|
||||||
|
|
||||||
|
# Phase 06: Plugin output sanitization (strict|moderate|off)
|
||||||
|
PLUGIN_OUTPUT_SANITIZATION_STRICTNESS=moderate
|
||||||
|
|
||||||
|
# Phase 06: production runtime rollout gate. Leave false until the
|
||||||
|
# external plugin runtime security sign-off is complete. Production
|
||||||
|
# install/grant/enable and plugin workers fail closed unless true.
|
||||||
|
PLUGIN_RUNTIME_PRODUCTION_ENABLED=false
|
||||||
|
# Optional fail-closed switch for worker-general plugin hook fanout. In
|
||||||
|
# production with PLUGIN_RUNTIME_PRODUCTION_ENABLED=true and Redis present,
|
||||||
|
# worker-general already treats plugin hook fanout as required; set this only
|
||||||
|
# to force the same startup behavior in staging/canary environments.
|
||||||
|
# PLUGIN_HOOK_FANOUT_REQUIRED=false
|
||||||
|
|
||||||
|
# Phase 06: plugin worker sandbox limits. Trusted keys are a CSV of hex
|
||||||
|
# Ed25519 public keys; empty fails signature verification closed.
|
||||||
|
# PLUGIN_TRUSTED_PUBLIC_KEYS=
|
||||||
|
PLUGIN_MAX_FUEL=1000000
|
||||||
|
PLUGIN_MAX_MEMORY_MB=64
|
||||||
|
PLUGIN_MAX_WALL_CLOCK_MS=5000
|
||||||
|
PLUGIN_RATE_LIMIT_PER_MINUTE=100
|
||||||
|
PLUGIN_RATE_LIMIT_WINDOW_SECONDS=60
|
||||||
|
|
||||||
|
# Phase 06: PluginCapabilityUse audit retention (days)
|
||||||
|
PLUGIN_AUDIT_RETENTION_DAYS=90
|
||||||
|
PLUGIN_AUDIT_RETENTION_BATCH_SIZE=1000
|
||||||
|
PLUGIN_AUDIT_RETENTION_MAX_BATCHES=100
|
||||||
|
PLUGIN_AUDIT_RETENTION_CRON="0 3 * * *"
|
||||||
|
|
||||||
|
# Phase 06: optional override for host version used in plugin compat check (default: package.json version)
|
||||||
|
PLUGIN_HOST_VERSION_OVERRIDE=
|
||||||
|
|
||||||
|
# Phase 06 / F-005 Phase B: dev escape hatch to skip the on-disk binary
|
||||||
|
# signature verify at install time. MUST NOT be set in production.
|
||||||
|
PLUGIN_INSTALL_SKIP_BINARY_VERIFY=false
|
||||||
|
|
||||||
|
# Phase 06 / F-001: explicit per-tenant capability consent.
|
||||||
|
# When "true" (default in production), enablePlugin refuses to flip
|
||||||
|
# Plugin.enabled=true until every manifest-declared capability has a
|
||||||
|
# matching TenantPluginCapabilityGrant row. Set "false" for dev /
|
||||||
|
# integration-test environments that pre-date F-001.
|
||||||
|
PLUGIN_REQUIRE_CAPABILITY_CONSENT=true
|
||||||
|
|
||||||
|
# Phase 06 / F-011: per-tenant install rate limit (sliding window, 60s).
|
||||||
|
PLUGIN_INSTALL_RATE_LIMIT_PER_MIN=5
|
||||||
|
PLUGIN_SETTINGS_WRITE_RATE_LIMIT_PER_MIN=60
|
||||||
|
PLUGIN_SETTINGS_FRAME_VIOLATION_RATE_LIMIT_PER_MIN=120
|
||||||
|
PLUGIN_RATE_LIMIT_FAIL_OPEN=false
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
# Core local development
|
||||||
|
APP_NAME=HiveGrid Local
|
||||||
|
DATABASE_URL="file:./dev.db?connection_limit=1&connect_timeout=30"
|
||||||
|
SESSION_SECRET=replace-with-local-session-secret
|
||||||
|
CRYPTO_SECRET=replace-with-local-crypto-secret
|
||||||
|
APP_BASE_DOMAIN=localhost:3000
|
||||||
|
WEB_APP_HOST=app.localhost:3000
|
||||||
|
ADMIN_APP_HOST=admin.localhost:3000
|
||||||
|
API_HOST=api.localhost:3001
|
||||||
|
APP_PROTOCOL=http
|
||||||
|
|
||||||
|
# Legacy API/auth tokens
|
||||||
|
API_ACCESS_TOKEN=replace-with-local-api-token
|
||||||
|
JWT_SECRET=replace-with-local-jwt-secret
|
||||||
|
|
||||||
|
# Local convenience
|
||||||
|
SEED_DEMO_DATA=true
|
||||||
|
# Matches the local seed admin only; ignored outside NODE_ENV=development.
|
||||||
|
DEMO_USER=admin@email.com:password
|
||||||
|
# WEBHOOKS_URL=https://...ngrok-free.app
|
||||||
|
|
||||||
|
# Optional local providers; MailerSend is the default transactional runtime provider
|
||||||
|
# STORAGE_ENDPOINT=
|
||||||
|
# STORAGE_REGION=
|
||||||
|
# STORAGE_BUCKET=
|
||||||
|
# STORAGE_ACCESS_KEY_ID=
|
||||||
|
# STORAGE_SECRET_ACCESS_KEY=
|
||||||
|
# STORAGE_SESSION_TOKEN=
|
||||||
|
# STORAGE_PUBLIC_BASE_URL=
|
||||||
|
# STORAGE_FORCE_PATH_STYLE=false
|
||||||
|
# MAILJET_API_KEY=
|
||||||
|
# MAILJET_SECRET_KEY=
|
||||||
|
# MAILJET_FROM_EMAIL=
|
||||||
|
# MAILJET_FROM_NAME=
|
||||||
|
# WORKER_ENABLED=false
|
||||||
|
# EXPORT_RETENTION_QUEUE_ENABLED=false
|
||||||
|
# IMPORT_QUEUE_ENABLED=false
|
||||||
|
# BULLMQ_REDIS_URL=redis://localhost:6379/0
|
||||||
|
# REDIS_URL is a fallback only when BULLMQ_REDIS_URL is absent; keep it commented if a platform injects it.
|
||||||
|
# REDIS_URL=redis://localhost:6379/0
|
||||||
|
# BROWSER_RUNTIME_URL=
|
||||||
|
# BROWSER_RUNTIME_API_KEY=
|
||||||
|
# BROWSER_SESSION_TIMEOUT_MS=60000
|
||||||
|
# ANALYTICS_TOKEN=
|
||||||
|
# SITE_KEY_EXAMPLE_SITE=
|
||||||
@@ -0,0 +1,109 @@
|
|||||||
|
# Required core
|
||||||
|
APP_NAME=HiveGrid
|
||||||
|
# DATABASE_URL points at PgBouncer (port 6432) for application traffic.
|
||||||
|
# Append `?pgbouncer=true&connection_limit=10` so Prisma disables prepared-
|
||||||
|
# statement caching (transaction-mode pooling cannot keep them). DIRECT_URL
|
||||||
|
# below is the unpooled link used by Prisma Migrate. See docs/ops/pgbouncer.md.
|
||||||
|
DATABASE_URL="postgres://{USER}:{PASSWORD}@{POOL_HOST}:6432/{DATABASE}?pgbouncer=true&connection_limit=10"
|
||||||
|
SESSION_SECRET=
|
||||||
|
CRYPTO_SECRET=
|
||||||
|
APP_BASE_DOMAIN=your-domain.invalid
|
||||||
|
WEB_APP_HOST=app.your-domain.invalid
|
||||||
|
ADMIN_APP_HOST=admin.your-domain.invalid
|
||||||
|
API_HOST=api.your-domain.invalid
|
||||||
|
MCP_HOST=0.0.0.0
|
||||||
|
MCP_PORT=8080
|
||||||
|
MCP_ALLOWED_HOSTS=mcp.your-domain.invalid,staging-mcp.your-domain.invalid
|
||||||
|
MCP_ALLOWED_ORIGINS=https://mcp.your-domain.invalid,https://staging-mcp.your-domain.invalid
|
||||||
|
MCP_RESOURCE_URL=https://mcp.your-domain.invalid
|
||||||
|
MCP_AUTHORIZATION_SERVER_URL=https://app.your-domain.invalid
|
||||||
|
APP_PROTOCOL=https
|
||||||
|
|
||||||
|
# Required for current legacy API/auth endpoints
|
||||||
|
API_ACCESS_TOKEN=
|
||||||
|
JWT_SECRET=
|
||||||
|
API_KEY_LEGACY_PLAINTEXT_FALLBACK=false
|
||||||
|
API_KEY_HASH_SECRET=
|
||||||
|
|
||||||
|
# Required if public analytics ingestion is enabled
|
||||||
|
ANALYTICS_TOKEN=
|
||||||
|
|
||||||
|
# Production/runtime platform
|
||||||
|
NODE_ENV=production
|
||||||
|
# DIRECT_URL: unpooled Postgres URL (port 5432, bypasses PgBouncer). Required
|
||||||
|
# so Prisma Migrate keeps prepared statements alive. See docs/ops/pgbouncer.md.
|
||||||
|
DIRECT_URL="postgres://{USER}:{PASSWORD}@{POSTGRES_HOST}:5432/{DATABASE}"
|
||||||
|
# Optional Postgres read-replica for hot-read paths (CRM/KB listings,
|
||||||
|
# dashboards, public sites/portals). Falls back to DATABASE_URL when
|
||||||
|
# unset — single-DB deploys keep working unchanged. Use a read-only DB
|
||||||
|
# user (GRANT SELECT) and ideally a PgBouncer-fronted replica endpoint.
|
||||||
|
# Replication is eventually consistent. See docs/architecture/rw-split.md.
|
||||||
|
# DATABASE_READ_URL="postgres://{READ_USER}:{PASSWORD}@{REPLICA_HOST}:6432/{DATABASE}?pgbouncer=true&connection_limit=10"
|
||||||
|
# SERVER_URL=https://app.example.com
|
||||||
|
|
||||||
|
# Production seed bootstrap. Set in Coolify before first migration/seed run; blank values are rejected.
|
||||||
|
# SEED_ADMIN_EMAIL=owner@example.com
|
||||||
|
# SEED_ADMIN_PASSWORD=replace-with-a-strong-one-time-bootstrap-password
|
||||||
|
|
||||||
|
# Optional providers; MailerSend is the default transactional runtime provider
|
||||||
|
STORAGE_ENDPOINT=
|
||||||
|
STORAGE_REGION=
|
||||||
|
STORAGE_BUCKET=
|
||||||
|
STORAGE_ACCESS_KEY_ID=
|
||||||
|
STORAGE_SECRET_ACCESS_KEY=
|
||||||
|
STORAGE_SESSION_TOKEN=
|
||||||
|
STORAGE_PUBLIC_BASE_URL=
|
||||||
|
STORAGE_FORCE_PATH_STYLE=false
|
||||||
|
MAILJET_API_KEY=
|
||||||
|
MAILJET_SECRET_KEY=
|
||||||
|
MAILJET_FROM_EMAIL=
|
||||||
|
# MAILJET_FROM_NAME=
|
||||||
|
MAILJET_WEBHOOK_SECRET=
|
||||||
|
SUPPORT_EMAIL=
|
||||||
|
COMPANY_NAME=
|
||||||
|
COMPANY_ADDRESS=
|
||||||
|
INTEGRATIONS_CONTACT_FORMSPREE=
|
||||||
|
CAPTCHA_PROVIDER=cap
|
||||||
|
CAP_INSTANCE_URL=https://captcha.hivegrid.de
|
||||||
|
CAP_SITE_SECRET=
|
||||||
|
CAP_SITE_SECRET_LOGIN=
|
||||||
|
CAP_SITE_SECRET_FORMS=
|
||||||
|
CAP_SITE_SECRET_BOOKING=
|
||||||
|
CAP_SITEKEY_LOGIN=
|
||||||
|
CAP_SITEKEY_FORMS=
|
||||||
|
CAP_SITEKEY_BOOKING=
|
||||||
|
MCAPTCHA_INSTANCE_URL=
|
||||||
|
MCAPTCHA_ACCOUNT_SECRET=
|
||||||
|
MCAPTCHA_SITEKEY_LOGIN=
|
||||||
|
MCAPTCHA_SITEKEY_FORMS=
|
||||||
|
MCAPTCHA_SITEKEY_BOOKING=
|
||||||
|
CAPTCHA_FAIL_OPEN=true
|
||||||
|
AUTH_MAGIC_LINK_ENABLED=false
|
||||||
|
AUTH_MAGIC_LINK_TOKEN_TTL_MINUTES=15
|
||||||
|
NOTIFICATIONS_NOVU_API_KEY=
|
||||||
|
# Set WORKER_ENABLED=true only on the worker resource. Leave it unset for web/API resources.
|
||||||
|
# WORKER_ENABLED=false
|
||||||
|
EXPORT_RETENTION_QUEUE_ENABLED=false
|
||||||
|
IMPORT_QUEUE_ENABLED=false
|
||||||
|
# Set this on worker resources only.
|
||||||
|
# BULLMQ_REDIS_URL=redis://default:<redis-password>@redis.your-domain.invalid:6379/0
|
||||||
|
# REDIS_URL is a fallback only when BULLMQ_REDIS_URL is absent; keep it commented if a platform injects it.
|
||||||
|
# REDIS_URL=redis://localhost:6379/0
|
||||||
|
|
||||||
|
# Plugin worker runtime. Set these on WORKER_QUEUE_GROUP=plugin resources.
|
||||||
|
# PLUGIN_TRUSTED_PUBLIC_KEYS=
|
||||||
|
PLUGIN_MAX_FUEL=1000000
|
||||||
|
PLUGIN_MAX_MEMORY_MB=64
|
||||||
|
PLUGIN_MAX_WALL_CLOCK_MS=5000
|
||||||
|
PLUGIN_RATE_LIMIT_PER_MINUTE=100
|
||||||
|
PLUGIN_RATE_LIMIT_WINDOW_SECONDS=60
|
||||||
|
PLUGIN_OUTPUT_SANITIZATION_STRICTNESS=moderate
|
||||||
|
|
||||||
|
BROWSER_RUNTIME_URL=
|
||||||
|
BROWSER_RUNTIME_API_KEY=
|
||||||
|
BROWSER_SESSION_TIMEOUT_MS=60000
|
||||||
|
IPSTACK_API_KEY=
|
||||||
|
IPAPIIS_API_KEY=
|
||||||
|
PORTAL_SERVER_URL=
|
||||||
|
PORTAL_SERVER_FLY_TOKEN=
|
||||||
|
# SITE_KEY_EXAMPLE_SITE=
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
# Non-secret test fixture used by env-contract checks.
|
||||||
|
# Values are deterministic placeholders only; never copy production secrets here.
|
||||||
|
APP_NAME=HiveGrid Test
|
||||||
|
DATABASE_URL="file:./test.db?connection_limit=1&connect_timeout=30"
|
||||||
|
SESSION_SECRET=test-session-secret-placeholder
|
||||||
|
CRYPTO_SECRET=test-crypto-secret-placeholder
|
||||||
|
APP_BASE_DOMAIN=localhost.test
|
||||||
|
WEB_APP_HOST=app.localhost.test
|
||||||
|
ADMIN_APP_HOST=admin.localhost.test
|
||||||
|
API_HOST=api.localhost.test
|
||||||
|
MCP_HOST=127.0.0.1
|
||||||
|
MCP_PORT=8080
|
||||||
|
MCP_ALLOWED_HOSTS=mcp.localhost.test,localhost,127.0.0.1,::1
|
||||||
|
MCP_ALLOWED_ORIGINS=http://mcp.localhost.test,http://localhost,http://127.0.0.1
|
||||||
|
MCP_RESOURCE_URL=http://mcp.localhost.test:8080
|
||||||
|
MCP_AUTHORIZATION_SERVER_URL=http://app.localhost.test
|
||||||
|
APP_PROTOCOL=http
|
||||||
|
|
||||||
|
# Legacy API/auth tokens
|
||||||
|
API_ACCESS_TOKEN=test-api-access-token-placeholder
|
||||||
|
JWT_SECRET=test-jwt-secret-placeholder
|
||||||
|
API_KEY_HASH_SECRET=test-api-key-hash-secret-placeholder
|
||||||
|
|
||||||
|
# Test-safe platform/runtime values
|
||||||
|
NODE_ENV=test
|
||||||
|
PORT=3000
|
||||||
|
HOST=127.0.0.1
|
||||||
|
API_PORT=3001
|
||||||
|
WORKER_ENABLED=false
|
||||||
|
EXPORT_RETENTION_QUEUE_ENABLED=false
|
||||||
|
IMPORT_QUEUE_ENABLED=false
|
||||||
|
BULLMQ_REDIS_URL=redis://localhost:6379/15
|
||||||
|
BROWSER_RUNTIME_URL=http://localhost:9222
|
||||||
|
BROWSER_RUNTIME_API_KEY=test-browser-runtime-api-key-placeholder
|
||||||
|
BROWSER_SESSION_TIMEOUT_MS=1000
|
||||||
|
STORAGE_ENDPOINT=https://storage.example.test
|
||||||
|
STORAGE_REGION=us-east-1
|
||||||
|
STORAGE_BUCKET=test-storage
|
||||||
|
STORAGE_ACCESS_KEY_ID=test-storage-access-key
|
||||||
|
STORAGE_SECRET_ACCESS_KEY=test-storage-secret-key
|
||||||
|
STORAGE_SESSION_TOKEN=
|
||||||
|
STORAGE_PUBLIC_BASE_URL=
|
||||||
|
STORAGE_FORCE_PATH_STYLE=true
|
||||||
|
|
||||||
|
# Safe optional provider placeholders used by contract tests
|
||||||
|
MAILJET_API_KEY=test-mailjet-api-key-placeholder
|
||||||
|
MAILJET_SECRET_KEY=test-mailjet-secret-key-placeholder
|
||||||
|
MAILJET_FROM_EMAIL=test@example.com
|
||||||
|
SUPPORT_EMAIL=support@example.com
|
||||||
|
COMPANY_NAME=Example Test Company
|
||||||
|
COMPANY_ADDRESS=123 Test Street
|
||||||
|
ANALYTICS_TOKEN=test-analytics-token-placeholder
|
||||||
|
SITE_KEY_EXAMPLE_SITE=test-site-key-placeholder
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
!.eslintrc
|
||||||
|
!app/utils/services/.server/
|
||||||
|
!app/utils/services/.server/urlService.test.ts
|
||||||
|
!app/utils/services/apiService.entity-resolver.test.ts
|
||||||
|
!utils/services/apiService.entity-resolver.test.ts
|
||||||
|
!test/isolation/fixtures/user-session-isolation.test.ts
|
||||||
|
!test/isolation/fixtures/user-session-isolation.ts
|
||||||
@@ -0,0 +1,298 @@
|
|||||||
|
{
|
||||||
|
"root": true,
|
||||||
|
"env": {
|
||||||
|
"browser": true,
|
||||||
|
"node": true,
|
||||||
|
"es2022": true
|
||||||
|
},
|
||||||
|
"parser": "@typescript-eslint/parser",
|
||||||
|
"parserOptions": {
|
||||||
|
"ecmaVersion": "latest",
|
||||||
|
"sourceType": "module",
|
||||||
|
"ecmaFeatures": {
|
||||||
|
"jsx": true
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"plugins": ["@typescript-eslint", "import", "jsx-a11y", "react-hooks"],
|
||||||
|
"extends": ["plugin:jsx-a11y/recommended"],
|
||||||
|
"ignorePatterns": [
|
||||||
|
".react-router/",
|
||||||
|
"apps/web/.react-router/",
|
||||||
|
"app/",
|
||||||
|
"app/generated/",
|
||||||
|
"apps/web/app/generated/",
|
||||||
|
"build/",
|
||||||
|
"coverage/",
|
||||||
|
"dist/",
|
||||||
|
"node_modules/",
|
||||||
|
"!apps/web/app/utils/services/.server/",
|
||||||
|
"!apps/web/app/utils/services/.server/urlService.test.ts",
|
||||||
|
"!apps/web/app/utils/services/apiService.entity-resolver.test.ts",
|
||||||
|
"!apps/web/app/utils/db/users.mfa.test.ts",
|
||||||
|
"!utils/services/.server/",
|
||||||
|
"!utils/services/.server/urlService.test.ts",
|
||||||
|
"!utils/services/apiService.entity-resolver.test.ts"
|
||||||
|
],
|
||||||
|
"rules": {
|
||||||
|
"no-console": "warn",
|
||||||
|
"no-debugger": "error",
|
||||||
|
"jsx-a11y/no-autofocus": "off",
|
||||||
|
"import/first": "off",
|
||||||
|
"@typescript-eslint/consistent-type-imports": "off",
|
||||||
|
"prefer-const": "off",
|
||||||
|
"@typescript-eslint/ban-ts-comment": "off",
|
||||||
|
"no-var": "off",
|
||||||
|
"@typescript-eslint/no-unused-vars": "warn",
|
||||||
|
"no-restricted-imports": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"patterns": [
|
||||||
|
{
|
||||||
|
"group": [
|
||||||
|
"~/generated/prisma/client/*",
|
||||||
|
"app/generated/prisma/client/*",
|
||||||
|
"apps/web/app/generated/prisma/client/*",
|
||||||
|
"@prisma/client",
|
||||||
|
"@prisma/client/*"
|
||||||
|
],
|
||||||
|
"message": "Import Prisma through @hivegrid/db package boundaries instead of generated clients."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"group": ["@hivegrid/entitlements/src/*", "packages/entitlements/src/*"],
|
||||||
|
"message": "Import entitlements through the public @hivegrid/entitlements package boundary."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"group": [
|
||||||
|
"@hivegrid/foundation/src/*",
|
||||||
|
"packages/foundation/src/*",
|
||||||
|
"@hivegrid/view-models/src/*",
|
||||||
|
"packages/view-models/src/*",
|
||||||
|
"@hivegrid/ui-app/src/*",
|
||||||
|
"packages/ui-app/src/*",
|
||||||
|
"@hivegrid/ui-subframe/src/*",
|
||||||
|
"packages/ui-subframe/src/*",
|
||||||
|
"@hivegrid/ui-mock/src/*",
|
||||||
|
"packages/ui-mock/src/*"
|
||||||
|
],
|
||||||
|
"message": "Import Phase C packages through their public @hivegrid/* package boundaries."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"overrides": [
|
||||||
|
{
|
||||||
|
"files": [".eslintrc"],
|
||||||
|
"parser": "jsonc-eslint-parser",
|
||||||
|
"rules": {
|
||||||
|
"@typescript-eslint/no-unused-vars": "off"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": [
|
||||||
|
"**/*.server.ts",
|
||||||
|
"**/*.server.tsx",
|
||||||
|
"apps/api/src/**/*.ts",
|
||||||
|
"apps/worker/src/**/*.ts",
|
||||||
|
"packages/*/src/**/*.ts",
|
||||||
|
"apps/web/app/utils/**/*.ts",
|
||||||
|
"apps/web/app/modules/**/services/**/*.ts",
|
||||||
|
"apps/web/app/modules/**/db/**/*.ts"
|
||||||
|
],
|
||||||
|
"excludedFiles": [
|
||||||
|
"**/*.test.ts",
|
||||||
|
"**/*.test.tsx",
|
||||||
|
"**/*.spec.ts",
|
||||||
|
"**/*.spec.tsx"
|
||||||
|
],
|
||||||
|
"rules": {
|
||||||
|
"no-console": "error"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": [
|
||||||
|
"**/*.test.ts",
|
||||||
|
"**/*.test.tsx",
|
||||||
|
"**/*.spec.ts",
|
||||||
|
"**/*.spec.tsx",
|
||||||
|
"scripts/**/*.ts",
|
||||||
|
"scripts/**/*.mjs",
|
||||||
|
"scripts/**/*.js"
|
||||||
|
],
|
||||||
|
"rules": {
|
||||||
|
"no-console": "off"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": [
|
||||||
|
"apps/web/app/components/**/*.tsx",
|
||||||
|
"apps/web/app/routes/**/*.tsx"
|
||||||
|
],
|
||||||
|
"excludedFiles": [
|
||||||
|
"**/*.server.tsx",
|
||||||
|
"**/*.server.ts"
|
||||||
|
],
|
||||||
|
"rules": {
|
||||||
|
"no-console": "off"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": ["packages/db/src/client.server.ts", "packages/db/src/prisma-browser.ts"],
|
||||||
|
"rules": {
|
||||||
|
"no-restricted-imports": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"patterns": [
|
||||||
|
{
|
||||||
|
"group": [
|
||||||
|
"~/generated/prisma/client/*",
|
||||||
|
"app/generated/prisma/client/*",
|
||||||
|
"apps/web/app/generated/prisma/client/*",
|
||||||
|
"@prisma/client",
|
||||||
|
"@prisma/client/*"
|
||||||
|
],
|
||||||
|
"message": "Import Prisma through package-owned generated entrypoints inside @hivegrid/db boundaries."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": ["app/utils/db/**/*.ts", "apps/web/app/utils/db/**/*.ts"],
|
||||||
|
"rules": {
|
||||||
|
"no-restricted-imports": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"patterns": [
|
||||||
|
{
|
||||||
|
"group": [
|
||||||
|
"~/generated/prisma/client/*",
|
||||||
|
"app/generated/prisma/client/*",
|
||||||
|
"apps/web/app/generated/prisma/client/*",
|
||||||
|
"@prisma/client",
|
||||||
|
"@prisma/client/*"
|
||||||
|
],
|
||||||
|
"message": "Import Prisma through @hivegrid/db package boundaries instead of generated clients."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"group": ["react", "react/*"],
|
||||||
|
"message": "app/utils/db is a server-only legacy DB boundary; keep React/UI imports out. See docs/db-legacy.md."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": ["packages/foundation/src/**/*.{ts,tsx}", "packages/view-models/src/**/*.{ts,tsx}"],
|
||||||
|
"rules": {
|
||||||
|
"no-restricted-imports": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"patterns": [
|
||||||
|
{
|
||||||
|
"group": [
|
||||||
|
"react",
|
||||||
|
"react/*",
|
||||||
|
"react-dom",
|
||||||
|
"react-dom/*",
|
||||||
|
"~/generated/prisma/client/*",
|
||||||
|
"app/generated/prisma/client/*",
|
||||||
|
"apps/web/app/generated/prisma/client/*",
|
||||||
|
"@prisma/client",
|
||||||
|
"@prisma/client/*",
|
||||||
|
"~/routes/*",
|
||||||
|
"~/components/*",
|
||||||
|
"app/*",
|
||||||
|
"apps/web/app/*"
|
||||||
|
],
|
||||||
|
"message": "Foundation and view-model packages must stay UI/runtime/generated-client free."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": ["packages/ui-app/src/**/*.{ts,tsx}", "packages/ui-subframe/src/**/*.{ts,tsx}", "packages/ui-mock/src/**/*.{ts,tsx}"],
|
||||||
|
"rules": {
|
||||||
|
"no-restricted-imports": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"patterns": [
|
||||||
|
{
|
||||||
|
"group": [
|
||||||
|
"~/generated/prisma/client/*",
|
||||||
|
"app/generated/prisma/client/*",
|
||||||
|
"apps/web/app/generated/prisma/client/*",
|
||||||
|
"@prisma/client",
|
||||||
|
"@prisma/client/*",
|
||||||
|
"@hivegrid/db",
|
||||||
|
"@hivegrid/db/*"
|
||||||
|
],
|
||||||
|
"message": "UI packages must not access DB boundaries directly."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": ["packages/ui-app/src/**/*.{ts,tsx}", "packages/ui-subframe/src/**/*.{ts,tsx}", "packages/ui-mock/src/**/*.{ts,tsx}"],
|
||||||
|
"rules": {
|
||||||
|
"no-restricted-syntax": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"selector": "Property[key.name=/^(title|label|placeholder|ariaLabel|alt|description|message|heading|subject)$/] > Literal[value=/[A-Za-zÄÖÜäöü]/]",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "Property[key.value=/^(title|label|placeholder|aria-label|ariaLabel|alt|description|message|heading|subject)$/] > Literal[value=/[A-Za-zÄÖÜäöü]/]",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "Property[key.name=/^(title|label|placeholder|ariaLabel|alt|description|message|heading|subject)$/] > TemplateLiteral",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "Property[key.value=/^(title|label|placeholder|aria-label|ariaLabel|alt|description|message|heading|subject)$/] > TemplateLiteral",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"files": ["packages/ui-app/src/**/*.{tsx}", "packages/ui-subframe/src/**/*.{tsx}", "packages/ui-mock/src/**/*.{tsx}"],
|
||||||
|
"rules": {
|
||||||
|
"no-restricted-syntax": [
|
||||||
|
"error",
|
||||||
|
{
|
||||||
|
"selector": "Property[key.name=/^(title|label|placeholder|ariaLabel|alt|description|message|heading|subject)$/] > Literal[value=/[A-Za-zÄÖÜäöü]/]",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "Property[key.value=/^(title|label|placeholder|aria-label|ariaLabel|alt|description|message|heading|subject)$/] > Literal[value=/[A-Za-zÄÖÜäöü]/]",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "Property[key.name=/^(title|label|placeholder|ariaLabel|alt|description|message|heading|subject)$/] > TemplateLiteral",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "Property[key.value=/^(title|label|placeholder|aria-label|ariaLabel|alt|description|message|heading|subject)$/] > TemplateLiteral",
|
||||||
|
"message": "Use i18n key fields instead of hardcoded user-facing strings in Phase C UI package descriptors."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "JSXText[value=/\\S/]",
|
||||||
|
"message": "Use i18n label keys or translated values instead of hardcoded JSX text in Phase C UI packages."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"selector": "JSXAttribute[name.name=/^(aria-label|title|placeholder)$/] > Literal[value=/[A-Za-zÄÖÜäöü]/]",
|
||||||
|
"message": "Use i18n label keys or translated values instead of hardcoded JSX accessibility/title text in Phase C UI packages."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
{
|
||||||
|
"$schema-comment": "Baseline catalogue of jsx-a11y/recommended rules that are currently disabled in .eslintrc because the codebase has pre-existing violations. The plan is to drive these counts down to zero, then promote each rule back to `error` in .eslintrc and remove it from this file. See docs/contributing/wcag-audit.md for the reduction policy. Counts are produced by `scripts/verify-a11y-baseline.mjs`.",
|
||||||
|
"generatedAt": "2026-05-17",
|
||||||
|
"lastUpdatedAt": "2026-07-01",
|
||||||
|
"scope": ["apps/web/app/**/*.tsx"],
|
||||||
|
"ruleset": "plugin:jsx-a11y/recommended",
|
||||||
|
"totalViolations": 56,
|
||||||
|
"rules": {
|
||||||
|
"jsx-a11y/no-autofocus": {
|
||||||
|
"violations": 56,
|
||||||
|
"severity": "P2",
|
||||||
|
"rationale": "Autofocus remains in form/editor surfaces. Button/link wrappers now use programmatic focus instead of DOM autoFocus. Migration plan: prefer programmatic focus on open() so screen-reader users hear the modal title first."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"promoted": {
|
||||||
|
"jsx-a11y/anchor-has-content": {
|
||||||
|
"promotedAt": "2026-05-20",
|
||||||
|
"rationale": "Reached 0 violations. The two reusable wrappers (PaginationLink, StepperTitle) now destructure `children` and render it explicitly so the rule can statically verify content. Rule moved back to `error` (jsx-a11y/recommended default) and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/heading-has-content": {
|
||||||
|
"promotedAt": "2026-05-20",
|
||||||
|
"rationale": "Reached 0 violations alongside anchor-has-content — see StepperTitle. Rule moved back to `error` and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/label-has-associated-control": {
|
||||||
|
"promotedAt": "2026-05-20",
|
||||||
|
"rationale": "P1. Reached 0 violations (#73 WCAG sweep). Form labels were associated with their controls via htmlFor+id (marketing-funnels, PropertyForm); accessible text was flattened to within depth-2 (NewMember, RowForm, GroupForm); empty/decorative labels captioning non-form widgets were converted to <div>/role=group captions (ConfirmModal inputs now carry aria-label, PreviewTooltips, PreviewInputTextWithMonacoEditor, JsonPropertyForm, PromptTemplateForm). Rule moved back to `error` and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/click-events-have-key-events": {
|
||||||
|
"promotedAt": "2026-05-20",
|
||||||
|
"rationale": "P1. Reached 0 violations (#73 WCAG sweep). Genuine div-buttons were converted to <button> (ShowMoreLinesText, WorkflowExecutionsSidebar, BlockRun toggle); rows with nested interactive children gained role=button + tabIndex + onKeyDown (ConditionsGroupsInfo, prompt-builder templates); dead onClick={e=>e.preventDefault()} handlers on plain divs were removed (PdfViewer, WorkflowRun); image lightbox trigger wrapped in <button> (HoverEffect). Three genuine mouse-only click-to-focus hit-area enhancements (input-group, InputRichTextEditor, novel editor, SiteTypeCard wrapper) retain a justified inline eslint-disable to avoid a redundant tab stop ahead of an already-keyboard-accessible control. Rule moved back to `error` and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/no-static-element-interactions": {
|
||||||
|
"promotedAt": "2026-05-20",
|
||||||
|
"rationale": "P1. Reached 0 violations alongside click-events-have-key-events (#73 WCAG sweep) — same set of fixes. Rule moved back to `error` and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/no-noninteractive-element-interactions": {
|
||||||
|
"promotedAt": "2026-05-20",
|
||||||
|
"rationale": "P1. Reached 0 violations (#73 WCAG sweep). The <img> lightbox trigger (HoverEffect) was wrapped in a <button>; the role=group input-group addon retains a justified inline eslint-disable for its mouse-only focus-forwarding click. Rule moved back to `error` and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/anchor-is-valid": {
|
||||||
|
"promotedAt": "2026-05-25",
|
||||||
|
"rationale": "Reached 0 violations after Popover demo menu anchors were converted to button controls. Rule moved back to `error` and the `off` override removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/no-noninteractive-tabindex": {
|
||||||
|
"promotedAt": "2026-05-25",
|
||||||
|
"rationale": "Verifier reproduced 0 violations across the tracked app and UI scope. Rule moved back to `error` and the stale `off` override was removed from .eslintrc."
|
||||||
|
},
|
||||||
|
"jsx-a11y/media-has-caption": {
|
||||||
|
"promotedAt": "2026-05-28",
|
||||||
|
"rationale": "Reached 0 violations after AudioOrVideoPlayer started rendering a captions track for audio and video media by default, with optional caller-provided VTT metadata. Rule moved back to `error` and the `off` override was removed from .eslintrc."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"reductionPolicy": {
|
||||||
|
"monotonicDecrease": "scripts/verify-a11y-baseline.mjs (run in CI on PRs) MUST fail if any rule's count grows above the value recorded here. Reducing the count is encouraged — re-run the script to update the baseline.",
|
||||||
|
"promotionThreshold": "When a rule's violation count reaches 0, remove its `off` override from .eslintrc, delete the entry from this file, and add a row to docs/contributing/wcag-audit.md changelog."
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
name: Sentry release
|
||||||
|
description: |
|
||||||
|
Composite action wrapper for scripts/ci/sentry-release.sh. Use this
|
||||||
|
from Gitea workflows that target a Gitea-Actions runner without
|
||||||
|
workflow_call support (Gitea < 1.21). Callers must already have the
|
||||||
|
repository checked out before invoking this action.
|
||||||
|
|
||||||
|
inputs:
|
||||||
|
project:
|
||||||
|
description: "Sentry project slug (hivegrid-api|hivegrid-worker|hivegrid-web)"
|
||||||
|
required: true
|
||||||
|
environment:
|
||||||
|
description: "Deployment environment label (production|staging|preview)"
|
||||||
|
required: true
|
||||||
|
release:
|
||||||
|
description: "Release identifier (typically gitea.sha)"
|
||||||
|
required: true
|
||||||
|
sourcemaps-path:
|
||||||
|
description: "Directory containing source-maps to upload, or 'none'"
|
||||||
|
required: false
|
||||||
|
default: "none"
|
||||||
|
|
||||||
|
runs:
|
||||||
|
using: composite
|
||||||
|
steps:
|
||||||
|
- name: Verify sentry-cli is reachable
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
node -v
|
||||||
|
npx --yes @sentry/cli@2.41.1 --version
|
||||||
|
|
||||||
|
- name: Tag Sentry release
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
bash scripts/ci/sentry-release.sh \
|
||||||
|
--project "${{ inputs.project }}" \
|
||||||
|
--environment "${{ inputs.environment }}" \
|
||||||
|
--release "${{ inputs.release }}" \
|
||||||
|
--sourcemaps "${{ inputs.sourcemaps-path }}"
|
||||||
@@ -0,0 +1,51 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
|
||||||
|
"extends": [
|
||||||
|
"config:recommended",
|
||||||
|
":dependencyDashboard",
|
||||||
|
":semanticCommitTypeAll(chore)"
|
||||||
|
],
|
||||||
|
"schedule": ["before 5am on monday"],
|
||||||
|
"timezone": "Europe/Berlin",
|
||||||
|
"labels": ["dependencies"],
|
||||||
|
"commitMessagePrefix": "chore(deps):",
|
||||||
|
"prHourlyLimit": 4,
|
||||||
|
"prConcurrentLimit": 10,
|
||||||
|
"rangeStrategy": "bump",
|
||||||
|
"packageRules": [
|
||||||
|
{
|
||||||
|
"groupName": "ai-providers",
|
||||||
|
"matchPackagePatterns": [
|
||||||
|
"^@mistralai/",
|
||||||
|
"^mistralai$",
|
||||||
|
"^@scaleway",
|
||||||
|
"^scaleway$",
|
||||||
|
"^aleph-alpha",
|
||||||
|
"^@aleph-alpha/"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"groupName": "react-stack",
|
||||||
|
"matchPackageNames": ["react", "react-dom", "react-router", "vite"],
|
||||||
|
"matchPackagePatterns": ["^@react-router/", "^@vitejs/"]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"groupName": "test-tooling",
|
||||||
|
"matchPackageNames": ["vitest"],
|
||||||
|
"matchPackagePatterns": ["^@vitest/", "^@testing-library/"]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"groupName": "lint-tooling",
|
||||||
|
"matchPackageNames": ["eslint"],
|
||||||
|
"matchPackagePatterns": ["^eslint-", "^@eslint/", "^@typescript-eslint/"]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"matchManagers": ["dockerfile"],
|
||||||
|
"schedule": ["before 5am on the first day of the month"]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"matchManagers": ["github-actions"],
|
||||||
|
"schedule": ["before 5am on monday"]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,96 @@
|
|||||||
|
name: Sentry Release
|
||||||
|
|
||||||
|
# Reusable workflow for Gitea Actions. Mirrors the GitHub equivalent at
|
||||||
|
# .github/workflows/_sentry-release.yml. Requires Gitea Actions runner
|
||||||
|
# capable of workflow_call (Gitea >= 1.21). For older runners use the
|
||||||
|
# composite action at .gitea/actions/sentry-release/action.yml instead.
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_call:
|
||||||
|
inputs:
|
||||||
|
project:
|
||||||
|
description: "Sentry project slug (api|worker|web) in the 'sentry' org on sentry.saas-ctrl.com"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
environment:
|
||||||
|
description: "Deployment environment label (production|staging|preview)"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
sourcemaps-path:
|
||||||
|
description: "Directory containing source-maps to upload, or 'none'"
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: "none"
|
||||||
|
sourcemaps-artifact:
|
||||||
|
description: "Optional workflow artifact to download before source-map upload, or 'none'"
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: "none"
|
||||||
|
secrets:
|
||||||
|
SENTRY_AUTH_TOKEN:
|
||||||
|
description: "Sentry auth token (project:releases scope)"
|
||||||
|
required: true
|
||||||
|
SENTRY_ORG:
|
||||||
|
description: "Sentry organisation slug"
|
||||||
|
required: true
|
||||||
|
SENTRY_URL:
|
||||||
|
description: "Sentry self-hosted base URL"
|
||||||
|
required: true
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
release:
|
||||||
|
name: Sentry release (${{ inputs.project }})
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 15
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
fetch-depth: 0
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Download source-map artifact
|
||||||
|
if: ${{ inputs.sourcemaps-artifact != 'none' }}
|
||||||
|
uses: actions/download-artifact@v3
|
||||||
|
with:
|
||||||
|
name: ${{ inputs.sourcemaps-artifact }}
|
||||||
|
path: ${{ inputs.sourcemaps-path }}
|
||||||
|
|
||||||
|
- name: Verify sentry-cli is reachable
|
||||||
|
env:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
|
run: |
|
||||||
|
node -v
|
||||||
|
npx --yes @sentry/cli@2.41.1 --version
|
||||||
|
|
||||||
|
- name: Tag Sentry release
|
||||||
|
env:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
|
run: |
|
||||||
|
bash scripts/ci/sentry-release.sh \
|
||||||
|
--project "${{ inputs.project }}" \
|
||||||
|
--environment "${{ inputs.environment }}" \
|
||||||
|
--release "${{ gitea.sha }}" \
|
||||||
|
--sourcemaps "${{ inputs.sourcemaps-path }}"
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
name: Accessibility
|
||||||
|
|
||||||
|
# Runs the axe-core vitest suites (apps/web ui components, SkipToContent)
|
||||||
|
# and the WCAG-2.2-AA color-contrast verifier on every PR + push to main.
|
||||||
|
#
|
||||||
|
# Mirror of .github/workflows/a11y.yml for the Gitea runner.
|
||||||
|
#
|
||||||
|
# Docs: docs/contributing/wcag-audit.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- main
|
||||||
|
pull_request:
|
||||||
|
|
||||||
|
# Cancel superseded runs so rapid pushes don't pile up unclaimed on the runner
|
||||||
|
# (mirrors ci.yml). Without this each push stacked a new a11y run on the queue.
|
||||||
|
concurrency:
|
||||||
|
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
|
||||||
|
cancel-in-progress: true
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
axe:
|
||||||
|
name: axe-core + color-contrast
|
||||||
|
# Use the self-hosted Gitea runner label (like every ci.yml job). The previous
|
||||||
|
# `ubuntu-latest` was a leftover from the GitHub mirror and matches no Gitea
|
||||||
|
# runner, so this job sat pending forever (never claimed) on every PR + push.
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 20
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
# Same repo variable ci.yml exposes top-level: the internal Gitea host IP that the
|
||||||
|
# "Resolve internal Gitea host" step writes to /etc/hosts so checkout can clone
|
||||||
|
# git.tool-ctrl.de inside the runner container. Without it the step is a no-op.
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
steps:
|
||||||
|
# Same as every ci.yml job: make the internal Gitea host resolvable inside the
|
||||||
|
# runner container so actions/checkout can clone git.tool-ctrl.de. Without this the
|
||||||
|
# checkout step fails (the job never had it -> a11y could never run on Gitea).
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Run color-contrast verifier
|
||||||
|
run: pnpm run verify:color-contrast
|
||||||
|
|
||||||
|
- name: Verify accessibility coverage
|
||||||
|
run: pnpm run verify:a11y-coverage
|
||||||
|
|
||||||
|
- name: Run axe vitest suite (test:a11y)
|
||||||
|
run: pnpm run test:a11y
|
||||||
|
|
||||||
|
- name: Verify accessibility lint baseline
|
||||||
|
run: pnpm run verify:a11y-baseline
|
||||||
|
|
||||||
|
- name: Lint accessibility rules (eslint-plugin-jsx-a11y)
|
||||||
|
run: pnpm run lint
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
name: Bundle Budget
|
||||||
|
|
||||||
|
# Gitea variant of .github/workflows/bundle-budget.yml. Uses Gitea-API to
|
||||||
|
# post / upsert a sticky PR comment with per-route gzip sizes.
|
||||||
|
# Docs: docs/architecture/bundle-budgets.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- "apps/web/**"
|
||||||
|
- "packages/brand/**"
|
||||||
|
- "packages/config/**"
|
||||||
|
- "packages/entitlements/**"
|
||||||
|
- "packages/form-widget/**"
|
||||||
|
- "packages/foundation/**"
|
||||||
|
- "packages/i18n/**"
|
||||||
|
- "packages/plugin-runtime/**"
|
||||||
|
- "packages/ui*/**"
|
||||||
|
- "packages/url/**"
|
||||||
|
- "packages/view-models/**"
|
||||||
|
- "package.json"
|
||||||
|
- "pnpm-lock.yaml"
|
||||||
|
- "scripts/bundle-budgets.json"
|
||||||
|
- "scripts/verify-bundle-size.mjs"
|
||||||
|
- ".gitea/workflows/bundle-budget.yml"
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
measure:
|
||||||
|
name: Measure & report bundle sizes
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 30
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout PR head
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Build web (PR head)
|
||||||
|
run: pnpm --filter @hivegrid/web build
|
||||||
|
|
||||||
|
- name: Verify aggregate bundle budgets
|
||||||
|
run: pnpm run verify:bundle-size
|
||||||
|
|
||||||
|
- name: Measure PR bundle sizes
|
||||||
|
run: node scripts/verify-bundle-size.mjs --json > pr-bundle-report.json
|
||||||
|
|
||||||
|
- name: Render PR comment markdown
|
||||||
|
# Baseline download from Gitea artifact storage is opt-in via
|
||||||
|
# BUNDLE_BASELINE_URL; falls back to no-diff mode otherwise.
|
||||||
|
run: |
|
||||||
|
if [ -n "${BUNDLE_BASELINE_URL:-}" ]; then
|
||||||
|
curl -sSfL "$BUNDLE_BASELINE_URL" -o main-bundle-report.json || true
|
||||||
|
fi
|
||||||
|
node scripts/render-bundle-budget-comment.mjs \
|
||||||
|
--current pr-bundle-report.json \
|
||||||
|
--baseline main-bundle-report.json \
|
||||||
|
--out bundle-comment.md
|
||||||
|
env:
|
||||||
|
BUNDLE_BASELINE_URL: ${{ vars.BUNDLE_BASELINE_URL }}
|
||||||
|
|
||||||
|
- name: Upsert Gitea PR comment
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
||||||
|
GITEA_HOST: ${{ vars.GITEA_HOST || 'git.tool-ctrl.de' }}
|
||||||
|
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||||
|
REPO: ${{ github.repository }}
|
||||||
|
run: node scripts/post-bundle-budget-gitea-comment.mjs
|
||||||
@@ -0,0 +1,631 @@
|
|||||||
|
name: CI
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
concurrency:
|
||||||
|
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
|
||||||
|
cancel-in-progress: true
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
# The former single "verify" gate is split into two parallel jobs (verify-1 + verify-2)
|
||||||
|
# to halve CI wallclock. The two heavy UI checks (ui-visual + hot-swap) sit in verify-1,
|
||||||
|
# the two heavy accessibility checks (a11y-coverage + a11y smoke) in verify-2, with the
|
||||||
|
# lighter static gates spread evenly. Every required command still runs exactly once
|
||||||
|
# across both jobs and keeps its canonical relative order WITHIN its owning job.
|
||||||
|
verify-1:
|
||||||
|
name: Quality Static Verify (1/2)
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 20
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Verify GitHub CI workflow
|
||||||
|
run: pnpm run verify:github-ci-workflow
|
||||||
|
|
||||||
|
- name: Verify Gitea CI workflow
|
||||||
|
run: pnpm run verify:gitea-ci-workflow
|
||||||
|
|
||||||
|
- name: Verify Gitea deploy workflow
|
||||||
|
run: pnpm run verify:deploy-workflow
|
||||||
|
|
||||||
|
- name: Verify deploy readiness
|
||||||
|
run: pnpm run verify:deploy-readiness
|
||||||
|
|
||||||
|
- name: Verify Docker baseline
|
||||||
|
run: pnpm run verify:docker-baseline
|
||||||
|
|
||||||
|
- name: Verify Docker non-root runtime
|
||||||
|
run: pnpm run verify:docker-non-root
|
||||||
|
|
||||||
|
- name: Verify CI baseline
|
||||||
|
run: pnpm run verify:ci-baseline
|
||||||
|
|
||||||
|
- name: Verify source health
|
||||||
|
run: pnpm run verify:source-health
|
||||||
|
|
||||||
|
- name: Verify ESLint baseline
|
||||||
|
run: pnpm run verify:eslint-baseline
|
||||||
|
|
||||||
|
- name: Verify env drift
|
||||||
|
run: pnpm run verify:env-drift
|
||||||
|
|
||||||
|
- name: Verify health baseline
|
||||||
|
run: pnpm run verify:health-baseline
|
||||||
|
|
||||||
|
- name: Verify API inventory
|
||||||
|
run: pnpm run verify:api-inventory
|
||||||
|
|
||||||
|
- name: Verify UI mock static baseline
|
||||||
|
run: pnpm run verify:ui-visual
|
||||||
|
|
||||||
|
- name: Test UI mock hot-swap
|
||||||
|
run: pnpm run test:hot-swap
|
||||||
|
|
||||||
|
verify-2:
|
||||||
|
name: Quality Static Verify (2/2)
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 20
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Verify tenant isolation report
|
||||||
|
run: pnpm run verify:tenant-isolation-report
|
||||||
|
|
||||||
|
- name: Verify cross-cutting model registry completeness
|
||||||
|
run: pnpm run verify:cross-cutting-models
|
||||||
|
|
||||||
|
- name: Verify sidebar routes
|
||||||
|
run: pnpm run verify:sidebar-routes
|
||||||
|
|
||||||
|
- name: Verify i18n keys
|
||||||
|
run: pnpm run verify:i18n
|
||||||
|
|
||||||
|
- name: Verify Tenant Auth tenant and onboarding gates
|
||||||
|
run: |
|
||||||
|
pnpm run verify:tenant-auth-baseline
|
||||||
|
pnpm run verify:onboarding-flow
|
||||||
|
|
||||||
|
- name: Verify Phase C package boundaries
|
||||||
|
run: pnpm run verify:phase-c-boundaries
|
||||||
|
|
||||||
|
- name: Verify Feature Manifest removed modules
|
||||||
|
run: pnpm run verify:removed-modules
|
||||||
|
|
||||||
|
- name: Verify accessibility coverage
|
||||||
|
run: pnpm run verify:a11y-coverage
|
||||||
|
|
||||||
|
- name: Test accessibility smoke
|
||||||
|
run: pnpm run test:a11y
|
||||||
|
|
||||||
|
- name: Verify documentation gates
|
||||||
|
run: |
|
||||||
|
pnpm run verify:porting-docs-baseline
|
||||||
|
pnpm run verify:production-docs
|
||||||
|
pnpm run verify:release-docs
|
||||||
|
pnpm run verify:docs-links
|
||||||
|
|
||||||
|
typecheck-test:
|
||||||
|
name: Quality Typecheck and Tests
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 25
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Typecheck
|
||||||
|
run: pnpm typecheck
|
||||||
|
|
||||||
|
- name: Lint
|
||||||
|
run: pnpm lint
|
||||||
|
|
||||||
|
- name: Foundation package tests
|
||||||
|
run: pnpm run test:foundation
|
||||||
|
|
||||||
|
- name: Workspace package tests
|
||||||
|
run: pnpm run test:packages
|
||||||
|
|
||||||
|
- name: Unit tests
|
||||||
|
run: pnpm test
|
||||||
|
|
||||||
|
build:
|
||||||
|
name: Quality Build and Bundle
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 30
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Verify Feature Manifest core without plugins
|
||||||
|
run: pnpm run verify:core-build-without-plugins-smoke
|
||||||
|
|
||||||
|
- name: Build
|
||||||
|
env:
|
||||||
|
HIVEGRID_BUILD_SOURCEMAPS: "1"
|
||||||
|
run: pnpm run build:ci
|
||||||
|
|
||||||
|
- name: Verify bundle size
|
||||||
|
run: pnpm run verify:bundle-size
|
||||||
|
|
||||||
|
- name: Verify web Sentry sourcemaps
|
||||||
|
run: test -n "$(find apps/web/build/client -type f -name '*.map' -print -quit)"
|
||||||
|
|
||||||
|
- name: Upload web Sentry sourcemaps
|
||||||
|
uses: actions/upload-artifact@v3
|
||||||
|
with:
|
||||||
|
name: web-client-sourcemaps
|
||||||
|
path: apps/web/build/client
|
||||||
|
if-no-files-found: error
|
||||||
|
retention-days: 7
|
||||||
|
|
||||||
|
- name: Verify production seed artifact
|
||||||
|
run: pnpm run verify:production-seed-artifact
|
||||||
|
|
||||||
|
api:
|
||||||
|
name: API Service
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 25
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Verify OpenAPI security
|
||||||
|
run: pnpm run verify:openapi-security
|
||||||
|
|
||||||
|
- name: Typecheck API
|
||||||
|
run: pnpm --filter @hivegrid/api typecheck
|
||||||
|
|
||||||
|
- name: Test API
|
||||||
|
run: pnpm exec vitest run apps/api/src
|
||||||
|
|
||||||
|
- name: Build API
|
||||||
|
run: pnpm --filter @hivegrid/api build
|
||||||
|
|
||||||
|
mcp:
|
||||||
|
name: MCP Service
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 20
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Typecheck MCP
|
||||||
|
run: pnpm --filter @hivegrid/mcp typecheck
|
||||||
|
|
||||||
|
- name: Test MCP
|
||||||
|
run: pnpm --filter @hivegrid/mcp test
|
||||||
|
|
||||||
|
- name: Build MCP
|
||||||
|
run: pnpm --filter @hivegrid/mcp build
|
||||||
|
|
||||||
|
worker:
|
||||||
|
name: Worker Service
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 25
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Typecheck Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker typecheck
|
||||||
|
|
||||||
|
- name: Test Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker exec vitest run
|
||||||
|
|
||||||
|
- name: Verify workflow outbox native readiness
|
||||||
|
run: pnpm run verify:workflow-outbox-native
|
||||||
|
|
||||||
|
- name: Build Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker build
|
||||||
|
|
||||||
|
- name: Health Check Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker health
|
||||||
|
env:
|
||||||
|
WORKER_ENABLED: "false"
|
||||||
|
|
||||||
|
database:
|
||||||
|
name: Database Checks
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 20
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Generate database client
|
||||||
|
run: pnpm run db:generate
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
|
||||||
|
- name: Setup Docker CLI
|
||||||
|
run: |
|
||||||
|
if ! command -v docker >/dev/null 2>&1; then
|
||||||
|
if ! command -v apt-get >/dev/null 2>&1 || [ "$(id -u)" != "0" ]; then
|
||||||
|
echo "Docker CLI missing and apt-get is not available as root"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
apt-get update -qq
|
||||||
|
apt-get install -qq -y --no-install-recommends ca-certificates curl
|
||||||
|
install -m 0755 -d /etc/apt/keyrings
|
||||||
|
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
|
||||||
|
chmod a+r /etc/apt/keyrings/docker.asc
|
||||||
|
. /etc/os-release
|
||||||
|
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian ${VERSION_CODENAME} stable" > /etc/apt/sources.list.d/docker.list
|
||||||
|
apt-get update -qq
|
||||||
|
apt-get install -qq -y --no-install-recommends docker-ce-cli
|
||||||
|
fi
|
||||||
|
|
||||||
|
docker --version
|
||||||
|
|
||||||
|
- name: Verify migrations schema parity
|
||||||
|
run: pnpm run verify:migrations-parity
|
||||||
|
|
||||||
|
- name: Verify database migration status
|
||||||
|
if: gitea.event_name != 'pull_request'
|
||||||
|
run: pnpm run verify:db-migrate-status:staging
|
||||||
|
env:
|
||||||
|
COOLIFY_STAGING_SSH_HOST: ${{ vars.COOLIFY_STAGING_SSH_HOST }}
|
||||||
|
COOLIFY_STAGING_SSH_USER: ${{ vars.COOLIFY_STAGING_SSH_USER }}
|
||||||
|
COOLIFY_STAGING_WEB_RESOURCE_UUID: ${{ vars.COOLIFY_STAGING_WEB_RESOURCE_UUID }}
|
||||||
|
COOLIFY_STAGING_SSH_KEY: ${{ secrets.COOLIFY_STAGING_SSH_KEY }}
|
||||||
|
|
||||||
|
- name: Test database package
|
||||||
|
run: pnpm --filter @hivegrid/db test
|
||||||
|
|
||||||
|
docker-smoke:
|
||||||
|
name: Docker Smoke
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 30
|
||||||
|
# No needs: the Docker images are built from source inside this job (no dependency on the
|
||||||
|
# quality/build jobs' outputs), so it runs fully in parallel instead of waiting on the
|
||||||
|
# ~4 min quality phase -> off the critical tail. Trade-off: if quality fails, the images
|
||||||
|
# still build (wasted compute), but the run fails overall anyway.
|
||||||
|
steps:
|
||||||
|
- name: Setup hosts override and Docker CLI
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v docker >/dev/null 2>&1 || ! docker buildx version >/dev/null 2>&1 || ! docker compose version >/dev/null 2>&1; then
|
||||||
|
if ! command -v apt-get >/dev/null 2>&1 || [ "$(id -u)" != "0" ]; then
|
||||||
|
echo "Docker CLI/buildx missing and apt-get is not available as root"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
apt-get update -qq
|
||||||
|
apt-get install -qq -y --no-install-recommends ca-certificates curl
|
||||||
|
install -m 0755 -d /etc/apt/keyrings
|
||||||
|
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
|
||||||
|
chmod a+r /etc/apt/keyrings/docker.asc
|
||||||
|
. /etc/os-release
|
||||||
|
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian ${VERSION_CODENAME} stable" > /etc/apt/sources.list.d/docker.list
|
||||||
|
apt-get update -qq
|
||||||
|
apt-get install -qq -y --no-install-recommends docker-ce-cli docker-buildx-plugin docker-compose-plugin
|
||||||
|
fi
|
||||||
|
|
||||||
|
docker --version
|
||||||
|
docker buildx version
|
||||||
|
docker compose version
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Docker Buildx
|
||||||
|
uses: docker/setup-buildx-action@v3
|
||||||
|
|
||||||
|
# Layer-cache strategy: this job runs on the self-hosted toolctrl-ci runner against the
|
||||||
|
# mounted host Docker daemon, whose BuildKit keeps a persistent local layer cache between
|
||||||
|
# CI runs (proven by the fact the `docker run hivegrid-*:smoke` steps below find images the
|
||||||
|
# build loaded into the host store). The Dockerfile additionally persists the pnpm store via
|
||||||
|
# `RUN --mount=type=cache,id=hivegrid-pnpm-store`. The three targets share base/deps/build
|
||||||
|
# stages, so a single daemon dedupes them within a run. No explicit `--cache-to/--cache-from`
|
||||||
|
# (type=local/registry) is configured: it would add cold first runs, import/export overhead
|
||||||
|
# and would require `--load` for the smoke steps, for no gain over the warm host cache.
|
||||||
|
# `type=gha` is intentionally not used here — it is GitHub-hosted-runner-only.
|
||||||
|
- name: Build Docker smoke targets
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
docker build --target web --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-web:smoke . &
|
||||||
|
web_pid=$!
|
||||||
|
docker build --target api --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-api:smoke . &
|
||||||
|
api_pid=$!
|
||||||
|
docker build --target mcp --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-mcp:smoke . &
|
||||||
|
mcp_pid=$!
|
||||||
|
docker build --target worker --build-arg APP_REVISION=ci-smoke-revision --tag hivegrid-worker:smoke . &
|
||||||
|
worker_pid=$!
|
||||||
|
|
||||||
|
status=0
|
||||||
|
wait "$web_pid" || status=$?
|
||||||
|
wait "$api_pid" || status=$?
|
||||||
|
wait "$mcp_pid" || status=$?
|
||||||
|
wait "$worker_pid" || status=$?
|
||||||
|
exit "$status"
|
||||||
|
|
||||||
|
- name: Validate web Docker artifacts
|
||||||
|
run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'
|
||||||
|
|
||||||
|
- name: Validate web Docker runtime
|
||||||
|
run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke
|
||||||
|
env:
|
||||||
|
DOCKER_WEB_SMOKE_TRANSPORT: exec
|
||||||
|
|
||||||
|
- name: Validate API Docker runtime
|
||||||
|
run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke
|
||||||
|
env:
|
||||||
|
DOCKER_API_SMOKE_TRANSPORT: exec
|
||||||
|
|
||||||
|
- name: Validate MCP Docker runtime
|
||||||
|
run: bash scripts/docker-mcp-runtime-smoke.sh hivegrid-mcp:smoke
|
||||||
|
env:
|
||||||
|
DOCKER_MCP_SMOKE_TRANSPORT: exec
|
||||||
|
|
||||||
|
- name: Validate worker Docker runtime
|
||||||
|
run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke
|
||||||
|
|
||||||
|
- name: Validate Docker Compose config
|
||||||
|
run: docker compose config
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
name: Coverage
|
||||||
|
|
||||||
|
# Gitea variant of .github/workflows/coverage.yml. Runs vitest with --coverage
|
||||||
|
# and the per-path gate (scripts/verify-test-coverage.mjs) and upserts a
|
||||||
|
# sticky PR comment via the Gitea API.
|
||||||
|
#
|
||||||
|
# Docs: docs/architecture/test-coverage.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- "apps/**"
|
||||||
|
- "packages/**"
|
||||||
|
- "scripts/coverage-targets.json"
|
||||||
|
- "scripts/verify-test-coverage.mjs"
|
||||||
|
- "scripts/coverage-summary.mjs"
|
||||||
|
- "vitest.config.ts"
|
||||||
|
- ".gitea/workflows/coverage.yml"
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
coverage:
|
||||||
|
name: Measure coverage and gate thresholds
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 30
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout PR head
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Run vitest with coverage (enforces per-path gates)
|
||||||
|
run: pnpm run verify:test-coverage
|
||||||
|
|
||||||
|
- name: Render PR coverage comment
|
||||||
|
if: always()
|
||||||
|
run: node scripts/coverage-summary.mjs --pr-comment > coverage-comment.md
|
||||||
|
|
||||||
|
- name: Upsert Gitea PR comment
|
||||||
|
if: always()
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
|
||||||
|
GITEA_HOST: ${{ vars.GITEA_HOST || 'git.tool-ctrl.de' }}
|
||||||
|
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||||
|
REPO: ${{ github.repository }}
|
||||||
|
COMMENT_PATH: coverage-comment.md
|
||||||
|
COMMENT_MARKER: "<!-- coverage-report -->"
|
||||||
|
run: node scripts/post-coverage-gitea-comment.mjs
|
||||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,209 @@
|
|||||||
|
name: E2E Readiness
|
||||||
|
|
||||||
|
# Runs the deployed staging/readiness browser suite in fail-closed mode.
|
||||||
|
# Main CI intentionally remains browser-free; this lane proves the authenticated
|
||||||
|
# Playwright/mobile/a11y contract against a live target on schedule or demand.
|
||||||
|
#
|
||||||
|
# Docs: docs/testing/e2e-readiness.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
plugin_lifecycle_mutation:
|
||||||
|
description: "Operator-approved disposable run: persist plugin grant/revoke and enable/disable state"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
plugin_settings_write:
|
||||||
|
description: "Operator-approved disposable run: persist plugin settings iframe writes"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
workflow_outbox_drain:
|
||||||
|
description: "Operator-approved run: require worker/outbox drain to terminal WorkflowExecution status"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
workflow_webhook_run:
|
||||||
|
description: "Operator-approved run: execute the webhook workflow against workflow_webhook_target_url"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
workflow_webhook_target_url:
|
||||||
|
description: "Operator-owned disposable webhook target URL, required when workflow_webhook_run is true"
|
||||||
|
required: false
|
||||||
|
default: ""
|
||||||
|
type: string
|
||||||
|
subscription_success:
|
||||||
|
description: "Operator-approved run: require Stripe checkout success return smoke"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
subscription_success_path:
|
||||||
|
description: "Externally acquired Stripe checkout success return path, required when subscription_success is true"
|
||||||
|
required: false
|
||||||
|
default: ""
|
||||||
|
type: string
|
||||||
|
schedule:
|
||||||
|
# 04:00 UTC nightly, after deploy and Lighthouse windows have settled.
|
||||||
|
- cron: "0 4 * * *"
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
E2E_BASE_URL: https://app.hivegrid.de
|
||||||
|
E2E_A11Y_STRICT: "1"
|
||||||
|
E2E_BROWSER_MATRIX: "1"
|
||||||
|
E2E_ALLOW_WORKFLOW_RUN: "1"
|
||||||
|
REQUIRE_E2E_A11Y: "1"
|
||||||
|
REQUIRE_AUTH_E2E: "1"
|
||||||
|
REQUIRE_E2E_READINESS: "1"
|
||||||
|
E2E_REGISTRATION_EXPECTS_EMAIL_VERIFICATION: "0"
|
||||||
|
E2E_TENANT_ACCOUNT_NAME: E2E Readiness
|
||||||
|
E2E_TENANT_ACCOUNT_SLUG: e2e-readiness
|
||||||
|
E2E_TENANT_DASHBOARD_PATH: /e2e-readiness/dashboard
|
||||||
|
E2E_TENANT_SETTINGS_ACCOUNT_PATH: /e2e-readiness/settings/account
|
||||||
|
E2E_TENANT_SETTINGS_PROFILE_PATH: /e2e-readiness/settings/profile
|
||||||
|
E2E_TENANT_SUBSCRIPTION_PATH: /e2e-readiness/settings/subscription
|
||||||
|
E2E_TENANT_MEMBERS_PATH: /e2e-readiness/settings/members
|
||||||
|
E2E_TENANT_ROLES_AND_PERMISSIONS_PATH: /e2e-readiness/settings/roles-and-permissions
|
||||||
|
E2E_TENANT_NOTIFICATIONS_PATH: /e2e-readiness/settings/notifications
|
||||||
|
E2E_TENANT_LOGS_PATH: /e2e-readiness/settings/logs
|
||||||
|
E2E_TENANT_LOG_EVENTS_PATH: /e2e-readiness/settings/logs/events
|
||||||
|
E2E_TENANT_AUDIT_EXPORT_PATH: /e2e-readiness/settings/audit-export
|
||||||
|
E2E_TENANT_PRIVACY_PATH: /e2e-readiness/settings/privacy
|
||||||
|
E2E_TENANT_CHATBOT_PATH: /e2e-readiness/settings/chatbot
|
||||||
|
E2E_TENANT_AI_USAGE_PATH: /e2e-readiness/settings/ai-usage
|
||||||
|
E2E_TENANT_API_PATH: /e2e-readiness/settings/api
|
||||||
|
E2E_TENANT_API_KEYS_PATH: /e2e-readiness/settings/api/keys
|
||||||
|
E2E_TENANT_API_DOCS_PATH: /e2e-readiness/settings/api/docs
|
||||||
|
E2E_TENANT_API_LOGS_PATH: /e2e-readiness/settings/api/logs
|
||||||
|
E2E_TENANT_POLICIES_PATH: /e2e-readiness/settings/policies
|
||||||
|
E2E_TENANT_PORTAL_ANALYTICS_PATH: /e2e-readiness/portals/e2e-readiness/analytics
|
||||||
|
E2E_TENANT_PORTAL_SETTINGS_PATH: /e2e-readiness/portals/e2e-readiness/settings
|
||||||
|
E2E_ADMIN_EMAIL_SEQUENCES_PATH: /email-sequences
|
||||||
|
E2E_PLUGIN_SETTINGS_PATH: /e2e-readiness/settings/plugins
|
||||||
|
E2E_WORKFLOW_ENGINE_PATH: /e2e-readiness/workflow-engine/workflows
|
||||||
|
E2E_WORKFLOW_BUILDER_PATH: /e2e-readiness/workflow-engine/workflows/wf_123
|
||||||
|
E2E_WORKFLOW_RUN_API_PATH: /e2e-readiness/workflow-engine/workflows/wf_123/run/api
|
||||||
|
E2E_WORKFLOW_RUN_MANUAL_PATH: /e2e-readiness/workflow-engine/workflows/wf_123/run/manual
|
||||||
|
E2E_WORKFLOW_WEBHOOK_BUILDER_PATH: /e2e-readiness/workflow-engine/workflows/wf_webhook_123
|
||||||
|
E2E_WORKFLOW_WEBHOOK_RUN_MANUAL_PATH: /e2e-readiness/workflow-engine/workflows/wf_webhook_123/run/manual
|
||||||
|
E2E_WORKFLOW_WAITING_BUILDER_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123
|
||||||
|
E2E_WORKFLOW_WAITING_RUN_MANUAL_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123/run/manual
|
||||||
|
E2E_WORKFLOW_WAITING_RUN_API_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123/run/api
|
||||||
|
E2E_WORKFLOW_WAITING_EXECUTIONS_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123/executions
|
||||||
|
E2E_WORKFLOW_WAITING_EXECUTION_ID: wfe_waiting_123
|
||||||
|
PLUGIN_BINARY_BASE_PATH: /tmp/e2e-plugins
|
||||||
|
PLAYWRIGHT_BROWSERS_PATH: .cache/ms-playwright
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
readiness:
|
||||||
|
name: Strict Playwright readiness
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 45
|
||||||
|
env:
|
||||||
|
E2E_TENANT_EMAIL: ${{ secrets.E2E_TENANT_EMAIL }}
|
||||||
|
E2E_TENANT_PASSWORD: ${{ secrets.E2E_TENANT_PASSWORD }}
|
||||||
|
E2E_PLUGIN_READONLY_EMAIL: ${{ secrets.E2E_PLUGIN_READONLY_EMAIL }}
|
||||||
|
E2E_PLUGIN_READONLY_PASSWORD: ${{ secrets.E2E_PLUGIN_READONLY_PASSWORD }}
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Cache Playwright browsers
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .cache/ms-playwright
|
||||||
|
key: ${{ runner.os }}-playwright-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-playwright-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Install Playwright browsers
|
||||||
|
run: pnpm exec playwright install --with-deps chromium webkit
|
||||||
|
|
||||||
|
- name: Apply manual operator E2E opt-ins
|
||||||
|
if: ${{ github.event_name == 'workflow_dispatch' }}
|
||||||
|
# Bind dispatch inputs to env vars instead of interpolating ${{ inputs.* }}
|
||||||
|
# straight into the shell, so a crafted value cannot inject commands or
|
||||||
|
# extra lines into $GITHUB_ENV (CI script injection). Free-form URL/path
|
||||||
|
# inputs are additionally allowlist-validated before being written.
|
||||||
|
env:
|
||||||
|
OPT_PLUGIN_LIFECYCLE_MUTATION: ${{ inputs.plugin_lifecycle_mutation }}
|
||||||
|
OPT_PLUGIN_SETTINGS_WRITE: ${{ inputs.plugin_settings_write }}
|
||||||
|
OPT_WORKFLOW_OUTBOX_DRAIN: ${{ inputs.workflow_outbox_drain }}
|
||||||
|
OPT_WORKFLOW_WEBHOOK_RUN: ${{ inputs.workflow_webhook_run }}
|
||||||
|
OPT_WORKFLOW_WEBHOOK_TARGET_URL: ${{ inputs.workflow_webhook_target_url }}
|
||||||
|
OPT_SUBSCRIPTION_SUCCESS: ${{ inputs.subscription_success }}
|
||||||
|
OPT_SUBSCRIPTION_SUCCESS_PATH: ${{ inputs.subscription_success_path }}
|
||||||
|
run: |
|
||||||
|
if [ "$OPT_PLUGIN_LIFECYCLE_MUTATION" = "true" ]; then
|
||||||
|
echo "E2E_ALLOW_PLUGIN_LIFECYCLE_MUTATION=1" >> "$GITHUB_ENV"
|
||||||
|
fi
|
||||||
|
if [ "$OPT_PLUGIN_SETTINGS_WRITE" = "true" ]; then
|
||||||
|
echo "E2E_ALLOW_PLUGIN_SETTINGS_WRITE=1" >> "$GITHUB_ENV"
|
||||||
|
fi
|
||||||
|
if [ "$OPT_WORKFLOW_OUTBOX_DRAIN" = "true" ]; then
|
||||||
|
echo "E2E_REQUIRE_WORKFLOW_OUTBOX_DRAIN=1" >> "$GITHUB_ENV"
|
||||||
|
fi
|
||||||
|
if [ "$OPT_WORKFLOW_WEBHOOK_RUN" = "true" ]; then
|
||||||
|
echo "E2E_ALLOW_WORKFLOW_WEBHOOK_RUN=1" >> "$GITHUB_ENV"
|
||||||
|
case "$OPT_WORKFLOW_WEBHOOK_TARGET_URL" in
|
||||||
|
"") ;;
|
||||||
|
*[!a-zA-Z0-9:/?._~=%\&-]*) echo "Invalid workflow_webhook_target_url" >&2; exit 1 ;;
|
||||||
|
*) printf 'E2E_WORKFLOW_WEBHOOK_TARGET_URL=%s\n' "$OPT_WORKFLOW_WEBHOOK_TARGET_URL" >> "$GITHUB_ENV" ;;
|
||||||
|
esac
|
||||||
|
fi
|
||||||
|
if [ "$OPT_SUBSCRIPTION_SUCCESS" = "true" ]; then
|
||||||
|
echo "E2E_REQUIRE_SUBSCRIPTION_SUCCESS=1" >> "$GITHUB_ENV"
|
||||||
|
case "$OPT_SUBSCRIPTION_SUCCESS_PATH" in
|
||||||
|
"") ;;
|
||||||
|
*[!a-zA-Z0-9:/?._~=%\&-]*) echo "Invalid subscription_success_path" >&2; exit 1 ;;
|
||||||
|
*) printf 'E2E_TENANT_SUBSCRIPTION_SUCCESS_PATH=%s\n' "$OPT_SUBSCRIPTION_SUCCESS_PATH" >> "$GITHUB_ENV" ;;
|
||||||
|
esac
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Run strict E2E readiness suite
|
||||||
|
run: pnpm run verify:e2e-a11y
|
||||||
|
|
||||||
|
- name: Upload Playwright traces
|
||||||
|
if: always()
|
||||||
|
uses: actions/upload-artifact@v3
|
||||||
|
with:
|
||||||
|
name: e2e-readiness-results
|
||||||
|
path: test-results/
|
||||||
|
if-no-files-found: ignore
|
||||||
|
retention-days: 14
|
||||||
@@ -0,0 +1,72 @@
|
|||||||
|
name: Lighthouse CI
|
||||||
|
|
||||||
|
# Audits the deployed staging site (https://app.hivegrid.de). A
|
||||||
|
# meaningful Lighthouse audit needs a live server, a database and seeded
|
||||||
|
# content; reproducing that whole stack inside a CI job is brittle, so the
|
||||||
|
# audit targets the deployed environment instead.
|
||||||
|
#
|
||||||
|
# This is therefore a post-deploy / monitoring audit, NOT a per-commit merge
|
||||||
|
# gate — staging always lags the commit under review. It runs nightly and on
|
||||||
|
# manual dispatch.
|
||||||
|
#
|
||||||
|
# Docs: docs/architecture/lighthouse.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
schedule:
|
||||||
|
# 03:00 UTC nightly — after the day's deploys have settled.
|
||||||
|
- cron: "0 3 * * *"
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
lighthouse:
|
||||||
|
name: Run Lighthouse audits
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 30
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Mint Lighthouse session cookie
|
||||||
|
run: node scripts/rotate-lighthouse-session-cookie.mjs
|
||||||
|
env:
|
||||||
|
LIGHTHOUSE_LOGIN_URL: https://app.hivegrid.de/login
|
||||||
|
LIGHTHOUSE_LOGIN_EMAIL: ${{ secrets.LIGHTHOUSE_LOGIN_EMAIL }}
|
||||||
|
LIGHTHOUSE_LOGIN_PASSWORD: ${{ secrets.LIGHTHOUSE_LOGIN_PASSWORD }}
|
||||||
|
LIGHTHOUSE_SESSION_COOKIE: ${{ secrets.LIGHTHOUSE_SESSION_COOKIE }}
|
||||||
|
LIGHTHOUSE_SESSION_COOKIE_NAME: hivegrid_session
|
||||||
|
LIGHTHOUSE_COOKIE_DOMAIN: app.hivegrid.de
|
||||||
|
|
||||||
|
- name: Install Chromium
|
||||||
|
# The Gitea runner image (node:20-bookworm) ships no browser; LHCI's
|
||||||
|
# healthcheck otherwise fails with "Chrome installation not found".
|
||||||
|
run: |
|
||||||
|
apt-get update
|
||||||
|
apt-get install -y --no-install-recommends chromium fonts-liberation
|
||||||
|
rm -rf /var/lib/apt/lists/*
|
||||||
|
|
||||||
|
- name: Run Lighthouse-CI against staging
|
||||||
|
run: npx --yes @lhci/cli@0.13.x autorun --config=./.lighthouserc.staging.json
|
||||||
|
env:
|
||||||
|
# chromium installs to /usr/bin/chromium on Debian bookworm.
|
||||||
|
CHROME_PATH: /usr/bin/chromium
|
||||||
|
|
||||||
|
- name: Upload Lighthouse artifacts
|
||||||
|
if: always()
|
||||||
|
uses: actions/upload-artifact@v3
|
||||||
|
with:
|
||||||
|
name: lighthouse-ci-results
|
||||||
|
path: .lighthouseci/
|
||||||
|
retention-days: 14
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
name: SDK Codegen Drift
|
||||||
|
|
||||||
|
# Gitea variant of .github/workflows/sdk-codegen.yml. Re-runs the
|
||||||
|
# @hivegrid/api-client-ts generation pipeline on PRs that touch the
|
||||||
|
# upstream OpenAPI surface or the SDK package, then verifies the
|
||||||
|
# committed src/generated/ tree is in sync with openapi.json.
|
||||||
|
#
|
||||||
|
# Docs: docs/sdks/typescript.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- "apps/api/src/openapi.ts"
|
||||||
|
- "apps/api/src/openapi.test.ts"
|
||||||
|
- "packages/api-client-ts/**"
|
||||||
|
- "packages/api-types/**"
|
||||||
|
- ".gitea/workflows/sdk-codegen.yml"
|
||||||
|
|
||||||
|
env:
|
||||||
|
HIVEGRID_GITEA_HOST_IP: ${{ vars.HIVEGRID_GITEA_HOST_IP }}
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
drift-check:
|
||||||
|
name: Verify SDK codegen is in sync with OpenAPI spec
|
||||||
|
runs-on: toolctrl-ci
|
||||||
|
timeout-minutes: 15
|
||||||
|
steps:
|
||||||
|
- name: Resolve internal Gitea host
|
||||||
|
run: |
|
||||||
|
if [ -n "${HIVEGRID_GITEA_HOST_IP:-}" ]; then
|
||||||
|
if ! HIVEGRID_GITEA_HOST_IP="$HIVEGRID_GITEA_HOST_IP" node -e 'process.exit(require("node:net").isIP(process.env.HIVEGRID_GITEA_HOST_IP || "") ? 0 : 1)'; then
|
||||||
|
echo "HIVEGRID_GITEA_HOST_IP must be a single IPv4 or IPv6 token"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
printf '%s git.tool-ctrl.de\n' "$HIVEGRID_GITEA_HOST_IP" >> /etc/hosts
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Checkout PR head
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Regenerate OpenAPI capture
|
||||||
|
run: pnpm --filter @hivegrid/api-client-ts generate-spec
|
||||||
|
|
||||||
|
- name: Regenerate typed client (Hey-API)
|
||||||
|
run: pnpm --filter @hivegrid/api-client-ts generate
|
||||||
|
|
||||||
|
- name: Fail if generated code drifts from committed state
|
||||||
|
run: |
|
||||||
|
if ! git diff --exit-code --stat \
|
||||||
|
packages/api-client-ts/openapi.json \
|
||||||
|
packages/api-client-ts/src/generated; then
|
||||||
|
echo ""
|
||||||
|
echo "SDK codegen drift detected. Run:"
|
||||||
|
echo ""
|
||||||
|
echo " pnpm --filter @hivegrid/api-client-ts generate:all"
|
||||||
|
echo ""
|
||||||
|
echo "then commit packages/api-client-ts/openapi.json and packages/api-client-ts/src/generated/."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo "SDK codegen is in sync with the upstream OpenAPI spec."
|
||||||
|
|
||||||
|
- name: Typecheck SDK packages
|
||||||
|
run: |
|
||||||
|
pnpm --filter @hivegrid/api-client-ts typecheck
|
||||||
|
pnpm --filter @hivegrid/api-types typecheck
|
||||||
|
|
||||||
|
- name: Run SDK tests
|
||||||
|
run: |
|
||||||
|
pnpm --filter @hivegrid/api-client-ts test
|
||||||
|
pnpm --filter @hivegrid/api-types test
|
||||||
@@ -0,0 +1,75 @@
|
|||||||
|
# Dependabot configuration for supply-chain hygiene.
|
||||||
|
# Docs: https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
|
||||||
|
#
|
||||||
|
# Notes:
|
||||||
|
# - Dependabot's `npm` ecosystem reads root package.json + the pnpm-lock.yaml.
|
||||||
|
# Workspace packages under apps/* and packages/* are covered transitively via
|
||||||
|
# the root lockfile, so a single `directory: "/"` entry is sufficient.
|
||||||
|
# - assignees/reviewers are intentionally left empty so each fork/clone can
|
||||||
|
# wire them up via repo-level settings without editing this file.
|
||||||
|
version: 2
|
||||||
|
updates:
|
||||||
|
- package-ecosystem: npm
|
||||||
|
directory: "/"
|
||||||
|
schedule:
|
||||||
|
interval: weekly
|
||||||
|
open-pull-requests-limit: 10
|
||||||
|
commit-message:
|
||||||
|
prefix: "chore(deps):"
|
||||||
|
labels:
|
||||||
|
- dependencies
|
||||||
|
assignees: []
|
||||||
|
reviewers: []
|
||||||
|
groups:
|
||||||
|
ai-providers:
|
||||||
|
patterns:
|
||||||
|
- "@mistralai/*"
|
||||||
|
- "mistralai"
|
||||||
|
- "@scaleway/*"
|
||||||
|
- "scaleway"
|
||||||
|
- "@scaleway-sdk/*"
|
||||||
|
- "aleph-alpha*"
|
||||||
|
- "@aleph-alpha/*"
|
||||||
|
react-stack:
|
||||||
|
patterns:
|
||||||
|
- "react"
|
||||||
|
- "react-dom"
|
||||||
|
- "react-router"
|
||||||
|
- "@react-router/*"
|
||||||
|
- "vite"
|
||||||
|
- "@vitejs/*"
|
||||||
|
test-tooling:
|
||||||
|
patterns:
|
||||||
|
- "vitest"
|
||||||
|
- "@vitest/*"
|
||||||
|
- "@testing-library/*"
|
||||||
|
lint-tooling:
|
||||||
|
patterns:
|
||||||
|
- "eslint"
|
||||||
|
- "eslint-*"
|
||||||
|
- "@eslint/*"
|
||||||
|
- "@typescript-eslint/*"
|
||||||
|
|
||||||
|
- package-ecosystem: github-actions
|
||||||
|
directory: "/"
|
||||||
|
schedule:
|
||||||
|
interval: weekly
|
||||||
|
open-pull-requests-limit: 10
|
||||||
|
commit-message:
|
||||||
|
prefix: "chore(deps):"
|
||||||
|
labels:
|
||||||
|
- dependencies
|
||||||
|
assignees: []
|
||||||
|
reviewers: []
|
||||||
|
|
||||||
|
- package-ecosystem: docker
|
||||||
|
directory: "/"
|
||||||
|
schedule:
|
||||||
|
interval: monthly
|
||||||
|
open-pull-requests-limit: 10
|
||||||
|
commit-message:
|
||||||
|
prefix: "chore(deps):"
|
||||||
|
labels:
|
||||||
|
- dependencies
|
||||||
|
assignees: []
|
||||||
|
reviewers: []
|
||||||
+82
@@ -0,0 +1,82 @@
|
|||||||
|
name: Sentry Release
|
||||||
|
|
||||||
|
# Reusable workflow that tags a release in our self-hosted Sentry,
|
||||||
|
# optionally uploads source-maps, correlates commits and marks a deploy.
|
||||||
|
# Consumed via `uses: ./.github/workflows/_sentry-release.yml`.
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_call:
|
||||||
|
inputs:
|
||||||
|
project:
|
||||||
|
description: "Sentry project slug (hivegrid-api|hivegrid-worker|hivegrid-web)"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
environment:
|
||||||
|
description: "Deployment environment label (production|staging|preview)"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
sourcemaps-path:
|
||||||
|
description: "Directory containing source-maps to upload, or 'none'"
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: "none"
|
||||||
|
sourcemaps-artifact:
|
||||||
|
description: "Optional workflow artifact to download before source-map upload, or 'none'"
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: "none"
|
||||||
|
secrets:
|
||||||
|
SENTRY_AUTH_TOKEN:
|
||||||
|
description: "Sentry auth token (project:releases scope)"
|
||||||
|
required: true
|
||||||
|
SENTRY_ORG:
|
||||||
|
description: "Sentry organisation slug"
|
||||||
|
required: true
|
||||||
|
SENTRY_URL:
|
||||||
|
description: "Sentry self-hosted base URL"
|
||||||
|
required: true
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
release:
|
||||||
|
name: Sentry release (${{ inputs.project }})
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 15
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
fetch-depth: 0
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Download source-map artifact
|
||||||
|
if: ${{ inputs.sourcemaps-artifact != 'none' }}
|
||||||
|
uses: actions/download-artifact@v4
|
||||||
|
with:
|
||||||
|
name: ${{ inputs.sourcemaps-artifact }}
|
||||||
|
path: ${{ inputs.sourcemaps-path }}
|
||||||
|
|
||||||
|
- name: Verify sentry-cli is reachable
|
||||||
|
env:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
|
run: |
|
||||||
|
node -v
|
||||||
|
npx --yes @sentry/cli@2.41.1 --version
|
||||||
|
|
||||||
|
- name: Tag Sentry release
|
||||||
|
env:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
|
run: |
|
||||||
|
bash scripts/ci/sentry-release.sh \
|
||||||
|
--project "${{ inputs.project }}" \
|
||||||
|
--environment "${{ inputs.environment }}" \
|
||||||
|
--release "${{ github.sha }}" \
|
||||||
|
--sourcemaps "${{ inputs.sourcemaps-path }}"
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
name: Accessibility
|
||||||
|
|
||||||
|
# Runs the axe-core vitest suites (apps/web ui components, SkipToContent)
|
||||||
|
# and the WCAG-2.2-AA color-contrast verifier on every PR + push to main.
|
||||||
|
#
|
||||||
|
# Docs: docs/contributing/wcag-audit.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- main
|
||||||
|
pull_request:
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
concurrency:
|
||||||
|
group: a11y-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
|
||||||
|
cancel-in-progress: true
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
axe:
|
||||||
|
name: axe-core + color-contrast
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 20
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Run color-contrast verifier
|
||||||
|
run: pnpm run verify:color-contrast
|
||||||
|
|
||||||
|
- name: Verify accessibility coverage
|
||||||
|
run: pnpm run verify:a11y-coverage
|
||||||
|
|
||||||
|
- name: Run axe vitest suite (test:a11y)
|
||||||
|
run: pnpm run test:a11y
|
||||||
|
|
||||||
|
- name: Verify accessibility lint baseline
|
||||||
|
run: pnpm run verify:a11y-baseline
|
||||||
|
|
||||||
|
- name: Lint accessibility rules (eslint-plugin-jsx-a11y)
|
||||||
|
run: pnpm run lint
|
||||||
+74
@@ -0,0 +1,74 @@
|
|||||||
|
name: Bundle Budget Baseline
|
||||||
|
|
||||||
|
# Captures the main-branch bundle report as an artifact so the
|
||||||
|
# bundle-budget PR workflow can render Δ-from-main columns. Runs on
|
||||||
|
# push to main; downstream PR workflow downloads `bundle-baseline-main`.
|
||||||
|
# Docs: docs/architecture/bundle-budgets.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths:
|
||||||
|
- "apps/web/**"
|
||||||
|
- "packages/brand/**"
|
||||||
|
- "packages/config/**"
|
||||||
|
- "packages/entitlements/**"
|
||||||
|
- "packages/form-widget/**"
|
||||||
|
- "packages/foundation/**"
|
||||||
|
- "packages/i18n/**"
|
||||||
|
- "packages/plugin-runtime/**"
|
||||||
|
- "packages/ui*/**"
|
||||||
|
- "packages/url/**"
|
||||||
|
- "packages/view-models/**"
|
||||||
|
- "package.json"
|
||||||
|
- "pnpm-lock.yaml"
|
||||||
|
- "scripts/bundle-budgets.json"
|
||||||
|
- "scripts/verify-bundle-size.mjs"
|
||||||
|
- ".github/workflows/bundle-budget-baseline.yml"
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
capture:
|
||||||
|
name: Capture bundle baseline
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 30
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
- name: Build web
|
||||||
|
run: pnpm --filter @hivegrid/web build
|
||||||
|
|
||||||
|
- name: Verify aggregate bundle budgets
|
||||||
|
run: pnpm run verify:bundle-size
|
||||||
|
|
||||||
|
- name: Measure bundle sizes
|
||||||
|
run: node scripts/verify-bundle-size.mjs --json > main-bundle-report.json
|
||||||
|
|
||||||
|
- name: Upload baseline artifact
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: bundle-baseline-main
|
||||||
|
path: main-bundle-report.json
|
||||||
|
retention-days: 30
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
name: Bundle Budget
|
||||||
|
|
||||||
|
# Posts a sticky PR comment with per-route gzip sizes vs scripts/bundle-budgets.json.
|
||||||
|
# Non-blocking: exceeds-limit routes show a warning row but never fail the PR check.
|
||||||
|
# Docs: docs/architecture/bundle-budgets.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- "apps/web/**"
|
||||||
|
- "packages/brand/**"
|
||||||
|
- "packages/config/**"
|
||||||
|
- "packages/entitlements/**"
|
||||||
|
- "packages/form-widget/**"
|
||||||
|
- "packages/foundation/**"
|
||||||
|
- "packages/i18n/**"
|
||||||
|
- "packages/plugin-runtime/**"
|
||||||
|
- "packages/ui*/**"
|
||||||
|
- "packages/url/**"
|
||||||
|
- "packages/view-models/**"
|
||||||
|
- "package.json"
|
||||||
|
- "pnpm-lock.yaml"
|
||||||
|
- "scripts/bundle-budgets.json"
|
||||||
|
- "scripts/verify-bundle-size.mjs"
|
||||||
|
- ".github/workflows/bundle-budget.yml"
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
pull-requests: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
measure:
|
||||||
|
name: Measure & report bundle sizes
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 30
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Checkout PR head
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
- name: Build web (PR head)
|
||||||
|
run: pnpm --filter @hivegrid/web build
|
||||||
|
|
||||||
|
- name: Verify aggregate bundle budgets
|
||||||
|
run: pnpm run verify:bundle-size
|
||||||
|
|
||||||
|
- name: Measure PR bundle sizes
|
||||||
|
run: node scripts/verify-bundle-size.mjs --json > pr-bundle-report.json
|
||||||
|
|
||||||
|
- name: Upload PR bundle report
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: bundle-report-pr-${{ github.event.pull_request.number }}
|
||||||
|
path: pr-bundle-report.json
|
||||||
|
retention-days: 14
|
||||||
|
|
||||||
|
- name: Download main baseline (if available)
|
||||||
|
id: baseline
|
||||||
|
uses: dawidd6/action-download-artifact@v6
|
||||||
|
with:
|
||||||
|
name: bundle-baseline-main
|
||||||
|
workflow: bundle-budget-baseline.yml
|
||||||
|
branch: main
|
||||||
|
path: baseline
|
||||||
|
if_no_artifact_found: warn
|
||||||
|
continue-on-error: true
|
||||||
|
|
||||||
|
- name: Render PR comment markdown
|
||||||
|
run: node scripts/render-bundle-budget-comment.mjs \
|
||||||
|
--current pr-bundle-report.json \
|
||||||
|
--baseline baseline/main-bundle-report.json \
|
||||||
|
--out bundle-comment.md
|
||||||
|
|
||||||
|
- name: Post sticky PR comment
|
||||||
|
uses: marocchino/sticky-pull-request-comment@v2
|
||||||
|
with:
|
||||||
|
header: bundle-budget-report
|
||||||
|
path: bundle-comment.md
|
||||||
@@ -0,0 +1,402 @@
|
|||||||
|
name: CI
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
pull_request:
|
||||||
|
|
||||||
|
concurrency:
|
||||||
|
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
|
||||||
|
cancel-in-progress: true
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
quality:
|
||||||
|
name: Quality Gates
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 45
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Verify GitHub CI workflow
|
||||||
|
run: pnpm run verify:github-ci-workflow
|
||||||
|
|
||||||
|
- name: Verify Gitea CI workflow
|
||||||
|
run: pnpm run verify:gitea-ci-workflow
|
||||||
|
|
||||||
|
- name: Verify Gitea deploy workflow
|
||||||
|
run: pnpm run verify:deploy-workflow
|
||||||
|
|
||||||
|
- name: Verify deploy readiness
|
||||||
|
run: pnpm run verify:deploy-readiness
|
||||||
|
|
||||||
|
- name: Verify CI baseline
|
||||||
|
run: pnpm run verify:ci-baseline
|
||||||
|
|
||||||
|
- name: Verify source health
|
||||||
|
run: pnpm run verify:source-health
|
||||||
|
|
||||||
|
- name: Verify ESLint baseline
|
||||||
|
run: pnpm run verify:eslint-baseline
|
||||||
|
|
||||||
|
- name: Verify env drift
|
||||||
|
run: pnpm run verify:env-drift
|
||||||
|
|
||||||
|
- name: Verify health baseline
|
||||||
|
run: pnpm run verify:health-baseline
|
||||||
|
|
||||||
|
- name: Verify API inventory
|
||||||
|
run: pnpm run verify:api-inventory
|
||||||
|
|
||||||
|
- name: Verify tenant isolation report
|
||||||
|
run: pnpm run verify:tenant-isolation-report
|
||||||
|
|
||||||
|
- name: Verify sidebar routes
|
||||||
|
run: pnpm run verify:sidebar-routes
|
||||||
|
|
||||||
|
- name: Verify i18n keys
|
||||||
|
run: pnpm run verify:i18n
|
||||||
|
|
||||||
|
- name: Verify Tenant Auth tenant and onboarding gates
|
||||||
|
run: |
|
||||||
|
pnpm run verify:tenant-auth-baseline
|
||||||
|
pnpm run verify:onboarding-flow
|
||||||
|
|
||||||
|
- name: Verify Phase C package boundaries
|
||||||
|
run: pnpm run verify:phase-c-boundaries
|
||||||
|
|
||||||
|
- name: Verify Feature Manifest plugin removal gates
|
||||||
|
run: |
|
||||||
|
pnpm run verify:core-build-without-plugins-smoke
|
||||||
|
pnpm run verify:removed-modules
|
||||||
|
|
||||||
|
- name: Verify UI mock static baseline
|
||||||
|
run: pnpm run verify:ui-visual
|
||||||
|
|
||||||
|
- name: Test UI mock hot-swap
|
||||||
|
run: pnpm run test:hot-swap
|
||||||
|
|
||||||
|
- name: Verify accessibility coverage
|
||||||
|
run: pnpm run verify:a11y-coverage
|
||||||
|
|
||||||
|
- name: Test accessibility smoke
|
||||||
|
run: pnpm run test:a11y
|
||||||
|
|
||||||
|
- name: Verify documentation gates
|
||||||
|
run: |
|
||||||
|
pnpm run verify:porting-docs-baseline
|
||||||
|
pnpm run verify:production-docs
|
||||||
|
pnpm run verify:release-docs
|
||||||
|
pnpm run verify:docs-links
|
||||||
|
|
||||||
|
- name: Typecheck
|
||||||
|
run: pnpm typecheck
|
||||||
|
|
||||||
|
- name: Lint
|
||||||
|
run: pnpm lint
|
||||||
|
|
||||||
|
- name: Foundation package tests
|
||||||
|
run: pnpm run test:foundation
|
||||||
|
|
||||||
|
- name: Workspace package tests
|
||||||
|
run: pnpm run test:packages
|
||||||
|
|
||||||
|
- name: Unit tests
|
||||||
|
run: pnpm test
|
||||||
|
|
||||||
|
- name: Build
|
||||||
|
env:
|
||||||
|
HIVEGRID_BUILD_SOURCEMAPS: "1"
|
||||||
|
run: pnpm run build:ci
|
||||||
|
|
||||||
|
- name: Verify bundle size
|
||||||
|
run: pnpm run verify:bundle-size
|
||||||
|
|
||||||
|
- name: Verify web Sentry sourcemaps
|
||||||
|
run: test -n "$(find apps/web/build/client -type f -name '*.map' -print -quit)"
|
||||||
|
|
||||||
|
- name: Upload web Sentry sourcemaps
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: web-client-sourcemaps
|
||||||
|
path: apps/web/build/client
|
||||||
|
if-no-files-found: error
|
||||||
|
retention-days: 7
|
||||||
|
|
||||||
|
- name: Verify production seed artifact
|
||||||
|
run: pnpm run verify:production-seed-artifact
|
||||||
|
|
||||||
|
api:
|
||||||
|
name: API Service
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 25
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Verify OpenAPI security
|
||||||
|
run: pnpm run verify:openapi-security
|
||||||
|
|
||||||
|
- name: Typecheck API
|
||||||
|
run: pnpm --filter @hivegrid/api typecheck
|
||||||
|
|
||||||
|
- name: Test API
|
||||||
|
run: pnpm exec vitest run apps/api/src
|
||||||
|
|
||||||
|
- name: Build API
|
||||||
|
run: pnpm --filter @hivegrid/api build
|
||||||
|
|
||||||
|
worker:
|
||||||
|
name: Worker Service
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 25
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Typecheck Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker typecheck
|
||||||
|
|
||||||
|
- name: Test Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker exec vitest run
|
||||||
|
|
||||||
|
- name: Build Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker build
|
||||||
|
|
||||||
|
- name: Health Check Worker
|
||||||
|
run: pnpm --filter @hivegrid/worker health
|
||||||
|
env:
|
||||||
|
WORKER_ENABLED: "false"
|
||||||
|
|
||||||
|
database:
|
||||||
|
name: Database Checks
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 20
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Generate database client
|
||||||
|
run: pnpm run db:generate
|
||||||
|
env:
|
||||||
|
DATABASE_URL: postgresql://hivegrid:hivegrid@localhost:5432/hivegrid?schema=public
|
||||||
|
|
||||||
|
- name: Verify migrations schema parity
|
||||||
|
run: pnpm run verify:migrations-parity
|
||||||
|
|
||||||
|
- name: Verify database migration status
|
||||||
|
if: github.event_name != 'pull_request'
|
||||||
|
run: pnpm run verify:db-migrate-status
|
||||||
|
env:
|
||||||
|
DATABASE_URL: ${{ secrets.DATABASE_URL }}
|
||||||
|
|
||||||
|
- name: Test database package
|
||||||
|
run: pnpm --filter @hivegrid/db test
|
||||||
|
|
||||||
|
docker-smoke:
|
||||||
|
name: Docker Smoke
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 30
|
||||||
|
needs: [quality, api, worker, database]
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Docker Buildx
|
||||||
|
uses: docker/setup-buildx-action@v3
|
||||||
|
|
||||||
|
- name: Build web Docker target
|
||||||
|
uses: docker/build-push-action@v7
|
||||||
|
with:
|
||||||
|
context: .
|
||||||
|
target: web
|
||||||
|
build-args: APP_REVISION=ci-smoke-revision
|
||||||
|
tags: hivegrid-web:smoke
|
||||||
|
load: true
|
||||||
|
push: false
|
||||||
|
cache-from: type=gha,scope=hivegrid-web-smoke
|
||||||
|
cache-to: type=gha,mode=max,scope=hivegrid-web-smoke
|
||||||
|
|
||||||
|
- name: Validate web Docker artifacts
|
||||||
|
run: docker run --rm --entrypoint /bin/sh hivegrid-web:smoke -lc 'test -f /myapp/apps/web/build/server/index.js && test -d /myapp/apps/web/build/client && test -f /myapp/build/server-runtime/server.js'
|
||||||
|
|
||||||
|
- name: Validate web Docker runtime
|
||||||
|
run: bash scripts/docker-web-runtime-smoke.sh hivegrid-web:smoke
|
||||||
|
|
||||||
|
- name: Build API Docker target
|
||||||
|
uses: docker/build-push-action@v7
|
||||||
|
with:
|
||||||
|
context: .
|
||||||
|
target: api
|
||||||
|
build-args: APP_REVISION=ci-smoke-revision
|
||||||
|
tags: hivegrid-api:smoke
|
||||||
|
load: true
|
||||||
|
push: false
|
||||||
|
cache-from: type=gha,scope=hivegrid-api-smoke
|
||||||
|
cache-to: type=gha,mode=max,scope=hivegrid-api-smoke
|
||||||
|
|
||||||
|
- name: Validate API Docker runtime
|
||||||
|
run: bash scripts/docker-api-runtime-smoke.sh hivegrid-api:smoke
|
||||||
|
|
||||||
|
- name: Build worker Docker target
|
||||||
|
uses: docker/build-push-action@v7
|
||||||
|
with:
|
||||||
|
context: .
|
||||||
|
target: worker
|
||||||
|
build-args: APP_REVISION=ci-smoke-revision
|
||||||
|
tags: hivegrid-worker:smoke
|
||||||
|
load: true
|
||||||
|
push: false
|
||||||
|
cache-from: type=gha,scope=hivegrid-worker-smoke
|
||||||
|
cache-to: type=gha,mode=max,scope=hivegrid-worker-smoke
|
||||||
|
|
||||||
|
- name: Validate worker Docker runtime
|
||||||
|
run: bash scripts/docker-worker-runtime-smoke.sh hivegrid-worker:smoke
|
||||||
|
|
||||||
|
- name: Validate Docker Compose config
|
||||||
|
run: docker compose config
|
||||||
|
|
||||||
|
resolve-sentry-environment:
|
||||||
|
name: Resolve Sentry environment
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 5
|
||||||
|
needs: docker-smoke
|
||||||
|
outputs:
|
||||||
|
environment: ${{ steps.resolve.outputs.environment }}
|
||||||
|
steps:
|
||||||
|
- name: Resolve target environment from ref
|
||||||
|
id: resolve
|
||||||
|
run: |
|
||||||
|
REF="${GITHUB_REF:-}"
|
||||||
|
if [ "$REF" = "refs/heads/main" ]; then
|
||||||
|
echo "environment=production" >> "$GITHUB_OUTPUT"
|
||||||
|
elif [ "$REF" = "refs/heads/staging" ]; then
|
||||||
|
echo "environment=staging" >> "$GITHUB_OUTPUT"
|
||||||
|
else
|
||||||
|
echo "environment=preview" >> "$GITHUB_OUTPUT"
|
||||||
|
fi
|
||||||
|
|
||||||
|
sentry-release-api:
|
||||||
|
name: Sentry release (api)
|
||||||
|
needs: resolve-sentry-environment
|
||||||
|
uses: ./.github/workflows/_sentry-release.yml
|
||||||
|
with:
|
||||||
|
project: hivegrid-api
|
||||||
|
environment: ${{ needs.resolve-sentry-environment.outputs.environment }}
|
||||||
|
sourcemaps-path: none
|
||||||
|
secrets:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
|
|
||||||
|
sentry-release-worker:
|
||||||
|
name: Sentry release (worker)
|
||||||
|
needs: resolve-sentry-environment
|
||||||
|
uses: ./.github/workflows/_sentry-release.yml
|
||||||
|
with:
|
||||||
|
project: hivegrid-worker
|
||||||
|
environment: ${{ needs.resolve-sentry-environment.outputs.environment }}
|
||||||
|
sourcemaps-path: none
|
||||||
|
secrets:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
|
|
||||||
|
sentry-release-web:
|
||||||
|
name: Sentry release (web)
|
||||||
|
needs: resolve-sentry-environment
|
||||||
|
uses: ./.github/workflows/_sentry-release.yml
|
||||||
|
with:
|
||||||
|
project: hivegrid-web
|
||||||
|
environment: ${{ needs.resolve-sentry-environment.outputs.environment }}
|
||||||
|
sourcemaps-path: apps/web/build/client
|
||||||
|
sourcemaps-artifact: web-client-sourcemaps
|
||||||
|
secrets:
|
||||||
|
SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
|
||||||
|
SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
|
||||||
|
SENTRY_URL: ${{ secrets.SENTRY_URL }}
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
name: "CLA Assistant"
|
||||||
|
on:
|
||||||
|
issue_comment:
|
||||||
|
types: [created]
|
||||||
|
pull_request_target:
|
||||||
|
types: [opened,closed,synchronize]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
CLAAssistant:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: "CLA Assistant"
|
||||||
|
if: (github.event.comment.body == 'recheck' || github.event.comment.body == 'I acknowledge that I have read the LegacySourceProduct CLA Document and I hereby sign the CLA. I acknowledge that I understand this code is not open source and for commercial purposes. I acknowledge that I am waiving all Intellectual Property Rights; including, but not limited to copyright.') || github.event_name == 'pull_request_target'
|
||||||
|
# Beta Release
|
||||||
|
uses: contributor-assistant/github-action@v2.2.0
|
||||||
|
env:
|
||||||
|
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
# the below token should have repo scope and must be manually added by you in the repository's secret
|
||||||
|
PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
|
||||||
|
with:
|
||||||
|
path-to-signatures: 'signatures/version1/cla.json'
|
||||||
|
path-to-document: 'https://gist.github.com/AlexandroMtzG/27a8c5dcc65735a8f744efff84e6693f'
|
||||||
|
branch: 'main'
|
||||||
|
allowlist: user1,bot*
|
||||||
|
custom-notsigned-prcomment: 'Thank you for your contribution, please kindly read and sign our [Contributor License Agreement](https://gist.github.com/AlexandroMtzG/27a8c5dcc65735a8f744efff84e6693f) by commenting the following:'
|
||||||
@@ -0,0 +1,80 @@
|
|||||||
|
name: Coverage
|
||||||
|
|
||||||
|
# Runs vitest with --coverage and the per-path threshold gate
|
||||||
|
# (scripts/verify-test-coverage.mjs reads scripts/coverage-targets.json).
|
||||||
|
# Uploads the lightweight gate summary as an artifact and posts a sticky PR
|
||||||
|
# comment with the coverage-summary.json totals.
|
||||||
|
#
|
||||||
|
# Docs: docs/architecture/test-coverage.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- "apps/**"
|
||||||
|
- "packages/**"
|
||||||
|
- "scripts/coverage-targets.json"
|
||||||
|
- "scripts/verify-test-coverage.mjs"
|
||||||
|
- "scripts/coverage-summary.mjs"
|
||||||
|
- "vitest.config.ts"
|
||||||
|
- ".github/workflows/coverage.yml"
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
pull-requests: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
coverage:
|
||||||
|
name: Measure coverage and gate thresholds
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 30
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Run vitest with coverage (enforces per-path gates)
|
||||||
|
env:
|
||||||
|
HIVEGRID_COVERAGE_GATE: "1"
|
||||||
|
run: pnpm run verify:test-coverage
|
||||||
|
|
||||||
|
- name: Upload coverage gate summary
|
||||||
|
if: always()
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: coverage-gate-summary-${{ github.run_id }}
|
||||||
|
path: coverage-gate/coverage-summary.json
|
||||||
|
retention-days: 14
|
||||||
|
|
||||||
|
- name: Render PR coverage comment
|
||||||
|
if: github.event_name == 'pull_request'
|
||||||
|
env:
|
||||||
|
COVERAGE_SUMMARY_PATH: coverage-gate/coverage-summary.json
|
||||||
|
run: node scripts/coverage-summary.mjs --pr-comment > coverage-comment.md
|
||||||
|
|
||||||
|
- name: Post sticky PR comment
|
||||||
|
if: github.event_name == 'pull_request'
|
||||||
|
uses: marocchino/sticky-pull-request-comment@v2
|
||||||
|
with:
|
||||||
|
header: coverage-report
|
||||||
|
path: coverage-comment.md
|
||||||
+198
@@ -0,0 +1,198 @@
|
|||||||
|
name: E2E Readiness
|
||||||
|
|
||||||
|
# Runs the deployed staging/readiness browser suite in fail-closed mode.
|
||||||
|
# Main CI intentionally remains browser-free; this lane proves the authenticated
|
||||||
|
# Playwright/mobile/a11y contract against a live target on schedule or demand.
|
||||||
|
#
|
||||||
|
# Docs: docs/testing/e2e-readiness.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
plugin_lifecycle_mutation:
|
||||||
|
description: "Operator-approved disposable run: persist plugin grant/revoke and enable/disable state"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
plugin_settings_write:
|
||||||
|
description: "Operator-approved disposable run: persist plugin settings iframe writes"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
workflow_outbox_drain:
|
||||||
|
description: "Operator-approved run: require worker/outbox drain to terminal WorkflowExecution status"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
workflow_webhook_run:
|
||||||
|
description: "Operator-approved run: execute the webhook workflow against workflow_webhook_target_url"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
workflow_webhook_target_url:
|
||||||
|
description: "Operator-owned disposable webhook target URL, required when workflow_webhook_run is true"
|
||||||
|
required: false
|
||||||
|
default: ""
|
||||||
|
type: string
|
||||||
|
subscription_success:
|
||||||
|
description: "Operator-approved run: require Stripe checkout success return smoke"
|
||||||
|
required: false
|
||||||
|
default: "false"
|
||||||
|
type: boolean
|
||||||
|
subscription_success_path:
|
||||||
|
description: "Externally acquired Stripe checkout success return path, required when subscription_success is true"
|
||||||
|
required: false
|
||||||
|
default: ""
|
||||||
|
type: string
|
||||||
|
schedule:
|
||||||
|
# 04:00 UTC nightly, after deploy and Lighthouse windows have settled.
|
||||||
|
- cron: "0 4 * * *"
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
|
||||||
|
env:
|
||||||
|
E2E_BASE_URL: https://app.hivegrid.de
|
||||||
|
E2E_A11Y_STRICT: "1"
|
||||||
|
E2E_BROWSER_MATRIX: "1"
|
||||||
|
E2E_ALLOW_WORKFLOW_RUN: "1"
|
||||||
|
REQUIRE_E2E_A11Y: "1"
|
||||||
|
REQUIRE_AUTH_E2E: "1"
|
||||||
|
REQUIRE_E2E_READINESS: "1"
|
||||||
|
E2E_REGISTRATION_EXPECTS_EMAIL_VERIFICATION: "0"
|
||||||
|
E2E_TENANT_ACCOUNT_NAME: E2E Readiness
|
||||||
|
E2E_TENANT_ACCOUNT_SLUG: e2e-readiness
|
||||||
|
E2E_TENANT_DASHBOARD_PATH: /e2e-readiness/dashboard
|
||||||
|
E2E_TENANT_SETTINGS_ACCOUNT_PATH: /e2e-readiness/settings/account
|
||||||
|
E2E_TENANT_SETTINGS_PROFILE_PATH: /e2e-readiness/settings/profile
|
||||||
|
E2E_TENANT_SUBSCRIPTION_PATH: /e2e-readiness/settings/subscription
|
||||||
|
E2E_TENANT_MEMBERS_PATH: /e2e-readiness/settings/members
|
||||||
|
E2E_TENANT_ROLES_AND_PERMISSIONS_PATH: /e2e-readiness/settings/roles-and-permissions
|
||||||
|
E2E_TENANT_NOTIFICATIONS_PATH: /e2e-readiness/settings/notifications
|
||||||
|
E2E_TENANT_LOGS_PATH: /e2e-readiness/settings/logs
|
||||||
|
E2E_TENANT_LOG_EVENTS_PATH: /e2e-readiness/settings/logs/events
|
||||||
|
E2E_TENANT_AUDIT_EXPORT_PATH: /e2e-readiness/settings/audit-export
|
||||||
|
E2E_TENANT_PRIVACY_PATH: /e2e-readiness/settings/privacy
|
||||||
|
E2E_TENANT_CHATBOT_PATH: /e2e-readiness/settings/chatbot
|
||||||
|
E2E_TENANT_AI_USAGE_PATH: /e2e-readiness/settings/ai-usage
|
||||||
|
E2E_TENANT_API_PATH: /e2e-readiness/settings/api
|
||||||
|
E2E_TENANT_API_KEYS_PATH: /e2e-readiness/settings/api/keys
|
||||||
|
E2E_TENANT_API_DOCS_PATH: /e2e-readiness/settings/api/docs
|
||||||
|
E2E_TENANT_API_LOGS_PATH: /e2e-readiness/settings/api/logs
|
||||||
|
E2E_TENANT_POLICIES_PATH: /e2e-readiness/settings/policies
|
||||||
|
E2E_TENANT_PORTAL_ANALYTICS_PATH: /e2e-readiness/portals/e2e-readiness/analytics
|
||||||
|
E2E_TENANT_PORTAL_SETTINGS_PATH: /e2e-readiness/portals/e2e-readiness/settings
|
||||||
|
E2E_ADMIN_EMAIL_SEQUENCES_PATH: /email-sequences
|
||||||
|
E2E_PLUGIN_SETTINGS_PATH: /e2e-readiness/settings/plugins
|
||||||
|
E2E_WORKFLOW_ENGINE_PATH: /e2e-readiness/workflow-engine/workflows
|
||||||
|
E2E_WORKFLOW_BUILDER_PATH: /e2e-readiness/workflow-engine/workflows/wf_123
|
||||||
|
E2E_WORKFLOW_RUN_API_PATH: /e2e-readiness/workflow-engine/workflows/wf_123/run/api
|
||||||
|
E2E_WORKFLOW_RUN_MANUAL_PATH: /e2e-readiness/workflow-engine/workflows/wf_123/run/manual
|
||||||
|
E2E_WORKFLOW_WEBHOOK_BUILDER_PATH: /e2e-readiness/workflow-engine/workflows/wf_webhook_123
|
||||||
|
E2E_WORKFLOW_WEBHOOK_RUN_MANUAL_PATH: /e2e-readiness/workflow-engine/workflows/wf_webhook_123/run/manual
|
||||||
|
E2E_WORKFLOW_WAITING_BUILDER_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123
|
||||||
|
E2E_WORKFLOW_WAITING_RUN_MANUAL_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123/run/manual
|
||||||
|
E2E_WORKFLOW_WAITING_RUN_API_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123/run/api
|
||||||
|
E2E_WORKFLOW_WAITING_EXECUTIONS_PATH: /e2e-readiness/workflow-engine/workflows/wf_waiting_123/executions
|
||||||
|
E2E_WORKFLOW_WAITING_EXECUTION_ID: wfe_waiting_123
|
||||||
|
PLUGIN_BINARY_BASE_PATH: /tmp/e2e-plugins
|
||||||
|
PLAYWRIGHT_BROWSERS_PATH: .cache/ms-playwright
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
readiness:
|
||||||
|
name: Strict Playwright readiness
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 45
|
||||||
|
env:
|
||||||
|
E2E_TENANT_EMAIL: ${{ secrets.E2E_TENANT_EMAIL }}
|
||||||
|
E2E_TENANT_PASSWORD: ${{ secrets.E2E_TENANT_PASSWORD }}
|
||||||
|
E2E_PLUGIN_READONLY_EMAIL: ${{ secrets.E2E_PLUGIN_READONLY_EMAIL }}
|
||||||
|
E2E_PLUGIN_READONLY_PASSWORD: ${{ secrets.E2E_PLUGIN_READONLY_PASSWORD }}
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout code
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Cache Playwright browsers
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .cache/ms-playwright
|
||||||
|
key: ${{ runner.os }}-playwright-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-playwright-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Install Playwright browsers
|
||||||
|
run: pnpm exec playwright install --with-deps chromium webkit
|
||||||
|
|
||||||
|
- name: Apply manual operator E2E opt-ins
|
||||||
|
if: ${{ github.event_name == 'workflow_dispatch' }}
|
||||||
|
# Bind dispatch inputs to env vars instead of interpolating ${{ inputs.* }}
|
||||||
|
# straight into the shell, so a crafted value cannot inject commands or
|
||||||
|
# extra lines into $GITHUB_ENV (CI script injection). Free-form URL/path
|
||||||
|
# inputs are additionally allowlist-validated before being written.
|
||||||
|
env:
|
||||||
|
OPT_PLUGIN_LIFECYCLE_MUTATION: ${{ inputs.plugin_lifecycle_mutation }}
|
||||||
|
OPT_PLUGIN_SETTINGS_WRITE: ${{ inputs.plugin_settings_write }}
|
||||||
|
OPT_WORKFLOW_OUTBOX_DRAIN: ${{ inputs.workflow_outbox_drain }}
|
||||||
|
OPT_WORKFLOW_WEBHOOK_RUN: ${{ inputs.workflow_webhook_run }}
|
||||||
|
OPT_WORKFLOW_WEBHOOK_TARGET_URL: ${{ inputs.workflow_webhook_target_url }}
|
||||||
|
OPT_SUBSCRIPTION_SUCCESS: ${{ inputs.subscription_success }}
|
||||||
|
OPT_SUBSCRIPTION_SUCCESS_PATH: ${{ inputs.subscription_success_path }}
|
||||||
|
run: |
|
||||||
|
if [ "$OPT_PLUGIN_LIFECYCLE_MUTATION" = "true" ]; then
|
||||||
|
echo "E2E_ALLOW_PLUGIN_LIFECYCLE_MUTATION=1" >> "$GITHUB_ENV"
|
||||||
|
fi
|
||||||
|
if [ "$OPT_PLUGIN_SETTINGS_WRITE" = "true" ]; then
|
||||||
|
echo "E2E_ALLOW_PLUGIN_SETTINGS_WRITE=1" >> "$GITHUB_ENV"
|
||||||
|
fi
|
||||||
|
if [ "$OPT_WORKFLOW_OUTBOX_DRAIN" = "true" ]; then
|
||||||
|
echo "E2E_REQUIRE_WORKFLOW_OUTBOX_DRAIN=1" >> "$GITHUB_ENV"
|
||||||
|
fi
|
||||||
|
if [ "$OPT_WORKFLOW_WEBHOOK_RUN" = "true" ]; then
|
||||||
|
echo "E2E_ALLOW_WORKFLOW_WEBHOOK_RUN=1" >> "$GITHUB_ENV"
|
||||||
|
case "$OPT_WORKFLOW_WEBHOOK_TARGET_URL" in
|
||||||
|
"") ;;
|
||||||
|
*[!a-zA-Z0-9:/?._~=%\&-]*) echo "Invalid workflow_webhook_target_url" >&2; exit 1 ;;
|
||||||
|
*) printf 'E2E_WORKFLOW_WEBHOOK_TARGET_URL=%s\n' "$OPT_WORKFLOW_WEBHOOK_TARGET_URL" >> "$GITHUB_ENV" ;;
|
||||||
|
esac
|
||||||
|
fi
|
||||||
|
if [ "$OPT_SUBSCRIPTION_SUCCESS" = "true" ]; then
|
||||||
|
echo "E2E_REQUIRE_SUBSCRIPTION_SUCCESS=1" >> "$GITHUB_ENV"
|
||||||
|
case "$OPT_SUBSCRIPTION_SUCCESS_PATH" in
|
||||||
|
"") ;;
|
||||||
|
*[!a-zA-Z0-9:/?._~=%\&-]*) echo "Invalid subscription_success_path" >&2; exit 1 ;;
|
||||||
|
*) printf 'E2E_TENANT_SUBSCRIPTION_SUCCESS_PATH=%s\n' "$OPT_SUBSCRIPTION_SUCCESS_PATH" >> "$GITHUB_ENV" ;;
|
||||||
|
esac
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Run strict E2E readiness suite
|
||||||
|
run: pnpm run verify:e2e-a11y
|
||||||
|
|
||||||
|
- name: Upload Playwright traces
|
||||||
|
if: always()
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: e2e-readiness-results
|
||||||
|
path: test-results/
|
||||||
|
if-no-files-found: ignore
|
||||||
|
retention-days: 14
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
name: Lighthouse CI
|
||||||
|
|
||||||
|
# GitHub mirror of .gitea/workflows/lighthouse.yml. Audits the deployed
|
||||||
|
# staging site (https://app.hivegrid.de) nightly + on manual dispatch.
|
||||||
|
# See the Gitea variant and docs/architecture/lighthouse.md for the rationale
|
||||||
|
# behind auditing a deployed environment rather than a CI-local server.
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
schedule:
|
||||||
|
# 03:00 UTC nightly — after the day's deploys have settled.
|
||||||
|
- cron: "0 3 * * *"
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
lighthouse:
|
||||||
|
name: Run Lighthouse audits
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 30
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Mint Lighthouse session cookie
|
||||||
|
run: node scripts/rotate-lighthouse-session-cookie.mjs
|
||||||
|
env:
|
||||||
|
LIGHTHOUSE_LOGIN_URL: https://app.hivegrid.de/login
|
||||||
|
LIGHTHOUSE_LOGIN_EMAIL: ${{ secrets.LIGHTHOUSE_LOGIN_EMAIL }}
|
||||||
|
LIGHTHOUSE_LOGIN_PASSWORD: ${{ secrets.LIGHTHOUSE_LOGIN_PASSWORD }}
|
||||||
|
LIGHTHOUSE_SESSION_COOKIE: ${{ secrets.LIGHTHOUSE_SESSION_COOKIE }}
|
||||||
|
LIGHTHOUSE_SESSION_COOKIE_NAME: hivegrid_session
|
||||||
|
LIGHTHOUSE_COOKIE_DOMAIN: app.hivegrid.de
|
||||||
|
|
||||||
|
- name: Run Lighthouse-CI against staging
|
||||||
|
# ubuntu-latest ships Chrome pre-installed; no browser setup needed.
|
||||||
|
run: npx --yes @lhci/cli@0.13.x autorun --config=./.lighthouserc.staging.json
|
||||||
|
|
||||||
|
- name: Upload Lighthouse artifacts
|
||||||
|
if: always()
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: lighthouse-ci-results
|
||||||
|
path: .lighthouseci/
|
||||||
|
retention-days: 14
|
||||||
@@ -0,0 +1,83 @@
|
|||||||
|
name: SDK Codegen Drift
|
||||||
|
|
||||||
|
# Re-runs the @hivegrid/api-client-ts generation pipeline on PRs that touch
|
||||||
|
# the upstream OpenAPI surface (apps/api/src/openapi.ts) or the SDK package
|
||||||
|
# itself, then verifies the committed src/generated/ tree is in sync with
|
||||||
|
# the captured openapi.json.
|
||||||
|
#
|
||||||
|
# Drift is a hard failure: regenerating + committing is part of the PR.
|
||||||
|
#
|
||||||
|
# Docs: docs/sdks/typescript.md
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- "apps/api/src/openapi.ts"
|
||||||
|
- "apps/api/src/openapi.test.ts"
|
||||||
|
- "packages/api-client-ts/**"
|
||||||
|
- "packages/api-types/**"
|
||||||
|
- ".github/workflows/sdk-codegen.yml"
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
pull-requests: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
drift-check:
|
||||||
|
name: Verify SDK codegen is in sync with OpenAPI spec
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
timeout-minutes: 15
|
||||||
|
steps:
|
||||||
|
- name: Checkout PR head
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enable Corepack
|
||||||
|
run: corepack enable
|
||||||
|
|
||||||
|
- name: Prepare pnpm 10.33.0
|
||||||
|
run: corepack prepare pnpm@10.33.0 --activate
|
||||||
|
|
||||||
|
- name: Configure pnpm store
|
||||||
|
run: pnpm config set store-dir .pnpm-store
|
||||||
|
|
||||||
|
- name: Cache pnpm store
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .pnpm-store
|
||||||
|
key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pnpm-
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile --prefer-offline
|
||||||
|
|
||||||
|
- name: Regenerate OpenAPI capture
|
||||||
|
run: pnpm --filter @hivegrid/api-client-ts generate-spec
|
||||||
|
|
||||||
|
- name: Regenerate typed client (Hey-API)
|
||||||
|
run: pnpm --filter @hivegrid/api-client-ts generate
|
||||||
|
|
||||||
|
- name: Fail if generated code drifts from committed state
|
||||||
|
run: |
|
||||||
|
if ! git diff --exit-code --stat \
|
||||||
|
packages/api-client-ts/openapi.json \
|
||||||
|
packages/api-client-ts/src/generated; then
|
||||||
|
echo ""
|
||||||
|
echo "SDK codegen drift detected. Run:"
|
||||||
|
echo ""
|
||||||
|
echo " pnpm --filter @hivegrid/api-client-ts generate:all"
|
||||||
|
echo ""
|
||||||
|
echo "then commit packages/api-client-ts/openapi.json and packages/api-client-ts/src/generated/."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo "SDK codegen is in sync with the upstream OpenAPI spec."
|
||||||
|
|
||||||
|
- name: Typecheck SDK packages
|
||||||
|
run: |
|
||||||
|
pnpm --filter @hivegrid/api-client-ts typecheck
|
||||||
|
pnpm --filter @hivegrid/api-types typecheck
|
||||||
|
|
||||||
|
- name: Run SDK tests
|
||||||
|
run: |
|
||||||
|
pnpm --filter @hivegrid/api-client-ts test
|
||||||
|
pnpm --filter @hivegrid/api-types test
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
node_modules
|
||||||
|
.DS_Store
|
||||||
|
**/.DS_Store
|
||||||
|
|
||||||
|
.cache
|
||||||
|
.env
|
||||||
|
.env.*
|
||||||
|
!.env.example
|
||||||
|
!.env.local.example
|
||||||
|
!.env.production.example
|
||||||
|
!.env.test
|
||||||
|
.vercel
|
||||||
|
.output
|
||||||
|
|
||||||
|
/build/
|
||||||
|
/public/build
|
||||||
|
/apps/web/public/build
|
||||||
|
/apps/*/dist/
|
||||||
|
/packages/*/dist/
|
||||||
|
/apps/web/app/styles/app.css
|
||||||
|
|
||||||
|
# Supabase
|
||||||
|
**/supabase/.branches
|
||||||
|
**/supabase/.temp
|
||||||
|
**/supabase/.env
|
||||||
|
|
||||||
|
prisma/*.db
|
||||||
|
prisma/schema/*.db
|
||||||
|
|
||||||
|
.idea
|
||||||
|
apps/web/app/styles/app.css
|
||||||
|
apps/web/app/styles/app.css
|
||||||
|
|
||||||
|
vite.config.ts.timestamp*
|
||||||
|
|
||||||
|
openai/files
|
||||||
|
aws-lightsail-containers.json
|
||||||
|
tsconfig.tsbuildinfo
|
||||||
|
|
||||||
|
.react-router/
|
||||||
|
**/.react-router/
|
||||||
|
apps/web/app/generated/prisma/
|
||||||
|
.claude/
|
||||||
|
.cursor
|
||||||
|
__pycache__
|
||||||
|
|
||||||
|
# ── TC baseline (auto-generated) ──
|
||||||
|
.tc
|
||||||
|
.tc-id
|
||||||
|
.bg-shell/
|
||||||
|
Thumbs.db
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
.idea/
|
||||||
|
.vscode/
|
||||||
|
*.code-workspace
|
||||||
|
node_modules/
|
||||||
|
.next/
|
||||||
|
dist/
|
||||||
|
build/
|
||||||
|
!apps/web/app/utils/build/
|
||||||
|
!apps/web/app/utils/build/**
|
||||||
|
__pycache__/
|
||||||
|
*.pyc
|
||||||
|
.venv/
|
||||||
|
venv/
|
||||||
|
target/
|
||||||
|
vendor/
|
||||||
|
*.log
|
||||||
|
coverage/
|
||||||
|
coverage-gate/
|
||||||
|
.cache/
|
||||||
|
tmp/
|
||||||
|
|
||||||
|
evals/results/injection-vectors.json
|
||||||
|
evals/results/injection-vectors.html
|
||||||
|
|
||||||
|
# SBOM produced by scripts/generate-sbom.mjs (build-time artifact, shipped inside Docker images)
|
||||||
|
sbom-pnpm.json
|
||||||
|
|
||||||
|
# Plugin runtime external-audit packages (scripts/build-plugin-audit-package.sh output)
|
||||||
|
artifacts/plugin-audit/
|
||||||
|
|
||||||
|
# GSD baseline (auto-generated)
|
||||||
|
.gsd
|
||||||
|
.gsd-id
|
||||||
|
.mcp.json
|
||||||
|
nul
|
||||||
|
nul.*
|
||||||
|
con
|
||||||
|
con.*
|
||||||
|
prn
|
||||||
|
prn.*
|
||||||
|
aux
|
||||||
|
aux.*
|
||||||
|
com[1-9]
|
||||||
|
com[1-9].*
|
||||||
|
lpt[1-9]
|
||||||
|
lpt[1-9].*
|
||||||
@@ -0,0 +1,37 @@
|
|||||||
|
{
|
||||||
|
"ci": {
|
||||||
|
"collect": {
|
||||||
|
"url": [
|
||||||
|
"http://localhost:3000/",
|
||||||
|
"http://localhost:3000/pricing",
|
||||||
|
"http://localhost:3000/contact",
|
||||||
|
"http://localhost:3000/login",
|
||||||
|
"http://localhost:3000/app/demo/dashboard",
|
||||||
|
"http://localhost:3000/app/demo/crm",
|
||||||
|
"http://localhost:3000/app/demo/settings/members",
|
||||||
|
"http://localhost:3000/admin/dashboard",
|
||||||
|
"http://localhost:3000/admin/analytics"
|
||||||
|
],
|
||||||
|
"numberOfRuns": 3,
|
||||||
|
"puppeteerScript": "./scripts/lighthouse-puppeteer-auth.cjs",
|
||||||
|
"settings": {
|
||||||
|
"preset": "desktop"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"assert": {
|
||||||
|
"assertions": {
|
||||||
|
"categories:performance": ["error", { "minScore": 0.95 }],
|
||||||
|
"categories:accessibility": ["warn", { "minScore": 0.95 }],
|
||||||
|
"categories:best-practices": ["warn", { "minScore": 0.95 }],
|
||||||
|
"categories:pwa": ["warn", { "minScore": 0.9 }],
|
||||||
|
"first-contentful-paint": ["warn", { "maxNumericValue": 2500 }],
|
||||||
|
"largest-contentful-paint": ["warn", { "maxNumericValue": 3500 }],
|
||||||
|
"total-blocking-time": ["warn", { "maxNumericValue": 300 }],
|
||||||
|
"cumulative-layout-shift": ["warn", { "maxNumericValue": 0.1 }]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"upload": {
|
||||||
|
"target": "temporary-public-storage"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
{
|
||||||
|
"ci": {
|
||||||
|
"collect": {
|
||||||
|
"url": [
|
||||||
|
"https://boiler.saas-ctrl.com/login",
|
||||||
|
"https://boiler.saas-ctrl.com/privacy-policy",
|
||||||
|
"https://boiler.saas-ctrl.com/terms-and-conditions"
|
||||||
|
],
|
||||||
|
"puppeteerScript": "./scripts/lighthouse-puppeteer-auth.cjs",
|
||||||
|
"numberOfRuns": 3,
|
||||||
|
"settings": {
|
||||||
|
"preset": "desktop",
|
||||||
|
"chromeFlags": "--no-sandbox --disable-dev-shm-usage"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"assert": {
|
||||||
|
"assertions": {
|
||||||
|
"categories:performance": ["error", { "minScore": 0.95 }],
|
||||||
|
"categories:accessibility": ["warn", { "minScore": 0.95 }],
|
||||||
|
"categories:best-practices": ["warn", { "minScore": 0.95 }],
|
||||||
|
"categories:pwa": ["warn", { "minScore": 0.9 }],
|
||||||
|
"first-contentful-paint": ["warn", { "maxNumericValue": 2500 }],
|
||||||
|
"largest-contentful-paint": ["warn", { "maxNumericValue": 3500 }],
|
||||||
|
"total-blocking-time": ["warn", { "maxNumericValue": 300 }],
|
||||||
|
"cumulative-layout-shift": ["warn", { "maxNumericValue": 0.1 }]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"upload": {
|
||||||
|
"target": "temporary-public-storage"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
v22.12.0
|
||||||
@@ -0,0 +1,177 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 16mm
|
||||||
|
css: |-
|
||||||
|
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
|
||||||
|
h1 { font-size: 19px; } h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; }
|
||||||
|
table { font-size: 9.5px; border-collapse: collapse; width: 100%; }
|
||||||
|
th, td { border: 1px solid #ccc; padding: 3px 5px; text-align: left; vertical-align: top; }
|
||||||
|
th { background: #fff7e8; }
|
||||||
|
code, pre { background: #f4f4f4; font-size: 9px; }
|
||||||
|
pre { padding: 8px; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# Designer-First Playbook — HiveGrid 2.0
|
||||||
|
|
||||||
|
Ausführungsplan für den Fall: **Designer baut Screens zuerst, Backend wird dagegen gebaut.**
|
||||||
|
Erstellt: 2026-06-08. Basiert auf ROADMAP.md (21 Phasen) + der Hot-Swap-Architektur (Phase 1, M013–M017).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. Das Grundprinzip
|
||||||
|
|
||||||
|
- **Backend-Abhängigkeit** läuft 1→21 (Datenmodell vor Features). Das ist DEINE Reihenfolge.
|
||||||
|
- **Design-Abhängigkeit** läuft über **wiederverwendbare Archetypen**, NICHT über die Phasen-Nummern. Das ist die Reihenfolge des **Designers**.
|
||||||
|
- Beide Tracks brauchen **je ein Fundament zuerst**:
|
||||||
|
- Backend-Fundament = **Phase 1** (VM/Adapter/ui-mock/Visual-Reg/Smoke-Harness). Blockt alles.
|
||||||
|
- Design-Fundament = **Sprint D0** (Design-System + App-Shell + Archetypen). Blockt ~70% aller Screens.
|
||||||
|
- Danach läuft der **Designer 1–2 Phasen vor dir**. Du baust Backend gegen fertige Screens.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Die zwei Fundamente (Block 0 — parallel)
|
||||||
|
|
||||||
|
| Track | Wer | Inhalt | Fertig wenn |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Backend-Fundament = Phase 1 | Du | Boilerplate, EU-Sterilisation, VM-Konvention, Action-Callback, Subframe-Adapter, ui-mock, Visual-Reg-Gate, Hot-Swap-Drill | Hot-Swap-Drill grün; 1 Beispiel-Route lädt VM gegen Mock |
|
||||||
|
| Design-Fundament = Sprint D0 | Designer | Subframe-Design-System (Tokens, Farben, Typo, Spacing) + App-Shell (Sidebar/Breadcrumb/Topbar) + die 5 Archetypen + Zustands-Kit | Alle Archetypen + Zustände in Subframe vorhanden |
|
||||||
|
|
||||||
|
**Diese beiden laufen GLEICHZEITIG.** Solange beide nicht stehen, gibt es kein sauberes designer-first.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Die Archetypen (= die Design-Dependency-Map)
|
||||||
|
|
||||||
|
Jeder Archetyp wird **einmal** designt und von vielen Phasen konsumiert. Reihenfolge = nach Hebel.
|
||||||
|
|
||||||
|
| # | Archetyp | Einmal designen → diese Screens werden „compose" |
|
||||||
|
|---|----------|---|
|
||||||
|
| A1 | **App-Shell** (Sidebar, Breadcrumb, Topbar, Nav) | ALLE Phasen |
|
||||||
|
| A2 | **List-View** (Filterbar, Tabelle/Cards, Bulk-Bar, Pagination, Spalten-Config, CSV, Leerzustand) | P6, P7, P8(Liste), P4(Tasks/Files), P3(Audit-Viewer/Notif-Center), P14(Segmente), P19(Tenant-Liste + Flag-Admin), P21(Help-Artikel) |
|
||||||
|
| A3 | **Detail-View** (Header+Quick-Actions, Inline-Edit-Feld, Related-Panels, Activity-Sidebar, Custom-Felder) | P6(Contact/Company/Lead), P8(Deal), P9(Projekt), P17(HR-Profil), P18(Portal-Projekt) |
|
||||||
|
| A4 | **Form/Input-Kit** (alle 12 Feldtypen, Validierung, Datei-Feld, Select/Multiselect) | P6(Custom-Felder), P16(Form-Builder), P20(Onboarding), P2(Auth-Forms), jedes Create/Edit |
|
||||||
|
| A5 | **Modal/Wizard** (mehrstufig, Bestätigungs-Dialog, Side-Panel) | P6(Lead-Promotion), P20(Onboarding-Wizard), Bestätigungen überall |
|
||||||
|
| A6 | **Settings/Connection-Cards** (Toggle, Connection-Status, Key-Eingabe) | P5(Apps-Engine), P3(Feature-Flags), P20(Billing/Branding), P19(Admin) |
|
||||||
|
| A7 | **Zustands-Kit** (Leer / Laden-Skeleton / Fehler / keine-Berechtigung) | ALLE — Pflicht laut VM-Konvention (Loading/Error sind VM-Zustände) |
|
||||||
|
|
||||||
|
**Konsequenz:** Sind A1–A7 fertig (= Sprint D0), kann der Designer ~70% der Screens in Stunden statt Tagen zusammenstecken.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Die Bespoke-Screens (Sonderfälle — früh starten!)
|
||||||
|
|
||||||
|
Diese nutzen kaum Archetypen, brauchen die meiste Iteration → **so früh wie möglich starten, auch wenn das Backend noch fern ist.** Sortiert nach Vorlaufzeit (längste zuerst):
|
||||||
|
|
||||||
|
| Rang | Bespoke-Screen | Phase | Aufwand | Warum früh |
|
||||||
|
|---|---|:---:|---|---|
|
||||||
|
| 1 | **Automation Flow-/Node-Editor** | P12 | 🔴 sehr hoch | Schwierigste UI der ganzen App; viele Iterationen |
|
||||||
|
| 2 | **Form-Builder-Canvas** (Drag-Drop) | P16 | 🔴 sehr hoch | Komplexe Interaktion + Conditional-Logic-Editor |
|
||||||
|
| 3 | **Plantafel / Scheduling-Board** | P9 | 🟠 hoch | Custom-Grid, Drag pro Monteur/Tag, offline |
|
||||||
|
| 4 | **Dashboard + Widget-Grid + Cmd+K** | P11 | 🟠 hoch | Widget-System + Command-Palette = 2 Sonder-UIs |
|
||||||
|
| 5 | **Customer-Portal-Shell** | P18 | 🟠 hoch | **Extern sichtbar** — eigene Design-Sprache, höchster Polish |
|
||||||
|
| 6 | **Mobile-PWA-Shell** (installierbare PWA) | P27 (v2) | 🟠 hoch | Eigenes Touch-Paradigma (Tab-Bar, offline) — PWA-only, kein nativer Client (AD-17) |
|
||||||
|
| 7 | **Kalender-View** | P16 | 🟡 mittel | Standard-aber-eigen (Monats/Wochen-Grid) |
|
||||||
|
| 8 | **Team-Chat / HiveMind-Chat** | P15/P13 | 🟡 mittel | Message-Liste + Composer + Presence |
|
||||||
|
| 9 | **Sales-Kanban** | P8 | 🟡 mittel | Spalten + Draggable-Cards |
|
||||||
|
| 10 | **Öffentliche Booking-Seiten** | P16 | 🟡 mittel | **Extern sichtbar** — Slot-Picker, Branding |
|
||||||
|
| 11 | **Help-Center** (public) | P21 | 🟡 mittel | Content-Site, SEO, Suche |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Designer-Reihenfolge (die Antwort auf „welche Screens zuerst")
|
||||||
|
|
||||||
|
```
|
||||||
|
D0 Design-Fundament System + App-Shell + Archetypen A1–A7 + Zustände ◄── ZUERST, höchster Hebel
|
||||||
|
│
|
||||||
|
D1 CRM-Cluster (P6) Contact/Company/Lead-Liste + Detail + Lead-Promo-Modal + Custom-Feld-UI
|
||||||
|
│ → etabliert das dominante Muster für den halben Rest
|
||||||
|
│
|
||||||
|
D2 Bespoke früh starten (PARALLEL, lange Vorlaufzeit):
|
||||||
|
├─ Flow-Editor (P12) ◄── längste Vorlaufzeit, JETZT anfangen
|
||||||
|
├─ Form-Builder (P16)
|
||||||
|
├─ Plantafel (P9)
|
||||||
|
└─ Dashboard + Cmd+K (P11)
|
||||||
|
│
|
||||||
|
D3 CRUD-Feature-Screens (schnell, reuse Archetypen):
|
||||||
|
Lead-Inbox (P7), Sales-Liste+Kanban (P8), Tasks/Files (P4),
|
||||||
|
Email/Marketing (P14), HR (P17), Auth-Screens (P2)
|
||||||
|
│
|
||||||
|
D4 Extern/Brand-kritisch (eigene Politur-Runde):
|
||||||
|
Customer-Portal (P18), Booking-public (P16), Onboarding-Wizard (P20),
|
||||||
|
Help-Center + Mobile (P21)
|
||||||
|
│
|
||||||
|
D5 Niedriger Polish-Druck (intern), dazwischen:
|
||||||
|
Plattform-Admin (P19), Settings (P5/P3), KI-Chat (P13)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Kurzantwort:** **Design-Fundament → CRM → parallel die 4 Bespoke-Langläufer (Flow-Editor, Form-Builder, Plantafel, Dashboard).**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Backend-Track (deine Reihenfolge) mit Parallelisierung
|
||||||
|
|
||||||
|
Du baust sequenziell, aber der Designer liegt vor dir. Pro Block: was du baust + was der Designer geliefert haben muss.
|
||||||
|
|
||||||
|
| Block | Deine Phasen (Backend) | Designer muss fertig haben | Charakter |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **0** | **P1** Fundament | D0 läuft parallel | Infra, kein Design nötig |
|
||||||
|
| **1** | P2, P3, P4, P5 | D0 fertig; D1(CRM) + D2(Bespoke) laufen | Auth/Plumbing/Files/Apps-Engine — backend-lastig |
|
||||||
|
| **2** | **P6, P7, P8, P9** (SHK-Kernpfad) | CRM, Lead, Sales-Kanban, Plantafel | erste echte Screens — Noah-Validierung startet |
|
||||||
|
| **3** | **P10** KWP | — (kein UI) | reines Backend |
|
||||||
|
| **4** | P11, P12, P13 | Dashboard/Cmd+K, Flow-Editor, KI-Chat | USP-Säulen — Bespoke muss bereitliegen |
|
||||||
|
| **5** | P14, P15, P16 | Email, Chat, Form-Builder, Kalender, Booking | Kommunikation |
|
||||||
|
| **6** | P17, P18 | HR, **Customer-Portal (extern)** | Menschen/extern |
|
||||||
|
| **7** | P19, P20, P21 | Admin, Onboarding, **Mobile**, Help | Plattform & Launch |
|
||||||
|
|
||||||
|
**Reorder-Spielraum (echte Deps, nicht 1→21-Zwang):** P14/P15 hängen nur an P6+P5, P16 an P7+P5, P17 an P4, P19 an P3. Heißt: sobald CRM (P6) steht, könntest du Email (P14) oder Telefonie (P15) vorziehen, falls ein Screen früher fertig ist. P10 (KWP) kann jederzeit nach P9 laufen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Verifikations-Gates (was du wo prüfst)
|
||||||
|
|
||||||
|
### 6a. Pro Screen — die Designer→Backend-Übergabe (Checkliste)
|
||||||
|
|
||||||
|
```
|
||||||
|
[ ] 1. UI-SPEC existiert /gsd-ui-phase N → Element-Liste + Zustände + Interaktionen
|
||||||
|
[ ] 2. Screen designt Designer liefert Subframe-Screen (aus der Element-Liste!)
|
||||||
|
[ ] 3. RECONCILIATION ◄── kritischster Check:
|
||||||
|
[ ] jedes angezeigte Feld hat eine Datenquelle (Modell/Spec)? (keine „unmöglichen Daten")
|
||||||
|
[ ] jede Aktion/Button mappt auf eine Domänen-Operation?
|
||||||
|
[ ] Zustände designt: leer / laden / Fehler / keine-Berechtigung?
|
||||||
|
[ ] 4. VM ableiten VM-Typ + Action-Callbacks aus dem Screen lesen
|
||||||
|
[ ] 5. Backend bauen /gsd-plan-phase N (Planner baut Loader/Actions gegen das VM) → execute
|
||||||
|
[ ] 6. Integration Adapter bindet Screen an VM → Smoke-Test grün
|
||||||
|
[ ] 7. Visual-Reg-Baseline Playwright-Baseline für den Screen setzen
|
||||||
|
[ ] 8. Hot-Swap-Drill CI tauscht gegen ui-mock → läuft noch? (beweist saubere Trennung)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6b. Pro Phase — GSD-Gates (automatisch)
|
||||||
|
|
||||||
|
- **Source-Coverage-Audit** (Planner): jedes Phase-Requirement in einem Plan.
|
||||||
|
- **must_haves** (goal-backward): Truths/Artefakte/Key-Links erfüllt.
|
||||||
|
- **plan-checker**: Pläne erreichen das Ziel (vor dem Bauen, Loop ≤3×).
|
||||||
|
- **execute-phase Verifier**: Phasen-Ziel goal-backward erfüllt.
|
||||||
|
|
||||||
|
### 6c. Projektweit — Dauergates (CI, jeder Merge)
|
||||||
|
|
||||||
|
- **ESLint**: kein React-Import im VM-Paket (erzwingt Trennung).
|
||||||
|
- **Smoke-Test pro Route** (gegen ui-mock).
|
||||||
|
- **Visual-Regression**: Diff > Threshold → Build bricht mit Klartext-Liste betroffener Screens.
|
||||||
|
- **Hot-Swap-Drill**: ui-mock-Tausch muss grün bleiben.
|
||||||
|
|
||||||
|
### 6d. Stakeholder — Noah/Geerkens (AD-19)
|
||||||
|
|
||||||
|
Nach jeder UI-Phase: **PROGRESS-TRACKER-Klick-Pfad** → Noah validiert den echten Screen. Designer-first ist hier im Vorteil: Noah sieht reale Screens früh, nicht erst beim Big-Bang.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Die drei kritischen Erfolgsregeln
|
||||||
|
|
||||||
|
1. **Designer designt aus der UI-SPEC-Element-Liste**, nicht frei — sonst Reconciliation-Hölle (Screens mit Daten, die's nicht gibt).
|
||||||
|
2. **Phase 1 zuerst, ohne Kompromiss** — die Hot-Swap-Maschine ist die Voraussetzung, dass ein Screen überhaupt andocken kann.
|
||||||
|
3. **Bespoke-Langläufer (Flow-Editor, Form-Builder) sofort starten** — sie sind der kritische Pfad des Design-Tracks, auch wenn ihr Backend (P12/P16) erst spät kommt.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Erstellt 2026-06-08 als Ergänzung zu ROADMAP.md / PHASE-SOURCES.md für den designer-first-Modus.*
|
||||||
Binary file not shown.
@@ -0,0 +1,319 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 14mm
|
||||||
|
css: |-
|
||||||
|
body { font-size: 10px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
|
||||||
|
h1 { font-size: 18px; }
|
||||||
|
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
|
||||||
|
h3 { font-size: 11.5px; margin-top: 12px; break-after: avoid; page-break-after: avoid; }
|
||||||
|
table { font-size: 8.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
|
||||||
|
thead { display: table-header-group; }
|
||||||
|
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
|
||||||
|
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
|
||||||
|
th { background: #fff7e8; }
|
||||||
|
li { break-inside: avoid; }
|
||||||
|
p { orphans: 3; widows: 3; }
|
||||||
|
pre { background: #f4f4f4; padding: 8px; font-size: 8.5px; break-inside: avoid; }
|
||||||
|
code { background: #f4f4f4; padding: 1px 3px; font-size: 8.5px; }
|
||||||
|
.pagebreak { page-break-after: always; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# ENTITÄTENMODELL HiveGrid 2.0
|
||||||
|
|
||||||
|
**Stand:** 16.06.2026 · **Status: ✅ APPROVED & LOCKED** (Projekt-zentrisch, AD-20; **offene Modellierungs-Fragen entschieden 16.06.**, s.u.) · **Quelle:** Davids konsolidiertes CRM/Pipeline-Briefing (`HiveGrid_CRM_Datenlogik_UX_Entscheidungen.md`) für den Kern + Modul-Specs (`_bmad-output/specs/`, Block A) für die unveränderten Domänen.
|
||||||
|
|
||||||
|
> ✅ **Projekt-zentrisches Modell (AD-20) — verbindlich.** Der CRM/Pipeline-Kern: EIN `Projekt`-Kern + konfigurierbare **Pipeline-Views** + **Pipeline-Feld-Config-Layer**; `Kontakt`-Oberbegriff (Kontakttyp/-status/-art); **Lead → Projekt**; **Rechnung** als Sub-Entity (v1); **Abnahme** als Checklisten/Protokoll-Sub-Area. „Deal" und „Auftrag" sind **Pipeline-Typen, keine eigenen Entitäten**. Maschinenlesbar: `entity-model.dbml` (ER-Diagramm: `entity-model.svg`). Laienfassung: `ENTITY-MODELL-ERKLAERUNG.pdf`. **Hinweis zu den Domänen 6–13 unten** (Auth, Files, Apps, Suche, Automation/KI, Kommunikation, Kalender/Forms, HR, Admin, Billing, Onboarding): vom Pivot unberührt — wo dort `Deal`/`Project` steht, ist der `Projekt`-Kern gemeint, wo `Contact`/`Company` steht, der `Kontakt`-Oberbegriff.
|
||||||
|
|
||||||
|
## Lies das zuerst (3 Architektur-Grundregeln)
|
||||||
|
|
||||||
|
1. **First-Class-Tabellen + Konfig-Layer, KEIN Entity-Builder (AD-2, revidiert).** Jede Entität ist eine typisierte Prisma-Tabelle mit echten Spalten. Der `Projekt`-Kern ist EINE typisierte Tabelle (Superset der Felder); Konfigurierbarkeit läuft über `CustomFieldDefinition`+`CustomFieldValue` **und** den **Pipeline-Feld-Config-Layer** (`PipelineFieldConfig`: Sichtbarkeit/Pflicht je Pipeline+Status). Der Boilerplate-`entityBuilder.prisma` (Entity/Row/RowValue) bleibt **entfernt** — kein generisches Row/RowValue-Modell.
|
||||||
|
2. **RLS auf allem Tenant-bezogenen (AD-1).** Fast jede Tabelle hat `tenant_id` + Postgres-Row-Level-Security. Ausnahmen: globale Definitions-Tabellen (App, SubscriptionProduct, FeatureFlag, Onboarding-Templates, Subprocessor) und die Plattform-Admin-Welt (eigene Trennung).
|
||||||
|
3. **Polymorphe Verknüpfung statt harter FKs, wo es modulübergreifend ist.** `FileEntityLink`, `Activity`, `SearchIndexEntry`, `Task.linked_entity` nutzen `entity_type` + `entity_id` (kein FK), damit jedes Modul andocken kann, ohne das Schema zu ändern.
|
||||||
|
|
||||||
|
**Legende:** `[v1]` = Launch-Scope · `[v2]` = nach Launch (markiert, nicht weggelassen) · Flags: `[RLS]` `[Soft-Delete]` (archived_at) `[polymorph]` `[verschlüsselt]` `[append-only]`
|
||||||
|
|
||||||
|
## Die Kern-Kette (das Herzstück, hier zählt jede Relation)
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─ Pipeline (View) ─1:N─ PipelineStage (= Status; offen/gewonnen/verloren)
|
||||||
|
│ └─1:N─ PipelineAccess (wer darf sehen/bearbeiten)
|
||||||
|
│ └─1:N─ PipelineFieldConfig (Feld sichtbar/pflicht je Pipeline+Status)
|
||||||
|
Lead ──Weiterverar- ▼ N:1
|
||||||
|
(Vorstufe) beitungsfrei- PROJEKT ◀──M:N (Rolle)──▶ Kontakt ◀──self-ref (Rolle: haupt/sekundär)──▶ Kontakt
|
||||||
|
│ gabe=ja ──────▶ │ (EIN Kern: Deal- + Auftrags-Felder) (Privatperson | Organisation)
|
||||||
|
│ konvertiert_ │
|
||||||
|
│ projekt_id ├─1:N─▶ Termin · Rechnung [v1 NEU] · Aufgabe · Aktivität · Dokument
|
||||||
|
└ verknuepfter_ ├─1:N─▶ Checkliste ─1:N─▶ ChecklistItem (Mängel = Checkliste)
|
||||||
|
kontakt_id ├─1:N─▶ AbnahmeProtokoll ─1:N─▶ AbnahmeSignatur (immutable; Kunde+Monteur)
|
||||||
|
├─1:N─▶ ProjektMitglied (Monteure, Rolle)
|
||||||
|
└─1:N─▶ ProjektExternesFeld [v2] (KWP/API — komplett v2, in v1 NICHT)
|
||||||
|
```
|
||||||
|
|
||||||
|
Merksätze: **Es gibt nur einen Arbeitsdatensatz — das Projekt.** „Deal" und „Auftrag" sind Pipelines (Views), keine Entitäten — ein Projekt wechselt nur die Pipeline, es entsteht kein zweiter Datensatz und kein Won-Handoff. **`Status` ist immer pipeline-intern** (kein globaler Projektstatus). **Lead → Projekt** bei Weiterverarbeitungsfreigabe; der Kontakt wird separat verknüpft (kein Promotion-Modal mehr). **Kontakt ist Oberbegriff** (Privatperson/Organisation); Haupt-/Sekundärkontakt = Rolle einer Kontakt-Relation. **AbnahmeProtokoll bleibt rechtlich bindend** (immutable, 6 Jahre, signatur-gebunden) und bindet eine Mängel-Checkliste ein.
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## Cross-Cutting-Entitäten (modulübergreifend - zuerst verstehen!)
|
||||||
|
|
||||||
|
Diese werden von vielen Modulen geschrieben/referenziert. Sie sind der Grund, warum das Modell erweiterbar bleibt.
|
||||||
|
|
||||||
|
| Entität | Modul | Rolle | Schlüssel |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **Activity** [v1] | CRM | Event-Sourcing-Zentrale: jedes Modul schreibt Aktivitäten hierher, ein Stream liest sie | `subject_type` + `subject_id` (polymorph) · `actor_kind` (user/system/automation/ki_agent) · `activity_type` (~30 Typen) · `related_entity_refs[]` |
|
||||||
|
| **AuditEntry** [v1] | Audit | Append-only Compliance-Log, SHA-256-Hash-Kette | `subject_type/id` · `before_diff`/`after_diff` (JSONB) · `summary_text` (DE) · [append-only] |
|
||||||
|
| **FileEntityLink** [v1] | Files | M:N Datei ↔ beliebige Entität | `file_id` + `entity_type` + `entity_id` + `link_role` [polymorph] |
|
||||||
|
| **CustomFieldDefinition / CustomFieldValue** [v1] | CRM | Tenant-eigene Felder auf Projekt/Kontakt/Lead/Rechnung | Definition (Typ, Entity-Ziel) ← Value (entity_id + Wert) · pro Pipeline via `PipelineFieldConfig` schaltbar |
|
||||||
|
| **Tag / TagAssignment** [v1] | CRM | Farbige Tags, entity-übergreifend | Tag (name, color) ↔ Assignment (entity_type + entity_id) [polymorph] |
|
||||||
|
| **SearchIndexEntry** [v1] | Suche | Zentraler Such-Index über alle Entitäten | `entity_type/id` · `tsvector_de` (FTS) · ~~`embedding` pgvector **[v2-Spalte]**~~ → ruht, RAG entfällt ([[AD-26]]) · `permission_subject` |
|
||||||
|
| **HiveNumberSeq** [v1] | Sales | Fortlaufende Nummern (P-2026-0042, R-2026-0042) | pro `tenant_id` + `entity_type`, multi-tenant-sicher |
|
||||||
|
| **DataConnection** [v1] | Apps-Engine | Tenant ↔ externe App (AirCall, PandaDoc, Google, KWP) | `app_id` · `credentials` (verschlüsselt) · `connection_status` |
|
||||||
|
|
||||||
|
**Die Tenant/User-Achse** (hängt an fast allem): `Tenant 1:N TenantUser N:1 User` · Rollen über `TenantRole` + `Permission` + `RoleAssignment` · `Group` orthogonal (N:M User).
|
||||||
|
|
||||||
|
## Domäne 1: Identität & Mandanten (M27)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Tenant | v1 | slug, status (trial/active/past_due/frozen/suspended/deletion_pending), default_language | 1:N TenantUser/Role · [RLS-Wurzel] |
|
||||||
|
| User | v1 | email, language, timezone, theme_preference, date_format | N:M Tenant (kein RLS, global) |
|
||||||
|
| TenantUser | v1 | tenant_id, user_id, status | M:N Role via RoleAssignment · [RLS] |
|
||||||
|
| TenantRole | v1 | name, is_template_origin | 1:N Permission · [RLS] · 6 SHK-Rollen geseedet |
|
||||||
|
| Permission | v1 | role_id, permission_key | [RLS] |
|
||||||
|
| Group | v1 | name | N:M User · [RLS][Soft-Delete] |
|
||||||
|
| TenantUserInvitation | v1 | email, token, expires_at, accepted_at | [RLS] · 48h-Token |
|
||||||
|
| Session | v1 | user_id, tenant_id, last_activity_at, browser_fingerprint | Postgres-Source + Redis-Cache · [RLS] |
|
||||||
|
| ApiKey | **v2** | key_hash, scope, expires_at | [RLS][Soft-Delete] · wandert mit Public-API |
|
||||||
|
|
||||||
|
## Domäne 2: Querschnitt (Audit M21, Notifications M22, i18n M30)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AuditEntry | v1 | actor_kind, action, subject_type/id, before/after_diff, summary_text, ip | [RLS][append-only] |
|
||||||
|
| AuditExportJob | **v2** | filter_criteria, format (csv/json/pdf), status, result_file_url | [RLS] |
|
||||||
|
| AuditRetentionPolicy | **v2** | default_retention_months (6–120), legal_hold_active | (tenant_id PK) |
|
||||||
|
| Notification | v1 | recipient_user_id, event_type, title, body, deeplink, priority, read_at, bundle_id | [RLS] |
|
||||||
|
| NotificationPreference | v1 | user_id, event_type, channel_in_app/email/push, priority_threshold | [RLS] |
|
||||||
|
| NotificationDevice | v1 | user_id, device_kind, push_token | [RLS] · Push-Kanal ruht in v1 |
|
||||||
|
| NotificationBundle | **v2** | event_type_group, count, bundle_window_seconds | [RLS] |
|
||||||
|
| NotificationQuietHours | **v2** | user_id, weekday, start/end_time, urgent_override | [RLS] |
|
||||||
|
|
||||||
|
*i18n: keine eigene Tabelle - Strings in JSON-Files; nur Felder `User.language`, `Tenant.default_language`, `Kontakt.language`.*
|
||||||
|
|
||||||
|
## Domäne 3: Files & Tasks (M23, M26)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| File | v1 | display_name, mime_type, size, storage_key, checksum, preview_status, assigned_to, source | [RLS][Soft-Delete] |
|
||||||
|
| FileVersion | **v2** | file_id, version_number, storage_key, change_note | [RLS][append-only] |
|
||||||
|
| FileChunk / FileUploadProgress | v1 | upload_id, chunk_index / received_chunks, status, expires_at (24h) | chunked Upload + Resume |
|
||||||
|
| **FileEntityLink** | v1 | file_id, entity_type, entity_id, link_role | [RLS][polymorph] |
|
||||||
|
| Task | v1 | title, description, assigned_to_user **oder** _group, deadline, priority, status, source, linked_entity_type/id | [RLS][Soft-Delete][polymorph link] |
|
||||||
|
| TaskWatcher | v1 | task_id, user_id | M:N · [RLS] |
|
||||||
|
|
||||||
|
## Domäne 4: Apps-Engine (M33a) - der Integrations-Vertrag
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| App | v1 | key (kwp/gmail/aircall), category, connection_type (oauth2/api_key), connection_schema, phase | global, kein RLS |
|
||||||
|
| DataConnection | v1 | tenant_id, app_id, credentials (verschlüsselt), connection_status, last_health_check | [RLS] |
|
||||||
|
| AppSyncRun | v1 | data_connection_id, kind, status, items_total/succeeded/failed, summary_text | [RLS] |
|
||||||
|
| AppSyncRunLog | v1 | severity, message_text, tech_details | [RLS] |
|
||||||
|
| AppSyncItem | v1 | entity_type/id (HiveGrid) ↔ external_id, operation, status | [RLS][polymorph] |
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## Domäne 5: Projekt-zentrischer CRM-Kern (M01–M04, AD-20) — siehe Kern-Ketten-Diagramm
|
||||||
|
|
||||||
|
> **Ersetzt** die früher getrennten Domänen CRM-Kern / Lead-Inbox / Sales-Pipeline / Auftragspipeline. Ein `Projekt`-Kern, Pipelines als Views.
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **Projekt** | v1 | projekt_nummer (HiveNumberSeq), projektname, projekttyp, quelle, promotion, prioritaet, start/deadline, auftragsvolumen, potenzieller_auftragswert, zustaendige_person_id, projektleiter_id, projekt/rechnungs/bauher_adresse_id, kommunikation_*, stage_id (=Status), konvertiert_aus_lead_id | N:1 Pipeline/Stage · M:N Kontakt (ProjektKontakt) · 1:N Sub-Areas · [RLS][Soft-Delete] |
|
||||||
|
| **Pipeline** | v1 | name, typ_hint (sales/auftrag/custom), position | 1:N Stage/FieldConfig/Access · [Soft-Delete] |
|
||||||
|
| **PipelineStage** | v1 | pipeline_id, name, stage_kind (offen/gewonnen/verloren), win_probability, color | N:1 Pipeline · = die Statuswerte |
|
||||||
|
| **PipelineFieldConfig** | v1 | pipeline_id, stage_id (NULL=pipeline-weit), field_key (System ODER `custom:<id>`), sichtbar, pflicht, reihenfolge | Konfig-Layer · nicht sichtbare Felder bleiben erhalten |
|
||||||
|
| **PipelineFieldVisibility** | v1 | field_config_id, principal_type (rolle/gruppe/user), principal_id, kann_sehen, kann_bearbeiten | **Field-Level-Rechte (komplex, Entsch. 16.06.)** — z.B. Auftragsvolumen nur für Vertrieb; ohne Eintrag = für alle sichtbar |
|
||||||
|
| **PipelineAccess** | v1 | pipeline_id, principal_type (rolle/user/gruppe), principal_id, kann_sehen, kann_bearbeiten | wer-sieht-Pipeline |
|
||||||
|
| **ProjektMitglied** | v1 | projekt_id, user_id, rolle (projektleiter/monteur/zustaendig/beobachter) | M:N (mehrere Monteure) |
|
||||||
|
| **Kontakt** | v1 | kontakt_typ (privatperson/organisation), kontakt_status (kontakt/kunde/bestandskunde), vorname/nachname, org_name, org_merkmal (gmbh/kg/öffentlich/sonstige — optional), primaer_email/-telefon, adresse_id | M:N Projekt · self-ref KontaktRelation · [RLS][Soft-Delete] |
|
||||||
|
| **KontaktRelation** | v1 | von_kontakt_id, zu_kontakt_id, rolle (hauptkontakt/sekundaerkontakt), kontext | self-ref M:N — Kontaktart = Rolle der Relation |
|
||||||
|
| **KontaktEmail / KontaktTelefon** | v1 | kontakt_id, wert, primaer | Multi-Werte 1:N |
|
||||||
|
| **ProjektKontakt** | v1 | projekt_id, kontakt_id, rolle (auftraggeber/bauherr/rechnungsempfaenger/ansprechpartner), primaer | M:N-Brücke Projekt↔Kontakt |
|
||||||
|
| **Lead** | v1 | quelle, quelle_detail, status (new/qualified/converted/lost/spam), **weiterverarbeitung_freigabe (ja/nein/unklar)**, vorname/nachname/email/telefon, rohdaten (JSONB), spam_score, konvertiert_projekt_id, verknuepfter_kontakt_id | → Projekt, → Kontakt · [Soft-Delete] · DSGVO-Auto-Lösch |
|
||||||
|
| **Adresse** | v1 | strasse, hausnummer, plz, ort, land | von Projekt (3 Slots: Projekt/Rechnung/Bauherr) + Kontakt referenziert |
|
||||||
|
|
||||||
|
**Sub-Areas am Projekt:**
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **Rechnung** | **v1 NEU** | rechnungsnummer (HiveNumberSeq), betrag, status (entwurf/gestellt/bezahlt/storniert), datum, faellig_am, datei_id, quelle (manuell/kwp) | einfaches Sub-Entity am Projekt (E3) |
|
||||||
|
| **Termin** | v1 | projekt_id, kontakt_id, titel, start/ende_at, ort | Kalender-Sync (M25) dockt an |
|
||||||
|
| **Checkliste / ChecklistItem** | v1 | name, typ (generisch/maengel/abnahme_doku) / text, status, maengel_klasse (kritisch/klein/kosmetisch), foto_file_id | „Mängel" = Checkliste mit typ=maengel (E2) |
|
||||||
|
| **AbnahmeProtokoll** | v1 | projekt_id, maengel_checkliste_id, datum, anwesende, druckprobe, funktionspruefung, zaehlerstaende, pdf_file_id, gesperrt_at | **[immutable]** 6 Jahre · offline-fähig |
|
||||||
|
| **AbnahmeSignatur** | v1 | abnahme_id, signer_name, signer_rolle (kunde/monteur), signatur_file_id, signiert_at | Touch-Unterschrift |
|
||||||
|
| **ProjektExternesFeld** | **v2** | projekt_id, system (kwp), feld_key, wert | KWP/API-Felder — **komplett v2** (in v1 NICHT vorhanden, Entscheidung 16.06.); v2: Sync mit „KWP gewinnt" |
|
||||||
|
| **CustomFieldDefinition / Value** | v1 | entity_target (projekt/kontakt/lead/rechnung), field_type / entity_id, wert | dynamische Felder, pro Pipeline schaltbar |
|
||||||
|
| **Activity / Tag** | v1 | siehe Cross-Cutting | [polymorph] |
|
||||||
|
|
||||||
|
*Material-Ausgang/Lagerist-Sicht, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets → v2-Backlog (Modell-Pivot E2). Material-Listen am Auftrag bleiben v1.*
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## Domäne 6: Suche & Dashboard (M24, M20)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| SearchIndexEntry | v1 | entity_type/id, title, body_text, tsvector_de, **~~embedding (pgvector → v2)~~ — ruht, RAG entfällt ([[AD-26]])**, permission_subject, is_archived | [RLS][polymorph] |
|
||||||
|
| RecentSearch | v1 | user_id, query_text, applied_filters, result_count | [RLS] |
|
||||||
|
| ~~EmbeddingProviderJob~~ | ~~v1~~ | ~~search_entry_id, provider, status~~ | **ruht — RAG/Embeddings entfallen ([[AD-26]]); Meilisearch-Keyword bleibt** |
|
||||||
|
| Dashboard | v1 | name, is_default_for_role (gf/office/monteur/…), is_shared | [RLS][Soft-Delete] |
|
||||||
|
| DashboardLayout | v1 | dashboard_id, user_id (NULL=shared), widgets[], layout_data | 3 feste Rollen-Layouts v1 |
|
||||||
|
| WidgetInstance | v1 | widget_catalog_key, config, position, size | (Custom-Widgets + Drag&Drop → v2) |
|
||||||
|
|
||||||
|
## Domäne 7: Automation & ~~KI~~ (M17, ~~M18~~ → KI entfällt, [[AD-26]])
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AutomationRule | v1 | name, flow_data (JSON), enabled, created_via | [RLS][Soft-Delete] |
|
||||||
|
| AutomationRuleStep | v1 | rule_id, step_kind (trigger/condition/action/flow_control), node_type, config, parent_step_ids[] | Graph-Knoten |
|
||||||
|
| AutomationExecution | v1 | rule_id, trigger_payload, status, dry_run, idempotency_key, reverse_window_expires_at | [RLS][24h-Undo] |
|
||||||
|
| AutomationStepExecution | v1 | execution_id, step_id, input/output, summary_text | |
|
||||||
|
| AutomationCredential | v1 | key, value (verschlüsselt) | [verschlüsselt] |
|
||||||
|
| AutomationTemplate | v1 | flow_data, category, is_published | SHK-Vorlagen |
|
||||||
|
| ~~LlmGatewayProvider / Model~~ | ~~v1~~ | ~~key, region (EU), model_kind~~ | **entfernt — KI→MCP ([[AD-26]])** |
|
||||||
|
| ~~AiSettings~~ | ~~v1~~ | ~~enabled_use_cases[], default_models, usage_limit_tokens~~ | **entfernt — KI→MCP ([[AD-26]])** |
|
||||||
|
| ~~AiCredits~~ | ~~v1~~ | ~~current_balance_tokens, monthly_grant~~ | **entfernt — KI→MCP ([[AD-26]])** |
|
||||||
|
| ~~AiTokenUsage~~ | ~~v1~~ | ~~use_case, model_id, input/output_tokens, cost~~ | **entfernt — KI→MCP ([[AD-26]])** |
|
||||||
|
| ~~Conversation / ConversationMessage~~ | ~~v1~~ | ~~kind, role, content~~ | **entfernt — KI→MCP ([[AD-26]])** |
|
||||||
|
| ~~GeneratedObject~~ | ~~v1~~ | ~~use_case, data (Schema-validiert)~~ | **entfernt — KI→MCP ([[AD-26]])** |
|
||||||
|
| ~~TenantEmbedding / HiveMindRAGEmbedding~~ | ~~v2~~ | ~~entity_type/id, embedding (pgvector)~~ | **zurückgestellt — RAG entfällt, KI→MCP ([[AD-26]]); v3-Kandidat** |
|
||||||
|
| ~~WhisperTranscript~~ | ~~v2~~ | ~~audio_source_type, transcript_text, confidence~~ | **zurückgestellt — KI→MCP ([[AD-26]]); v3-Kandidat** |
|
||||||
|
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]):** Alle KI-Entitäten oben sind **entfernt bzw. zurückgestellt** — HiveGrid hostet kein eigenes LLM/RAG/Whisper, sondern wird Remote-MCP-Server ([[VR-MCP]]/[[VD-MCP]]). **MCP führt KEINE neuen KI-Entitäten ein:** es nutzt das bestehende `ApiKey`/`Credential` (Auth + Scopes aus der Public-API, [[VR-P22]]) + M001-Audit; höchstens eine kleine `McpGrant`/Scope-Tabelle kommt hinzu. Die Automation-Entitäten (AutomationRule … AutomationTemplate) bleiben **unverändert v1**.
|
||||||
|
|
||||||
|
## Domäne 8: Kommunikation (Email M09/M10, Telefonie M12, Chat M13)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| TenantSendingDomain | v1 | domain, dkim/spf/dmarc-Records, verification_status | [RLS][verschlüsselt][Soft-Delete] |
|
||||||
|
| TenantInboundAddress | v1 | local_part, full_address, purpose (lead_inbox/bcc_logging/reply_routing) | [RLS][Soft-Delete] |
|
||||||
|
| Email | v1 | purpose, from_sender_id, to, delivery_status, related_kontakt/projekt_id | System-/Transaktions-Mails · [RLS][Soft-Delete] |
|
||||||
|
| EmailIntegrationMailbox / Message / SyncCursor / WebhookEvent | **v2** | provider (gmail/microsoft), oauth_tokens, matched_kontakt/projekt_id | Postfach-Sync [RLS][polymorph] |
|
||||||
|
| Campaign | v1 | name, subject, template_id, sender_id, recipient_segment_id, status, delivered/opened/clicked_count | [RLS][Soft-Delete] |
|
||||||
|
| OutboundEmail | v1 | campaign_id, recipient_kontakt_id, tracking_token, unsubscribe_token, delivery_status | pro Empfänger [RLS] |
|
||||||
|
| OutboundEmailOpen / Click | v1 | opened_at (IP anonymisiert) / clicked_at, link_url | Tracking |
|
||||||
|
| EmailTemplate / EmailSender | v1 | body_html / from_name/email, sending_domain_id, is_default | [RLS] |
|
||||||
|
| RecipientSegment | v1 | entity_type, filter_definition (JSONB), is_static_snapshot | [RLS][Soft-Delete] |
|
||||||
|
| Unsubscribe / EmailSuppressionList | v1 | kontakt_id, scope, reason / email_address (unique), reason | [RLS] |
|
||||||
|
| TelephonyConnection | v1 | provider (aircall), oauth_token (verschl.), webhook_secret | max. 1 aktiv/Tenant · [RLS] |
|
||||||
|
| TelephonyUserBinding | v1 | tenant_user_id ↔ provider_user_id | AirCall-User-Mapping |
|
||||||
|
| TelephonyCallSession | v1 | direction, status, from/to_number (E.164), matched_kontakt/lead/projekt_id, note, recording_url | [RLS][Soft-Delete][polymorph match] |
|
||||||
|
| TelephonyWebhookEvent | v1 | event_type, signature_valid, processing_status | [append-only][30d] |
|
||||||
|
| *HalloPetra-Modelle* | **v2** | (M105) | zweiter Telefonie-Adapter |
|
||||||
|
| TeamChat | v1 | kind (project/group/dm), projekt_id, archived_reason, last_message_at | [RLS][Soft-Delete] |
|
||||||
|
| TeamChatMember | v1 | chat_id, user_id, role_in_chat, last_read_message_id, is_pinned | [RLS] |
|
||||||
|
| TeamChatMessage | v1 | chat_id, author, body (Markdown), parent_message_id (Thread), mentions[], attachments[] | [RLS][Soft-Delete] |
|
||||||
|
| TeamChatThread / PinnedMessage / Reaction / Read | v1 | parent_message_id / message_id / emoji / read_at | Threads, Pins (max 50), Reactions, Read-Receipts |
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## Domäne 9: Kalender, Booking, Forms, Signatur (M25, M06, M05, M07)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Relationen / Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| CalendarConnection | v1 (Google) / **v2 (MS)** | provider, oauth_refresh_token (verschl.), status | [RLS][verschlüsselt] |
|
||||||
|
| CalendarEvent | v1 | source (internal/external_synced), starts/ends_at, is_busy, internal_entity_link | [RLS][Soft-Delete] |
|
||||||
|
| CalendarEventMapping / SyncCursor / WebhookEvent | v1 | internal↔external_id / cursor_token / payload | Sync-Infra |
|
||||||
|
| BookingPage | v1 | slug, duration_minutes, assignment_strategy (eine Strategie v1), is_published, intake_form_id | [RLS][Soft-Delete] |
|
||||||
|
| BookingPageProvider | v1 | booking_page_id, tenant_user_id | M:N User |
|
||||||
|
| AvailabilityRule / Exception | v1 | day_of_week, start/end_time / date, kind | Verfügbarkeit |
|
||||||
|
| Appointment | v1 | booking_page_id, provider_user_id, start/end, status (scheduled/held/cancelled/no_show/rescheduled), kontakt_id\|lead_id, form_submission_id | → Kontakt/Lead/Form · [RLS] |
|
||||||
|
| Form | v1 | slug, subtype (standard/acceptance_form/onboarding/survey), status, is_public | 1:N Field/Action · [RLS][Soft-Delete] |
|
||||||
|
| FormField | v1 | field_key, field_type (12 Typen), required, validation_rules | N:1 Form |
|
||||||
|
| FormSubmission | v1 | form_id, submission_data (JSON), linked_entity_type/id | [RLS][Soft-Delete][polymorph] |
|
||||||
|
| FormFile | v1 | submission_id, field_key, file_id | → File |
|
||||||
|
| FormAction | v1 | action_type (send_email/create_lead/create_projekt/webhook/trigger_automation), action_config | Post-Submit |
|
||||||
|
| FormLink | **v2** | token, expires_at, usage_limit | personalisierte Links |
|
||||||
|
| SignatureProviderConnection | v1 | data_connection_id (Apps-Engine!), provider (PandaDoc), is_default | [RLS] |
|
||||||
|
| ProjektSignatureDocument | v1 | projekt_id, provider_document_id, source_pdf_file_id, status (draft/sent/viewed/signed/declined), signed_pdf_file_id | → Projekt (Angebot/Pipeline) · [RLS][Soft-Delete] |
|
||||||
|
| ProjektSignatureSigner | v1 | document_id, signer_email/name, linked_kontakt_id, status, signed_at | → Kontakt |
|
||||||
|
|
||||||
|
## Domäne 10: HR-Hub (M14) - viel Verschlüsselung
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| HrEmployeeProfile | v1 | user_id (1:1), personal_number, hire_date, position, team, location_id, manager_user_id, emergency_contact_* | [RLS] |
|
||||||
|
| HrLocation | v1 | name, address_*, geo, image_file_id | [RLS][Soft-Delete] |
|
||||||
|
| HrAnnouncement (+ Read/Reaction/Comment) | v1 | title, body, audience_kind, requires_acknowledgement | [RLS][Soft-Delete] |
|
||||||
|
| HrEmployeeDocument | v1 | employee_user_id, document_kind, file_id, visibility | [RLS][Soft-Delete] |
|
||||||
|
| HrResource / HrQuickLink | v1 | kind, url/file_id, category, audience | [RLS][Soft-Delete] |
|
||||||
|
| HrSurvey (+ Item/Submission) | v1 | is_anonymous, result_visibility, item_type (text/rating_5/nps/choice/boolean) | [RLS] · anonym: submitter_hash |
|
||||||
|
| HrRequest (+ Template) | v1 | request_kind (expense/hardware/training/reference), form_submission_id, status, assigned_approver | [RLS][Soft-Delete] |
|
||||||
|
| EmployeePayslip | v1 | period_year/month, file_id (PDF), is_read | [RLS][Soft-Delete] |
|
||||||
|
| EmployeeUploadReminder (+ Dispatch) | v1 | document_kind, cadence_kind, due_at, status | [RLS] |
|
||||||
|
| EmployeeVacationRequest | v1 | start/end_date, request_kind, status, assigned_approver, calendar_event_id | → Calendar · [RLS] |
|
||||||
|
| EmployeeSickLeaveReport | v1 | start/return_date, certificate_file_id, status | [RLS][**verschlüsselt** AU-Schein] |
|
||||||
|
| EmployeePasswordSafeVault (+ Entry/Access) | v1 | username/password/notes (**AES-256-GCM**), permission_level (read/write/admin) | [RLS][**verschlüsselt**] · Reveal audit-geloggt |
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## Domäne 11: Plattform-Admin (M37) - eigene Welt, KEIN tenant_id
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AdminUser | **v2** | email, password_hash, totp_secret (Pflicht), status | v1 = Boilerplate-Modell mit MFA-Step-up; getrennte Identität → v2 |
|
||||||
|
| AdminRole / AdminPermission / AdminSession | **v2** | name (super_admin/support/sales) / permission_id / expires_at (8h), ip | parallele RBAC → v2 |
|
||||||
|
| AdminAuditLog | v1 | admin_user_id, action_type, target_kind/id, summary_text, metadata (Diff) | cross-tenant (tenant_id=null) |
|
||||||
|
| AdminTenantNote | v1 | tenant_id, note_text, category, pinned | Markdown-Notizen |
|
||||||
|
| AdminSupportTicket (+ Message) | v1 | source_kind (in_app_feedback_widget/inbound_email), tenant_id, status, priority | speist sich aus Feedback-Widget |
|
||||||
|
| AdminLead / AdminDeal / AdminLeadActivity | **v2** | (M040 Plattform-Lead-Pipeline) | unser eigenes Sales-Tool |
|
||||||
|
|
||||||
|
## Domäne 12: Billing & Abo-Baukasten (M28) - wichtig: das Recut-Modell
|
||||||
|
|
||||||
|
**Struktur (keine Seat-Typen mehr - Basis-Preis pro Nutzer + Feature-Module als Positionen):**
|
||||||
|
|
||||||
|
```
|
||||||
|
SubscriptionProduct ─1:N─▶ SubscriptionPrice (legacyProvider_price_id, interval month|year|one_time)
|
||||||
|
│ (Plan: Core/Swarm/Colony)
|
||||||
|
├─M:N─▶ SubscriptionFeature (via ProductFeature, +quota_value JSON) ◀── Konnektor-Gate!
|
||||||
|
└─1:N─▶ SubscriptionUsageBasedPrice ─1:N─▶ UsageBasedTier (Staffel-Overage)
|
||||||
|
│
|
||||||
|
TenantSubscription (1:1 Tenant) ─N:1─▶ Product │
|
||||||
|
├─1:N─▶ TenantSubscriptionProductPrice (quantity=Seats, is_metered)
|
||||||
|
├─1:N─▶ TenantSubscriptionUsageRecord (metric, usage_amount, reported_to_legacyProvider)
|
||||||
|
└─ status (trial/active/past_due/cancelled/frozen) + Legacy-Provider-IDs + Dunning-Felder
|
||||||
|
Credit (ai_token/bonus, balance_after, valid_until) ─N:1─▶ Tenant
|
||||||
|
CheckoutSessionStatus (legacyProvider_checkout_session, intent) ─N:1─▶ Tenant
|
||||||
|
```
|
||||||
|
|
||||||
|
`SubscriptionFeature.code` (z. B. `kwp_integration`) ist die Brücke zur Konnektor-Pflicht: `tenantHasModule()` prüft, ob das Feature im Abo des Tenants enthalten ist. Quotas (max_users, ai_tokens) hängen an `SubscriptionProductFeature.quota_value`.
|
||||||
|
|
||||||
|
## Domäne 13: Onboarding, Branding, DSGVO (M29, M31, M35)
|
||||||
|
|
||||||
|
| Entität | v | Kern-Felder | Flags |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Onboarding (+ Filter/Step) | v1 | code (shk_standard), industry, template_directory | global · Wizard-UI → v2 |
|
||||||
|
| OnboardingSession (+ Action) | v1 | onboarding_id, current_step, status, payload | [RLS] |
|
||||||
|
| OnboardingDemoProvisioning | v1 | template_code, entities_created (JSON), removable_until (+30d) | is_demo_data-Flag in Listen |
|
||||||
|
| OnboardingInvitationDispatch | v1 | tenant_user_invitation_id | → M27 |
|
||||||
|
| (User.theme_preference) | v1 | system/light/dark - **v1 nur light/dark** | Feld in User; TenantBranding → v2 |
|
||||||
|
| GdprExportJob | v1 | scope (user_self/tenant_full), status, result_file_id (ZIP), result_expires_at | [RLS] |
|
||||||
|
| TenantDeletionRequest | v1 | reason, grace_period_ends_at (+30d), status | [RLS] · Slug-Confirm |
|
||||||
|
| AvvAcceptance | v1 | avv_version, accepted_by, pdf_file_id, signer_name | [RLS] |
|
||||||
|
| Subprocessor | v1 | name, country, is_eu_eea, data_categories, dpa_url | global |
|
||||||
|
|
||||||
|
## Zähl-Übersicht & offene Modellierungs-Fragen
|
||||||
|
|
||||||
|
**~135 Entitäten gesamt** (Kern konsolidiert: Deal+Project → Projekt), davon ~25 mit `[v2]` markiert. Cross-Cutting (polymorph): Activity, AuditEntry, FileEntityLink, SearchIndexEntry, Tag, CustomField, AppSyncItem, Task-Link, Telephony/Email-Match, ProjektKontakt.
|
||||||
|
|
||||||
|
**Entschieden 16.06. (Raffael + Claude) — Modell final festgesetzt:**
|
||||||
|
1. **Polymorphe Refs ohne FK** (Activity/FileEntityLink/SearchIndexEntry) — ✅ akzeptiert (Erweiterbarkeit); App-seitige Konsistenz + Cleanup-Jobs.
|
||||||
|
2. **Adressen** — ✅ eigene `Adresse`-Tabelle (Projekt 3 Slots: Projekt/Rechnung/Bauherr; Kontakt 1 Slot); HrLocation embedded.
|
||||||
|
3. **Rechte/Sichtbarkeit pro Pipeline** — ✅ **voll/komplex schon in v1**: `PipelineAccess` (wer sieht/bearbeitet Pipeline) + `PipelineFieldConfig` (Feld sichtbar/pflicht je Pipeline+Status) + **NEU `PipelineFieldVisibility`** (Field-Level-Rechte je Rolle/Gruppe/User, z.B. Auftragsvolumen nur für Vertrieb). Ersetzt harte Permission-Bundles für Feld-Sichtbarkeit.
|
||||||
|
4. **HiveNumberSeq** — ✅ Row-Lock-/`SELECT … FOR UPDATE`-Strategie, **lückenlos** (GoBD-Pflicht für Rechnungen; **keine** Postgres-Sequence wegen Lücken bei Rollback). Gilt für Projekt- + Rechnungs-Nummern.
|
||||||
|
5. **`is_demo_data`-Flag** — ✅ auf allen seedbaren Entitäten (Bulk-Lösch beim Echt-Start), quer durchs Modell.
|
||||||
|
6. **Wertelisten final:** `kontakt_status` = **Kontakt / Kunde / Bestandskunde** ✅ · Label **„Organisation"** (NICHT „Unternehmen" — umfasst auch Vereine/Körperschaften) ✅ · **KWP-Felder komplett aus v1 raus → erst v2** (`ProjektExternesFeld` = [v2], in v1 nicht vorhanden) ✅.
|
||||||
|
|
||||||
|
---
|
||||||
|
*Begleitdateien: `entity-model.dbml` (DBML für dbdiagram.io / ER-Diagramm `entity-model.svg`) · `ENTITY-MODELL-ERKLAERUNG.pdf` (laienverständliche Fassung). Approved-Quelle: `HiveGrid_CRM_Datenlogik_UX_Entscheidungen.md`. Architektur-Entscheidungen: `docs/ARCHITECTURE-DECISIONS.md` (AD-1 RLS, AD-2 First-Class revidiert, AD-20 Projekt-zentrisch).*
|
||||||
Binary file not shown.
@@ -0,0 +1,164 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 18mm
|
||||||
|
printBackground: true
|
||||||
|
css: |-
|
||||||
|
* { box-sizing: border-box; }
|
||||||
|
body { font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; font-size: 11px; line-height: 1.55; color: #1c1c1c; }
|
||||||
|
h1 { font-size: 23px; color: #b8730a; margin-bottom: 2px; }
|
||||||
|
h1 + p.sub { color: #777; font-size: 11px; margin-top: 0; margin-bottom: 18px; }
|
||||||
|
h2 { font-size: 15px; color: #1c1c1c; border-bottom: 2px solid #f5a623; padding-bottom: 4px; margin-top: 26px; break-after: avoid; page-break-after: avoid; }
|
||||||
|
h3 { font-size: 12.5px; color: #b8730a; margin-top: 16px; margin-bottom: 4px; break-after: avoid; page-break-after: avoid; }
|
||||||
|
p { orphans: 3; widows: 3; margin: 6px 0; }
|
||||||
|
ul { margin: 6px 0 6px 0; padding-left: 18px; }
|
||||||
|
li { margin: 4px 0; orphans: 2; widows: 2; break-inside: avoid; page-break-inside: avoid; }
|
||||||
|
strong { color: #b8730a; }
|
||||||
|
.card { break-inside: avoid; page-break-inside: avoid; background: #fafafa; border: 1px solid #ececec; border-left: 3px solid #f5a623; border-radius: 5px; padding: 9px 13px; margin: 9px 0; }
|
||||||
|
.card h3 { margin-top: 0; }
|
||||||
|
.flow { break-inside: avoid; page-break-inside: avoid; background: #f6f9fe; border: 1px solid #e2ecf8; border-left: 3px solid #3d7fd6; border-radius: 5px; padding: 9px 13px; margin: 9px 0; }
|
||||||
|
.flow h3 { color: #2c5fa0; }
|
||||||
|
.rel { break-inside: avoid; page-break-inside: avoid; margin: 5px 0; padding: 5px 10px; border-left: 2px solid #e0c089; background: #fffdf7; border-radius: 3px; }
|
||||||
|
.intro { break-inside: avoid; page-break-inside: avoid; background: #fff7e8; border: 1px solid #f0dcb0; border-radius: 5px; padding: 11px 14px; margin: 10px 0 4px 0; }
|
||||||
|
.note { color: #555; font-size: 10px; font-style: italic; }
|
||||||
|
table { border-collapse: collapse; width: 100%; font-size: 10px; margin: 6px 0; break-inside: avoid; page-break-inside: avoid; }
|
||||||
|
th, td { border: 1px solid #ccc; padding: 4px 7px; text-align: left; vertical-align: top; }
|
||||||
|
th { background: #fff7e8; }
|
||||||
|
.pagebreak { page-break-after: always; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# Das HiveGrid-Datenmodell — einfach erklärt
|
||||||
|
|
||||||
|
<p class="sub">Projekt-zentrisches CRM/Pipeline-Modell · Stand 14.06.2026 · für Design & Produkt (nicht-technisch)</p>
|
||||||
|
|
||||||
|
<div class="intro">
|
||||||
|
<strong>Die Grundidee in einem Satz:</strong> Es gibt <strong>ein zentrales Objekt — das Projekt</strong>. Alles andere ist entweder eine Vorstufe davor (der Lead), eine Brille darauf (die Pipeline), ein Beteiligter (Kontakte, Mitarbeiter) oder etwas, das daran hängt (Termine, Rechnungen, Checklisten, Aufgaben, Dokumente). „Deal" und „Auftrag" sind <strong>keine eigenen Dinge</strong> mehr, sondern nur Namen von Pipelines — also verschiedene Sichten auf dasselbe Projekt.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## Die Bausteine
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>Lead — die Vorstufe</h3>
|
||||||
|
Ein Sammelbecken für eingehende Anfragen aus allen Quellen (Formular, Website, Social Media, Liste, CSV, manuell, E-Mail, Anruf). Felder dürfen hier noch leer sein. Der wichtigste Punkt ist die <strong>Weiterverarbeitungsfreigabe</strong> (Ja / Nein / Unklar) — sie ist die Grenze zwischen „nur eine Anfrage" und „echtes Projekt".
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>Projekt — der Kern</h3>
|
||||||
|
Der eigentliche Arbeitsdatensatz. Trägt alle festen Angaben (Name, Quelle, Priorität, Start/Deadline, Auftragsvolumen, Adressen, zuständige Person, Projektleiter …) und beliebige <strong>selbst definierte Felder</strong>. Jedes Projekt läuft in <strong>genau einer Pipeline</strong> und steht dort auf <strong>genau einem Status</strong>.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>Pipeline — die Brille</h3>
|
||||||
|
Eine frei benennbare Ansicht auf Projekte („Vertrieb", „Aufträge", „Wartungsverträge" …). Der Admin legt pro Pipeline fest:
|
||||||
|
<ul>
|
||||||
|
<li>welche <strong>Status-Schritte</strong> (Spalten) es gibt,</li>
|
||||||
|
<li>welche <strong>Felder sichtbar oder Pflicht</strong> sind (auch je Status),</li>
|
||||||
|
<li><strong>wer</strong> die Pipeline sehen und bearbeiten darf.</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>Kontakt — Personen & Organisationen</h3>
|
||||||
|
Ein Oberbegriff: ein Kontakt ist <strong>entweder eine Privatperson oder eine Organisation</strong>. Dazu kommen ein Status (Kontakt / Kunde / Bestandskunde) und mehrere Erreichbarkeiten. <strong>Hauptkontakt</strong> und <strong>Sekundärkontakt</strong> sind keine Eigenschaft des Kontakts selbst, sondern eine <strong>Beziehung</strong> zwischen Kontakten.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>Anhänge am Projekt (Sub-Bereiche)</h3>
|
||||||
|
Termine, <strong>Rechnungen</strong>, Checklisten (mit Punkten), die <strong>Abnahme</strong> (ein eigenes, nach Unterschrift gesperrtes Protokoll) und — <strong>ab Version 2</strong> — KWP-/Schnittstellen-Felder. „Mängel" ist dabei einfach eine Checkliste mit dem Namen „Mängel".
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>Querschnitt — hängt überall dran</h3>
|
||||||
|
<strong>Aufgaben, Aktivitäten (der Verlauf), Dokumente und Tags</strong> können an jeder Sache hängen — an einem Projekt, einem Kontakt oder einem Lead.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## Die Beziehungen — in einfachen Sätzen
|
||||||
|
|
||||||
|
<h3>Vom Lead zum Projekt</h3>
|
||||||
|
<div class="rel">Ein Lead wird zu <strong>höchstens einem</strong> Projekt.</div>
|
||||||
|
<div class="rel">Ein Projekt entsteht aus <strong>höchstens einem</strong> Lead — kann aber auch direkt ohne Lead angelegt werden.</div>
|
||||||
|
<div class="rel">Ein Lead kann mit <strong>einem</strong> Kontakt verknüpft werden; der Kontakt bleibt eigenständig.</div>
|
||||||
|
|
||||||
|
<h3>Projekt und Pipeline</h3>
|
||||||
|
<div class="rel">Ein Projekt liegt in <strong>genau einer</strong> Pipeline.</div>
|
||||||
|
<div class="rel">Eine Pipeline enthält <strong>beliebig viele</strong> Projekte.</div>
|
||||||
|
<div class="rel">Eine Pipeline hat <strong>mehrere</strong> Status-Schritte; ein Projekt steht immer auf <strong>genau einem</strong> Status-Schritt.</div>
|
||||||
|
<div class="rel">Eine Pipeline bestimmt selbst, <strong>welche</strong> Felder sichtbar oder Pflicht sind und <strong>wer</strong> sie sehen darf.</div>
|
||||||
|
|
||||||
|
<h3>Kontakte</h3>
|
||||||
|
<div class="rel">Ein Kontakt ist <strong>entweder</strong> eine Privatperson <strong>oder</strong> eine Organisation.</div>
|
||||||
|
<div class="rel">Ein Kontakt kann <strong>mehrere</strong> E-Mail-Adressen und <strong>mehrere</strong> Telefonnummern haben.</div>
|
||||||
|
<div class="rel">Eine Organisation kann <strong>mehrere</strong> Hauptkontakte und <strong>mehrere</strong> Sekundärkontakte haben.</div>
|
||||||
|
<div class="rel">Eine Privatperson kann <strong>selbst</strong> Hauptkontakt sein und zusätzlich <strong>mehrere</strong> Sekundärkontakte haben.</div>
|
||||||
|
<div class="rel">Ein Kontakt kann an <strong>mehreren</strong> Projekten beteiligt sein, und ein Projekt kann <strong>mehrere</strong> Kontakte haben — jeweils mit einer Rolle (Auftraggeber, Bauherr, Rechnungsempfänger, Ansprechpartner).</div>
|
||||||
|
|
||||||
|
<h3>Beteiligte und Adressen</h3>
|
||||||
|
<div class="rel">Ein Projekt hat <strong>eine</strong> zuständige Person und <strong>einen</strong> Projektleiter.</div>
|
||||||
|
<div class="rel">Ein Projekt kann <strong>mehrere</strong> Monteure haben, und ein Monteur kann an <strong>mehreren</strong> Projekten arbeiten.</div>
|
||||||
|
<div class="rel">Ein Projekt hat <strong>eine</strong> Projektadresse und <strong>optional je eine</strong> separate Rechnungs- und Bauherradresse.</div>
|
||||||
|
|
||||||
|
<h3>Anhänge am Projekt</h3>
|
||||||
|
<div class="rel">Ein Projekt kann <strong>beliebig viele</strong> Termine, Rechnungen, Checklisten, Aufgaben und Dokumente haben — jedes davon gehört zu <strong>genau einem</strong> Projekt.</div>
|
||||||
|
<div class="rel">Eine Checkliste besteht aus <strong>mehreren</strong> Punkten; jeder Punkt gehört zu <strong>genau einer</strong> Checkliste.</div>
|
||||||
|
<div class="rel">Eine Abnahme gehört zu <strong>genau einem</strong> Projekt, bindet <strong>eine</strong> Mängel-Checkliste ein und sammelt <strong>mehrere</strong> Unterschriften (Kunde und Monteur). Nach der Unterschrift ist sie gesperrt.</div>
|
||||||
|
<div class="rel">Ein Projekt kann <strong>mehrere</strong> KWP-/Schnittstellen-Felder tragen — <strong>erst ab Version 2</strong> (in Version 1 noch nicht enthalten; KWP-Anbindung kommt nach dem Launch).</div>
|
||||||
|
|
||||||
|
<h3>Eigene Felder & Querschnitt</h3>
|
||||||
|
<div class="rel">Ein Betrieb kann <strong>beliebig viele</strong> eigene Felder definieren; jedes davon lässt sich pro Pipeline ein-/ausblenden und zur Pflicht machen.</div>
|
||||||
|
<div class="rel">Aufgaben, Aktivitäten, Dokumente und Tags können an <strong>jeder</strong> Sache hängen — Projekt, Kontakt oder Lead.</div>
|
||||||
|
|
||||||
|
## Was das für den Nutzer bedeutet
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<strong>1. Der Betrieb baut sich sein CRM selbst.</strong> Jeder SHK-Betrieb legt eigene Pipelines an, benennt sie, blendet Felder ein/aus, macht Felder zur Pflicht und legt fest, wer reinschauen darf — ohne Entwickler.
|
||||||
|
</div>
|
||||||
|
<div class="card">
|
||||||
|
<strong>2. Keine Brüche, keine Doppelerfassung.</strong> Ein Auftrag ist derselbe Datensatz wie der frühere „Deal" — er wechselt nur die Pipeline. Der Verlauf bleibt lückenlos vom ersten Kontakt bis zur Abnahme.
|
||||||
|
</div>
|
||||||
|
<div class="card">
|
||||||
|
<strong>3. Ein klarer Status statt zwei.</strong> „Status" heißt immer: wo steht das Projekt in <em>dieser</em> Pipeline. Kein verwirrender zweiter Gesamtstatus.
|
||||||
|
</div>
|
||||||
|
<div class="card">
|
||||||
|
<strong>4. Flexible Kontaktwelt.</strong> Privatkunden, Firmen mit mehreren Ansprechpartnern, Sekundärkontakte — alles abbildbar, und ein Kontakt taucht überall im richtigen Zusammenhang auf.
|
||||||
|
</div>
|
||||||
|
<div class="card">
|
||||||
|
<strong>5. Rechtssichere Abnahme & Rechnungen am Projekt.</strong> Die Abnahme bleibt unveränderlich mit Unterschrift; Rechnungen lassen sich direkt am Projekt führen.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## Die Abläufe — so fühlt es sich an
|
||||||
|
|
||||||
|
<div class="flow">
|
||||||
|
<h3>A · Anfrage wird zum Projekt</h3>
|
||||||
|
Anfrage landet als Lead in der Inbox. Der Sachbearbeiter prüft und setzt die Weiterverarbeitungsfreigabe auf <strong>Ja</strong> → ein Projekt entsteht, die bekannten Daten werden übernommen, der Kunde wird als Kontakt verknüpft. Bei <strong>Nein/Unklar</strong> bleibt es ein Lead.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="flow">
|
||||||
|
<h3>B · Projekt wandert durch den Vertrieb</h3>
|
||||||
|
Im Kanban der Vertriebs-Pipeline zieht man das Projekt von Spalte zu Spalte (= Status). Bei „gewonnen" taucht <strong>dasselbe</strong> Projekt in der Auftrags-Pipeline auf — mit deren Feldern und Schritten. Keine Übergabe, kein Neuanlegen.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="flow">
|
||||||
|
<h3>C · Admin richtet eine neue Pipeline ein</h3>
|
||||||
|
Beispiel „Wartungsverträge": Spalten definieren, festlegen welche Felder sichtbar/pflichtig sind und welche Rollen Zugriff haben. Ab sofort können Projekte dort laufen.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="flow">
|
||||||
|
<h3>D · Monteur auf der Baustelle</h3>
|
||||||
|
Öffnet das Projekt mobil → Abnahme-Checkliste abarbeiten, Mängel mit Foto und Schweregrad erfassen → Kunde und Monteur unterschreiben auf dem Display → Protokoll wird gesperrt und als PDF abgelegt. Funktioniert <strong>offline</strong>.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="flow">
|
||||||
|
<h3>E · Büro arbeitet am Projekt</h3>
|
||||||
|
Rechnung am Projekt anlegen, Termin einplanen, Aufgabe an einen Kollegen zuweisen, Dokument anhängen — alles hängt am selben Projekt.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="flow">
|
||||||
|
<h3>F · Kontaktpflege mit Rückschreiben</h3>
|
||||||
|
In der Projektansicht steht die Telefonnummer des Auftraggebers; man ändert sie direkt dort → die Änderung wird <strong>auf den Kontakt zurückgeschrieben</strong> (das Feld „gehört" dem Kontakt, wird nur im Projekt angezeigt). Der Verlauf hält fest, wer wann was geändert hat.
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="intro">
|
||||||
|
<strong>Kurz:</strong> ein Datensatz, viele konfigurierbare Brillen. „Vertrieb" und „Auftrag" werden über die Pipeline-Konfiguration unterschieden statt über getrennte Datentöpfe — flexibler für den Betrieb. <span class="note">Die sorgfältig durchdachte Stelle dabei sind Sichtbarkeit & Rechte pro Pipeline — voll ausgebaut: einzelne Felder lassen sich <strong>pro Rolle/Gruppe</strong> ein- oder ausblenden (z.B. das Auftragsvolumen nur für den Vertrieb).</span>
|
||||||
|
</div>
|
||||||
Binary file not shown.
@@ -0,0 +1,84 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 14mm
|
||||||
|
landscape: true
|
||||||
|
css: |-
|
||||||
|
body { font-size: 10px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
|
||||||
|
h1 { font-size: 18px; } h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; }
|
||||||
|
table { font-size: 9px; border-collapse: collapse; width: 100%; }
|
||||||
|
th, td { border: 1px solid #ccc; padding: 3px 5px; text-align: left; vertical-align: top; }
|
||||||
|
th { background: #fff7e8; }
|
||||||
|
code { background: #f4f4f4; padding: 1px 3px; font-size: 8.5px; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# Externals-Checkliste — 4-Wochen-Sprint
|
||||||
|
|
||||||
|
**Stand:** 2026-06-12 (aktualisiert nach Scope-Schnitt 11.06. — siehe `SCOPE-V1-CUTS.md`) · Abgeglichen mit `.env.example` + allen v1-Phasen.
|
||||||
|
Spalte „Wer" im Team-Meeting ausfüllen. **Kategorie A heute anstoßen — das sind Wartezeiten, keine Arbeit.**
|
||||||
|
|
||||||
|
> **Durch den Scope-Schnitt entfallen/entschärft:** A2 nur noch Calendar-Scope (Gmail raus) · A3 Apple-Konto ruht (kein App-Store in v1/v2 — PWA-only, → v3) · A4 Google Play → v3 · A7 Microsoft Entra → v2 · B3 HalloPetra → v2 · B7 FCM/APNs **entfällt** (PWA → Web-Push/VAPID) · AlephAlpha (B6-Teil) → v2 · Memberspot/Boobora → v2. **AD-6 (Mailjet) + AD-7 (mCaptcha) sind GELOCKT** (Boilerplate-verdrahtet). **NEU: E6 AVV + Auskunfts-Vorlage (Anwalt).**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## A — Lange Vorlaufzeit (HEUTE anstoßen, sonst reißt Woche 3–4)
|
||||||
|
|
||||||
|
| # | Was | Wofür (Phase) | Vorlauf / Risiko | Wer |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| A1 | **KWP (✅ entschärft, 12.06.):** Hersteller richtet Zugang ein, verfügbar ~**19.07.** (nach Launch → P10 = erstes v2-Modul). **Jetzt erledigen:** (a) Callback-URLs zurückmelden: `https://app.hivegrid.de/integrations/kwp/oauth/callback` + `https://staging-app.hivegrid.de/integrations/kwp/oauth/callback` (PKCE), (b) **kwp-bnWin.net auf 8.1 N3** bei Geerkens-IT aktualisieren | v2-P10 | 🟢 kein Sprint-Risiko mehr; Antwort-Mail diese Woche | |
|
||||||
|
| A2 | **Google Cloud:** OAuth-App + **nur Calendar-API**-Scope-Verifizierung (Gmail-Scopes entfallen — Postfach-Sync → v2) | P16 Kalender (nur Google; Outlook → v2) | 🟠 Review Tage–Wochen; Testmodus mit Workspace-Konten als Brücke | |
|
||||||
|
| ~~A3~~ | ~~Apple Developer~~ | **v3** (kein App-Store in v1/v2 — PWA-only, AD-17) | Konto vorhanden, ruht — keine Aktion | — |
|
||||||
|
| ~~A4~~ | ~~Google Play Console~~ | **v3** (kein App-Store in v1/v2 — PWA-only) | ruht bis native App (v3) | — |
|
||||||
|
| A5 | **Mollie-Konto + Live-Verifizierung** (Geschäftsdaten, Bankkonto, Webseite-Anforderungen) + Lago-Production-Planung | P20 / BILL-08 | 🟠 Tage; Test-Mode reicht für Entwicklung, Live für Go-Live | |
|
||||||
|
| A6 | **Sende-Domain einrichten:** SPF/DKIM/DMARC für Mailjet + **Domain-Warm-up** beginnen | P1 (notify), P2 (Einladungen), P14 (Marketing!) | 🟠 DNS sofort; Reputation/Warm-up braucht Laufzeit — je früher, desto besser für Zustellbarkeit | |
|
||||||
|
| ~~A7~~ | ~~Microsoft Entra (Outlook/Graph)~~ | v2 (Outlook-Kalender + Postfach-Sync → v2) | → v2-Vorbereitung | — |
|
||||||
|
|
||||||
|
## B — Konten/Keys anlegen (Tag 1–3, kurzer Vorlauf)
|
||||||
|
|
||||||
|
| # | Was | Wofür | Hinweis | Wer |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| B1 | **Mailjet**-Konto + API-Keys | P1/P2/P3/P14 | ✅ Boilerplate bereits verdrahtet (`MAILJET_*`) → **AD-6 heute formal locken** | |
|
||||||
|
| B2 | **AirCall**-Konto + API/Sandbox + Webhooks | P15 | Sandbox reicht bis W3 | |
|
||||||
|
| ~~B3~~ | ~~HalloPetra~~ | v2 (M105 → v2) | → v2 | — |
|
||||||
|
| B4 | **PandaDoc** und/oder **DocuSign** Konto + API (Sandbox) | P16 Signatur | einen Provider für Launch wählen, zweiter später | |
|
||||||
|
| B5 | **Hetzner-Projekt `HiveGrid` anlegen** (Infra-ADR-009): S3-Object-Storage-Bucket + Token, Storage Box (Backups) · **DEK-Master-Key** in Coolify-Secrets (AD-8 revidiert: app-seitige Envelope-Encryption, kein Cloud-KMS) · ⚠ `SCALEWAY_*`-Env-Vars der Boilerplate auf Hetzner-Endpoint umziehen (S3-API identisch) | P4 (Storage), P5/P17 (DEK), Prod-Compute | 🟢 Stunden — Muster im Infra-Repo | |
|
||||||
|
| B6 | **Mistral** (La Plateforme) API-Key — **Primär-LLM** (Infra-Wechsel: Scaleway Generative APIs entfallen; zweiter EU-Provider + Whisper → v2) | P13 | ✅ in `.env.example` vorgesehen | |
|
||||||
|
| ~~B7~~ | ~~FCM/APNs~~ | **entfällt** (PWA → Web-Push/VAPID, kein FCM/APNs-Konto nötig) | v2: VAPID-Keys selbst generieren, notify()-Push-Kanal aktivieren | — |
|
||||||
|
| B8 | **Geo-IP-Dienst** (ipapi.is / ipstack) API-Key | P2 (Session-Standortanzeige) | ✅ in Boilerplate; EU-Konformität kurz prüfen oder Feature stubben | |
|
||||||
|
| B9 | **HaveIBeenPwned** k-Anonymity (frei) bzw. API-Key | P2 (Breach-Check) | k-Anonymity-Endpoint ist kostenlos/ohne Key | |
|
||||||
|
| B10 | **Subframe**-Workspace + Lizenzen für Designer + Devs | Designer-Track ab W1 | sofort, sonst steht D0 | |
|
||||||
|
|
||||||
|
## C — Eigene Infra provisionieren (Ops, Woche 1–2)
|
||||||
|
|
||||||
|
| # | Was | Wofür | Deadline | Wer |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| C1 | **Meilisearch: läuft bereits zentral auf `node1`** (Infra-ADR-008) — nur **scoped Key minten** (`indexes: ["hivegrid-*"]`, Muster: Boilerplate-Key vom 06.06.; `MEILI_API_KEY`, nicht Master-Key!) | P11 (AD-5) | 🟢 5 Minuten statt Setup | |
|
||||||
|
| C2 | **mCaptcha: läuft bereits zentral** auf `captcha.saas-ctrl.com` (Infra-ADR-013) — nur ENV anbinden + Sitekey anlegen (AD-7 ✓) | P2 Login, P16 Public-Forms/Booking | 🟢 anbinden statt aufsetzen | |
|
||||||
|
| C3 | **Hosting/Deploy (Infra-ADR-009/010, ersetzt Fly/Scaleway — `fly.toml` entfernt, `deployment-region-provider-pinning.md` stale!):** Staging auf **`staging-1`** via zentrale **Coolify**-Control-Plane (Muster: Boilerplate läuft dort mit 8 Apps) · Prod = Hetzner-Projekt `HiveGrid` (`hivegrid-db`/`-app`/`-worker`/`-lb`) · Registry = Gitea, build-once/promote (Infra-ADR-005). **Staging (User-Entscheidung 12.06., revidiert): ÖFFENTLICH** auf `staging-app.hivegrid.de` + `staging-api.hivegrid.de` (beide unter dem `*.hivegrid.de`-Wildcard-Zertifikat, kein VPN). **Pflicht-Härtung dafür:** (a) **NUR synthetische Daten** — niemals echte Kunden-/Geerkens-Daten auf Staging (DSGVO; Demo-Seeds reichen), (b) eigene Secrets/Keys je Umgebung (Mollie Test-Mode, Lago Staging, eigene OAuth-Apps, eigene Webhook-Secrets), (c) Webhooks auf staging-api mit HMAC-Signaturpflicht + Rate-Limit, (d) `X-Robots-Tag: noindex` + robots.txt deny, (e) Login wie Prod (TOTP), optional IP-Allowlist nachrüstbar. OAuth-Callbacks: Staging-Redirect-URIs (`staging-app.…`) bei KWP/Google mitregistrieren | ab W1 (CI/Gates brauchen Staging!) | Mitte W1 | |
|
||||||
|
| C4 | **Postgres + Redis: Coolify-managed** (Staging auf `staging-1`, Prod auf `hivegrid-db` — Muster: mITapp/Boilerplate; PgBouncer auf staging-1 vorhanden, siehe `docs/ops/pgbouncer.md`) | alles | Mitte W1 | |
|
||||||
|
| C5 | **Domains/DNS + TLS (Cloudflare — `hivegrid.de`-Zone existiert bereits!):** `app.hivegrid.de` + `admin.hivegrid.de` (Host-Routing + Cookie-Domain-Trennung!) + `staging-app.hivegrid.de` + `staging-api.hivegrid.de` (öffentlich, siehe C3) — ein `*.hivegrid.de`-Wildcard deckt alle. Portal/Forms/Booking/Help/API sind **Pfade** unter app.* gemäß `INTEGRATION-CONTRACTS.md` §6 (korrigiert 12.06.) | P1 URL-Schemata, P19 Admin, C3 Staging | W1 | |
|
||||||
|
| C6 | (Optional) **Authentik** für Admin-SSO (AD-3, optional) | P19 | kann Fast-Follow sein | |
|
||||||
|
|
||||||
|
## D — Entscheidungen, die heute fallen können (Boilerplate hat sie quasi getroffen)
|
||||||
|
|
||||||
|
| # | Entscheidung | Faktenlage | Aktion |
|
||||||
|
|---|---|---|---|
|
||||||
|
| D1 | **AD-6 EU-Email-Provider** | Boilerplate ist auf **Mailjet** verdrahtet (Keys, Webhooks, Worker-Delivery) — Tendenz im ADR war ohnehin Mailjet | Heute locken: ADR-Eintrag auf `Accepted`, Konto anlegen (B1), Domain-Setup (A6) |
|
||||||
|
| D2 | **AD-7 Captcha** | Boilerplate liefert **self-hosted mCaptcha** inkl. Infra-README — EU-perfekt (PoW, keine US-Firma) | Heute locken: ADR auf `Accepted`, Instanz aufsetzen (C2) |
|
||||||
|
| D3 | **EU-Sterilisations-Zusatzfunde** | `.env.example` enthält noch **GA-Tracking** (`ANALYTICS_GA_TRACKING_ID`) + **ConvertKit** (US) | In P1-Scope aufnehmen: entfernen/ersetzen (Analytics → EU-Alternative oder raus) |
|
||||||
|
| D4 | Signatur-Provider primär | PandaDoc **oder** DocuSign für Launch | im Team-Meeting wählen (B4) |
|
||||||
|
|
||||||
|
## E — Organisatorisch (Menschen & Termine)
|
||||||
|
|
||||||
|
| # | Was | Wann | Wer |
|
||||||
|
|---|---|---|---|
|
||||||
|
| E1 | **Noah: 4 Freitags-Slots** für Gate-Demos fest blocken (W1 CRM-Vorschau, W2 CRM, W3 Kette, W4 Voll-Walkthrough) | heute terminieren | |
|
||||||
|
| E2 | ~~KWP-Ansprechpartner identifizieren~~ ✅ läuft (KWP-Mail an Noah, 12.06.) · **NEU: Noah-Frage — gehört der Lagerist-Arbeitsplatz (M070) zum Validierungs-Versprechen?** (entscheidet, ob die M070-Dünnung hält) | bei Demo #1 (Fr W2) | |
|
||||||
|
| E3 | Echte SHK-Beispieldaten von Geerkens für Seeds-Validierung (Pipelines, Custom-Felder, Rollen) | bis W2 | |
|
||||||
|
| E4 | Dev-Zuordnung Tracks A/B/C + Scope-Leiter-Abnahme | Team-Meeting | |
|
||||||
|
| ~~E5~~ | ~~App-Store-Metadaten~~ → **v3** (kein App-Store in v1/v2 — PWA-only) | — | — |
|
||||||
|
| **E6** | **AVV-Vertragsvorlage (Auftragsverarbeitung, Art. 28) + DSGVO-Auskunfts-Vorlage** vom Anwalt — Launch-Pflicht für jeden Mandanten! | diese Woche beauftragen | |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Merksatz fürs Meeting:** Kategorie A sind **Wartezeiten** — jede Stunde Verzögerung beim Anstoßen wandert 1:1 ans Ende des Sprints. B+C sind Arbeit, die parallel läuft. D sind Geschenke der Boilerplate — einfach locken.
|
||||||
Binary file not shown.
@@ -0,0 +1,92 @@
|
|||||||
|
# Handoff — D1: Login-2FA-Gate + Trust-Device (Backend)
|
||||||
|
|
||||||
|
> **Temporäres Handoff** (löschbar nach Erledigung). Für einen frischen Agenten, der **nur D1** fertigbaut.
|
||||||
|
> Lies zuerst `AGENTS.md` + `.planning/ticket-docs/R-P2a.md` + `R-P2b.md`. Stand: 2026-06-18.
|
||||||
|
|
||||||
|
## Mission
|
||||||
|
Erzwinge **2FA (TOTP) beim Tenant-Login** (Produktentscheidung 18.06.). Heute fragt der Login **keinen**
|
||||||
|
TOTP-Code ab (2FA nur als Step-up für sensible Aktionen). Baue das **Login-Gate** als Backend; die
|
||||||
|
Code-Eingabe-**Screen** liefert David (D-P2) — baue eine minimale funktionale Inline-UI als Swap-Ziel.
|
||||||
|
|
||||||
|
## Arbeitsbranch
|
||||||
|
`p2b-rls` (auf `origin`, enthält Upstream-Merge + komplettes R-P2a inkl. S4b + R-P2b RLS/Lifecycle/Rollen +
|
||||||
|
D2/D3). Bau D1 **auf `p2b-rls`** weiter (oder eigener Branch off p2b-rls). **Nicht** nach `main` mergen/pushen
|
||||||
|
(main auto-deployt auf Staging). Alles ist grün: `pnpm test` = 3758 passed | 6 skipped (RLS-Integration skippt ohne DB).
|
||||||
|
|
||||||
|
## Toolchain / Befehle (WICHTIG)
|
||||||
|
- Node **22.12.0** via fnm — vor JEDEM pnpm: `eval "$(fnm env)"; fnm use 22.12.0`
|
||||||
|
- `pnpm typecheck` · `pnpm lint` (--max-warnings=0) · `pnpm test` · `pnpm run verify:i18n`
|
||||||
|
- Pre-Push-Hook braucht DB-URLs: `set -a; . ./.env; set +a` vor `git push origin p2b-rls`
|
||||||
|
- Commits enden mit: `Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>`
|
||||||
|
|
||||||
|
## Das Design (so umsetzen)
|
||||||
|
|
||||||
|
**Zwei-Schritt-Login** (die bestehende Step-up-Infra reicht NICHT — die setzt schon eingeloggten `userId` voraus):
|
||||||
|
|
||||||
|
1. **`loginFromRequest`** (`apps/web/app/modules/users/services/AuthService.ts`, ~Z.156). Nach erfolgreichem
|
||||||
|
Passwort-Check + `clearFailedLogins(...)`, **vor** der Session-Erstellung:
|
||||||
|
```ts
|
||||||
|
const totpStatus = await getUserTotpStatus(user.id); // users.db.server.ts
|
||||||
|
if (totpStatus?.enabled) {
|
||||||
|
// KEINE Session. Pending-MFA-Zustand ins SIGNIERTE Cookie: pendingMfaUserId (NICHT userId!)
|
||||||
|
// + pendingMfaRedirectTo (rohes redirectTo). Antwort { requiresMfa: true } + Set-Cookie.
|
||||||
|
return beginPendingMfaLogin({ userId: user.id, redirectTo });
|
||||||
|
}
|
||||||
|
// sonst: bisheriger Pfad (startServerSession + createUserSession)
|
||||||
|
```
|
||||||
|
Da `pendingMfaUserId` ≠ `userId`, gewährt `requireUserId` (liest `userId`) **keinen** Zugriff — Gate hält.
|
||||||
|
|
||||||
|
2. **Verify-Route** (neu, tenant-fähig; Muster: `apps/web/app/routeModules/admin/mfa-challenge.impl.ts`).
|
||||||
|
Liest `pendingMfaUserId` aus dem Cookie → `verifyTotpCode(encryptedSecret, code)` **oder** Recovery-Code
|
||||||
|
(`apps/web/app/utils/auth/mfa/recovery-codes.server.ts`) → bei Erfolg: `setLoggedUser` + `getHome` +
|
||||||
|
`startServerSession` (`services/auth/sessionLifecycle.server.ts`) + `createUserSession` (setzt `userId`,
|
||||||
|
löscht `pendingMfaUserId`). Rate-Limit via `apps/web/app/utils/auth/mfa/challenge-rate-limit.server.ts`.
|
||||||
|
Routen sind folder-convention-autoregistriert (`createRoutesFromFolders`) — neue Datei = neue Route.
|
||||||
|
|
||||||
|
3. **`session.server.ts`**: `pendingMfaUserId?: string` (+ `pendingMfaRedirectTo?`) in den `UserSession`-Typ,
|
||||||
|
in `createUserSession`/`getUserInfo` durchreichen. `requireUserId` **nicht** ändern (liest `userId`).
|
||||||
|
|
||||||
|
4. **Trust-Device** (kann Folgeschritt sein): „diesem Gerät vertrauen → künftig Code überspringen" braucht
|
||||||
|
einen **PERSISTENTEN Geräte-Marker**, der den Logout überlebt — **NICHT** `UserSession.trustedAt` (das ist
|
||||||
|
per Session!). Vorschlag: signierter Long-Lived-Cookie `trusted-device` (HMAC über userId+random, serverseitig
|
||||||
|
gegen eine `TrustedDevice`-Tabelle geprüft) **oder** eine `TrustedDevice`-Tabelle (userId, tokenHash, expiresAt).
|
||||||
|
In Schritt 1 vor dem Gate prüfen → wenn vertrauenswürdig, MFA überspringen. In Schritt 2 bei „remember" setzen.
|
||||||
|
|
||||||
|
## Schlüssel-Dateien
|
||||||
|
- Login: `apps/web/app/modules/users/services/AuthService.ts` (`loginFromRequest`)
|
||||||
|
- TOTP: `apps/web/app/services/auth/totp.server.ts` (`verifyTotpCode`, `getTotpSafeStatus`)
|
||||||
|
- TOTP-Status/Secret: `apps/web/app/utils/db/users.db.server.ts` (`getUserTotpStatus`, `getUserTotpPendingEnrollment`)
|
||||||
|
- Recovery-Codes: `apps/web/app/utils/auth/mfa/recovery-codes.server.ts`
|
||||||
|
- MFA-Rate-Limit: `apps/web/app/utils/auth/mfa/challenge-rate-limit.server.ts`
|
||||||
|
- Admin-Muster (spiegeln): `apps/web/app/routeModules/admin/mfa-challenge.impl.ts`
|
||||||
|
- Cookie/Session: `apps/web/app/utils/session.server.ts` (+ Test `session.server.test.ts` mockt store/lifecycle)
|
||||||
|
- Server-Session: `apps/web/app/services/auth/sessionLifecycle.server.ts` (`startServerSession`)
|
||||||
|
- Enrollment (existiert, Tenant): `apps/web/app/routes/app.$tenant/settings/profile.tsx`
|
||||||
|
|
||||||
|
## DoD (D1) — ERLEDIGT 2026-06-18 (Details in `.planning/ticket-docs/R-P2a.md`, Abschnitt „D1")
|
||||||
|
- [x] TOTP-User bekommt mit Passwort allein **keine** Session (Gate); Antwort `requiresMfa`.
|
||||||
|
- [x] Verify-Route schließt Login ab (TOTP **und** Recovery-Code), inkl. Server-Session-Erzeugung.
|
||||||
|
- [x] `requireUserId` lehnt den Pending-Zustand ab (kein Zugriff vor Verify) — unverändert (liest nur `userId`).
|
||||||
|
- [x] Trust-Device-Skip via persistentem Marker (signiertes `RJ_trusted_device`-Cookie, 30 Tage; ohne DB-Tabelle).
|
||||||
|
- [x] Minimale Code-Eingabe-UI (data-ui-id) als Swap-Ziel für Davids D-P2 (`routeModules/auth/login-mfa.component.tsx`).
|
||||||
|
- [x] i18n-Keys (de+en) für alle UI-Texte (`account.loginMfa.*`). Tests: TOTP-User→requiresMfa, Verify-OK→Session,
|
||||||
|
Verify-Falsch→Reject, Nicht-TOTP-User→normaler Login (Regression). Bestehende Login-Tests bleiben grün.
|
||||||
|
- [x] `pnpm typecheck` + `pnpm lint` + `pnpm run verify:i18n` + `pnpm test` grün (**3777 passed | 6 skipped**).
|
||||||
|
|
||||||
|
> Restpunkt (Folge): tabellengestützte Einzel-Geräte-Widerrufbarkeit (`TrustedDevice`-Tabelle). Handoff
|
||||||
|
> kann nach Plane-Pflege gelöscht werden.
|
||||||
|
|
||||||
|
## Gotchas
|
||||||
|
- **i18n-Guard**: user-facing Strings MÜSSEN i18n-Keys sein (kein Klartext auf `description`/`title`/Label-Props).
|
||||||
|
Keys in `apps/web/public/locales/{de,en}/*.json` (Parität!). `auth.json` für Auth-Fehler, `settings.json` (flache Dot-Keys).
|
||||||
|
- Login-Tests haben Nicht-TOTP-User → der neue Zweig greift dort nicht (additiv, kein Bruch).
|
||||||
|
- `verifyTotpCode` nimmt das **verschlüsselte** Secret (siehe Admin-impl Z.135 wie es geholt wird).
|
||||||
|
- AD-21: Schema-Änderungen (falls `TrustedDevice`-Tabelle) via `prisma db push` auf dem Branch; lokale DB war down
|
||||||
|
→ Docker `pgvector/pgvector:pg16` (Setup-Muster im Header von `apps/web/app/utils/db/.server/rls-tenant-isolation.integration.test.ts`).
|
||||||
|
|
||||||
|
## Plane (Ticket-Pflege)
|
||||||
|
- R-P2a #18 = `4b52fe1d-eb78-42b2-a169-ad410553d86f`; R-P2b #19 = `1a0471a4-3a68-41b6-a21c-421200267230`.
|
||||||
|
- Token: `~/.cli-tokens/plane` (oder `PLANE_API_KEY`). Base `https://project.tool-ctrl.de`, Workspace `toolctrl`,
|
||||||
|
Projekt `35d0d968-8ab3-40cc-97b8-b81d917dc5df`. Identität prüfen via `GET /api/v1/users/me/` (muss `raffael` sein).
|
||||||
|
- Kommentar-Stil: Prefix „Claude: ", 1. Person (= raffael), schlicht, kein AI-Sprech, **keine Em-Dashes (—)**, korrekte Umlaute.
|
||||||
|
- Abschluss: Ticket-Doc (`.planning/ticket-docs/R-P2a.md`) Umsetzungsstand + Proof ergänzen, dann Plane-Kommentar.
|
||||||
+162
@@ -0,0 +1,162 @@
|
|||||||
|
# HiveGrid CRM: Datenlogik und UX-Entscheidungen
|
||||||
|
|
||||||
|
Konsolidierte Grundlage fuer CRM-Kern, Pipeline-Views, Kontakte und Relations
|
||||||
|
|
||||||
|
| Feld | Inhalt |
|
||||||
|
| --- | --- |
|
||||||
|
| Projekt | HiveGrid CRM / Pipeline-Grundstruktur |
|
||||||
|
| Dokumenttyp | Produkt- und UX-Entscheidungsbriefing |
|
||||||
|
| Stand | Nach Developer-Ruecksprache: keine Aenderungen erforderlich |
|
||||||
|
| Hinweis | Die Screenshots wurden als Arbeitskontext genutzt, sind aber nicht Teil dieses finalen Dokuments, da mehrere Details inzwischen ueberholt sind. |
|
||||||
|
|
||||||
|
**Ziel:** Dieses Dokument beschreibt die fachliche Datenlogik, Relationen und groben UX-Entscheidungen. Es trifft keine technischen Infrastrukturentscheidungen und ersetzt keine spaetere Detailumsetzung.
|
||||||
|
|
||||||
|
## 1. Executive Summary
|
||||||
|
|
||||||
|
Das CRM-Modell besteht aus einer klaren Vorstufe und einem zentralen Arbeitskern: **LeadInput** sammelt und qualifiziert eingehende Leads. Nach Weiterverarbeitung/Freigabe entsteht ein **Projekt**. Ab diesem Zeitpunkt ist Projekt der zentrale Datensatz, auf den Pipelines, Status, Kontakte, Aufgaben, Checklisten und weitere Arbeitsbereiche schauen.
|
||||||
|
|
||||||
|
Pipelines sind keine eigenen Objektarten. Namen wie Deal oder Auftrag sind nur Beispiele fuer frei konfigurierbare Views. Der Admin entscheidet, welche Pipelines existieren, wer sie sehen darf und welche Felder dort sichtbar oder verpflichtend sind.
|
||||||
|
|
||||||
|
Kontakt ist der Oberbegriff fuer Personen und Organisationen. Ob ein Kontakt Kunde ist, wird ueber einen Kontaktstatus abgebildet. Hauptkontakt und Sekundaerkontakt beschreiben die Kontaktart bzw. Rolle im jeweiligen Kontext.
|
||||||
|
|
||||||
|
| Bereich | Entscheidung | Auswirkung fuer Screens |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| LeadInput | Eigenes Tool und Vorstufe vor Projekt. | Lead-Daten koennen spaetere Projektfelder vorbereiten, werden aber erst nach Freigabe vererbt. |
|
||||||
|
| Projekt | Zentraler Arbeitsdatensatz nach Weiterverarbeitung. | Projekt-Detail wird der wichtigste Kontext fuer Pipeline-Arbeit. |
|
||||||
|
| Pipeline | Frei konfigurierbare View auf Projekte. | Pipeline-Name, Zugriff, Felder und Pflichtlogik sind adminseitig steuerbar. |
|
||||||
|
| Kontakte | Kontakt ist Oberbegriff; Typen sind Privatperson oder Organisation. | Organisationen und Personen werden ueber klare Listen und Verknuepfungen erreichbar. |
|
||||||
|
| Inline Edit | Verknuepfte Daten duerfen direkt inline bearbeitet werden. | Edits schreiben auf den verknuepften Datenpunkt zurueck; Verlauf/Rollback sichert nachtraeglich ab. |
|
||||||
|
|
||||||
|
## 2. LeadInput und Projekt
|
||||||
|
|
||||||
|
### Grundlogik
|
||||||
|
|
||||||
|
**LeadInput** ist ein eigenes Tool. Dort werden Leads aus unterschiedlichen Quellen gesammelt, z. B. Formular, Website, Social Media, Leadliste, CSV-Import oder manuelle Erfassung.
|
||||||
|
|
||||||
|
LeadInput kann bereits Datenpunkte enthalten, die spaeter auch im Projekt relevant sind. Viele Felder koennen noch leer sein. Wenn eine Quelle oder API bereits passende Daten liefert, koennen diese frueh dem richtigen Datenpunkt zugeordnet werden.
|
||||||
|
|
||||||
|
Bei Weiterverarbeitung werden relevante Lead-Daten in ein Projekt vererbt. Die fachliche Trennung liegt zwischen **Lead** und **Projekt**, nicht zwischen Deal und Projekt.
|
||||||
|
|
||||||
|
### Weiterverarbeitungsfreigabe
|
||||||
|
|
||||||
|
Jeder Lead braucht den Datenpunkt **Weiterverarbeitungsfreigabe**. Die genaue DSGVO-/Prozesslogik kann spaeter durch Developer bzw. Datenschutz abgestimmt werden. Fuer diese Strukturentscheidung ist wichtig, dass der Datenpunkt existiert.
|
||||||
|
|
||||||
|
| Wert | Bedeutung fuer die Produktlogik |
|
||||||
|
| --- | --- |
|
||||||
|
| Ja | Lead darf in ein Projekt ueberfuehrt werden; relevante Daten koennen vererbt werden. |
|
||||||
|
| Nein | Normale Projektanlage soll nicht stattfinden. |
|
||||||
|
| Unklar / Pruefen | Weiterverarbeitung ist fachlich nicht eindeutig freigegeben; genaue Behandlung wird spaeter festgelegt. |
|
||||||
|
|
||||||
|
## 3. Projekt und Pipelines
|
||||||
|
|
||||||
|
### Projekt als Kern
|
||||||
|
|
||||||
|
Projekt ist der zentrale Arbeitsdatensatz. Alle Pipeline-Views, Aufgaben, Kontakte, Checklisten, Termine, Rechnungen und Integrationsdaten beziehen sich auf diesen Kern.
|
||||||
|
|
||||||
|
### Pipelines als Views
|
||||||
|
|
||||||
|
- Eine Pipeline ist eine frei benennbare Ansicht auf Projekte.
|
||||||
|
- Begriffe wie Deal oder Auftrag sind nur Beispielnamen.
|
||||||
|
- Ein Projekt ist genau einer Pipeline zugeordnet.
|
||||||
|
- Eine Mehrfachsichtbarkeit wuerde ueber Duplikation laufen und waere dann ein eigenes Projekt.
|
||||||
|
- Der UI-Begriff **Status** meint den Status innerhalb der aktuellen Pipeline.
|
||||||
|
- Ein separater globaler Projektstatus wird vorerst nicht benoetigt.
|
||||||
|
|
||||||
|
### Admin-Konfiguration
|
||||||
|
|
||||||
|
Admins koennen Pipelines anlegen, benennen und konfigurieren. Dazu gehoert:
|
||||||
|
|
||||||
|
- Zugriff: Welche Personen oder Rollen duerfen die Pipeline sehen?
|
||||||
|
- Feldsichtbarkeit: Welche Datenpunkte sind in der Pipeline sichtbar?
|
||||||
|
- Pflichtfelder: Welche Felder sind pro Pipeline oder Status verpflichtend?
|
||||||
|
- Statuswerte: Welche Spalten oder Schritte hat die Pipeline?
|
||||||
|
|
||||||
|
Nicht sichtbare Felder verschwinden nicht. Sie bleiben im Hintergrund erhalten und koennen z. B. fuer Admins oder andere Pipeline-Kontexte sichtbar sein.
|
||||||
|
|
||||||
|
## 4. Projektattribute und Unterbereiche
|
||||||
|
|
||||||
|
Projekt kann viele direkte Attribute haben. Gleichzeitig sollten wiederholbare oder eigenstaendige Bereiche nicht in ein einziges flaches Formular gezwungen werden.
|
||||||
|
|
||||||
|
| Direkte oder direkt sichtbare Projektattribute | Verknuepfte Bereiche / Unterbereiche |
|
||||||
|
| --- | --- |
|
||||||
|
| Projektname, Quelle, Promotion, Projekttyp, Status, Prioritaet, Start, Deadline, Auftragsvolumen, potenzieller Auftragswert, zustaendige Person, Projektleiter, Monteur, Projektadresse, separate Rechnungsadresse, separate Bauherradresse, projektbezogene Kommunikationsdaten. | Kontakte, Termine, Rechnungen, Checklisten, Aufgaben, Aktivitaeten, Dokumente, API-/KWP-Felder. |
|
||||||
|
|
||||||
|
### Maengel
|
||||||
|
|
||||||
|
**Maengel** werden nicht als eigenes Modul verstanden. Sie werden ueber Checklisten abgebildet, z. B. als Checkliste mit dem Namen Maengel.
|
||||||
|
|
||||||
|
### API-/KWP-Felder
|
||||||
|
|
||||||
|
API-/KWP-Felder sind im View-Kontext sichtbarkeitssteuerbare Felder. Ob sie in einer Pipeline sichtbar sind, entscheidet der Admin. Separat zu klaeren bleibt nur, welche Felder editierbar oder rein synchronisiert sind.
|
||||||
|
|
||||||
|
## 5. Kontaktmodell
|
||||||
|
|
||||||
|
**Kontakt** ist der Oberbegriff. Ein Kontakt kann eine Privatperson oder Organisation sein. Ob daraus Kunde oder spaeter Bestandskunde wird, laeuft ueber den Kontaktstatus.
|
||||||
|
|
||||||
|
| Begriff | Bedeutung |
|
||||||
|
| --- | --- |
|
||||||
|
| Kontakt | Oberbegriff fuer CRM-Kontakte. |
|
||||||
|
| Kontakttyp | Privatperson oder Organisation. |
|
||||||
|
| Kontaktstatus | Klaert, ob der Kontakt z. B. Kontakt, Kunde oder Bestandskunde ist. Werte spaeter final definieren. |
|
||||||
|
| Kontaktart | Hauptkontakt oder Sekundaerkontakt im jeweiligen Kontext. |
|
||||||
|
| Organisation | Top-Level-Kontakt fuer Unternehmen, Einrichtungen oder andere Organisationen. |
|
||||||
|
|
||||||
|
### Organisationen
|
||||||
|
|
||||||
|
Es gibt keine harte Grundunterscheidung zwischen Unternehmen und oeffentlicher Einrichtung. Der Grundtyp bleibt **Organisation**. Falls spaeter benoetigt, kann ein optionales Organisationsmerkmal oder Rechtsformfeld ergaenzt werden, z. B. GmbH, KG, oeffentliche Einrichtung oder sonstige Organisation.
|
||||||
|
|
||||||
|
### Hauptkontakt und Sekundaerkontakte
|
||||||
|
|
||||||
|
- Beim Erstellen einer Organisation soll ein Hauptkontakt mit angelegt bzw. direkt sichtbar sein.
|
||||||
|
- Mehrere Hauptkontakte sollen moeglich sein.
|
||||||
|
- Sekundaerkontakte koennen zusaetzlich als Liste im Kontext erscheinen.
|
||||||
|
- Bei Privatpersonen kann die Privatperson selbst als Hauptkontakt wirken.
|
||||||
|
- Weitere Sekundaerkontakte koennen auch bei Privatpersonen verknuepft werden.
|
||||||
|
|
||||||
|
Ob diese Verknuepfung technisch Parent, Relation oder Link heisst, ist fuer die UX zweitrangig. Wichtig ist, dass die Kontakte miteinander verknuepft und im richtigen Kontext sichtbar sind.
|
||||||
|
|
||||||
|
## 6. Listen, Navigation und Ansichten
|
||||||
|
|
||||||
|
### Listen
|
||||||
|
|
||||||
|
Fuer die Navigation sind zwei Einstiege sinnvoll:
|
||||||
|
|
||||||
|
- **Unternehmen** oder **Organisationen**: Einstieg fuer Organisationsdatensaetze.
|
||||||
|
- **Kontakte**: Einstieg fuer Personen und Ansprechpartner.
|
||||||
|
|
||||||
|
Personen sollen direkt suchbar sein, aber auch ueber Unternehmen bzw. Organisationen erreichbar bleiben. Die Kontaktliste sollte nach Unternehmen/Organisation filterbar sein.
|
||||||
|
|
||||||
|
### Aggregierte und spezifische Ansichten
|
||||||
|
|
||||||
|
Pipeline-/Projektansichten sind aggregierte Arbeitsansichten. Sie duerfen Projekt-, Kontakt- und Organisationsdaten zusammen anzeigen, wenn das fuer den Arbeitskontext sinnvoll ist.
|
||||||
|
|
||||||
|
Spezifische Ansichten wie Organisation oder Kontakt zeigen primaer die eigenen Daten. Verknuepfte Projekte, Kontakte oder Pipelines erscheinen dort als Referenz oder Liste, nicht als komplett fremdes Hauptformular.
|
||||||
|
|
||||||
|
### Inline-Bearbeitung und Verlauf
|
||||||
|
|
||||||
|
Verknuepfte Daten duerfen direkt inline bearbeitet werden. Ein Feld kann in einer Projektansicht sichtbar sein, fachlich aber zu Kontakt oder Organisation gehoeren. Der Edit schreibt dann auf den verknuepften Datenpunkt zurueck.
|
||||||
|
|
||||||
|
Die genaue visuelle Loesung ist UI-Ausfuehrung. Verlauf und Rollback sollen nachvollziehbar machen, was wann und von wem geaendert wurde.
|
||||||
|
|
||||||
|
## 7. Backlog
|
||||||
|
|
||||||
|
Folgende Module sind vorgemerkt, werden aber nicht in den ersten CRM-/Pipeline-Kern gezogen:
|
||||||
|
|
||||||
|
- Baustelle
|
||||||
|
- Supporttickets
|
||||||
|
- Leistungspositionen
|
||||||
|
- Zeiterfassung
|
||||||
|
- Materialbedarf
|
||||||
|
- Abnahme
|
||||||
|
|
||||||
|
## 8. Offene Punkte fuer spaetere Screens
|
||||||
|
|
||||||
|
1. Heisst die Organisationsliste im UI **Unternehmen** oder **Organisationen**?
|
||||||
|
2. Braucht es ein optionales Organisationsmerkmal/Rechtsform-Feld?
|
||||||
|
3. Welche Kontaktstatus-Werte werden final benoetigt?
|
||||||
|
4. Welche Pipeline-Statuswerte braucht die erste konkrete Pipeline?
|
||||||
|
5. Welche Projektkopf-Felder sind in einer konkreten View sichtbar?
|
||||||
|
6. Welche API-/KWP-Felder sind nur synchronisiert und welche editierbar?
|
||||||
|
|
||||||
|
Ende des konsolidierten Stands. Screenshots wurden bewusst nicht eingebunden, da sie nur als Arbeitskontext dienten und teilweise nicht mehr dem aktuellen Modell entsprechen.
|
||||||
|
|
||||||
@@ -0,0 +1,186 @@
|
|||||||
|
# Interim-UI Design-Standards — „David-nah bauen"
|
||||||
|
|
||||||
|
**Zweck:** Damit eine Interim-UI (AD-28, `.planning/INTERIM-UI-PLAYBOOK.md`) möglichst nah an Davids
|
||||||
|
kommenden finalen Subframe-Screens landet, baut der Dev nach **denselben** Layout-/Komponenten-/State-
|
||||||
|
Standards wie David. Dann ist Davids späterer Nachzug fast nur noch Feinschliff.
|
||||||
|
|
||||||
|
**Quelle & Autorität:** Diese Werte sind ein **In-Repo-Spiegel** von Davids Wireframe-Vault
|
||||||
|
`HiveGrid-Wireframes/` (Schwester-Ordner: `../HiveGrid-Wireframes/`, Gitea `git.tool-ctrl.de/david/Hivegrid-Wireframes`).
|
||||||
|
Autoritativ ist **immer der Vault**:
|
||||||
|
- `../HiveGrid-Wireframes/04 Standards/Subframe UI Standards/Layout/README.md` (Layout-Bibel, Entscheidungen D01–D0x)
|
||||||
|
- `../HiveGrid-Wireframes/Tickets/Fertige Tickets/D-D0b Layout Standards.md` (Handoff der Layout-Standards)
|
||||||
|
- `../HiveGrid-Wireframes/01 Regeln/Wireframing Playbook.md` + `Screen Agent Workflow.md` (Bau-/State-Regeln)
|
||||||
|
- `../HiveGrid-Wireframes/02 Wireframes/Screen Paket Tracker.md` (Screen-/Flow-Liste, Subframe-Links)
|
||||||
|
|
||||||
|
Der Vault liegt nicht im Cloud-Repo (CI/andere Maschinen haben ihn evtl. nicht) — deshalb dieser Spiegel.
|
||||||
|
**Bei Zweifel/Drift den Vault lesen und diese Datei nachziehen.** Davids Werte gewinnen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. Grundprinzip — Component-Defaults statt manueller Tailwind-Overrides
|
||||||
|
|
||||||
|
Davids härteste Bau-Regel (Layout-README, „Nutzung bei Subframe-MCP-Arbeit"):
|
||||||
|
|
||||||
|
> Komponenten-Defaults und Varianten verwenden, wenn sie den Standard bereits korrekt abbilden. Keine
|
||||||
|
> manuellen Tailwind-Overrides für Werte, die bereits über Auto Layout, Komponenten oder Varianten
|
||||||
|
> abgedeckt sind.
|
||||||
|
|
||||||
|
Für uns: **`~/ui`-Component-Defaults sind führend.** Wenn `Button`, `TextInput`, `Table`, `Dialog`, `Card`
|
||||||
|
das Padding/Gap/die Höhe schon intern richtig haben → Component + passende Variante nutzen, **nicht**
|
||||||
|
Höhen/Paddings mit Tailwind nachbauen. Manuelle Werte nur für feste Größen, Max-Breiten, Scroll/Overflow
|
||||||
|
oder responsive Constraints. Die Zahlen unten sind zum Prüfen/Setzen dort, wo eine Komponente sie nicht
|
||||||
|
selbst mitbringt — nicht zum Überschreiben funktionierender Defaults.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Spacing-Skala (D01) — 8px-Rhythmus
|
||||||
|
|
||||||
|
Erlaubte Layout-Werte (px): **4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96**.
|
||||||
|
- `8` = Basislogik für normale Gaps/Paddings. `4/12/20` = kompakte Zwischenwerte (Field-Anatomy, kleine
|
||||||
|
Icon-/Text-Abstände). `2` nur für Border-/Focus-/Icon-Feintuning.
|
||||||
|
- **Nicht neu einführen:** 6, 10, 14, 28, 36, 44 — nur wenn eine bestehende Komponente/ein Token sie schon mitbringt.
|
||||||
|
|
||||||
|
## 2. Page / Card / Grid-Padding (D02)
|
||||||
|
|
||||||
|
| Rolle | Wert |
|
||||||
|
|---|---|
|
||||||
|
| Page Padding (Standard & Minimum) | **24px** (nie darunter) |
|
||||||
|
| Card / Surface Padding | **16px** |
|
||||||
|
| Detail-/Editor-Surface Padding | **16px** |
|
||||||
|
| Grid / Card Gap | **16px** (kompakter Sonderfall 12px) |
|
||||||
|
| Section Gap (größere Bereiche) | **24px** |
|
||||||
|
|
||||||
|
Kompakte Momente reduzieren **nur lokale Gaps**, nie das Page Padding. `32px` ist **kein** freier Standard
|
||||||
|
für Detail-/Editorflächen — Ausnahme: die `Dialog`-Komponente darf eine 32px-Variante haben. Mobile-Padding = Backlog.
|
||||||
|
|
||||||
|
## 3. Text-Rhythmus (D03) — nur mit 150%-Text-Tokens für beschreibende Texte
|
||||||
|
|
||||||
|
| Zwischenraum | Gap |
|
||||||
|
|---|---|
|
||||||
|
| Page Title → Page Description | **0px** |
|
||||||
|
| Page Header → erster Content | **24px** |
|
||||||
|
| Section Title → Section Description | **0px** |
|
||||||
|
| Section Description → Section Content | **12px** |
|
||||||
|
|
||||||
|
`0px` ist ein bewusster Gap (kein Auto-Layout-Abstand). Beschreibungen nutzen **150%-Line-height-Tokens**
|
||||||
|
(auch bei einer Zeile). `0`-Line-height-Token nur für garantierte Einzeiler (Button-Label, Badge, Tab,
|
||||||
|
kompakte Truncation-Zelle), **nie** für umbrechbaren Text.
|
||||||
|
|
||||||
|
## 4. Formulare & Field-Anatomy
|
||||||
|
|
||||||
|
- **Field-Gap** zwischen kompletten Feld-Komponenten: **16px** (kompakt 12px; bewusst getrennte Sections 24px).
|
||||||
|
- **Field-Anatomy** (Reihenfolge `label → helpText → Control → message`):
|
||||||
|
`label → helpText` **8px** · `helpText → Control` **6px** · `Control → message` **4px** · `message` = 12px, Medium.
|
||||||
|
- Beschreibungen/Hilfetexte über die Component-Props/Slots füllen, **nicht** als freie Textblöcke daneben bauen.
|
||||||
|
- **Feldnamen (Vokabular):** unterer Field-Text heißt immer **`message`** (nicht `label`/`helper`/`helpText`).
|
||||||
|
- Form-Input horizontales Innenpadding: **12px** (ohne Icon / Rand↔Icon), Icon↔Text **8px** (Textarea ausgenommen).
|
||||||
|
- Form-Input-Radius: **`Radius Small` = 4px**.
|
||||||
|
|
||||||
|
## 5. Control-Höhen & Radius
|
||||||
|
|
||||||
|
- **Control-Höhen (exakt):** Small **32px** · Medium **36px** · Large **48px**. **Medium ist Default**
|
||||||
|
(heißt aber `Medium`, nicht `Default`). Gilt für Button, IconButton, TextInput, NumberInput, Select,
|
||||||
|
Multiselect(+Tags), Combobox, SearchInput, DatePicker (Single), ToggleGroup, ButtonGroup.
|
||||||
|
- **Radius-Tokens:** Small **4px** · Medium **8px** · Large **12px** · Round **9999px**.
|
||||||
|
- **Button:** Default-Variante = Medium = 36px hoch. Button-Höhe/-Padding **nicht** im Screen nachbauen.
|
||||||
|
- **Table:** Row-Height/Cell-Padding/Header-Dichte über die Table-Komponente (Carbon-Referenz: Rows
|
||||||
|
xs 24 / sm 32 / md 40 / lg 48 / xl 64, Column-Padding 16). Dichte wählen statt eigene Tabellenwerte setzen.
|
||||||
|
|
||||||
|
## 6. Dialoge / Modale (D07) — echte Dialog-Struktur
|
||||||
|
|
||||||
|
**Modal = in `~/ui` immer die echte `Dialog`-Komponente** (`DialogLayout → Dialog → Dialog.Content`).
|
||||||
|
**Verboten:** Modal aus `Card`, freiem `div`, absolutem Overlay, Blur-Hintergrund oder Fullscreen-Wrapper
|
||||||
|
nur visuell nachbauen. Vor Handoff prüfen, dass `Dialog` importiert ist und `Dialog.Content` im JSX steht.
|
||||||
|
|
||||||
|
**Ort-Begriffe:** `Page` = eigener App-Ort (Settings etc.) · `Dialog` = temporäres zentriertes Overlay ·
|
||||||
|
`Fullscreen Dialog` = viewport-füllendes Overlay (nicht für dauerhafte Bereiche) · `Drawer/Side Panel` =
|
||||||
|
seitliches Overlay (eigene Breitenregel).
|
||||||
|
|
||||||
|
| Dialog-Größe | Breite | wofür |
|
||||||
|
|---|---|---|
|
||||||
|
| XS | **420px** | kurze Bestätigung / knapper Hinweis |
|
||||||
|
| S | **560px** | kleines Formular, wenige Felder |
|
||||||
|
| M | **720px** | normales Formular / kurze Section-Struktur |
|
||||||
|
| L | **1200px max** | großer Editor mit Navigation/Suche |
|
||||||
|
|
||||||
|
- **Dialog-Padding:** **16px** Default, **32px** ruhigere Variante — über die Dialog-Variante, nicht per Override.
|
||||||
|
- **Dialog-Interne Gaps:** Title→Description **8px** · Field/Form-Row **16px** · Section-Gap **24px** ·
|
||||||
|
Footer-Button-Gap **8px**. **Footer-Actions rechts** ausgerichtet.
|
||||||
|
- Breitenklasse bleibt fix (wächst nicht auf 4K mit), nur der Overlay-Rand wächst; auf kleinen Viewports
|
||||||
|
Max-Width relativ zum Viewport. Fullscreen: Rand 24px/Seite, `width: calc(100vw - 48px)`, `height: calc(100vh - 48px)`.
|
||||||
|
|
||||||
|
## 7. Zustände (D09) — inline State-Komponenten, keine eigenen Screens
|
||||||
|
|
||||||
|
**Empty / Loading / Permission-Denied sind inline State-Komponenten, keine Modale und keine eigenen Screens**,
|
||||||
|
solange sie dem Standard entsprechen. In `~/ui`: `EmptyState`, `ErrorState`, `SkeletonText`/`Loader`, plus
|
||||||
|
Permission-Denied. (Erinnerung DoD/Bauprinzip: Permission-Denied zeigt **404, nicht 403**.)
|
||||||
|
|
||||||
|
**Nur** blockierende / sicherheits- / copy-kritische Zustände bekommen eigene Screens. Ein **blockierender
|
||||||
|
Error-State** braucht: Titel/Kernaussage · Ursache in Nutzersprache · Primäraktion · Sekundäraktion (zurück/Support).
|
||||||
|
|
||||||
|
## 8. Banner / Toast / Modal / Inline / Screen — Entscheidungs-Hierarchie
|
||||||
|
|
||||||
|
| UI-Form | Wann | `~/ui` | eigener Screen? |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **Inline** | betrifft genau ein Feld, dort korrigierbar (Pflichtfeld, ungültige Mail, 2FA-Code falsch) | Field-`message` | nein |
|
||||||
|
| **Screen-Banner** | betrifft aktuellen Screen/Formular (Login falsch, Speichern fehlgeschlagen, Integration getrennt) | `BannerAlert`/`Alert` | nur wenn optisch/fachlich wichtig |
|
||||||
|
| **Globaler Banner** | App/Shell/Tenant (Zahlung offen, Tenant gesperrt, Wartung) | App-Shell/D0 | D0 |
|
||||||
|
| **Toast** | kurze, nicht-blockierende Rückmeldung (gespeichert, kopiert, Export gestartet) | `Toast` | nein |
|
||||||
|
| **Modal/Dialog** | Nutzer bestätigt/entscheidet kurz, bleibt im Kontext (löschen, Rolle wechseln) | echter `Dialog` | falls eigener Entscheidmoment |
|
||||||
|
| **Eigener Screen** | Nutzer blockiert / neuer Flow-Status (Link abgelaufen, Magic-Link gesendet, Account gesperrt) | eigene Route | ja |
|
||||||
|
|
||||||
|
Faustregel: direkt im Feld korrigierbar → Inline; bleibt im Screen → Banner; kurze Rückmeldung → Toast;
|
||||||
|
muss bestätigen → Modal; blockiert → eigener Screen. Sicherheit/Zugang/Vertrauen/Recht → **eher Banner/Screen, nie Toast**.
|
||||||
|
|
||||||
|
## 9. Copy ist eine Design-Entscheidung
|
||||||
|
|
||||||
|
Bei **copy-kritischen** Zuständen (Auth, Sicherheit, Zugang, Erfolg — z.B. „Magic-Link gesendet",
|
||||||
|
„E-Mail oder Passwort ist nicht korrekt" (neutral, keine Enumeration), „Account gesperrt") den Text
|
||||||
|
**nicht selbst erfinden**. Entweder die im Screen-Paket dokumentierte Copy übernehmen oder Platzhalter-Copy
|
||||||
|
**klar als interim markieren** (i18n-Key mit `TODO`/interim-Hinweis), damit Davids Copy leicht einsetzbar ist.
|
||||||
|
Field-Validierung (Pflichtfeld, Passwort zu schwach) bleibt beim Form-Kit, kein eigener Zustand — außer fachlich/rechtlich wichtig.
|
||||||
|
|
||||||
|
## 10. Weitere Konventionen
|
||||||
|
|
||||||
|
- **Default-Ansicht = Admin**, außer der Flow braucht sichtbar eine andere Rolle (dann Variante).
|
||||||
|
- **Vokabular:** `Medium` (nicht `Default`) · `message` (nicht `label`) · `error` ≠ `destructive` (getrennt halten) ·
|
||||||
|
States `default/hover/active/focus/disabled/loading/error/selected` (`focus`≠`selected`).
|
||||||
|
- **Prop-Reihenfolge** (falls du Component-APIs baust): Zustand → Erscheinung → Größe → Layout-Sonderfälle →
|
||||||
|
Sichtbarkeit → Inhalt/Slots (Details in `07_Global-Rules.md` des Vaults).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. Verzahnung mit Davids Screen-Format (gleiche Sprache sprechen)
|
||||||
|
|
||||||
|
Damit der spätere Swap trivial wird, benennt und strukturiert die Interim-UI wie Davids Vault:
|
||||||
|
|
||||||
|
- **Screen-IDs übernehmen:** `S` = eigener Screen · `V` = Variante · `M` = Modal · `D` = dokumentierter
|
||||||
|
Zustand (kein Frame). Namen 1:1 wie im **Screen Paket Tracker** (z.B. „S01 Login", „S04 2FA Code eingeben",
|
||||||
|
„M02 Rolle bearbeiten", „V01 Login falsche Daten"). Interim-`<XPage>`-Dateien/Komponenten nach diesen IDs benennen.
|
||||||
|
- **Join-Schlüssel `ticket: D-*`:** Davids Pakete/Screens tragen `ticket: D-P2` (usw.) im Frontmatter — das
|
||||||
|
ist die Brücke zwischen unserem Cloud-Dev-Ticket und seinen Screens. Im Interim-UI-Vermerk der Ticket-Doc
|
||||||
|
das zugehörige `D-*` nennen (steht ohnehin im „blocked-by"/Screens-Block).
|
||||||
|
- **Subframe-Links:** Sobald Davids Paket auf `In Subframe`/`Review`/`Fertig` steht, hat **jeder Screen einen
|
||||||
|
`design/`-Deep-Link** (Team `f023064a5ca0`) im Tracker + Screen-Frontmatter, das Paket einen `flow/`-Link.
|
||||||
|
Diese sind die Vorlage für die Interim-UI (annähern) und später die Quelle des finalen Nachzugs.
|
||||||
|
- **Zustände-Tabelle** je Screen (`Zustand | Beschreibung | Umsetzung` mit Kanon Leer/Laden/Fehler/Keine
|
||||||
|
Berechtigung, Umsetzung-Enum Bauen/Wiederverwenden/Nur dokumentieren/Später/Raus) übernehmen, damit klar
|
||||||
|
ist, was Interim baut vs. dokumentiert.
|
||||||
|
|
||||||
|
**Nachzug-Trigger:** Wenn Davids Handoff kommt (neue/aktualisierte Datei in
|
||||||
|
`../HiveGrid-Wireframes/Tickets/Fertige Tickets/D-*.md` + Paket-Status im Tracker auf `Fertig`), zieht der
|
||||||
|
Dev die `design/`-Screens nach (siehe Refactor-Ablauf im Playbook), setzt den `🎨 design-nachzug`-Tag auf
|
||||||
|
erledigt und zieht die Visual-Baseline neu.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. Checkliste „David-nah" (pro Interim-Screen)
|
||||||
|
|
||||||
|
- [ ] Aus `~/ui`-Components + Layout gebaut, VM als Prop, kein handgeschriebenes Tailwind für Spacing/Höhen.
|
||||||
|
- [ ] Page 24 · Card/Surface 16 · Grid-Gap 16 · Section-Gap 24 · Field-Gap 16 · Text-Rhythmus (0/24/0/12).
|
||||||
|
- [ ] Controls: Medium(36) Default, Radius small(4) an Inputs; Button/Table-Dichte aus der Komponente.
|
||||||
|
- [ ] Modale als echter `Dialog` (`DialogLayout → Dialog → Dialog.Content`), Größe XS420/S560/M720/L1200, Padding 16/32, Footer rechts.
|
||||||
|
- [ ] Empty/Loading/Permission als inline State-Komponenten (Permission-Denied = 404), keine Extra-Screens.
|
||||||
|
- [ ] Banner/Toast/Modal/Inline/Screen nach Hierarchie (§8) gewählt.
|
||||||
|
- [ ] Copy-kritische Texte nicht erfunden — dokumentierte Copy oder interim-markierter Platzhalter.
|
||||||
|
- [ ] Screen-IDs/Namen an Davids Tracker angelehnt; `D-*`-Bezug im Interim-UI-Vermerk notiert.
|
||||||
@@ -0,0 +1,166 @@
|
|||||||
|
# Interim-UI-Playbook — Vorschau-Screens aus `~/ui` vor Davids Delta
|
||||||
|
|
||||||
|
**Stand:** 2026-07-05 · **Verbindliche Grundlage:** `docs/ARCHITECTURE-DECISIONS.md` **AD-28**
|
||||||
|
**Verwandt:** `.planning/INTERIM-UI-DESIGN-STANDARDS.md` (Davids Layout-/Komponenten-/State-Werte) ·
|
||||||
|
`DESIGNER-FIRST-PLAYBOOK.md` · `docs/INTEGRATION-CONTRACTS.md` · `ticket-docs/README.md`
|
||||||
|
|
||||||
|
## Warum dieses Playbook
|
||||||
|
|
||||||
|
Viele Dev-Tickets (R-P8/9/11/12, R-P2, AK-P3/4/14/16/17/19/20/21, v2: VR-P22b/VR-MCP) sind
|
||||||
|
serverseitig fertig, bleiben aber **On Hold**, weil die finale Optik an „Davids Delta" im
|
||||||
|
jeweiligen `D-*`-Screen-Ticket hängt — und diese Screens dauern noch. Die Component-Basis liegt
|
||||||
|
aber **schon im Repo**: `apps/web/app/ui/` (Alias `~/ui/*`) enthält 79 gesyncte Subframe-Components
|
||||||
|
+ die Layouts `DefaultPageLayout`/`DrawerLayout`/`DialogLayout` (gepflegt über `.subframe/sync.json`).
|
||||||
|
|
||||||
|
Statt auf David zu warten, baut der Dev **jetzt** aus denselben `~/ui`-Components eine **Interim-UI**
|
||||||
|
(Vorschau-Screen), stellt das Ticket damit fertig, testet es und schiebt es auf **Done**. Der spätere
|
||||||
|
Tausch gegen Davids finalen Subframe-Screen ist ein **getrackter Nachzug** hinter der stabilen
|
||||||
|
VM/Loader-Grenze — ein Component-Swap, kein Rewrite (Hot-Swap-Gedanke, M015/M017).
|
||||||
|
|
||||||
|
> **Begriff:** „Interim-UI" / „Interim-Screen". Nicht verwechseln mit `packages/ui-mock` — das ist
|
||||||
|
> der M017-Hot-Swap-Drop-in (bewusst hässliches Alt-Markup zum Beweis der Austauschbarkeit), etwas
|
||||||
|
> völlig anderes.
|
||||||
|
|
||||||
|
## Die goldene Regel (macht „später wenig Arbeit" real)
|
||||||
|
|
||||||
|
Ein Interim-Screen **muss**:
|
||||||
|
1. aus `~/ui`-Components + einem `~/ui/layouts/*` komponiert sein — **nie** handgeschriebenes
|
||||||
|
Tailwind-Markup (Negativ-Beispiel: `apps/web/app/routes/app.$tenant/tasks._index.tsx`, das eine
|
||||||
|
handgeschriebene `<table>` rendert und „Subframe polish follows David's D-P4 delta" trägt);
|
||||||
|
2. seine Daten aus dem bestehenden **View-Model** (`packages/view-models/**`) beziehen, das als Prop
|
||||||
|
hereingereicht wird;
|
||||||
|
3. alle statischen Texte über i18n-Keys (`t()`) auflösen.
|
||||||
|
|
||||||
|
Nur so ist Davids Delta hinterher hauptsächlich Anordnung/Feinschliff, und der Swap bleibt billig.
|
||||||
|
Wird Interim-UI als handgeschriebenes Tailwind gebaut, ist der Nachzug ein Neubau — das verfehlt den
|
||||||
|
ganzen Zweck und ist ein PR-Block wie ein Anti-Listen-Verstoß.
|
||||||
|
|
||||||
|
**Nach Davids Standards bauen (`~/ui`-Defaults + Design-Werte):** Damit die Interim-UI wirklich nah an
|
||||||
|
Davids kommende Pages kommt, folgt der Screen denselben Layout-/Komponenten-/State-Standards, nach denen
|
||||||
|
David selbst baut — festgehalten (mit exakten Werten: Page-Padding 24, Card 16, Dialog-Größen, Control-Höhen,
|
||||||
|
State-Regeln, Screen-Naming) in **`.planning/INTERIM-UI-DESIGN-STANDARDS.md`** (In-Repo-Spiegel von Davids
|
||||||
|
Vault `../HiveGrid-Wireframes/`). Kernpunkt: **`~/ui`-Component-Defaults sind führend** — Höhen/Paddings/
|
||||||
|
Dialog-Struktur nicht mit Tailwind nachbauen, wenn die Komponente/Variante sie schon abbildet. Modale immer
|
||||||
|
als echter `Dialog` (`DialogLayout → Dialog → Dialog.Content`), nie als Card-Fake. Diese Doc **vor dem
|
||||||
|
Screen-Bau lesen**.
|
||||||
|
|
||||||
|
## Wo der Interim-Screen lebt
|
||||||
|
|
||||||
|
```
|
||||||
|
apps/web/app/components/screens/<domain>/<Screen>Page.tsx
|
||||||
|
└─ export function <Screen>Page({ vm, actions }: { vm: <Screen>VM; actions: <Screen>Actions }) { … }
|
||||||
|
komponiert ~/ui-Components + DefaultPageLayout, rendert vm.data, ruft actions.onX
|
||||||
|
```
|
||||||
|
|
||||||
|
Die Route bleibt beim etablierten Muster und rendert nur:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// apps/web/app/routes/app.$tenant/<modul>._index.tsx
|
||||||
|
export default function XRoute() {
|
||||||
|
const { vm } = useLoaderData<LoaderData>();
|
||||||
|
return <XPage vm={vm} actions={{ onEdit, onArchive }} />;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Das ist genau das AGENTS.md-Zielmuster `<XPage vm={} actions={} />` — die Interim-UI füllt die heute
|
||||||
|
fehlende „mittlere Komposition" zwischen VM und `~/ui`-Primitives.
|
||||||
|
|
||||||
|
### Layer-Regeln bleiben unangetastet
|
||||||
|
Die drei Anti-Patterns (AGENTS.md) gelten weiter:
|
||||||
|
- kein `@prisma/client`/`~/db` in `packages/ui-app/**`;
|
||||||
|
- kein `packages/ui-subframe`-Direktimport in `app/routes/**`;
|
||||||
|
- kein `useLoaderData` in `packages/ui-app/**` — VM wird als Prop injiziert.
|
||||||
|
|
||||||
|
`~/ui`-Direktimport in `apps/web/app/components/**` bzw. `app/routes/**` ist **erlaubt** — er verletzt
|
||||||
|
kein Anti-Pattern (die verbieten nur `packages/ui-subframe`-Direktimporte). Wer den formalen
|
||||||
|
ui-app/ui-subframe-Adapterpfad nutzen will, kann das; für Interim-Screens ist die direkte
|
||||||
|
`~/ui`-Komposition der pragmatische, schnellere Weg.
|
||||||
|
|
||||||
|
## Done-Semantik (AD-28)
|
||||||
|
|
||||||
|
Ein UI-lastiges Ticket ist **Done-fähig**, sobald:
|
||||||
|
- **Dev-DoD 100 %** (alle nicht-Optik-Punkte grün) **und**
|
||||||
|
- **Interim-Screen** aus `~/ui` steht (goldene Regel erfüllt) **und**
|
||||||
|
- **Tests grün** (siehe DoD-Mapping unten).
|
||||||
|
|
||||||
|
Die **finale Subframe-Optik** ist dann **kein Done-Blocker** mehr, sondern ein **getrackter Nachzug**.
|
||||||
|
`/planning` bleibt die **Single Source of Truth** — der Nachzug wird zuerst in der Ticket-Doc markiert,
|
||||||
|
Plane spiegelt nur:
|
||||||
|
- **`.planning/ticket-docs/<ID>.md` (führend):** der standardisierte **`🎨 design-nachzug`-Tag** direkt
|
||||||
|
unter der Header-Tabelle (Format unten) **plus** der ausführliche Interim-UI-Vermerk in der Sektion
|
||||||
|
**„Dev-Nachzug (nach Davids `D-*`-Delta)"** (Muster unten),
|
||||||
|
- **Plane-Label `design-nachzug` (spiegelt die Doc):** nur für Board-Queries; wird aus dem Doc-Tag
|
||||||
|
abgeleitet, nie umgekehrt,
|
||||||
|
- die Interim-Visual-Baseline ist als „interim" markiert und wird beim Nachzug neu gezogen.
|
||||||
|
|
||||||
|
### Header-Tag in der Ticket-Doc (Single Source of Truth)
|
||||||
|
Direkt unter die Header-Tabelle der Ticket-Doc, damit `/planning` per `grep` autoritativ auswertbar ist
|
||||||
|
(`grep -rl "design-nachzug: offen" .planning/ticket-docs/`):
|
||||||
|
|
||||||
|
```md
|
||||||
|
**🎨 design-nachzug: offen** (seit YYYY-MM-DD) — Interim-UI aus `~/ui` steht; finale Subframe-Optik aus `D-<XXX>` ausstehend.
|
||||||
|
```
|
||||||
|
|
||||||
|
Beim David-Nachzug wird der Tag auf erledigt gesetzt (Historie bleibt in der Doc):
|
||||||
|
|
||||||
|
```md
|
||||||
|
**🎨 design-nachzug: erledigt** (YYYY-MM-DD) — finale `D-<XXX>`-Optik integriert, Visual-Baseline neu gezogen.
|
||||||
|
```
|
||||||
|
|
||||||
|
Done setzen weiterhin nur **mit expliziter Freigabe** und nach dem Abschluss-Audit (`plan-ticket` §8).
|
||||||
|
|
||||||
|
## DoD-Mapping — was Interim-UI erfüllt vs. was Nachzug bleibt
|
||||||
|
|
||||||
|
| DoD | Punkt | Mit Interim-UI |
|
||||||
|
|---|---|---|
|
||||||
|
| B 6–10 | Sidebar · Permission-Gate · Route · Breadcrumbs · i18n | **jetzt erfüllbar** |
|
||||||
|
| B 11/12 | Mobile-Tab-Bar · Customer-Portal | nur „falls relevant"; bei PWA-only (AD-17) i. d. R. Nachzug/deferred |
|
||||||
|
| D 18 | VM-Unit-Test | **jetzt erfüllbar** (reine Funktion) |
|
||||||
|
| D 19 | Smoke-Test `e2e/smoke/<modul>.spec.ts` | **jetzt erfüllbar** gegen Interim-Screen |
|
||||||
|
| D 20 | Hot-Swap-Drill (`packages/ui-mock`) | **jetzt erfüllbar** |
|
||||||
|
| D 21 | Visual-Regression (M016) | gegen **Interim-Baseline** erfüllbar; **Re-Baseline-Pflicht** beim David-Nachzug |
|
||||||
|
| — | finale Subframe-Optik | **Nachzug** (Label `design-nachzug`) |
|
||||||
|
|
||||||
|
## Refactor-Ablauf, wenn Davids Delta landet
|
||||||
|
|
||||||
|
**Davids Delta erscheint als:** neue/aktualisierte Datei in `../HiveGrid-Wireframes/Tickets/Fertige Tickets/D-*.md`
|
||||||
|
+ Paket-Status im `Screen Paket Tracker` auf `Fertig` + `design/`-Subframe-Links je Screen (Team `f023064a5ca0`).
|
||||||
|
|
||||||
|
1. VM/Loader/Route **unverändert** lassen.
|
||||||
|
2. Internals von `<XPage>` gegen Davids Subframe-Screen tauschen (gleiche `~/ui`-Components → meist
|
||||||
|
Umstellen/Neuanordnen, kein neuer Datenpfad).
|
||||||
|
3. Visual-Baseline neu ziehen (Interim-Snapshot ersetzen), Smoke/Hot-Swap erneut grün.
|
||||||
|
4. Plane-Label `design-nachzug` entfernen; Umsetzungs-Notiz + „Dev-Nachzug"-Sektion der Ticket-Doc
|
||||||
|
mit Datum + Proof ergänzen.
|
||||||
|
|
||||||
|
## Pro-Ticket-Checkliste (Interim-UI)
|
||||||
|
|
||||||
|
- [ ] Interim-`<XPage>` in `apps/web/app/components/screens/<domain>/` aus `~/ui` + Layout, VM als Prop.
|
||||||
|
- [ ] Route rendert `<XPage vm={} actions={} />`; kein handgeschriebenes Tailwind.
|
||||||
|
- [ ] **Davids Design-Standards befolgt** (`.planning/INTERIM-UI-DESIGN-STANDARDS.md`): Spacing/Padding/
|
||||||
|
Dialog-Struktur/Control-Höhen/States aus `~/ui`-Defaults; Screen-IDs/Naming an Davids Tracker angelehnt.
|
||||||
|
- [ ] Reachability B 6–10 verdrahtet (Sidebar/Permission/Route/Breadcrumb/i18n).
|
||||||
|
- [ ] Tests: VM-Unit (18) · Smoke (19) · Hot-Swap (20) · Visual-Regression gegen Interim-Baseline (21).
|
||||||
|
- [ ] Ticket-Doc (führend): `🎨 design-nachzug: offen`-Tag unter der Header-Tabelle **und** Interim-UI-Vermerk in der „Dev-Nachzug"-Sektion (Muster unten).
|
||||||
|
- [ ] Plane-Label `design-nachzug` gesetzt (spiegelt den Doc-Tag).
|
||||||
|
- [ ] Done nur bei Dev-DoD 100 % + Interim-UI + Tests grün + Freigabe.
|
||||||
|
|
||||||
|
### Muster: Interim-UI-Vermerk in „Dev-Nachzug (nach Davids `D-*`-Delta)"
|
||||||
|
|
||||||
|
```md
|
||||||
|
**Interim-UI (Vorschau, Stand YYYY-MM-DD):** Screen aus `~/ui` gebaut —
|
||||||
|
`apps/web/app/components/screens/<domain>/<Screen>Page.tsx`. Proof: Smoke `e2e/smoke/<modul>.spec.ts`,
|
||||||
|
Hot-Swap-Drill grün, Interim-Visual-Baseline `<pfad>` (als interim markiert).
|
||||||
|
Refactor-Nachzug offen: finale Subframe-Optik aus `D-<XXX>` (Plane-Label `design-nachzug`).
|
||||||
|
```
|
||||||
|
|
||||||
|
## Nachzug-Tracking
|
||||||
|
|
||||||
|
- **`/planning` ist führend:** Der `🎨 design-nachzug`-Tag in `.planning/ticket-docs/<ID>.md` ist die
|
||||||
|
autoritative Quelle. Offene Nachzüge findet man per `grep -rl "design-nachzug: offen" .planning/ticket-docs/` —
|
||||||
|
unabhängig von Plane und ohne API-Zugang.
|
||||||
|
- **Plane spiegelt:** Das Plane-Label **`design-nachzug`** (anlegbar über `.planning/plane-sync/scrub_plane.py`
|
||||||
|
oder manuell via `POST /labels/`) wird aus dem Doc-Tag abgeleitet und dient nur der Board-Sicht — nie
|
||||||
|
umgekehrt. Divergiert Plane vom Doc, gewinnt das Doc.
|
||||||
|
- Es gibt **kein** Skript, das Plane-Kommentare postet. Kommentar/Status weiter manuell via API
|
||||||
|
(`POST /issues/{iid}/comments/`, Identität vorab `GET users/me`); Done nur mit Freigabe.
|
||||||
@@ -0,0 +1,283 @@
|
|||||||
|
# Phase → Source-Dokumente (HiveGrid 2.0)
|
||||||
|
|
||||||
|
Mapping der 21 ROADMAP-Phasen auf ihre Quell-Dokumente für **Stufe-3-Enrichment** (`/gsd-plan-phase N`).
|
||||||
|
|
||||||
|
- **Modul-Specs** (`_bmad-output/specs/`) — das WHAT je Modul (requirements-pur, `detail-spec-draft`)
|
||||||
|
- **Milestone-PLANs** (`docs/milestones/`) — die detaillierte Ausführungsebene (176 Milestones mit Ziel, Abhängigkeiten, Definition-of-Done)
|
||||||
|
|
||||||
|
**Generiert:** 2026-06-07. Alle **176 Milestone-PLANs + 36 Modul-Specs + 2 Fundament-Docs** sind genau einer Phase zugeordnet (verifizierte Summe: 176 Milestones).
|
||||||
|
|
||||||
|
Beim Planen einer Phase liest der Planner/Researcher diese Specs + Milestone-PLANs als Enrich-Input.
|
||||||
|
|
||||||
|
> 🔴 **MODELL-PIVOT 2026-06-13 (AD-20):** Die Milestone-Maps von **Phase 6–9** (M01-CRM, M02-Lead, M03-Sales, M04-Auftrag) werden durch das Projekt-zentrische Modell neu geschnitten: Sales- und Auftrags-Milestones konsolidieren zu „Projekt & Pipelines" (Projekt-Kern + Pipeline-Engine + Feld-Config + konfigurierbarer Kanban); Lead→Projekt statt Promotion; Rechnung-Sub-Entity (NEU v1); Abnahme als Checklisten-Sub-Area. Der Re-Map erfolgt **mit dem gemeinsamen ER-Modell**. Single Source: `.planning/ENTITY-MODEL.md`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 1: Fundament & Walking-Skeleton
|
||||||
|
**Specs:** `docs/ARCHITECTURE-DECISIONS.md`, `docs/INTEGRATION-CONTRACTS.md`; Service-Kern-Teile aus `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md`, `M32-feature-flags.md`
|
||||||
|
**Milestone-PLANs (15):** M001-audit-log-default, M002-klartext-diagnostik, M003-i18n-pflicht-wiring, M004-tenant-scope-owner-check, M005-url-tampering-mass-action-schutz, M006-feature-flag-engine, M007-idempotenz-wrapper, M011-notification-service-layer, M012-workspace-topologie, M013-view-model-konvention, M014-action-callback-contract, M015-subframe-adapter-layer, M016-visual-regression-gate, M017-hot-swap-drill, M176-anti-liste-change-request-doku
|
||||||
|
> ⚠ **Restrukturiert 2026-06-10 (Dependency-Audit):** M001/M003/M006/M011 (Service-Kerne Audit, i18n, Feature-Flags, Notifications) von Phase 3 hierher verschoben — Phase 1 enthält die Wiring-Pflichten (REQ-integration-audit/notification-wiring), und der gesamte Auth-Block (P2, M018–M027) setzt diese Services voraus. Entspricht der ursprünglichen BMAD-Block-1-Ordnung.
|
||||||
|
> 🔌 **Neuer Integration-Contract „Entitlement-Gate-Pflicht" (2026-06-11):** Jedes Modul registriert einen **Feature-Konnektor** — `tenantHasModule('<modul>')` gated Sidebar-Eintrag, Routes und Actions. Pflicht-Checkpunkt JEDER Modul-Phase (wie Sidebar-/Audit-Wiring). Mechanik: Flag-Engine (M006, hat `plan-tier`-Targeting) × `packages/entitlements`. Modul-Liste als Vorlage: `archive/hivegrid-cloud/app/config/pricing-plans.ts` (14 Gates). Grundlage des Abo-Baukastens (P20-Recut).
|
||||||
|
|
||||||
|
## Phase 2: Identität & Mandantentrennung
|
||||||
|
**Specs:** `_bmad-output/specs/M27-auth-multi-tenancy.md`
|
||||||
|
**Milestone-PLANs (9):** M018-mandanten-anlage, M019-mandanten-trennung-hardening, M020-email-passwort-auth, M021-magic-link-sessions, M022-totp-2fa, M023-rollen-engine-shk-rollen-gruppen, M024-mitarbeiter-einladung-deaktivierung, M025-konto-loeschung, M026-mandanten-lebenszyklus
|
||||||
|
> Scope-Schnitt 2026-06-12 (Boilerplate-Recheck): M027 (API-Keys & Tarif-Gates) → v2 — wandert als Paket mit der Public-API (M161–163). Boilerplate-`ApiKey`-Modell + Settings-Routen bleiben ungenutzt im Code (Vorbereitung gratis, nicht in Sidebar verlinken). Auth-Block hat HIGH-Boilerplate-Coverage (`apps/web/app/services/auth/`) — RLS bleibt der Eigenbau-Kern (Boilerplate hat nur App-Level-Scoping).
|
||||||
|
|
||||||
|
## Phase 3: Querschnitts-Oberflächen
|
||||||
|
**Specs:** `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md` (Oberflächen-Teile; Service-Kerne → Phase 1)
|
||||||
|
**Milestone-PLANs (5):** M028-sprach-settings-aufloesung, M115-notifications-center, M116-notifications-user-settings, M151-audit-log-anzeige, M152-audit-log-export-aufbewahrung
|
||||||
|
> ⚠ **Restrukturiert 2026-06-10:** Service-Kerne (M001/M003/M006/M011) → Phase 1; Flag-Admin-UI (M031–M033) → Phase 19 (braucht laut eigener Vorbedingung die Admin-Welt M034). Phase 3 = die Bedien-Oberflächen: Audit-Viewer/Export, Notification-Center/Settings, Sprach-UX.
|
||||||
|
> Scope-Schnitt 2026-06-12 (Boilerplate-Recheck): **M029 (Sprach-Wechsler/Fallback) → v2** — v1 ist **DE-only**; M028 gedünnt auf DE-Defaults (Auflösungskette/Timezone → v2). HART: i18n-Pflicht-Wiring (M003, P1) + `verify:i18n`-CI-Gate bleiben unantastbar — alles i18n-ready. **M117 (Bündelung/Quiet-Hours/Push-Limits) → v2** — v1: Sofort-Zustellung, Center (M115), Kategorie-An/Aus (M116). **M152 gedünnt:** fixe Default-Retention + direkter CSV/PDF-Export (Boilerplate: Retention-Cron + PDF vorhanden); konfigurierbare Policy/Legal-Hold/Saved-Views → v2.
|
||||||
|
|
||||||
|
## Phase 4: Files & Tasks
|
||||||
|
**Specs:** `_bmad-output/specs/M23-files.md`, `M26-tasks.md`
|
||||||
|
**Milestone-PLANs (7):** M052-datei-upload, M053-speicher-backend-hetzner, M054-datei-permissions-sharing-versionierung, M055-datei-suche-tagging-archivierung, M071-aufgaben-crud-zuweisung, M072-aufgaben-listen-pro-modul, M073-aufgaben-erinnerungen-push-email
|
||||||
|
> M074-aufgaben-sync-erp → Phase 10 verschoben (2026-06-10): braucht Apps-Engine (P5) UND KWP-Sync-Foundation (P10) — ist inhaltlich eine KWP-Integration. Task-Entity-Verknüpfung zu CRM-Entitäten (M071 ↔ M042): Task-Kern hier, Entity-Links werden in Phase 6 nachverdrahtet.
|
||||||
|
> Scope-Schnitt 2026-06-12 (Boilerplate-Recheck): **M054 gedünnt** — Versionierung, Office-/Video-Previews, Resume-Upload → v2; v1 = Ersetzen + Bild-/PDF-Preview + **HEIC→JPG-Konvertierung (Pflicht — iPhone-Fotos der Monteure!)**; Permissions/Sharing bleiben. **M055 gedünnt** — OCR/Inhalts-Volltext → v2; Dateiname+Tags via Meilisearch + Archiv-Flag bleiben. Boilerplate liefert S3-Adapter/Signed-URLs/ClamAV (`packages/storage/`; ClamAV läuft zentral, Infra-ADR-014).
|
||||||
|
> ⚠ **Infra-Wechsel 12.06. (M053):** Speicher-Backend ist **Hetzner S3-kompatibles Object Storage** (per-Product-Bucket im Hetzner-Projekt `HiveGrid`, Infra-ADR-009) — NICHT mehr Scaleway (M053-PLAN-Name ist historisch). S3-API identisch, nur Endpoint/Credentials.
|
||||||
|
|
||||||
|
## Phase 5: Apps-Engine & Integrations-Framework
|
||||||
|
**Specs:** `_bmad-output/specs/M33a-apps-engine.md`
|
||||||
|
**Milestone-PLANs (3):** M008-apps-engine-adapter-state-machine, M009-apps-engine-setup-wizard-sync-log, M010-apps-engine-probe-scheduler-webhook-schutz
|
||||||
|
|
||||||
|
## Phase 6: CRM-Kern
|
||||||
|
**Specs:** `_bmad-output/specs/M01-crm-kern.md`
|
||||||
|
**Milestone-PLANs (5):** M042-kontakt-stammdaten, M043-firma-stammdaten, M044-schlagwoerter-custom-felder, M045-aktivitaets-stream, M046-listen-segmente-dsgvo
|
||||||
|
|
||||||
|
## Phase 7: Lead-Inbox
|
||||||
|
**Specs:** `_bmad-output/specs/M02-lead-inbox.md`
|
||||||
|
**Milestone-PLANs (4):** M047-lead-inbox-quellen-adapter, M048-lead-routing-pro-quelle, M050-spam-duplikat-erkennung, M051-lead-status-pipeline-verlust-gruende
|
||||||
|
> M049-auto-projekt-anlage → Phase 8 verschoben (2026-06-10, Dependency-Inversion): braucht den `Projekt`-Kern (M060). P7 liefert den Extension-Point (Lead-Status `qualified` + Event), P8 verdrahtet die automatische Projekt-Anlage in der Sales-Pipeline.
|
||||||
|
|
||||||
|
## Phase 8: Projekt & Pipelines (Kern)
|
||||||
|
**Specs:** `_bmad-output/specs/M03-sales-pipeline.md` *(Bezeichner historisch; Inhalt projekt-zentrisch re-gemappt — Single Source: `.planning/ENTITY-MODEL.md`, AD-20)*
|
||||||
|
**Milestone-PLANs (7):** M049-auto-projekt-anlage, M059-sales-pipeline-konfiguration, M060-projekt-crud, M061-sales-kanban-ui, M062-verlust-gewinn-gruende, M063-auto-auftragsprojekt-setter-closer, M064-pipeline-reporting-kwp-sync
|
||||||
|
> 🔴 **Pivot-Re-Map (AD-20, R-REFIT 16.06.):** Die Milestone-Inhalte sind projekt-zentrisch re-gemappt — „Verkaufsfall"/„Deal" = ein `Projekt`-Kern in der Sales-Pipeline-Sicht (kein eigenes Deal-Objekt), `M060-projekt-crud` = Projekt-CRUD; Pipeline-Engine baut zusätzlich PipelineAccess/-FieldConfig/-FieldVisibility (Field-Level-Rechte v1). Maßgeblich ist ENTITY-MODEL.md, nicht der historische Bezeichner in älteren Specs.
|
||||||
|
> M049 (aus Phase 7, 2026-06-10): Auto-Projekt-Anlage bei Lead-Qualifizierung — hier, weil der `Projekt`-Kern (M060) hier entsteht.
|
||||||
|
|
||||||
|
## Phase 9: Projekt & Pipelines (Auftrag)
|
||||||
|
**Specs:** `_bmad-output/specs/M04-auftragspipeline.md` *(Bezeichner historisch; Inhalt projekt-zentrisch re-gemappt — Single Source: `.planning/ENTITY-MODEL.md`, AD-20)*
|
||||||
|
**Milestone-PLANs (6):** M065-auftragspipeline-konfiguration, M066-auftrag-crud-kwp-archiv, M067-plantafel-tage-granularitaet, M068-auftrag-mitglieder-mgmt, M069-abnahme-workflow, M070-material-listen-lager
|
||||||
|
> 🔴 **Pivot-Re-Map (AD-20, R-REFIT 16.06.):** Die Milestone-NAMEN bleiben als Datei-Referenz, ihr **Inhalt ist projekt-zentrisch re-gemappt** — Auftrags-Welt = Pipeline-View auf denselben `Projekt`-Kern (kein separates Project-Objekt, kein Won-Handoff); `M066-auftrag-crud` = Auftrags-Sicht/Sub-Areas am Projekt inkl. **Rechnung-Sub-Entity v1 (E3, NEU)**, `M069-abnahme-workflow` = AbnahmeProtokoll-Sub-Area (Mängel = Checkliste). Maßgeblich ist ENTITY-MODEL.md, nicht der historische Bezeichner.
|
||||||
|
> Scope-Schnitt 2026-06-12: **M070 gedünnt** — Lagerist-Sicht + Material-Ausgangs-Dokumentation → v2; Material-Listen am Auftrag bleiben (KWP-Daten folgen mit v2-P5/Phase 32). Noah-Frage zum Lager-Arbeitsplatz auf der E-Liste.
|
||||||
|
> 🟦 **KWP-Anteil (D-1, Entsch. 16.06.):** Die KWP-Tokens in `M064-…-kwp-sync` und `M066-auftrag-crud-kwp-archiv` sind **Extension-Point-only** — **KWP komplett v2** (Phase 32 / ROADMAP-V2 v2-P5). KWP-Archiv-Anteile von M064/M066/M069 ruhen bis v2; beim Plan-Lauf **KEINEN KWP-Bau triggern** (nur VM-Slot/Stub/Event liefern).
|
||||||
|
|
||||||
|
## Phase 10: KWP-Integration — **→ v2 (KOMPLETT DEFERRED, 2026-06-12 — ERSTES v2-Modul)**
|
||||||
|
**Specs:** `_bmad-output/specs/M19-kwp-integration.md` ⚠ Recut (siehe Note)
|
||||||
|
**Milestone-PLANs (0 in v1):** alle acht KWP-Milestones (Task-ERP-Sync + die komplette Sync-Familie) vollständig → v2 (siehe v2-Sektion).
|
||||||
|
> **Grund (Kalender, nicht Scope):** KWP-API-Zugang lt. Hersteller-Mail erst ~**19.07.2026** — nach dem v1-Launch (~10.07.). KWP bleibt USP und wird **erstes v2-Modul** (Sync ~2–3 Wochen nach Launch). **Sofort erledigt in v1:** Callback-URL an KWP gemeldet (`https://app.hivegrid.de/integrations/kwp/oauth/callback` — eine feste URL, Tenant im `state`; OAuth Authorization Code Flow mit PKCE), bnWin.net-Update auf 8.1 N3 bei Geerkens angestoßen. **Andockpunkte bleiben v1:** Apps-Engine (P5; KWP wird `DataConnection type='rest-api'`), Extension-Points an Auftrag/Abnahme/Material. Recut-Note bleibt bindend für die v2-Planung (kwpsync.exe NICHT bauen, M089 obsolet). Phasen-Nummer reserviert, Ausführungsreihenfolge überspringt P10.
|
||||||
|
|
||||||
|
## Phase 11: Globale Suche & Dashboard
|
||||||
|
**Specs:** `_bmad-output/specs/M24-globale-suche.md`, `M20-dashboard.md`
|
||||||
|
**Milestone-PLANs (5):** M056-such-index, M057-permission-aware-search, M058-such-ui-saved-searches, M147-dashboard-layout-widget-engine, M148-dashboard-standard-widgets
|
||||||
|
> Scope-Schnitt 2026-06-11/AD-26: M149-custom-widgets + M150-export-report → v2. Suche = **Keyword-only** (Meilisearch); pgvector/Hybrid-RRF/HiveMind entfällt bzw. ruht als v3-Kandidat.
|
||||||
|
> Scope-Schnitt 2026-06-12 (Boilerplate-Recheck): **M147 gedünnt** — 3 feste Rollen-Layouts (GF/Büro/Monteur) statt Drag&Drop-Grid (react-grid-layout wäre Neueinkauf); Layout-Persistenz pro User → v2. Widget-Registry bleibt voll (Inversion `M064→M147` registriert Sales-Widgets darüber).
|
||||||
|
|
||||||
|
## Phase 12: Automation-Engine
|
||||||
|
**Specs:** `_bmad-output/specs/M17-automation-engine.md`
|
||||||
|
**Milestone-PLANs (8):** M075-automation-schema-ausloeser, M076-automation-aktion-registry-steuerung, M077-automation-bedingungen, M078-automation-visueller-editor, M079-automation-test-lauf-vorschau, M080-automation-undo-fenster, M081-automation-schleifen-webhook-anomalie, M082-automation-klartext-logs-metering
|
||||||
|
|
||||||
|
## Phase 13: ~~KI-Layer~~ → entfällt ([[AD-26]])
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]): Phase 13 entfällt in v1.** Die Milestones **M083/M084/M085/M086/M088 sind gelöscht** — HiveGrid hostet kein eigenes LLM/RAG. Die Tickets R-P13/D-P13/EXT-11 sind ebenfalls gelöscht.
|
||||||
|
~~**Specs:** `_bmad-output/specs/M18-ki-layer.md`~~ (entfällt)
|
||||||
|
~~**Milestone-PLANs (5):** M083-ki-eu-provider-layer, M084-ki-multi-provider-fallback, M085-ki-promptfoo-eval-suite, M086-ki-sprach-zu-automation, M088-ki-token-limits-pay-as-you-go~~ → **alle gestrichen ([[AD-26]])**
|
||||||
|
> ~~Scope-Schnitt 2026-06-11: M087 (HiveMind/RAG) + Whisper → v2. Sprach-zu-Automation (M086) EXKLUSIV im Automation-Kontext (direkte DB-Prüfungen, kein RAG). v1 baut Andock-Adapter: RetrievalProvider-Interface, Outbox-Index-Events (via P11), Bestätigungs-Grenze. M084: Mistral primär … → v2. M088: lokales Credits-Konto + Drossel; Abrechnung → v2.~~ → überholt durch [[AD-26]] (kein KI-Unterbau).
|
||||||
|
|
||||||
|
## Phase 14: Email & Marketing
|
||||||
|
**Specs:** `_bmad-output/specs/M09-email-inbox.md`, `M10-email-marketing.md`
|
||||||
|
**Milestone-PLANs (6):** M099-email-tracking-bounces, M100-marketing-email-editor, M101-marketing-segmente-empfaenger, M102-marketing-versand-engine, M103-marketing-ab-tests-reporting, M104-marketing-unsubscribe-bounces
|
||||||
|
> Scope-Schnitt 2026-06-11: M096/M097/M098 (Postfach-OAuth-Sync, Inbox-UI, Provider-Versand) → v2. **Aus M096 herausgelöst und v1-Pflicht:** Sende-Domain-Verifikation (DKIM/SPF/DMARC, Auto-Probe) — Marketing setzt sie voraus. **Neu (klein):** BCC-Logging-Brücke (`crm@tenant…` → Mail am Kontakt protokolliert, via Inbound-Infrastruktur). Marketing bleibt VOLL (inkl. A/B).
|
||||||
|
|
||||||
|
## Phase 15: Telefonie & Team-Chat
|
||||||
|
**Specs:** `_bmad-output/specs/M12-telefonie.md`, `M13-team-chat.md`
|
||||||
|
**Milestone-PLANs (9):** M106-telefonie-aircall, M107-telefonie-anruf-eingang, M108-telefonie-anruf-ausgang, M109-telefonie-voicemail-notizen, M110-chat-channel-permissions, M111-chat-direkt-nachrichten, M112-chat-anhaenge, M113-chat-modul-verknuepfungen, M114-chat-mentions-push
|
||||||
|
> Scope-Schnitt 2026-06-11: M105 (HalloPetra) → v2 — AirCall ist v1-Provider; TelephonyProviderInterface ist für den zweiten Adapter gebaut. Chat bleibt VOLL (inkl. Threads/Reactions/Pins).
|
||||||
|
|
||||||
|
## Phase 16: Kalender, Booking, Forms & Signatur
|
||||||
|
**Specs:** `_bmad-output/specs/M25-calendar-sync.md`, `M06-booking.md`, `M05-form-builder.md`, `M07-angebot-signatur.md`
|
||||||
|
**Milestone-PLANs (15):** M118-calendar-google-adapter, M119-calendar-termin-sync, M120-calendar-display-modul-verknuepfung, M121-form-editor, M122-form-veroeffentlichung, M123-form-submission-eingang, M124-form-conditional-display, M125-form-rate-limit-captcha-dsgvo, M126-booking-time-slot, M127-booking-verfuegbarkeit, M128-booking-bestaetigung, M129-booking-stornierung, M130-angebot-erstellung, M131-angebot-self-hosted-e-signatur, M132-angebot-status-tracking
|
||||||
|
> Scope-Schnitt 2026-06-12: **M122 gedünnt** — personalisierte Links (Tracking/Ablauf/Nutzungs-Limit) + JS-Snippet → v2; öffentliche URL + QR-Code + iFrame-Embed bleiben (SHK-Kernfall). **M129 bleibt explizit VOLL** (User-Entscheidung: Verschiebung/Re-Assignment/No-Show in v1).
|
||||||
|
|
||||||
|
## Phase 17: HR-Hub
|
||||||
|
**Specs:** `_bmad-output/specs/M14-hr-hub.md`
|
||||||
|
**Milestone-PLANs (7):** M133-hr-mitarbeiter-stammdaten, M134-hr-dokumente, M135-hr-urlaub, M136-hr-krankmeldungen, M137-hr-mitarbeiter-kommunikation, M139-hr-berichte-lohn-export, M140-hr-mitarbeiter-selbstbedienung
|
||||||
|
> Scope-Schnitt 2026-06-11: M138 (Drittanbieter-Onboarding Memberspot/Boobora) → v2. Mitarbeiter-Surveys (M139-Teil) bleiben auf User-Wunsch. M140 ohne Push in v1 (Web/PWA; Web-Push (VAPID) als Kanal → v2, AD-17).
|
||||||
|
|
||||||
|
## Phase 18: Customer-Portal — **→ v2 (KOMPLETT DEFERRED, 2026-06-11)**
|
||||||
|
**Specs:** `_bmad-output/specs/M15-customer-portal.md`
|
||||||
|
**Milestone-PLANs (0 in v1):** alle sechs Portal-Milestones vollständig → v2 (siehe v2-Sektion). AD-18 revidiert.
|
||||||
|
> v1 behält die Andockpunkte: P4-Portal-Upload-Vorbereitung (FileEntityLink), Portal-Pfad `app.hivegrid.de/portal/<tenant>/…` im P1-URL-Schema (gemäß `INTEGRATION-CONTRACTS.md` §6 — Pfad, keine Subdomain; korrigiert 2026-06-12). Phasen-Nummer bleibt reserviert (kein Renumbering), Ausführungsreihenfolge überspringt P18.
|
||||||
|
|
||||||
|
## Phase 19: Plattform-Admin
|
||||||
|
**Specs:** `_bmad-output/specs/M37-plattform-admin.md`
|
||||||
|
**Milestone-PLANs (7):** M031-feature-flag-schalter-lifecycle, M032-feature-flag-filter-editor, M034-plattform-admin-auth, M035-plattform-admin-dashboard, M036-plattform-admin-mandanten-verwaltung, M037-plattform-admin-stellvertreter-anmeldung, M041-plattform-admin-system-health-audit-support
|
||||||
|
> Scope-Schnitt 2026-06-11: M033 (Flag-Massen-Statistik) + M040 (Plattform-Lead-Pipeline) → v2. **Neu in P19-Scope:** Tenant-Abo-Zusammenstellung durch Admin (Abo-Baukasten-Mechanik: Feature-Konnektoren pro Tenant schalten + Legacy-Provider-Positionen; Self-Service-UI → v2).
|
||||||
|
> Scope-Schnitt 2026-06-12 (Boilerplate-Recheck): **M038 + M039 (getrennte AdminUser-Identität + AdminRBAC-Parallelwelt) → v2** — v1 nutzt das Boilerplate-Modell (AdminUser als User-Extension + MFA-Step-up-Gate, `admin-mfa-gate.server.ts`). **Bindende Auflagen für M034:** (a) TOTP-Pflicht hart erzwingen, (b) Admin-User bekommen **keinen Tenant-Workspace** und erscheinen in keiner Mandanten-Mitgliederliste (Boilerplate-Default-Provisionierung abschalten!), (c) Host-Routing `admin.hivegrid.de` → Admin-Routen (Boilerplate-Code routet `/admin`-Pfad), (d) **Cookie-Domain-Trennung** App↔Admin. **M035 gedünnt:** Boilerplate-KPIs (Tenants/User/MRR); Churn/ARPU/Health-Kacheln → v2 (bei 1 Launch-Kunden sinnfrei).
|
||||||
|
> M031–M033 (Flag-Admin-UI, 2026-06-10 aus Phase 3 hierher verschoben): Vorbedingung M034 (Admin-Auth) liegt hier; die Flag-**Engine** (M006, `tenantHasFlag()`) liegt in Phase 1 und ist ab dort von allen Phasen nutzbar.
|
||||||
|
|
||||||
|
## Phase 20: Billing, Onboarding & Branding
|
||||||
|
**Specs:** `_bmad-output/specs/M28-subscriptions-billing.md`, `M29-onboarding.md`, `M31-branding.md`
|
||||||
|
**Milestone-PLANs (8):** M030-pwa-theme-color, M153-subscriptions-billing-provider, M154-subscriptions-plan-seat-modell, M155-subscriptions-trial-readonly, M156-subscriptions-metering-pay-as-you-go, M158-onboarding-shk-provisionierung, M159-onboarding-branchen-templates, M160-onboarding-demo-daten
|
||||||
|
> ⚠ **M154-Recut bindend (2026-06-11):** Seat-Typ-Modell (Büro/Monteur) ist NICHT zu bauen — ersetzt durch **Abo-Baukasten**: Basis-Preis pro Nutzer + Feature-Module als zubuchbare Legacy-Provider-Positionen via Entitlement-Schicht (Flag-Engine `plan-tier`-Targeting × `packages/entitlements`). **Source-Spec:** `~/Documents/GitHub/archive/hivegrid-cloud/app/config/pricing-plans.ts` (Legacy D006: Core/Swarm/Colony, 14 Modul-Gates, 6 Quota-Dimensionen) — Struktur portieren, Preise/Tier-Zuschnitt = Kostenmatrix (Partner, AD-15). M156: Zähler+Drossel v1, Aufschlags-Abrechnung → v2. M157 (Wizard-UI) → v2 — Signup provisioniert SHK-Seed automatisch. M159: v1 nur SHK.
|
||||||
|
> Scope-Schnitt 2026-06-12: **M030 gedünnt** — nur Hell/Dunkel-Toggle, **kein System-Modus** (User-Entscheidung); nativer Status-Bar-Teil entfällt durch Mobile-Cut (Expo/Capacitor verworfen — PWA-only, AD-17; `next-themes` in Boilerplate-Deps). **M160 gedünnt** — KI-Walkthrough → v2 (gehört zum Wizard M157 = v2); Demo-Daten-Seed bleibt als Settings-Knopf, einfaches Löschen statt Multi-Step-Bulk; Mitarbeiter-Einladung läuft über M024.
|
||||||
|
|
||||||
|
## Phase 21: DSGVO & Launch-Reife
|
||||||
|
**Specs:** `_bmad-output/specs/M35-dsgvo-export.md` (M34/M36/M38/M39 → v2)
|
||||||
|
**Milestone-PLANs (2):** M164-dsgvo-daten-export, M165-dsgvo-loesch-workflow
|
||||||
|
> Scope-Schnitt 2026-06-11: Public-API (M161–163), DSGVO-Auskunft (M166 → manuelles Playbook: Suche + Kontakt-Export + Anwalts-Vorlage + Frist-Task), Mobile (M167–171, v2 als **Mobile-PWA-Ausbau** — Recut auf PWA, kein EAS-Build, keine Native-Module, keine Store-Compliance; Expo/Capacitor verworfen, AD-17), Help-Center/Desk (M172–175 → Minimal-FAQ) — alles → v2. **Bleibt zusätzlich klein in v1:** Feedback-Widget → speist P19-Support-Inbox (generische Quelle).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## v2-Phasen 22–34 — Source-Mapping
|
||||||
|
|
||||||
|
> Ergänzt 2026-06-15. Voll ausgearbeitete Phasen (Goal/Success-Criteria/Screens/Recut) in `.planning/ROADMAP.md` (Phase 22–34) + `.planning/ROADMAP-V2.md`. „phase:1"-Module (26/28/29/30): nur das **v2-Delta**, nicht das v1-Fundament. Block 2 (32/33/34) = Partner-API-Vertrag offen, agil vorziehbar.
|
||||||
|
|
||||||
|
### Phase 22: Public-API & Webhooks
|
||||||
|
**Specs:** `_bmad-output/specs/M34-public-api.md`
|
||||||
|
**Milestone-PLANs (4):** M161, M162, M163, M027 (api-keys)
|
||||||
|
**v1-Andockpunkte:** ApiKey-Modell (P2), Automation `external_event` + ausgehende Webhook-Action (P12), Frozen-Middleware (P20), Redis (Rate-Limit).
|
||||||
|
|
||||||
|
### Phase 23: Postfach-Sync (Email-Inbox)
|
||||||
|
**Specs:** `_bmad-output/specs/M09-email-inbox.md` (OAuth-Sync/Inbox/Threading; Sende-Domain ist v1)
|
||||||
|
**Milestone-PLANs (3):** M096, M097, M098
|
||||||
|
**v1-Andockpunkte:** Apps-Engine/`EmailProviderInterface` (P5), CRM-Matching (P6), Sende-Domain (P14), Files-Anhänge (P4). Risiko: Gmail restricted scopes (Antrag v1 EXT-13), Graph-Subscription-Renewal.
|
||||||
|
|
||||||
|
### Phase 24: Self-Service-Billing & Onboarding-Wizard
|
||||||
|
**Specs:** `_bmad-output/specs/M28-subscriptions-billing.md` (Block P), `M29-onboarding.md`
|
||||||
|
**Milestone-PLANs (1+):** M157 + M28-Self-Service-Delta
|
||||||
|
**v1-Andockpunkte:** Legacy-Provider/Checkout/Webhook + SubscriptionFeature (P20), TenantUserInvitation (P2), deklaratives Branchen-Template (geteilt P26/P30). Retro: KI-Coach aus P25.
|
||||||
|
|
||||||
|
### Phase 25: ~~KI-Tiefe — HiveMind/RAG~~ → MCP-Server ([[AD-26]])
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]): Phase 25 zurückgestellt → ersetzt durch MCP-Server.** Kein M0xx-Milestone (v2-Neuschnitt); verbindliche Bau-Spec = **[[VR-MCP]]** (Backend) / **[[VD-MCP]]** (Screens). HiveMind/RAG/Whisper sind v3-Kandidat.
|
||||||
|
~~**Specs:** `_bmad-output/specs/M18-ki-layer.md` (RAG/HiveMind/Whisper-Teile)~~ (entfällt)
|
||||||
|
~~**Milestone-PLANs (1+):** M087 + Whisper-EU + pgvector-Hybrid + zweiter EU-Provider~~ → **M087 gelöscht ([[AD-26]]); kein Milestone, neues Ticket [[VR-MCP]]**
|
||||||
|
**v1-Andockpunkte (MCP):** ApiKey-Auth + Scopes + Rate-Limit (Public-API, [[VR-P22]]), withTenantScope/RLS, withPermission (M004), M001-Audit. ~~Retro: Help-Korpus von P29.~~ → Help optional als MCP-Resource.
|
||||||
|
|
||||||
|
### Phase 26: Customer-Portal ⭐ *(ex-P18)*
|
||||||
|
**Specs:** `_bmad-output/specs/M15-customer-portal.md`
|
||||||
|
**Milestone-PLANs (6):** M141, M142, M143, M144, M145, M146
|
||||||
|
**v1-Andockpunkte:** FileEntityLink (P4), CRM/Project (P6), Project-Stages/Acceptance (P9), Sende-Domain (P14), Form-Builder `portal_form` (P16), URL-Pfad `app.hivegrid.de/portal/<tenant>` (P1).
|
||||||
|
|
||||||
|
### Phase 27: Mobile-PWA-Ausbau
|
||||||
|
**Specs:** `_bmad-output/specs/M36-mobile-app.md` ⚠ Recut auf PWA (kein EAS-Build, keine Native-Module, keine Store-Compliance; Expo/Capacitor verworfen, AD-17)
|
||||||
|
**Milestone-PLANs (5):** M167, M168, M169, M170, M171 — Recut auf PWA (kein EAS-Build, keine Native-Module, keine Store-Compliance)
|
||||||
|
**v1-Andockpunkte:** OfflineSyncQueue (P9, PWA-ready), notify()-Web-Push-Kanal (P21), Auth/Magic-Link/Biometrie via WebAuthn (P2), `IS_MOBILE_APP`-Flag (P20). Kein App-Store (PWA-only); nativer Client → frühestens v3.
|
||||||
|
|
||||||
|
### Phase 28: Plattform-Admin-Tiefe
|
||||||
|
**Specs:** `_bmad-output/specs/M37-plattform-admin.md` (Block A–D), `M32-feature-flags.md` (Massen-Statistik)
|
||||||
|
**Milestone-PLANs (4):** M038, M039, M033, M040
|
||||||
|
**v1-Andockpunkte:** Admin-Welt-Fundament M034 (P19), Auth-Bausteine (P2), FeatureFlag-Modell (P1). Hardgrenze: kein BYPASSRLS.
|
||||||
|
|
||||||
|
### Phase 29: Help-Center & Help-Desk
|
||||||
|
**Specs:** `_bmad-output/specs/M38-help-center.md`, `M39-help-desk.md`
|
||||||
|
**Milestone-PLANs (4):** M172, M173, M174, M175
|
||||||
|
**v1-Andockpunkte:** Feedback-Widget→Support-Inbox (P21), Admin (P19), Files (P4). Retro: liefert HelpArticle-Embeddings an P25.
|
||||||
|
|
||||||
|
### Phase 30: Dashboard-Deluxe & Querschnitt
|
||||||
|
**Specs:** `_bmad-output/specs/M20-dashboard.md`, `M22-notifications.md`, `M30-i18n.md`
|
||||||
|
**Milestone-PLANs (4):** M149, M150, M117, M029
|
||||||
|
**v1-Andockpunkte:** Dashboard/Widget-Registry (P11), Notification-Center (P3), i18n-Library (P1), WebSocket (P15). DeepL DE→EN.
|
||||||
|
|
||||||
|
### Phase 31: DSGVO-Vollausbau
|
||||||
|
**Specs:** `_bmad-output/specs/M35-dsgvo-export.md`
|
||||||
|
**Milestone-PLANs (1):** M166
|
||||||
|
**v1-Andockpunkte:** DSGVO-Export/Lösch-Fundament (P21), AdminAuditLog/Legal-Verwaltung (P28). AVV-PDF anwaltlich (v1 EXT-03).
|
||||||
|
|
||||||
|
### Phase 32: KWP-Integration *(Recut, Block 2)*
|
||||||
|
**Specs:** `_bmad-output/specs/M19-kwp-integration.md` + **`docs/milestones/M19-KWP-API-RECUT.md` (bindend)**
|
||||||
|
**Milestone-PLANs (8):** M089, M090, M091, M092, M093, M094, M095, M074
|
||||||
|
**v1-Andockpunkte:** M33a Apps-Engine-Adapter-Interface M008–M010 (P5, HART), Auftrag/Abnahme/Material-Extension-Points (P9), Automation `kwp.push` (P12), Cloud-Outbox/Idempotenz (P1/M007). ⚠ kwpsync.exe NICHT bauen. **Trigger:** KWP-API-Zugang ~20.07.
|
||||||
|
|
||||||
|
### Phase 33: Telefonie-Erweiterung (HalloPetra) *(Block 2)*
|
||||||
|
**Specs:** `_bmad-output/specs/M12-telefonie.md` (Provider-Pattern) — ⚠ HalloPetra in keiner Spec → **Vorlauf-Spec nötig**
|
||||||
|
**Milestone-PLANs (1):** M105
|
||||||
|
**v1-Andockpunkte:** TelephonyProviderInterface + AirCall-Adapter (P15), Automation `call.*` (P12), notify() (P3). **Trigger:** HalloPetra-API-Vertrag.
|
||||||
|
|
||||||
|
### Phase 34: HR-Drittanbieter-Onboarding *(Block 2)*
|
||||||
|
**Specs:** `_bmad-output/specs/M14-hr-hub.md` — ⚠ Memberspot/Boobora in keiner Spec → **Vorlauf-Spec nötig**
|
||||||
|
**Milestone-PLANs (1):** M138
|
||||||
|
**v1-Andockpunkte:** Apps-Engine (P5), HR-Hub (P17). **Trigger:** Memberspot/Boobora-API-Vertrag.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## v2 — Committed Deferred (Stand 2026-06-11, Scope-Schnitt)
|
||||||
|
|
||||||
|
**Definition (User, verbindlich):** v2 = alles, was gemacht werden MUSS — nur sequenziert nach dem v1-Launch. Kein Vielleicht-Backlog. Vollständige Entscheidungs-Historie: `.planning/SCOPE-V1-CUTS.md`.
|
||||||
|
|
||||||
|
**43 Milestones → v2:**
|
||||||
|
- **KWP-Integration (8):** M074, M089–M095 — **ERSTES v2-Modul** (API-Zugang ~19.07. > Launch ~10.07.; Recut-Note bindend: kwpsync.exe NICHT bauen); Callback-URL gemeldet, bnWin.net-8.1-N3-Update angestoßen, Andockpunkte in v1
|
||||||
|
- **Mobile-PWA (5):** M167–M171 — ⚠ Recut auf PWA (kein EAS-Build, keine Native-Module, keine Store-Compliance; Expo/Capacitor verworfen, AD-17); v1 = mobile-first responsive Web / PWA; nativer Client + App-Store → v3
|
||||||
|
- **Customer-Portal (6):** M141–M146 — AD-18 revidiert; Andockpunkte bleiben v1
|
||||||
|
- **Postfach-Sync (3):** M096, M097, M098 — Sende-Domain-Verifikation herausgelöst in v1
|
||||||
|
- **Public-API (4):** M161–M163, M027 (API-Keys & Tarif-Gates — Boilerplate-`ApiKey`-Modell bleibt ungenutzt im Code; Scope-Schnitt 12.06.)
|
||||||
|
- **Help-Center/Desk (4):** M172–M175 — v1: Minimal-FAQ + Feedback-Widget→P19-Inbox
|
||||||
|
- **Dashboard-Deluxe (2):** M149 (Custom-Widgets), M150 (Export/Report)
|
||||||
|
- **Admin-Teile (4):** M033 (Flag-Massen-Statistik), M040 (Plattform-Lead-Pipeline), M038 + M039 (getrennte AdminUser-Identität/AdminRBAC — bindende Auflagen beim Admin-Auth-Milestone in P19 dokumentiert; Scope-Schnitt 12.06.)
|
||||||
|
- ~~**KI-Kür (1):** M087 (HiveMind/RAG; + Whisper, pgvector/Hybrid-Suche, AlephAlpha — REQ-Ebene)~~ → **KI→MCP-Pivot ([[AD-26]]): M087 gestrichen; v2 liefert stattdessen den MCP-Server ([[VR-MCP]]/[[VD-MCP]], kein M0xx). HiveMind/RAG/Whisper = v3-Kandidat.**
|
||||||
|
- **Querschnitt (2):** M117 (Notification-Bündelung/Quiet-Hours — bewusst v2), M029 (Sprach-Wechsler — v1 DE-only, i18n-Wiring bleibt Pflicht; beide Scope-Schnitt 12.06.)
|
||||||
|
- **Sonstige (4):** M105 (HalloPetra), M138 (Memberspot/Boobora), M157 (Wizard-UI), M166 (DSGVO-Auskunft → manuelles Playbook)
|
||||||
|
|
||||||
|
**Dünnungen in v1 (Modul bleibt):** Kalender nur Google (Outlook v2) · Sales-Analytik = Basis-KPIs · Booking eine Zuteilungs-Strategie · M154→Abo-Baukasten-Recut · M156 ohne Aufschlags-Abrechnung · M159 nur SHK · *(12.06.)* M028 DE-only · M054 ohne Versionierung/Office-Video-Preview (HEIC→JPG bleibt!) · M055 ohne OCR · M147 feste Rollen-Layouts · M152 fixe Retention · M035 Boilerplate-KPIs · *(12.06., #12)* M030 nur Hell/Dunkel (kein System-Modus) · M070 ohne Lagerist-Sicht · M122 ohne personalisierte Links/JS-Snippet · M160 ohne KI-Walkthrough
|
||||||
|
|
||||||
|
**Bilanz: v1 = 133 Milestones · v2 = 43 Milestones · Summe 176 ✓**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Hinweise
|
||||||
|
|
||||||
|
- **Querschnitt-Milestones (M00, kein Modul):** Auf die Phasen verteilt, wo sie inhaltlich greifen — Fundament-Infra UND Service-Kerne (audit-default, i18n-wiring, flag-engine, notification-service) → Phase 1; aufgaben-listen → Phase 4; chat-/calendar-modul-verknuepfung → Phase 15/16.
|
||||||
|
- **Nicht im Ingest-Set (Phase 2-Produkt):** `M11-whatsapp` (von M13 referenziert; M18-Ref entfällt mit [[AD-26]]) ist nicht spec'd. Siehe REQUIREMENTS.md v2. ~~Beim Planen von P13/P15 als Stub markieren.~~ → P13 entfällt ([[AD-26]]); nur noch P15 betroffen.
|
||||||
|
- **Coverage:** 133 v1 + 43 v2 = 176/176 Milestone-PLANs zugeordnet, keine verwaisten Milestones. Dependency-Audit 2026-06-10: alle GSD-verursachten Reihenfolge-Verletzungen behoben (Service-Kerne → P1, M074 → P10, M031–M033 → P19). Scope-Schnitte 2026-06-11 + 2026-06-12 (#1–#12): siehe v2-Sektion.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependency-Inversion — Retro-Integrations-Ownership (0 offene Vorwärts-Deps)
|
||||||
|
|
||||||
|
**Prinzip (verbindlich für jeden plan-phase-Lauf):** Das spätere Modul integriert sich rückwirkend in frühere Oberflächen. Jede `Vorbedingung:`-Zeile in einem Milestone-PLAN, die auf eine spätere Phase zeigt, ist hiermit **invertiert**: Die Integrations-Aufgabe GEHÖRT der späteren Phase (Owner), die frühe Phase liefert nur den Extension-Point (VM-Slot, Domain-Event, Stub-Tabelle). Die BMAD-PLAN.md-Quelldateien bleiben unverändert — dieses Register ist die verbindliche Neuinterpretation. Damit existieren auf Phasen-Ebene **keine unaufgelösten Vorwärts-Abhängigkeiten**.
|
||||||
|
|
||||||
|
### Ownership-Register (wer integriert was rückwirkend)
|
||||||
|
|
||||||
|
| Owner | Retro-Integrations-Aufgaben (beim Planen dieser Phase MIT einplanen) |
|
||||||
|
|---|---|
|
||||||
|
| **P6 CRM** | Task↔CRM-Entity-Verknüpfung verdrahten (`M071→M042`; P4 liefert polymorphe EntityLink) |
|
||||||
|
| **P8 Sales** | Auto-Projekt aus qualifiziertem Lead (M049, hierher verschoben); SHK-Pipelines + Gründe selbst seeden (`M059→M158`, `M062→M158`); Lead→Projekt-Verdrahtung konsumiert das P7-Event |
|
||||||
|
| **P9 Projekte** | Sales-Won-Handoff konsumieren (`M063→M065`; P8 liefert deal.won-Event); Abnahme-Defaults selbst seeden (`M069→M158`) |
|
||||||
|
| **P10 KWP** *(→ v2, erstes v2-Modul = Phase 32 / ROADMAP-V2 v2-P5)* | Retro-Integrationen wandern mit: KWP-Sync in Auftrag-Archiv, Abnahme-Drift-Schutz, Material-Listen, Task-ERP-Sync (M074) — Phase 32 (= ROADMAP-V2 v2-P5, ex-P10) integriert sich rückwirkend; v1 liefert die Extension-Points (Auftrag/Abnahme/Material) |
|
||||||
|
| **P11 Suche/Dashboard** | Hybrid-Suche-Upgrade für Audit-Viewer (`M151→M057`), Datei-Suche (`M055→M056`), CRM-Segmente (`M046→M056`), Kanban-Filter (`M061→M057`); Sales-Reporting-Widgets (`M064→M147`; P8 liefert Aggregat-APIs); Dashboard-Default-Layout selbst seeden (`M148→M158`) |
|
||||||
|
| **P12 Automation** | Task-Liste im Automation-Modul (`M072→M075`; Pattern aus P4) |
|
||||||
|
| ~~**P13 KI**~~ → entfällt ([[AD-26]]) | ~~KI-Actions in der Automation-Registry registrieren (`M076→M083`; Registry ist type-safe erweiterbar gebaut)~~ → **entfällt: kein KI-Layer, keine KI-Actions (M083 gelöscht). Die Automation-Registry bleibt erweiterbar; künftige MCP/Provider docken via Apps-Engine an.** |
|
||||||
|
| **P14 Email/Marketing** | Task-Liste im Marketing-Modul (`M072→M104`); Channel-Bedarf von M068 prüfen (`M068→M104` — voraussichtlich durch P1-notify()-Kern gedeckt); Email-Templates selbst seeden (`M100→M158`) |
|
||||||
|
| **P16 Kalender/Booking/Forms** | Kalender in Plantafel (`M067→M119`, `M067→M129`); Kalender-Termin aus Won-Deal (`M063→M119`); Form-Templates für Abnahme (`M069→M121`); Task-Liste im Forms-Modul (`M072→M121`); Form-Templates selbst seeden (`M125→M158`) |
|
||||||
|
| **P17 HR** | Abwesenheiten in Plantafel anzeigen (`M067→M135`) |
|
||||||
|
| **P20 Billing/Branding** | Legacy-Provider ersetzt Subscription-Stub (`M026→M153`, `M036→M153`, `M041→M153`); ~~AI-Credits-Kauf (`M088→M153`, `M088→M156`)~~ → **entfällt ([[AD-26]]: kein LLM-Gateway → keine AI-Credits; M088 gelöscht)** |
|
||||||
|
| **v2 (deferred Owner)** | Diese Retro-Integrationen wandern mit ihren Owner-Modulen nach v2: Push-Kanal-Aktivierung + Settings-Erweiterung (Mobile), Theme→Portal, Portal-DSGVO-Löschung, Help-Desk→Admin-Inbox, Abwesenheiten→Plantafel bleibt v1 (HR bleibt!) |
|
||||||
|
|
||||||
|
### Extension-Point-Pflichten (frühe Phase MUSS liefern, damit die Inversion trägt)
|
||||||
|
|
||||||
|
| Phase | Extension-Point |
|
||||||
|
|---|---|
|
||||||
|
| P1 | `notify()` mit Kanal-Abstraktion inkl. ruhendem Push-Kanal; Search-Registry; Flag-Engine (bereits Success Criteria) |
|
||||||
|
| P2 | TenantSubscription-Status-Stub (manuell setzbar) — Frozen-Modus (M026) liest nur den Status, Legacy-Provider füllt ihn ab P20 |
|
||||||
|
| P3 | Notification-Settings-UI kanal-erweiterbar (Push-Sektion erscheint in P21) |
|
||||||
|
| P4 | Polymorphe EntityLink-Tabelle (`entity_type` + `entity_id`, kein harter FK); Task-Listen-Pattern als wiederverwendbare Komponente |
|
||||||
|
| P7 | Lead-Status-Event `lead.qualified` (Extension-Point für M049 in P8) |
|
||||||
|
| P8 | `deal.won`-Domain-Event; Aggregat-APIs für Reporting |
|
||||||
|
| P9 | Plantafel-VM-Slots für Termine/Abwesenheiten/Storno; Abnahme v1 mit festem Formular |
|
||||||
|
| ~~P13~~ → entfällt ([[AD-26]]) | ~~Lokales AiCredits-Konto mit manuellem Top-up (Kauf/Abrechnung folgt P20)~~ → **entfällt: kein KI-Layer/LLM-Gateway in v1; AiCredits gestrichen.** |
|
||||||
|
| P18 | *(→ v2)* Portal startet mit Default-Theme |
|
||||||
|
| P19 | Support-Inbox mit generischer Message-Quelle |
|
||||||
|
|
||||||
|
### Seed-Regel (ersetzt alle M158-Vorwärts-Refs)
|
||||||
|
|
||||||
|
Jede Modul-Phase seedet ihre eigenen SHK-Defaults deklarativ (AD-12). M158 (P20) orchestriert nur den Onboarding-Wizard über bereits vorhandene Seeds. Alle Refs auf M158 aus P8/P9/P11/P14/P16 sind durch Self-Seeding obsolet.
|
||||||
|
|
||||||
|
### Audit-Register (maschinenlesbar — jede invertierte Ref einzeln)
|
||||||
|
|
||||||
|
`M026→M153` `M151→M057` `M055→M056` `M071→M042` `M072→M075` `M072→M104` `M072→M121` `M046→M056` `M059→M158` `M061→M057` `M062→M158` `M063→M065` `M063→M119` `M064→M147` `M067→M119` `M067→M129` `M067→M135` `M068→M104` `M069→M121` `M069→M158` `M148→M158` ~~`M076→M083`~~ ~~`M088→M153`~~ ~~`M088→M156`~~ `M100→M158` `M125→M158` `M036→M153` `M041→M153`
|
||||||
|
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]): 3 Einträge entfernt** — `M076→M083`, `M088→M153`, `M088→M156` (Ziele M083/M088 gelöscht, kein KI-Layer). Verbleibend: **25 Einträge**.
|
||||||
|
|
||||||
|
(~~28~~ → 25 Einträge, Stand 2026-06-12 nach Scope-Schnitten + [[AD-26]]. Entfernt am 11.06.: 9 Refs, deren Quelle oder Ziel → v2 ging (Quellen/Ziele: 116, 030, 140 gegen 167/168/171; 141 gegen 030; 146 gegen 165; 041 gegen 174) — sie leben als v2-Inversionen in der v2-Planung weiter. Entfernt am 12.06. (#12, P10 → v2): die drei KWP-Inversionen (Quellen 066, 069, 070 gegen 095/092) — wandern mit dem v2-P10-Owner; die v1-Quell-Milestonen liefern weiterhin nur die Extension-Points. Ebenfalls per Inversion aufgelöst: die KWP-Anteile in den Vorbedingungen von 123 (Post-Submit-Action „KWP-Push" — Action-Registry ist erweiterbar, v2-P10 registriert nach, identisch zur Automation-Registry-Note) und 158 (KWP-Plantafel-Seed-Anteil entfällt in v1; v2-P10 seedet selbst, AD-12). Ergänzung 12.06.: Die M158-Vorbedingung „M115–M117" verliert ihren M117-Anteil an v2 — der Seed-Umfang von M158 umfasst nur noch Notification-Defaults aus M115/M116 (Bündelungs-Defaults entfallen); kein Register-Eintrag nötig, da M115/M116 in P3 vor P20 liegen. Ferner dokumentiertes Bereichs-Artefakt: Die M051-Vorbedingung „M047-M050" enthält M049 nur als Range-Nebeneffekt (M049 → P8 am 10.06.); M051 braucht real nur M047/M048/M050 — kein Register-Eintrag, beim P7-Planen die Range als M047/M048/M050 lesen. Konstruktionsbedingt zulässig: Die M164-Vorbedingung „M042-M170 (alle Daten-Module)" meint „alles, was zum Export-Zeitpunkt existiert" — v1-Export deckt die v1-Datenmodelle; jedes v2-Modul registriert seinen DSGVO-Export-Adapter bei v2-Bau selbst nach (Inversion, Owner = v2-Modul). Audit-Kontrakt: Vorwärts-Refs aus den Milestone-Vorbedingungen der **v1-gemappten** Milestones MINUS dieses Register MUSS leer sein.)
|
||||||
|
|
||||||
|
*Generiert: 2026-06-07 als Brücke zwischen GSD-ROADMAP und bestehender BMAD-Milestone/Spec-Basis.*
|
||||||
Binary file not shown.
@@ -0,0 +1,102 @@
|
|||||||
|
# HiveGrid 2.0
|
||||||
|
|
||||||
|
## What This Is
|
||||||
|
|
||||||
|
HiveGrid 2.0 ist eine Multi-Tenant-SaaS-Plattform für SHK-Handwerksbetriebe (Sanitär, Heizung, Klima). Sie bündelt CRM, Vertriebs- und Auftragspipeline, Team-Chat, visuelle KI-Automation und die Anbindung an das KWP-ERP in einem EU-gehosteten System.
|
||||||
|
|
||||||
|
HiveGrid ist ein Multi-Kunden-SaaS für den gesamten SHK-Markt. Die **Geerkens GmbH** (Kontakt: Noah) ist erster Kunde und Investor — Validierungspartner, nicht alleiniger Zweck. Das Produkt ersetzt dort HubSpot (CRM + Sales-Pipeline), Quiply (Team-Chat), Zapier/n8n (Automation) sowie mehrere Excel-Prozesse. Die Codebase wird als bespoke HiveGrid-Anwendung weitergeführt: historisches Fundament wird genutzt, produktfremde Altlasten werden entfernt.
|
||||||
|
|
||||||
|
> 🔴 **MODELL-PIVOT (2026-06-13):** CRM/Pipeline-Modell ist **Projekt-zentrisch** — ein `Projekt`-Kern, Pipelines = frei konfigurierbare Views; „Deal"/„Auftrag" sind Pipeline-Typen, keine eigenen Entitäten. Single Source: `.planning/ENTITY-MODEL.md`. ENTITY-MODEL/REQUIREMENTS/SCREEN-MAP/PHASE-SOURCES werden gegen den Anker neu gefasst (ER-Modell wird gemeinsam gebaut).
|
||||||
|
|
||||||
|
## Core Value
|
||||||
|
|
||||||
|
Jeder SHK-Betrieb (Mandant) wickelt die komplette Wertschöpfungskette — **Lead → Projekt (frei konfigurierbare Pipelines: Sales/Auftrag/…) → KWP-Sync (ab v2)** — inklusive visueller KI-Automation in einem einzigen, DSGVO-konformen EU-System ab. Wenn diese Kette nicht durchgängig funktioniert, scheitert das Produkt.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
Vollständige Liste mit 79 v1-Requirements über 36 Module: siehe `.planning/REQUIREMENTS.md`. Detaillierte Acceptance-Kriterien je Requirement: `.planning/intel/requirements.md` + Modul-Specs unter `_bmad-output/specs/`.
|
||||||
|
|
||||||
|
### Validated
|
||||||
|
|
||||||
|
<!-- Geliefert und bestätigt wertvoll. -->
|
||||||
|
|
||||||
|
(Noch keine — Big-Bang-Launch ohne phasiertes Produktiv-Go-Live, AD-19. Validierung erfolgt pro Modul über Noah/Geerkens via PROGRESS-TRACKER-Klick-Pfad.)
|
||||||
|
|
||||||
|
### Active
|
||||||
|
|
||||||
|
<!-- Aktueller Scope. Scope-Schnitt 2026-06-11: v1 = 146 Milestones / 94 Reqs; 30 MS committed → v2 (Mobile-PWA-Ausbau, Portal, Postfach-Sync, Public-API, Help, HiveMind/Whisper u.a.) — Details: SCOPE-V1-CUTS.md + ROADMAP. NEU: Konnektor-Pflicht (jedes Modul plan-gebunden schaltbar) + Abo-Baukasten-Billing (M154-Recut, Legacy: archive/hivegrid-cloud pricing-plans.ts, Core/Swarm/Colony). -->
|
||||||
|
|
||||||
|
**USP-Säulen (Differenzierung, volle Tiefe day-1 — AD-16):**
|
||||||
|
- [ ] Automation-Engine (M17) — visueller Editor, alle Trigger/Aktionen, 24h-Undo, Guards
|
||||||
|
- [ ] KI-Layer (M18) — EU-Provider, RAG, Sprach-zu-Automation, Pay-as-you-go
|
||||||
|
- [ ] KWP-Integration (M19) — bidirektionaler Sync mit dem SHK-ERP KWP (Kernsystem des Erstkunden)
|
||||||
|
|
||||||
|
**SHK-Kernpfad (AD-11, Projekt-zentrisch nach AD-20):**
|
||||||
|
- [ ] CRM/Kontakt-Kern (M01), Lead-Inbox/LeadInput (M02), **Projekt & Pipelines** (vormals Sales M03 + Auftrag M04 → ein `Projekt`-Kern + konfigurierbare Pipeline-Views; Abnahme bleibt v1 als Checklisten-Sub-Area, Rechnung = Sub-Entity v1)
|
||||||
|
|
||||||
|
**Fundament-Kern:**
|
||||||
|
- [ ] Auth/Multi-Tenancy (M27), Apps-Engine/Adapter (M33a), Audit-Log (M21), Notifications (M22), i18n (M30), Feature-Flags (M32), Plattform-Admin (M37)
|
||||||
|
|
||||||
|
**Breite (AD-13):**
|
||||||
|
- [ ] HR-Hub (M14), Customer-Portal (M15), Email (M09/M10), Telefonie (M12), Team-Chat (M13), Booking/Forms/Angebot (M05/M06/M07), Files/Suche/Calendar/Tasks (M23/M24/M25/M26), Billing (M28), Onboarding (M29), Branding (M31), Dashboard (M20), Public-API (M34), DSGVO-Export (M35), Mobile-PWA (M36 — PWA-only, kein nativer Client), Help-Center/Desk (M38/M39)
|
||||||
|
|
||||||
|
### Out of Scope
|
||||||
|
|
||||||
|
<!-- Explizite Grenzen mit Begründung — verhindert Scope-Creep. -->
|
||||||
|
|
||||||
|
- **Phase-2-Module (z.B. M11 WhatsApp)** — nicht spec'd, späterer Release; von M13/M18 referenziert, aber nicht im Ingest-Set
|
||||||
|
- **Konkrete Pricing-Stufen** — Billing-Engine wird gebaut, Preise geparkt; Geerkens auf Sonderkondition/Trial (AD-15)
|
||||||
|
- **Volle Migrations-Pipelines pro Altsystem** — sauberer Start, KWP-Sync füllt nach; HubSpot/Quiply als Read-only-Archiv, nur punktuelle CSV-Importe (AD-14)
|
||||||
|
- ~~EU-Email-Provider (AD-6) / Captcha (AD-7)~~ — **entschieden 11.06.: Mailjet + mCaptcha** (Boilerplate-verdrahtet)
|
||||||
|
- **KWP Windows-Sync-Programm (M089, alte M19-Variante)** — entfällt durch offizielle KWP-API; M089–M095 vor Umsetzung neu schneiden
|
||||||
|
|
||||||
|
## Context
|
||||||
|
|
||||||
|
- **SHK-Domäne:** Geerkens = Heizungsanlagen/Wartung/Reparatur. Entitäten: B2C/B2B-Kunden mit Anlagen-Zustand (Custom-Felder), mehrstufige Anlagen-Verkäufe, Wartungsverträge, Reparatur-Aufträge. Monteure arbeiten offline auf Baustellen (AD-17).
|
||||||
|
- **SHK-Seeds beim Tenant-Anlegen:** 6 Standard-Rollen + Permission-Bundles, SHK-Sales-Pipelines, Custom-Felder für Heizungsanlagen, Projekt-Pipelines, Automation-Templates, Onboarding-Branchen-Zweig — deklarativ, von Noah iterativ validiert (AD-12).
|
||||||
|
- **Workspace-Naming:** Alle Runtime-, UI-, Config-, DB-, Mail-, Queue- und View-Model-Pakete laufen unter `@hivegrid/*`; CLI = `hivegrid-cli`; technische Produkt-Contracts nutzen `HIVEGRID_*`, `hivegrid_*`, `x-hivegrid-*` und `hivegrid.*`.
|
||||||
|
- **Phase-0-Pflichten (vor jedem Fachmodul):** (1) Codebase lauffähig halten, (2) Naming-Drift beheben (AD-10), (3) EU-Sterilisation (GitHub/Google-OAuth-Reste raus), (4) M00 + 4 Querschnitts-Neubauten (logActivity, Search-Registry, Subframe-Adapter, Mass-Action-Schutz), (5) fehlende Dependencies ergänzen.
|
||||||
|
- **Spec-Stil:** Alle 36 Specs sind „requirements-pur" (benötigte UI-Elemente als Liste, keine Layouts — Designer hat freie Hand) und im Status `detail-spec-draft`. Vor Modulbau: Noah-Verifizierung, Index-/Migrations-SQL, SHK-Defaults finalisieren, Subframe-UI-Designs.
|
||||||
|
|
||||||
|
## Constraints
|
||||||
|
|
||||||
|
- **Mandanten-Trennung**: Echtes Postgres-RLS als bauliche Vorgabe (USING/WITH CHECK, `SET LOCAL app.tenant_id`, App-Rolle ohne BYPASSRLS) — AD-1
|
||||||
|
- **Datenmodell**: Typisierte First-Class-Prisma-Tabellen; Boilerplate-Entity-Builder (Entity/Row/RowValue) wird entfernt; Custom-Felder über `CustomFieldDefinition`+`CustomFieldValue` — AD-2
|
||||||
|
- **EU-Stack (keine US-Kern-Abhängigkeit)**: Meilisearch (zentral auf `node1`, scoped Key — Infra-ADR-008/013) + pgvector v2 + RRF (AD-5 sequenziert), Per-Tenant-DEK/Envelope-Encryption **app-seitig** (AD-8 revidiert 12.06.: Hetzner-Stack hat kein Cloud-KMS — Master-Key im Coolify-Secret-Store, Rotations-Runbook; bei P1-Ist-Stand-Check bestätigen), Mailjet (AD-6 ✓), mCaptcha zentral `captcha.saas-ctrl.com` (AD-7 ✓)
|
||||||
|
- **Infra-Stack (Infra-Repo `~/Documents/GitHub/infra`, ADR-009/010, ersetzt Scaleway seit 30.05.)**: Hetzner Cloud, ein Projekt pro SaaS (`HiveGrid`: hivegrid-db/app/worker/lb + S3-kompatibles Object Storage + Storage Box); Staging konsolidiert auf `staging-1`; Deploys via zentrale Coolify-Control-Plane; Registry = Gitea (build-once/promote); DNS = Cloudflare (`hivegrid.de`-Zone existiert); zentrale Dienste: Meilisearch/Sentry/Loki (node1), ClamAV, mCaptcha. `fly.toml` entfernt (Infra = Hetzner/Coolify); `docs/deployment-region-provider-pinning.md` stale → P1-Ist-Stand-Check
|
||||||
|
- **Sessions**: Postgres als Source-of-Truth + Redis-Cache; Cookie hält nur Session-ID (AD-4)
|
||||||
|
- **Realtime**: WebSocket für Chat (M13), SSE für Read-Updates (M03/M22) — AD-9
|
||||||
|
- **Tech-Stack**: React Router 7, Node 22.12.x (dev/test) / node:20 (runtime), Prisma/Postgres, Redis; **Subframe-UI ist Pflicht** für jede Route
|
||||||
|
- **Repo/Naming**: Bespoke HiveGrid-Codebase; `@hivegrid/*` ohne Alt-Aliase, Estate-Slugs bleiben externe Infrastruktur (AD-10)
|
||||||
|
- **Go-Live**: Big-Bang — erst live mit vollständigem Phase-1-Produkt (AD-19); interne Bau-Reihenfolge nach AD-11
|
||||||
|
|
||||||
|
## Key Decisions
|
||||||
|
|
||||||
|
Vollständige Extraktion mit Scope/Begründung: `.planning/intel/decisions.md`. Quelle: `docs/ARCHITECTURE-DECISIONS.md`.
|
||||||
|
|
||||||
|
| Decision | Kern | Status |
|
||||||
|
|----------|------|--------|
|
||||||
|
| AD-1 | Mandanten-Trennung via echtes Postgres-RLS | ✓ locked |
|
||||||
|
| AD-2 | Typisierte Tabellen, Entity-Builder raus — **revidiert 13.06.:** `Projekt` = EINE typisierte Tabelle + CustomFields + Pipeline-Feld-Config-Layer; generischer Entity-Builder bleibt entfernt | ✓ revidiert (13.06.) |
|
||||||
|
| AD-3 | Plattform-Admin getrennt (Email+PW+TOTP, opt. Authentik-SSO) | ✓ locked |
|
||||||
|
| AD-4 | Sessions: Postgres Source-of-Truth + Redis-Cache | ✓ locked |
|
||||||
|
| AD-5 | Such-Engine: Meilisearch (v1 Keyword); pgvector-Hybrid → v2 | ✓ sequenziert (11.06.) |
|
||||||
|
| AD-6 | EU-Email-Provider: **Mailjet** (Boilerplate-verdrahtet) | ✓ locked (11.06.) |
|
||||||
|
| AD-7 | Captcha: **mCaptcha self-hosted** (infra/ vorhanden) | ✓ locked (11.06.) |
|
||||||
|
| AD-8 | Verschlüsselung: Per-Tenant-DEK + Envelope, Crypto-Shredding | ✓ locked |
|
||||||
|
| AD-9 | Realtime: WebSocket (Chat) + SSE (Read-Updates) | ✓ locked |
|
||||||
|
| AD-10 | Naming: `@hivegrid/*` behalten, Docs anpassen | ✓ locked |
|
||||||
|
| AD-11 | Bau-Strategie: Hybrid (Fundament-Kern → SHK-Kernpfad → Breite) | ✓ locked |
|
||||||
|
| AD-12 | SHK-Defaults als deklaratives Seed, Noah validiert | ✓ locked |
|
||||||
|
| AD-13 | Go-Live-Scope: breiter Launch (Großteil der 36 Module) | ✓ locked |
|
||||||
|
| AD-14 | Migration: sauberer Start + KWP-Sync füllt nach | ✓ locked |
|
||||||
|
| AD-15 | Billing-Engine bauen, Preise geparkt | ✓ locked |
|
||||||
|
| AD-16 | USP-Säulen (Automation + KI) in voller Tiefe day-1 | ✓ locked |
|
||||||
|
| AD-17 | Mobile: **PWA-only (v1 + v2)** — Offline via PWA/Web (P9), Web-Push in v2; **kein Expo/native/App-Store** (native → frühestens v3) | ✓ revidiert (16.06.) |
|
||||||
|
| AD-18 | Customer-Portal → komplett v2 | ✓ revidiert (11.06.) |
|
||||||
|
| AD-19 | Go-Live-Modus: Big-Bang | ✓ locked |
|
||||||
|
| AD-20 | **Projekt-zentrisches Modell (NEU 13.06.):** ein `Projekt`-Kern; Pipelines = konfigurierbare Views; „Deal"/„Auftrag" = Pipeline-Typen, keine eigenen Entitäten; Lead → Projekt (Weiterverarbeitungsfreigabe); Abnahme v1 als Checklisten-Sub-Area, Rechnung v1-Sub-Entity, KWP-Felder v1-Halter/v2-Sync | ✓ locked (13.06.) |
|
||||||
|
| KWP-Recut | Offizielle KWP-API → M089 entfällt, M090–M095 vereinfacht; M093 bleibt; KWP als `DataConnection type='rest-api'` (M33a). M089–M095 vor Umsetzung neu schneiden. | ⚠ Recut nötig |
|
||||||
|
|
||||||
|
---
|
||||||
|
*Erzeugt: 2026-06-07 via `/gsd:ingest-docs` (Stufe 1 — WHAT) aus 38 Docs (37 SPEC + 1 ADR). ROADMAP folgt in Stufe 2.*
|
||||||
Binary file not shown.
@@ -0,0 +1,45 @@
|
|||||||
|
# .planning/ — START HIER (Live-Planung HiveGrid 2.0)
|
||||||
|
|
||||||
|
Dies ist das **aktive Planungs-Zuhause**. Wenn du planst, steuerst oder verstehen willst „wo stehen wir" — hier, nicht in `docs/` (das ist Boilerplate-/Technik-Referenz).
|
||||||
|
|
||||||
|
**Stand:** 2026-06-15
|
||||||
|
|
||||||
|
## Zuerst lesen (in dieser Reihenfolge)
|
||||||
|
1. **PROJECT.md** — Was ist HiveGrid, Core Value, Key Decisions (AD-1…AD-20), Constraints.
|
||||||
|
2. **ROADMAP.md** — die 21 Phasen mit Zielen & Success-Criteria.
|
||||||
|
3. **STATE.md** — aktueller Stand, was als Nächstes dran ist.
|
||||||
|
|
||||||
|
## Kern-Planung (gepflegt)
|
||||||
|
| Datei | Inhalt |
|
||||||
|
|---|---|
|
||||||
|
| PROJECT.md | Charter + Architektur-Entscheidungen (Kurzfassung; voll in `docs/ARCHITECTURE-DECISIONS.md`) |
|
||||||
|
| ROADMAP.md | 21 Phasen, Reihenfolge, Success-Criteria |
|
||||||
|
| REQUIREMENTS.md | v1-Requirements (90) je Modul |
|
||||||
|
| PHASE-SOURCES.md | Phase → Milestone-PLANs (`docs/milestones/`) Mapping für /gsd-plan-phase |
|
||||||
|
| SCOPE-V1-CUTS.md | Entscheidungs-Historie v1↔v2 (Schnitte #1–#13) |
|
||||||
|
| TIMELINE.md / SPRINT-4W.md | Master-Timeline + 4-Wochen-Sprint |
|
||||||
|
| STATE.md | Live-Status |
|
||||||
|
|
||||||
|
## Datenmodell — ✅ APPROVED & LOCKED (Projekt-zentrisch, AD-20)
|
||||||
|
| Datei | Rolle |
|
||||||
|
|---|---|
|
||||||
|
| **ENTITY-MODEL.md** | autoritatives Datenmodell (voll) |
|
||||||
|
| **entity-model.dbml** | maschinenlesbar → in dbdiagram.io importieren |
|
||||||
|
| **entity-model.svg** | gerendertes ER-Diagramm |
|
||||||
|
| **ENTITY-MODELL-ERKLAERUNG.md/.pdf** | laienverständliche Fassung (für Design/Stakeholder) |
|
||||||
|
| HiveGrid_CRM_Datenlogik_UX_Entscheidungen.md | Davids approved UX-Quelle (Grundlage des Pivots) |
|
||||||
|
|
||||||
|
## UX / Design
|
||||||
|
- **SCREEN-MAP.md** — Bau-Liste aller v1-Screens (Davids Arbeitsliste)
|
||||||
|
- **DESIGNER-FIRST-PLAYBOOK.md** — Designer-first-Methodik + Archetypen
|
||||||
|
|
||||||
|
## Externe Abhängigkeiten
|
||||||
|
- **EXTERNALS-CHECKLISTE.md** — Konten/APIs (KWP, Mistral, Mailjet, AirCall, Legacy-Provider, …)
|
||||||
|
|
||||||
|
## Unterordner
|
||||||
|
- **handouts/** — personalisierte Briefings (David, Akeshan, Dejan, Haris, Noah, Raffael)
|
||||||
|
- **intel/** — Bootstrap-Intel (Decisions/Constraints/Requirements-Extrakte; Referenz, nicht aktiv gepflegt)
|
||||||
|
|
||||||
|
## Konventionen
|
||||||
|
- `*.pdf` neben einer `*.md` = nur die gerenderte Fassung derselben Datei (zum Teilen).
|
||||||
|
- Infra-Realität: **Hetzner + Coolify + Cloudflare** (nicht Scaleway/Fly).
|
||||||
Binary file not shown.
@@ -0,0 +1,410 @@
|
|||||||
|
# Requirements: HiveGrid 2.0
|
||||||
|
|
||||||
|
**Defined:** 2026-06-07
|
||||||
|
**Core Value:** Jeder SHK-Betrieb (Mandant) wickelt die komplette Wertschöpfungskette — Lead → Projekt (frei konfigurierbare Pipelines) (→ KWP-Sync ab v2) — inklusive visueller Automation in einem einzigen, DSGVO-konformen EU-System ab. Wenn diese Kette nicht durchgängig funktioniert, scheitert das Produkt. *(Scope-Schnitt #12, 12.06.: KWP = erstes v2-Modul — API-Zugang des Herstellers erst ~19.07., nach v1-Launch. AD-26: kein eigenes LLM/RAG/Whisper; MCP-Server statt KI-Layer.)*
|
||||||
|
|
||||||
|
> ✅ **MODELL-PIVOT 2026-06-13 (AD-20) — Module 1–4 nachgezogen (R-REFIT, 16.06.):** Projekt-zentrisch (ein `Projekt`-Kern, Pipelines = Views). Umgesetzt: **REQ-crm-lead-promotion entfällt → REQ-lead-projekt-konvertierung** (Lead → Projekt bei Weiterverarbeitungsfreigabe, kein Modal, E4); **Sales (Modul 3) + Projekt (Modul 4) konsolidiert** zu „Projekt & Pipelines" mit Pipeline-Feld-Config-/Rechte-Layer (PipelineAccess/-FieldConfig/-FieldVisibility); **REQ-rechnung-sub-entity (NEU, E3)** angelegt; Kontaktmodell (Kontakttyp Privatperson/Organisation, -status, -art als Relation); Abnahme bleibt v1 als Checklisten/Protokoll-Sub-Area (E2). Single Source: `.planning/ENTITY-MODEL.md`.
|
||||||
|
|
||||||
|
## v1 Requirements
|
||||||
|
|
||||||
|
### Modul 1 — CRM-Kern
|
||||||
|
|
||||||
|
- [ ] **REQ-crm-datenmodell**: Typisierte First-Class-Prisma-Tabellen für alle CRM-Kernentitäten (Kontakt als Oberbegriff mit Kontakttyp Privatperson/Organisation, KontaktRelation, Lead, Activity, CustomField, Tag) mit RLS-Policies auf allen Tabellen.
|
||||||
|
- [ ] **REQ-crm-listen-views**: Kontakt- und Organisations-Listen mit server-seitiger Filter-, Sortier- und Paginierungslogik, Bulk-Actions und CSV-Export.
|
||||||
|
- [ ] **REQ-crm-detail-views**: Kontakt-, Organisations- und Lead-Detailansichten mit Inline-Edit, Activity-Stream, verknüpften Entitäten und Custom-Feldern.
|
||||||
|
- [ ] **REQ-lead-projekt-konvertierung**: Lead → Projekt bei `Weiterverarbeitungsfreigabe` (ja/nein/unklar); relevante Lead-Daten werden ins Projekt vererbt, der Kontakt wird separat verknüpft (kein Promotions-Modal, AD-20). *(Pivot 13.06.: ersetzt das frühere REQ-crm-lead-promotion / 4-Optionen-Modal.)*
|
||||||
|
- [ ] **REQ-crm-activity-stream**: Zentrale append-only Activity-Tabelle (Event-Sourcing) als chronologische Stream-View pro Entität, filterbar nach Typ/Actor/Zeitraum.
|
||||||
|
- [ ] **REQ-crm-custom-felder**: CustomFieldDefinition + CustomFieldValue pro Tenant für Kontakt/Lead/Projekt/Rechnung, mit Admin-Verwaltungs-Route, pro Pipeline via PipelineFieldConfig schaltbar und SHK-Branchen-Template-Defaults.
|
||||||
|
- [ ] **REQ-crm-duplikat-erkennung**: Live-Match-Check beim Anlegen und Bulk-Duplikat-Tool für Admins mit Side-by-Side-Merge.
|
||||||
|
- [ ] **REQ-crm-tags**: Tag-System mit ad-hoc-Erstellung, Farbgebung, Entity-übergreifender Verwaltung und Listen-Filter-Integration.
|
||||||
|
- [ ] **REQ-crm-permissions**: Permission-Bundle crm.* (read_own, read_all, write, delete, admin) mit Owner-Check und server-seitigem Permission-Filter.
|
||||||
|
|
||||||
|
### Modul 2 — Lead-Inbox
|
||||||
|
|
||||||
|
- [ ] **REQ-lead-inbox-liste**: Lead-Inbox als Arbeitsplatz mit Status-Filter, Triage-Quick-Actions, Bulk-Operationen und Real-time-Refresh.
|
||||||
|
- [ ] **REQ-lead-quellen-auto-anlage**: Automatische Lead-Anlage aus Form-Submission, eingehender E-Mail und AirCall-Inbound-Anruf mit Automation-Trigger.
|
||||||
|
- [ ] **REQ-lead-status-workflow**: Status-Enum (new|qualified|converted|lost|spam) mit definierten Übergängen und DSGVO-Auto-Lösch-Cron.
|
||||||
|
- [ ] **REQ-lead-anti-spam**: Rate-Limiting und Anomalie-Detection für Lead-Quellen mit Quarantäne-Modus und Tenant-Admin-Notification.
|
||||||
|
- [ ] **REQ-lead-statistiken**: Statistiken-Page mit KPI-Kacheln, Quellen-Aufschlüsselung und Trend-Charts, Permission-aware.
|
||||||
|
- [ ] **REQ-lead-permissions**: Permission-Bundle leads.* mit Owner-Check-Logik und permission-awarern Server-side-Filtern in allen Listen.
|
||||||
|
|
||||||
|
### Modul 3 — Projekt & Pipelines (Teil 1: Kern + Pipeline-Engine)
|
||||||
|
|
||||||
|
> *(Pivot 13.06., AD-20: ein `Projekt`-Kern; „Deal"/„Auftrag" = Pipeline-Typen (typ_hint), keine eigenen Entitäten. Single Source: ENTITY-MODEL.md.)*
|
||||||
|
|
||||||
|
- [ ] **REQ-projekt-kern-datenmodell**: Ein typisierter `Projekt`-Kern (Superset-Tabelle, Deal- + Auftrags-Felder) mit RLS und HiveNumberSeq für fortlaufende Projekt-Nummern; Pipeline (typ_hint sales/auftrag/custom) + PipelineStage (= Status, pipeline-intern; stage_kind offen/gewonnen/verloren) als konfigurierbare Views.
|
||||||
|
- [ ] **REQ-pipeline-rechte-config**: Pipeline-Feld-Config- und Rechte-Layer schon v1 komplex — PipelineAccess (wer sieht/bearbeitet Pipeline) + PipelineFieldConfig (Feld sichtbar/pflicht je Pipeline+Status) + PipelineFieldVisibility (Field-Level-Rechte je Rolle/Gruppe/User, z.B. Auftragsvolumen nur für Vertrieb).
|
||||||
|
- [ ] **REQ-projekt-kanban-listen-view**: Ein konfigurierbarer Kanban-View (Drag-&-Drop, Stage-Wechsel) und Listen-View mit Filter, Bulk-Actions, Real-Time-Updates und Reverse-Window für gewonnen/verloren.
|
||||||
|
- [ ] **REQ-projekt-pipeline-wechsel**: Projekt-Anlage aus mehreren Quellen, Stage-Wechsel-Validation und Pipeline-Wechsel statt Won-Handoff (ein Projekt wechselt nur die Pipeline — kein zweiter Datensatz entsteht); Auto-Archive-Cron für abgeschlossene Projekte.
|
||||||
|
- [ ] **REQ-projekt-forecast-kpis**: Forecast-Berechnung, KPIs pro Vertriebler, Stage-Conversion-Rates und Verlust-Grund-Auswertung mit Aggregat-Cache.
|
||||||
|
|
||||||
|
### Modul 4 — Projekt & Pipelines (Teil 2: Auftrags-Features + Sub-Areas)
|
||||||
|
|
||||||
|
> *(Pivot 13.06., AD-20: Auftrags-Welt = Pipeline-View auf denselben `Projekt`-Kern. Material/Zeiterfassung/Leistungspositionen/Baustelle/Support → v2.)*
|
||||||
|
|
||||||
|
- [ ] **REQ-projekt-sub-areas**: Sub-Areas am Projekt-Kern (Termine, Aufgaben, Aktivitäten, Dokumente, Checklisten, ProjektMitglied/Monteur-Zuweisung) + Plantafel-Ansicht für Ressourcen-Scheduling pro Monteur/Tag, offline-fähig.
|
||||||
|
- [ ] **REQ-rechnung-sub-entity**: `Rechnung` als einfaches Sub-Entity am Projekt-Kern (Liste/Anlegen/Verknüpfen) mit fortlaufender Rechnungsnummer (HiveNumberSeq, lückenlos/GoBD), Status (entwurf/gestellt/bezahlt/storniert) und PDF-Anhang. *(Pivot 13.06., E3 — einziger echter v1-Scope-Zuwachs.)*
|
||||||
|
- [ ] **REQ-projekt-abnahme**: AbnahmeProtokoll (+ AbnahmeSignatur) als immutable Sub-Area direkt am Projekt mit Touch-Unterschrift, Offline-Sync und M05-Form-Template-Unterstützung; „Mängel" als Checkliste (typ=maengel).
|
||||||
|
|
||||||
|
### Modul 5 — Form Builder
|
||||||
|
|
||||||
|
- [ ] **REQ-form-datenmodell**: Form, FormField, FormSubmission und FormAction als Datenmodell mit 12 Feld-Typen und konfigurierbaren Post-Submit-Aktionen. *(Scope-Schnitt 12.06.: FormLink — personalisierte Links mit Tracking/Ablauf/Limit — + JS-Snippet → v2; öffentliche URL, QR-Code und iFrame-Embed bleiben.)*
|
||||||
|
- [ ] **REQ-form-editor**: Drag-&-Drop-Form-Editor mit Echtzeit-Vorschau, Conditional Logic, SHK-Form-Templates und iFrame-Embed-Code.
|
||||||
|
- [ ] **REQ-form-actions**: Form-Actions nach Submission (Lead/Projekt/Task anlegen, Webhook, Email, Automation-Trigger) mit Field-Mapping und ActionLog.
|
||||||
|
|
||||||
|
### Modul 6 — Booking
|
||||||
|
|
||||||
|
- [ ] **REQ-booking-datenmodell**: BookingPage, AvailabilityRule, AvailabilityException und Appointment als Datenmodell für öffentlich erreichbare Buchungsseiten.
|
||||||
|
- [ ] **REQ-booking-slot-kalkulierung**: Slot-Berechnung unter Berücksichtigung von Verfügbarkeitsregeln, Ausnahmen, Kalender-Sync (M25) und Puffer, Timezone-aware.
|
||||||
|
- [ ] **REQ-booking-integrationen**: Lead-Inbox-Integration, Activity-Eintrag, Bestätigungs-Email und iFrame-Embed-Code nach Terminbuchung.
|
||||||
|
|
||||||
|
### Modul 7 — Angebot + Signatur
|
||||||
|
|
||||||
|
- [ ] **REQ-signatur-datenmodell**: SignatureDocument, SignatureSigner und SignatureProviderConnection für Multi-Signer-Workflows im Projekt-/Angebots-Kontext.
|
||||||
|
- [ ] **REQ-signatur-provider**: Self-hosted E-Signatur als Standardpfad (SES, AD-25); PandaDoc/DocuSign nur optionale BYOK-/Opt-in-Adapter via Apps-Engine (M33a) mit Connect-Flow, Webhook-Verarbeitung und Status-Updates.
|
||||||
|
|
||||||
|
### Modul 9 — Email-Inbox
|
||||||
|
|
||||||
|
- [ ] **REQ-email-datenmodell**: EmailIntegrationMailbox, EmailIntegrationMessage, TenantSendingDomain und TenantInboundAddress für bidirektionalen Gmail/Outlook-Sync.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-email-sync-strategie**: Bidirektionaler Sync Gmail/Outlook über ProviderAdapter-Interface mit Auto-Matching von Absendern zu Contact/Lead.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-email-inbox-view**: Inbox-View, Thread-View und Compose mit Permission-Scoping und CRM-Kontext-Verknüpfung.
|
||||||
|
|
||||||
|
### Modul 10 — Email-Marketing
|
||||||
|
|
||||||
|
- [ ] **REQ-marketing-datenmodell**: Campaign, OutboundEmail, EmailTemplate, RecipientSegment und EmailSuppressionList als Datenmodell mit DSGVO-konformem Tracking.
|
||||||
|
- [ ] **REQ-marketing-double-optin**: Double-Opt-In-Workflow mit DSGVO-Compliance, One-Click-Unsubscribe und Suppression-List-Check vor jedem Versand.
|
||||||
|
- [ ] **REQ-marketing-versand**: BullMQ-basierter Versand mit Rate-Limiting, Bounce-Handling und SMTP-Provider-Abstraktion (Mailjet, AD-6 gelockt).
|
||||||
|
|
||||||
|
### Modul 12 — Telefonie (AirCall)
|
||||||
|
|
||||||
|
- [ ] **REQ-telefonie-datenmodell**: TelephonyConnection, TelephonyUserBinding und TelephonyCallSession als Datenmodell für AirCall-Integration mit verschlüsselten OAuth-Tokens.
|
||||||
|
- [ ] **REQ-telefonie-provider-adapter**: TelephonyProviderInterface mit AirCallAdapter für Click-to-Call, Inbound-Webhook-Verarbeitung und automatische Lead-Anlage bei unbekannter Nummer.
|
||||||
|
|
||||||
|
### Modul 13 — Team-Chat
|
||||||
|
|
||||||
|
- [ ] **REQ-chat-datenmodell**: TeamChat, TeamChatMessage, Threads, Reactions und TeamChatRead als Datenmodell für drei Channel-Typen (public, private, entity-linked).
|
||||||
|
- [ ] **REQ-chat-realtime**: WebSocket-basiertes Real-Time-Messaging mit Presence, Typing-Indicator, Read-Receipts und Redis-Pub/Sub für Scale-Out.
|
||||||
|
- [ ] **REQ-chat-features**: Link-Previews, File-Uploads, @Mentions, Chat-Verlaufs-Suche und Entity-linked Channels im Projekt-Detail.
|
||||||
|
|
||||||
|
### Modul 14 — HR-Hub
|
||||||
|
|
||||||
|
- [ ] **REQ-hr-datenmodell**: HrEmployeeProfile, EmployeeVacationRequest, EmployeeSickLeaveReport, EmployeePayslip und HrRequest als Datenmodell mit AES-256-GCM-Verschlüsselung für sensible Daten.
|
||||||
|
- [ ] **REQ-hr-passwort-safe**: Verschlüsselter Passwort-Safe pro Mitarbeiter mit KMS-backed Envelope-Encryption, Audit-Trail und DSGVO-Export.
|
||||||
|
- [ ] **REQ-hr-urlaub-krank**: Urlaubs-Anfrage-Workflow (mehrstufiger Approval) und Krankmeldungs-Erfassung mit Abwesenheits-Kalender-Integration.
|
||||||
|
|
||||||
|
### Modul 15 — Customer-Portal
|
||||||
|
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-portal-datenmodell**: PortalUser, CustomerPortalSession, CustomerPortalProjectAccess und PortalConfiguration als vollständig getrennte Portal-Datenwelt.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-portal-auth-magic-link**: Magic-Link-Authentication für Endkunden (getrennte Auth-Welt, AD-3) mit One-Time-Token, IP-Bindung und DSGVO-Lösch-Workflow.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-portal-projekt-sicht**: Projekt-Sicht für Endkunden (nur explizit freigegebene Projekte), Dokument-Upload und Portal-Forms, Default-Sichtbarkeit NICHT sichtbar.
|
||||||
|
|
||||||
|
### Modul 17 — Automation Engine
|
||||||
|
|
||||||
|
- [ ] **REQ-automation-datenmodell**: AutomationRule (JSON-Graph), AutomationExecution, AutomationStepExecution und AutomationTemplate als Datenmodell für den Flow-Editor.
|
||||||
|
- [ ] **REQ-automation-trigger-library**: Phase-1-Trigger-Library über alle Module (CRM, Sales, Projekte, Email, Forms, Kalender, Zeit-Trigger, Webhooks).
|
||||||
|
- [ ] **REQ-automation-action-library**: Phase-1-Action-Library über alle Module (CRM-Aktionen, Notifications, KWP-Push, HTTP-Request, Tasks, If/Else, Delay, Loop).
|
||||||
|
- [ ] **REQ-automation-flow-editor**: Graph-basierter visueller Flow-Editor mit manueller Flow-Erstellung, Dry-Run und 24h-Undo. KI-/Sprach-Erstellung entfällt nach AD-26.
|
||||||
|
- [ ] **REQ-automation-schutz**: Loop-Guard, Rate-Limit, Idempotenz-Key, Resume-Mode und Trigger-Volumen-Metering pro Tenant.
|
||||||
|
|
||||||
|
### Modul 18 — ~~KI-Layer~~ → MCP-Server ([[AD-26]])
|
||||||
|
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]):** HiveGrid hostet kein eigenes LLM/RAG/Whisper mehr, sondern wird Remote-MCP-Server. Die vier KI-Requirements unten sind **entfernt bzw. zurückgestellt**; an ihre Stelle tritt `REQ-mcp-server` (siehe unten). Verbindliche Bau-Spec: [[VR-MCP]]/[[VD-MCP]].
|
||||||
|
|
||||||
|
- [ ] **REQ-mcp-server**: Remote-MCP-Server (Streamable HTTP, `@modelcontextprotocol/sdk`), der HiveGrid-Daten als **Read-Ressourcen** und freigegebene Schreib-Operationen als **Action-Tools** für externe KI-Clients bereitstellt. **Auth = API-Key + Scopes + Rate-Limit aus der Public-API** ([[VR-P22]]); Tenant wird aus dem Token abgeleitet, jeder Zugriff läuft durch `withTenantScope()`/RLS. Jede Action ist `withPermission()`-gegated, erzwingt bei Schreib-Operationen eine **Confirmation** und wird via M001-Audit protokolliert (Actor-Kind „MCP/Agent"). Keine neuen KI-Entitäten — Nutzung von `ApiKey`/`Credential` (ggf. kleine `McpGrant`/Scope-Tabelle).
|
||||||
|
- ~~**REQ-ki-llm-gateway**: EU-only LLM-Gateway (Mistral La Plateforme primär; …) mit Token-Tracking und Pay-as-you-go-AI-Credits.~~ → **entfernt (KI→MCP, [[AD-26]])** — kein eigenes LLM-Gateway.
|
||||||
|
- ~~**REQ-ki-rag-embeddings**: RAG-Pipeline mit pgvector, Outbox-Pattern für Embedding-Jobs und RLS-gefiltertem Top-K-Retrieval.~~ → **zurückgestellt (KI→MCP, [[AD-26]]; v3-Kandidat)**.
|
||||||
|
- ~~**REQ-ki-whisper**: Whisper-Transkription für Anruf-Aufzeichnungen über EU-Endpoint mit Token-Tracking und AiCredits-Deduktion.~~ → **zurückgestellt (KI→MCP, [[AD-26]]; v3-Kandidat)**.
|
||||||
|
- ~~**REQ-ki-hivemind**: HiveMind-KI-Assistent mit kontextuellem RAG-Chat, Conversation-History und Promptfoo-basiertem Sicherheits-Testing.~~ → **zurückgestellt (KI→MCP, [[AD-26]]; v3-Kandidat)**.
|
||||||
|
|
||||||
|
### Modul 19 — KWP-Integration
|
||||||
|
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-12 — erstes v2-Modul)* **REQ-kwp-datenmodell**: KwpSettings, KwpRegistry, KwpProjectQueue, KwpApiKey und KwpSchemaSnapshot als Cloud-seitiges Datenmodell (keine KWP-DB-Credentials in Cloud).
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-12 — erstes v2-Modul; ⚠ Recut: offizielle REST-API statt kwpsync.exe)* **REQ-kwp-architektur**: ~~Drei-Komponenten-Architektur (HiveGrid Cloud, kwpsync.exe Windows-Client, KWP MSSQL-DB)~~ → KWP als `DataConnection type='rest-api'` mit bidirektionalem Sync und Adapter-Pattern.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-12 — erstes v2-Modul)* **REQ-kwp-schema-drift**: Schema-Drift-Sentinel für Schema-/API-Versions-Änderungen mit regelmäßigem Snapshot, Drift-Detection und Tenant-Admin-Notification.
|
||||||
|
|
||||||
|
### Modul 20 — Dashboard
|
||||||
|
|
||||||
|
- [ ] **REQ-dashboard-datenmodell**: Dashboard, DashboardLayout und WidgetInstance als Datenmodell mit Role-Default-Layouts (SHK-Template geseedet). *(Scope-Schnitt 12.06.: 3 feste Rollen-Layouts GF/Büro/Monteur; Drag&Drop + User-Layout-Persistenz → v2.)*
|
||||||
|
- [ ] **REQ-dashboard-widgets**: Widget-Katalog mit Datenquellen aus Sales, Projekte, Tasks und HR; Realtime-Updates via WebSocket/SSE und Aggregat-Cache. KI-Widgets sind Backlog/v3 nach AD-26.
|
||||||
|
|
||||||
|
### Modul 21 — Audit-Log
|
||||||
|
|
||||||
|
- [ ] **REQ-audit-datenmodell**: Append-only AuditEntry mit SHA-256-Hash-Kette (Tamper-Nachweisbarkeit) und automatischer Generierung über Prisma-Middleware.
|
||||||
|
- [ ] **REQ-audit-retention-export**: Fixe Default-Retention (10 Jahre), BullMQ-Export-Jobs als NDJSON/CSV in S3-kompatibles Object Storage (Hetzner) und Cron-Auto-Löschung. *(Scope-Schnitt 12.06.: tenant-konfigurierbare Retention-Policy, Legal-Hold, Saved-Views → v2; Boilerplate liefert Retention-Cron + PDF-Export.)*
|
||||||
|
- [ ] **REQ-audit-permissions**: Audit-Zugriff permission-gegated (audit.read, audit.export) mit Plattform-Admin-View für mandantenübergreifende Einträge.
|
||||||
|
|
||||||
|
### Modul 22 — Notifications
|
||||||
|
|
||||||
|
- [ ] **REQ-notification-datenmodell**: Notification, NotificationPreference und NotificationDevice als Datenmodell. *(Scope-Schnitt 12.06.: NotificationBundle + NotificationQuietHours → v2 mit M117.)*
|
||||||
|
- [ ] **REQ-notification-versand-pipeline**: Drei-Kanal-Versand (In-App via SSE, Email, Web-Push via VAPID) über BullMQ mit notify()-Pflicht-Interface aus @hivegrid/notifications. *(Scope-Schnitt 12.06.: Sofort-Zustellung ohne Bündelung/Quiet-Hours; Push-Kanal Stub bis v2.)*
|
||||||
|
|
||||||
|
### Modul 23 — Files
|
||||||
|
|
||||||
|
- [ ] **REQ-files-datenmodell**: File, FileChunk, FileUploadProgress und FileEntityLink als Datenmodell mit S3-kompatiblem Object-Storage-Backend (Hetzner, Infra-ADR-009) und RLS auf Storage-Pfaden. *(Scope-Schnitt 12.06.: FileVersion → v2.)*
|
||||||
|
- [ ] **REQ-files-upload-preview**: Chunked-Upload (TUS), Preview-Generierung (PDF→PNG, Bild→WebP, **HEIC→JPG** — Pflicht für iPhone-Monteur-Fotos) und Customer-Portal-Upload-Unterstützung. *(Scope-Schnitt 12.06.: Versionierung, Office-/Video-Previews, Resume-Upload, OCR → v2.)*
|
||||||
|
|
||||||
|
### Modul 24 — Globale Suche
|
||||||
|
|
||||||
|
- [ ] **REQ-suche-datenmodell**: SearchIndexEntry, RecentSearch und Outbox-Pattern für Index-Jobs nach Entity-Mutationen. AD-26: keine Embedding-/RAG-Spalte in v1/v2; Outbox-Events bleiben für Meilisearch-Indexierung und spätere MCP-Resource-Aktualität.
|
||||||
|
- [ ] **REQ-suche-hybrid**: Keyword-Suche via Meilisearch mit permission-awarem SearchAdapter-Interface (INTEGRATION-CONTRACTS §8). AD-26: pgvector/Hybrid-RRF entfällt; v1+v2 = reine Meilisearch-Keyword-Suche.
|
||||||
|
- [ ] **REQ-suche-ui**: Cmd+K-Modal (global Hotkey, debounced) und Vollbild-Such-View mit persistierter Suche und RecentSearch-Anzeige.
|
||||||
|
|
||||||
|
### Modul 25 — Calendar-Sync
|
||||||
|
|
||||||
|
- [ ] **REQ-kalender-datenmodell**: CalendarConnection, CalendarEvent, CalendarEventMapping und CalendarSyncCursor für bidirektionalen Google/Outlook-Sync mit verschlüsselten OAuth-Tokens.
|
||||||
|
- [ ] **REQ-kalender-sync-adapter**: CalendarAdapter-Interface (GoogleCalendarAdapter + OutlookAdapter) mit Auto-Token-Refresh, Webhook-Subscriptions und bidirektionaler HiveGrid-Terminanlage.
|
||||||
|
|
||||||
|
### Modul 26 — Tasks
|
||||||
|
|
||||||
|
- [x] **REQ-tasks-datenmodell**: Task mit Status, Priorität, Fälligkeit, Entitäts-Verknüpfung (Contact/Company/Lead/Project) und TaskWatcher. — AK-P4b (auf main; CRM-Entity-Wiring folgt in P6/R-P6).
|
||||||
|
- [x] **REQ-tasks-reminder-archivierung**: Reminder-System via M22 (konfigurierbare Vorlaufzeit) und Auto-Archivierung abgeschlossener Tasks nach 30 Tagen per Cron. — AK-P4b (auf main; Reminder+Archiv-Cron auf Staging funktional verifiziert).
|
||||||
|
|
||||||
|
### Modul 27 — Auth / Multi-Tenancy / Permissions
|
||||||
|
|
||||||
|
- [ ] **REQ-auth-multi-tenancy**: Self-Service-Signup mit auto-generiertem Tenant-Slug, Reserved-Words-Validierung und URL-Struktur (app.hivegrid.de, admin.hivegrid.de).
|
||||||
|
- [ ] **REQ-auth-methoden**: Email+Passwort (NIST-konform, Breach-Check), TOTP-2FA (RFC 6238) und Magic-Link exklusiv für Customer-Portal (AD-3).
|
||||||
|
- [ ] **REQ-auth-rbac**: Rollen-basiertes Permission-System (Role ↔ User M:N) mit Permission-Keys in packages/entitlements und 6 SHK-Standard-Rollen geseedet *(Seed nur Staging/Dev — Produktion startet admin-only, AD-29)*.
|
||||||
|
- [ ] **REQ-auth-user-lifecycle**: User-Einladung (48h-Token), Soft-Deactivation und DSGVO-Löschung via PII-Anonymisierung ohne Audit-Trail-Verlust.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-12)* **REQ-auth-api-keys**: API-Key-System mit SHA-256-Hash-Speicherung, fein-granularen Scopes und Rate-Limit (1000 Req/Min Default). *(Wandert mit der Public-API; Boilerplate-`ApiKey`-Modell bleibt ungenutzt im Code.)*
|
||||||
|
|
||||||
|
### Modul 28 — Subscriptions/Billing
|
||||||
|
|
||||||
|
- [ ] **REQ-billing-datenmodell**: TenantSubscription mit Lago/Mollie-Recut nach AD-27: Lago als Billing-/Invoice-Engine, Mollie nur als Payment-Processor, lokaler HiveGrid-Billing-State fuer Entitlements und Frozen-Modus (Read-Only-Middleware). Kein v1-Usage-Billing, keine Credits; AI-Credits/AiTokenUsage entfallen nach AD-26.
|
||||||
|
- [ ] **REQ-billing-trial-dunning**: 14-Tage-Trial ohne Kreditkarte, Dunning-Email-Sequenz (Tag 1/3/7) bei fehlgeschlagener Zahlung und anschließender Frozen-Modus.
|
||||||
|
|
||||||
|
### Modul 29 — Onboarding
|
||||||
|
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-onboarding-wizard**: Branchen-getriebener Onboarding-Wizard nach Self-Service-Signup mit SHK-Template-Vorauswahl und OnboardingSession.
|
||||||
|
- [ ] **REQ-onboarding-demo-daten**: Demo-Daten-Provisioning auf Wunsch (Kontakte, Projekte in Sales-/Auftragssichten, Tasks) mit Lösch-Funktion via is_demo_data-Flag. *(Scope-Schnitt 12.06. + AD-26: KI-Walkthrough entfällt; Settings-Knopf statt Wizard-Schritt, einfaches Löschen.)*
|
||||||
|
|
||||||
|
### Modul 30 — i18n
|
||||||
|
|
||||||
|
- [ ] **REQ-i18n-architektur**: Locale-File-Struktur in packages/i18n, Language-Resolution (User → Tenant → DE), Build-Lint für Hard-Strings und ICU-Pluralisierung.
|
||||||
|
- [ ] **REQ-i18n-outbound**: Contact.language steuert Sprache der automatischen Outbound-Kommunikation; Notification-Templates in DE. *(Scope-Schnitt 12.06.: v1 DE-only — EN-Templates + Sprach-Wechsler → v2; i18n-Pflicht-Wiring + `verify:i18n`-Gate bleiben unantastbar, alles i18n-ready.)*
|
||||||
|
|
||||||
|
### Modul 31 — Branding
|
||||||
|
|
||||||
|
- [ ] **REQ-branding-theme-phase1**: User-Level Theme-Preference (Hell/Dunkel) mit SSR-kompatibler Cookie-Implementierung ohne Theme-Flash. *(Scope-Schnitt 12.06.: kein System-Modus — bewusst nur 2 Optionen; `next-themes` aus Boilerplate.)*
|
||||||
|
|
||||||
|
### Modul 32 — Feature-Flags
|
||||||
|
|
||||||
|
- [ ] **REQ-feature-flags-system**: Platform-Admin-Feature-Flag-System (FeatureFlag + TenantFeatureFlag) mit Redis-Cache, FeatureFlagFilter für automatische Aktivierung und AdminAuditLog.
|
||||||
|
|
||||||
|
### Modul 33a — Apps-Engine
|
||||||
|
|
||||||
|
- [ ] **REQ-apps-engine-datenmodell**: DataConnection, AppSyncRun, AppSyncItem und type-safe Adapter-Registry als zentrales Integrations-Framework.
|
||||||
|
- [ ] **REQ-apps-engine-lifecycle**: OAuth2-Connect-Flow (Gmail, Outlook, AirCall, PandaDoc), API-Key-Connect (KWP, Payment-Provider-APIs), Connection-Health-Monitoring und Settings-UI.
|
||||||
|
|
||||||
|
### Modul 34 — Public API & Webhooks
|
||||||
|
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-public-api-read**: Phase-1 Read-Only REST-API für Contacts, Deals, Leads, Projects, Tasks und Companies mit API-Key-Auth, Rate-Limit und Auto-genierter OpenAPI-Spec.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-public-webhooks**: Incoming Lead-Push Webhooks und ausgehende Webhook-Subscriptions mit HMAC-SHA256-Signatur, Retry-Logik und WebhookDelivery-Logging.
|
||||||
|
|
||||||
|
### Modul 35 — DSGVO-Export / Account-Löschung
|
||||||
|
|
||||||
|
- [ ] **REQ-dsgvo-export**: GDPR-Daten-Export als ZIP via BullMQ-Worker mit 72h-signed-Download-URL (S3-kompatibles Object Storage, Hetzner) und Download-Link-Email.
|
||||||
|
- [ ] **REQ-dsgvo-tenant-deletion**: Tenant-Account-Löschung mit Crypto-Shredding (Per-Tenant-DEK löschen), Lago-Subscription-Cancel/Mollie-Zahlungsreferenz-Bereinigung und vollständiger Storage/Cache-Bereinigung.
|
||||||
|
|
||||||
|
### Modul 36 — Mobile-PWA (PWA-only, kein nativer Client)
|
||||||
|
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11; PWA-only, AD-17)* **REQ-mobile-pwa**: Installierbare PWA (iOS Safari ≥ 16, Android Chrome ≥ 10) mit Service-Worker, Add-to-Homescreen, App-Manifest und Kamera-Upload über Web-APIs. *(Expo/Capacitor/native App verworfen — PWA-only, AD-17; nativer Client + App-Store → frühestens v3.)*
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-mobile-offline-sync**: Voller Offline-Betrieb mit IndexedDB-lokalem Daten-Subset, OfflineSyncQueue, KWP-gewinnt-Konfliktauflösung und Offline-Indikatoren.
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11; PWA-only, AD-17)* **REQ-mobile-push**: Web-Push (VAPID) mit NotificationDevice-Registrierung und Token-Rotation. *(APNs/FCM/nativer Push verworfen — Web-Push-only, AD-17.)*
|
||||||
|
|
||||||
|
### Modul 37 — Plattform-Admin
|
||||||
|
|
||||||
|
- [ ] **REQ-plattform-admin-identität**: Admin-Welt auf `admin.hivegrid.de` (Host-Routing, Cookie-Domain-Trennung zu app.*) mit TOTP-Pflicht + MFA-Step-up; Admin-User ohne Tenant-Workspace. *(Scope-Schnitt 12.06.: getrennte AdminUser-Identität/AdminSession/AdminRBAC = M038/M039 → v2; v1 = Boilerplate-Modell User-Extension + `admin-mfa-gate`.)*
|
||||||
|
- [ ] **REQ-plattform-admin-features**: Tenant-Management, Subscription-Overrides, Feature-Flag-Verwaltung, BullMQ-Queue-Monitoring und Support-Inbox aus M39.
|
||||||
|
|
||||||
|
### Modul 38 — Help-Center (öffentlich)
|
||||||
|
|
||||||
|
- *(→ v2, Scope-Schnitt 2026-06-11)* **REQ-help-center**: Dateibasiertes Markdown-Help-Center mit Build-generiertem Index, client-seitiger FlexSearch-Suche, Deep-Links aus der App und SSR-SEO.
|
||||||
|
|
||||||
|
### Modul 39 — Help-Desk / Support
|
||||||
|
|
||||||
|
- [ ] **REQ-feedback-widget**: In-App Feedback-Widget (Bug/Feature/Frage/Sonstiges) mit Rate-Limit, Screenshot-Anhang via M23 und Platform-Admin-Support-Inbox in M37.
|
||||||
|
|
||||||
|
### Querschnitt — Integration-Contracts
|
||||||
|
|
||||||
|
- [ ] **REQ-integration-sidebar**: Alle neuen Modul-Bereiche müssen in der Sidebar-Konfiguration registriert sein (Registrierung in apps/web/app/application/sidebar/).
|
||||||
|
- [ ] **REQ-integration-routes**: Verbindliche URL-Schemata für Mandanten-App, Plattform-Admin, Customer-Portal, Public-Forms, Booking, Help und API (INTEGRATION-CONTRACTS §3).
|
||||||
|
- [ ] **REQ-integration-activity-wiring**: Jede schreibende Aktion mit Entitäts-Bezug muss logActivity() aus @hivegrid/activity aufrufen.
|
||||||
|
- [ ] **REQ-integration-audit-wiring**: Audit läuft automatisch über Prisma-Middleware (M21); Ausnahmen (S3-Upload, externe Webhooks) manuell über auditEvent() aus @hivegrid/audit.
|
||||||
|
- [ ] **REQ-integration-notification-wiring**: Benachrichtigungen immer über notify() aus @hivegrid/notifications, kein direkter Kanal-Zugriff in Modul-Code.
|
||||||
|
- [ ] **REQ-integration-view-model-pflicht**: Jede Route gibt im Loader ein View-Model zurück; UI-Components empfangen nur VM + Action-Callbacks, kein direkter DB-Zugriff.
|
||||||
|
- [ ] **REQ-integration-smoke-tests**: Jede neue Route bekommt einen Smoke-Test in e2e/smoke/{modul}.spec.ts gegen packages/ui-mock.
|
||||||
|
|
||||||
|
## v2 Requirements
|
||||||
|
|
||||||
|
**Definition (verbindlich):** v2 = alles, was gemacht werden MUSS — nur sequenziert nach dem v1-Launch. Kein Vielleicht-Backlog.
|
||||||
|
|
||||||
|
**Scope-Schnitt 2026-06-11 (15 REQs aus v1 verschoben — Definitionen oben mit *(→ v2)* markiert, Historie in `SCOPE-V1-CUTS.md`):**
|
||||||
|
- **Mobile (PWA-Ausbau, AD-17):** REQ-mobile-pwa, REQ-mobile-offline-sync, REQ-mobile-push — v1 = mobile-first responsive Web / PWA; v2 = installierbare PWA-Vertiefung (Expo/Capacitor verworfen — PWA-only; nativer Client + App-Store → v3)
|
||||||
|
- **Customer-Portal:** REQ-portal-datenmodell, REQ-portal-auth-magic-link, REQ-portal-projekt-sicht
|
||||||
|
- ~~**KI-Kür:** REQ-ki-hivemind, REQ-ki-rag-embeddings, REQ-ki-whisper — v1 baut Andock-Adapter~~ → **KI→MCP-Pivot ([[AD-26]]): zurückgestellt (v3-Kandidat); v2 liefert stattdessen `REQ-mcp-server` (MCP-Server, siehe [[VR-MCP]]/[[VD-MCP]]). Kein eigenes LLM/RAG/Whisper.**
|
||||||
|
- **Postfach-Sync:** REQ-email-sync-strategie, REQ-email-inbox-view — Sende-Domain + BCC-Brücke bleiben v1
|
||||||
|
- **Public-API:** REQ-public-api-read, REQ-public-webhooks
|
||||||
|
- **Help:** REQ-help-center — v1 = Minimal-FAQ; REQ-feedback-widget bleibt v1
|
||||||
|
- **Onboarding:** REQ-onboarding-wizard — v1 = Auto-SHK-Provisionierung ohne Wizard-UI
|
||||||
|
|
||||||
|
**Scope-Schnitt 2026-06-12 #12 (Abschluss-Runde, 3 REQs verschoben + 4 Dünnungen):**
|
||||||
|
- **KWP-Integration (ERSTES v2-Modul):** REQ-kwp-datenmodell, REQ-kwp-architektur (⚠ Recut: REST-API statt kwpsync.exe), REQ-kwp-schema-drift — Kalender-Realität: Hersteller-API-Zugang ~19.07. > v1-Launch ~10.07.; Callback-URL gemeldet, Andockpunkte in v1
|
||||||
|
- **Dünnungs-Notes (REQ bleibt v1):** Theme nur Hell/Dunkel (kein System-Modus) · Demo-Daten ohne KI-Walkthrough · Forms ohne personalisierte Links/JS-Snippet · Material-Listen ohne Lagerist-Sicht
|
||||||
|
|
||||||
|
**Scope-Schnitt 2026-06-12 (Boilerplate-Recheck, 1 REQ verschoben + Dünnungs-Notes an 9 REQs):**
|
||||||
|
- **Public-API-Paket:** REQ-auth-api-keys — wandert mit REQ-public-api-read/-webhooks; Boilerplate-`ApiKey`-Modell bleibt im Code
|
||||||
|
- **Als Dünnungs-Notes (REQ bleibt v1):** Notification-Bündelung/Quiet-Hours (M117), Sprach-Wechsler/EN-Templates (v1 DE-only, i18n-ready Pflicht), getrennte AdminUser-Identität (M038/M039; Auflagen: kein Tenant-Workspace, admin.hivegrid.de-Host-Routing + Cookie-Trennung), Datei-Versionierung/Office-Video-Preview/OCR (HEIC→JPG bleibt!), Dashboard-Drag&Drop (3 feste Rollen-Layouts), Audit-Retention-Konfigurierbarkeit/Legal-Hold
|
||||||
|
|
||||||
|
Bereits zuvor v2 (in Phase-1-Specs referenziert, nicht vollständig spezifiziert):
|
||||||
|
|
||||||
|
- **M11 WhatsApp**: Von M13 (Team-Chat) referenziert; vollständige Spec und Implementierung verschoben auf spätere Phase.
|
||||||
|
- **REQ-branding-tenant-phase2**: Tenant-Branding, White-Label und Custom-Domain (TenantBranding: logo, Farben, Custom-Domain) — Feature-Gate branding.white_label nur in Enterprise-Plan; verschoben auf Phase 2.
|
||||||
|
- **REQ-signatur-provider Fallback**: Einfacher PDF-Upload mit manueller Signatur-Erfassung bleibt Fallback; Standard ist self-hosted SES (AD-25), externe Provider nur BYOK/Opt-in.
|
||||||
|
- **DeepL-Übersetzungs-Pipeline (M30)**: Automatische Übersetzungsvorschläge via DeepL für Locale-Files — Phase 2.
|
||||||
|
- **KI/HiveMind/RAG/Whisper**: kein v1/v2-Scope nach AD-26; v2 liefert stattdessen `REQ-mcp-server`.
|
||||||
|
|
||||||
|
## Out of Scope
|
||||||
|
|
||||||
|
Explizit ausgeschlossen. Dokumentiert zur Vermeidung von Scope-Creep.
|
||||||
|
|
||||||
|
| Feature | Reason |
|
||||||
|
|---------|--------|
|
||||||
|
| Konkrete Pricing-Stufen | Billing-Engine wird gebaut, Preise geparkt (AD-15); Geerkens auf Sonderkondition/Trial |
|
||||||
|
| Volle Migrations-Pipelines pro Altsystem | Sauberer Start; KWP-Sync füllt nach; HubSpot/Quiply als Read-only-Archiv, nur punktuelle CSV-Importe (AD-14) |
|
||||||
|
| ~~EU-Email-Provider-Wahl (AD-6)~~ | ✅ **GELOCKT 2026-06-11: Mailjet** (Boilerplate-verdrahtet, `MAILJET_*`) — kein offener Punkt mehr |
|
||||||
|
| ~~Captcha/Bot-Schutz (AD-7)~~ | ✅ **GELOCKT 2026-06-11: mCaptcha self-hosted** (`infra/mcaptcha/` fertig vorbereitet) — kein offener Punkt mehr |
|
||||||
|
| KWP Windows-Sync-Programm M089 (alte M19-Variante) | Entfällt durch offizielle KWP-API; M089–M095 vor Umsetzung neu schneiden; KWP wird als DataConnection type='rest-api' in M33a abgebildet |
|
||||||
|
|
||||||
|
## Traceability
|
||||||
|
|
||||||
|
Phase-Mapping aus ROADMAP.md (Stufe 2, revidiert auf 21 Phasen). Bau-Reihenfolge nach AD-11; jede Zeile genau einer Phase zugeordnet (100 % Coverage).
|
||||||
|
|
||||||
|
| Requirement | Phase | Status |
|
||||||
|
|-------------|-------|--------|
|
||||||
|
| REQ-integration-sidebar | Phase 1 | Pending |
|
||||||
|
| REQ-integration-routes | Phase 1 | Pending |
|
||||||
|
| REQ-integration-activity-wiring | Phase 1 | Pending |
|
||||||
|
| REQ-integration-audit-wiring | Phase 1 | Pending |
|
||||||
|
| REQ-integration-notification-wiring | Phase 1 | Pending |
|
||||||
|
| REQ-integration-view-model-pflicht | Phase 1 | Pending |
|
||||||
|
| REQ-integration-smoke-tests | Phase 1 | Pending |
|
||||||
|
| REQ-auth-multi-tenancy | Phase 2 | Pending |
|
||||||
|
| REQ-auth-methoden | Phase 2 | Pending |
|
||||||
|
| REQ-auth-rbac | Phase 2 | Pending |
|
||||||
|
| REQ-auth-user-lifecycle | Phase 2 | Pending |
|
||||||
|
| REQ-audit-datenmodell | Phase 1 | Pending |
|
||||||
|
| REQ-audit-retention-export | Phase 3 | Pending |
|
||||||
|
| REQ-audit-permissions | Phase 3 | Pending |
|
||||||
|
| REQ-notification-datenmodell | Phase 1 | Pending |
|
||||||
|
| REQ-notification-versand-pipeline | Phase 3 | Pending |
|
||||||
|
| REQ-i18n-architektur | Phase 1 | Pending |
|
||||||
|
| REQ-i18n-outbound | Phase 3 | Pending |
|
||||||
|
| REQ-feature-flags-system | Phase 1 | Pending |
|
||||||
|
| REQ-files-datenmodell | Phase 4 | Pending |
|
||||||
|
| REQ-files-upload-preview | Phase 4 | Pending |
|
||||||
|
| REQ-tasks-datenmodell | Phase 4 | Done |
|
||||||
|
| REQ-tasks-reminder-archivierung | Phase 4 | Done |
|
||||||
|
| REQ-apps-engine-datenmodell | Phase 5 | Pending |
|
||||||
|
| REQ-apps-engine-lifecycle | Phase 5 | Pending |
|
||||||
|
| REQ-crm-datenmodell | Phase 6 | Pending |
|
||||||
|
| REQ-crm-listen-views | Phase 6 | Pending |
|
||||||
|
| REQ-crm-detail-views | Phase 6 | Pending |
|
||||||
|
| REQ-lead-projekt-konvertierung | Phase 6 | Pending |
|
||||||
|
| REQ-crm-activity-stream | Phase 6 | Pending |
|
||||||
|
| REQ-crm-custom-felder | Phase 6 | Pending |
|
||||||
|
| REQ-crm-duplikat-erkennung | Phase 6 | Pending |
|
||||||
|
| REQ-crm-tags | Phase 6 | Pending |
|
||||||
|
| REQ-crm-permissions | Phase 6 | Pending |
|
||||||
|
| REQ-lead-inbox-liste | Phase 7 | Pending |
|
||||||
|
| REQ-lead-quellen-auto-anlage | Phase 7 | Pending |
|
||||||
|
| REQ-lead-status-workflow | Phase 7 | Pending |
|
||||||
|
| REQ-lead-anti-spam | Phase 7 | Pending |
|
||||||
|
| REQ-lead-statistiken | Phase 7 | Pending |
|
||||||
|
| REQ-lead-permissions | Phase 7 | Pending |
|
||||||
|
| REQ-projekt-kern-datenmodell | Phase 8 | Pending |
|
||||||
|
| REQ-pipeline-rechte-config | Phase 8 | Pending |
|
||||||
|
| REQ-projekt-kanban-listen-view | Phase 8 | Pending |
|
||||||
|
| REQ-projekt-pipeline-wechsel | Phase 8 | Pending |
|
||||||
|
| REQ-projekt-forecast-kpis | Phase 8 | Pending |
|
||||||
|
| REQ-projekt-sub-areas | Phase 9 | Pending |
|
||||||
|
| REQ-rechnung-sub-entity | Phase 9 | Pending |
|
||||||
|
| REQ-projekt-abnahme | Phase 9 | Pending |
|
||||||
|
| REQ-suche-datenmodell | Phase 11 | Pending |
|
||||||
|
| REQ-suche-hybrid | Phase 11 | Pending |
|
||||||
|
| REQ-suche-ui | Phase 11 | Pending |
|
||||||
|
| REQ-dashboard-datenmodell | Phase 11 | Pending |
|
||||||
|
| REQ-dashboard-widgets | Phase 11 | Pending |
|
||||||
|
| REQ-automation-datenmodell | Phase 12 | Pending |
|
||||||
|
| REQ-automation-trigger-library | Phase 12 | Pending |
|
||||||
|
| REQ-automation-action-library | Phase 12 | Pending |
|
||||||
|
| REQ-automation-flow-editor | Phase 12 | Pending |
|
||||||
|
| REQ-automation-schutz | Phase 12 | Pending |
|
||||||
|
| ~~REQ-ki-llm-gateway~~ → entfernt ([[AD-26]]) | ~~Phase 13~~ | Entfällt (KI→MCP) |
|
||||||
|
| REQ-mcp-server *(neu, [[AD-26]])* | v2-P4 (MCP) / [[VR-MCP]] | Pending |
|
||||||
|
| REQ-email-datenmodell | Phase 14 | Pending |
|
||||||
|
| REQ-marketing-datenmodell | Phase 14 | Pending |
|
||||||
|
| REQ-marketing-double-optin | Phase 14 | Pending |
|
||||||
|
| REQ-marketing-versand | Phase 14 | Pending |
|
||||||
|
| REQ-telefonie-datenmodell | Phase 15 | Pending |
|
||||||
|
| REQ-telefonie-provider-adapter | Phase 15 | Pending |
|
||||||
|
| REQ-chat-datenmodell | Phase 15 | Pending |
|
||||||
|
| REQ-chat-realtime | Phase 15 | Pending |
|
||||||
|
| REQ-chat-features | Phase 15 | Pending |
|
||||||
|
| REQ-kalender-datenmodell | Phase 16 | Pending |
|
||||||
|
| REQ-kalender-sync-adapter | Phase 16 | Pending |
|
||||||
|
| REQ-booking-datenmodell | Phase 16 | Pending |
|
||||||
|
| REQ-booking-slot-kalkulierung | Phase 16 | Pending |
|
||||||
|
| REQ-booking-integrationen | Phase 16 | Pending |
|
||||||
|
| REQ-form-datenmodell | Phase 16 | Pending |
|
||||||
|
| REQ-form-editor | Phase 16 | Pending |
|
||||||
|
| REQ-form-actions | Phase 16 | Pending |
|
||||||
|
| REQ-signatur-datenmodell | Phase 16 | Pending |
|
||||||
|
| REQ-signatur-provider | Phase 16 | Pending |
|
||||||
|
| REQ-hr-datenmodell | Phase 17 | Pending |
|
||||||
|
| REQ-hr-passwort-safe | Phase 17 | Pending |
|
||||||
|
| REQ-hr-urlaub-krank | Phase 17 | Pending |
|
||||||
|
| REQ-plattform-admin-identität | Phase 19 | Pending |
|
||||||
|
| REQ-plattform-admin-features | Phase 19 | Pending |
|
||||||
|
| REQ-billing-datenmodell | Phase 20 | Pending |
|
||||||
|
| REQ-billing-trial-dunning | Phase 20 | Pending |
|
||||||
|
| REQ-onboarding-demo-daten | Phase 20 | Pending |
|
||||||
|
| REQ-branding-theme-phase1 | Phase 20 | Pending |
|
||||||
|
| REQ-dsgvo-export | Phase 21 | Pending |
|
||||||
|
| REQ-dsgvo-tenant-deletion | Phase 21 | Pending |
|
||||||
|
| REQ-feedback-widget | Phase 21 | Pending |
|
||||||
|
|
||||||
|
**Coverage:**
|
||||||
|
- v1 requirements: 89 ausführbare v1-Requirements (Scope-Schnitte 2026-06-11/12: 19 → v2; **Pivot-Neuzählung 16.06.: REQ-crm-lead-promotion entfällt −1, REQ-rechnung-sub-entity NEU +1; AD-26 entfernt den v1-KI-Layer**)
|
||||||
|
- v2 adds: `REQ-mcp-server` in v2-P4 / Phase 25 (ersetzt den alten KI-Tiefe-Scope)
|
||||||
|
- Mapped to phases: 89 v1 + 1 v2-MCP (100 %)
|
||||||
|
- Unmapped: 0
|
||||||
|
|
||||||
|
**Pro-Phase-Verteilung:**
|
||||||
|
|
||||||
|
| Phase | Requirements |
|
||||||
|
|-------|--------------|
|
||||||
|
| Phase 1 — Fundament & Walking-Skeleton | 11 |
|
||||||
|
| Phase 2 — Identität & Mandantentrennung | 4 |
|
||||||
|
| Phase 3 — Querschnitts-Oberflächen | 4 |
|
||||||
|
| Phase 4 — Files & Tasks | 4 |
|
||||||
|
| Phase 5 — Apps-Engine & Integrations-Framework | 2 |
|
||||||
|
| Phase 6 — CRM-Kern | 9 |
|
||||||
|
| Phase 7 — Lead-Inbox | 6 |
|
||||||
|
| Phase 8 — Projekt & Pipelines (Teil 1: Kern + Pipeline-Engine) | 5 |
|
||||||
|
| Phase 9 — Projekt & Pipelines (Teil 2: Auftrags-Features + Sub-Areas) | 3 |
|
||||||
|
| Phase 10 — KWP-Integration | 0 (→ v2, erstes v2-Modul) |
|
||||||
|
| Phase 11 — Globale Suche & Dashboard | 5 |
|
||||||
|
| Phase 12 — Automation-Engine | 5 |
|
||||||
|
| Phase 13 — KI-Layer | 0 (entfällt nach AD-26; `REQ-mcp-server` liegt in v2-P4) |
|
||||||
|
| Phase 14 — Email & Marketing | 4 |
|
||||||
|
| Phase 15 — Telefonie & Team-Chat | 5 |
|
||||||
|
| Phase 16 — Kalender, Booking, Forms & Signatur | 10 |
|
||||||
|
| Phase 17 — HR-Hub | 3 |
|
||||||
|
| Phase 18 — Customer-Portal | 0 (→ v2) |
|
||||||
|
| Phase 19 — Plattform-Admin | 2 |
|
||||||
|
| Phase 20 — Billing, Onboarding & Branding | 4 |
|
||||||
|
| Phase 21 — DSGVO & Launch-Reife | 3 |
|
||||||
|
| **Summe** | **89 v1 + 1 v2-MCP** |
|
||||||
|
|
||||||
|
---
|
||||||
|
*Requirements definiert: 2026-06-07 via /gsd:ingest-docs (Stufe 1). Phase-Mapping ergänzt: 2026-06-07 via /gsd:new-project (Stufe 2 — ROADMAP). Re-Mapping auf 21 Phasen: 2026-06-07 (Roadmap-Revision — dicke Buckets aufgeteilt). Scope-Schnitte 2026-06-11/12 (#1–#12): 19 REQs → v2, Dünnungs-Notes an 13 REQs, AD-6/7-Lock nachgetragen. **R-REFIT 2026-06-16 (Pivot AD-20): Module 1–4 projekt-zentrisch nachgezogen; REQ-crm-lead-promotion → REQ-lead-projekt-konvertierung; Sales/Projekt-Reqs zu „Projekt & Pipelines" konsolidiert (REQ-projekt-kern-datenmodell, REQ-pipeline-rechte-config u.a.); REQ-rechnung-sub-entity NEU. AD-26: v1-KI-Layer entfernt, `REQ-mcp-server` als v2-P4 aufgenommen.** *
|
||||||
Binary file not shown.
@@ -0,0 +1,244 @@
|
|||||||
|
# Roadmap: HiveGrid 2.0 — v2 (Mo 13.07. – Fr 31.07.2026)
|
||||||
|
|
||||||
|
> **Status:** Entwurf 2026-06-15 (aus Modul-Specs destilliert). Ergänzt die v1-ROADMAP (Phasen 1–21). v2 = 43 committed-deferred Milestones, nach v1-Launch (10.07.) sequenziert — kein Vielleicht-Backlog.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
v2 bringt die eigentlichen USP-/Revenue-Hebel, die in v1 bewusst geschnitten wurden: **KWP-Sync** (das Haupt-Verkaufsargument), **Self-Service-Abo**, **Postfach-Sync**, **Customer-Portal**, **Mobile-PWA-Ausbau**, **MCP-Server** und **Public-API**. v1 hat die tragfähige Kette + alle **Andockpunkte** geliefert; v2 dockt rückwirkend an (Dependency-Inversion bleibt das Prinzip).
|
||||||
|
|
||||||
|
**Bau-Strategie:** Wie v1 zwei dependency-frei parallele Tracks (Raffael + Akeshan), Designer (David) 1–2 Phasen voraus. v2-Sprint in 3 Wochen: **v2-W1** 13.–19.07. · **v2-W2** 20.–26.07. · **v2-W3** 27.–31.07.
|
||||||
|
|
||||||
|
**Die kritische geteilte Vorbedingung:** Das **M33a-Apps-Engine-Adapter-Interface** (v1-P5, M008–M010) trägt KWP (v2-P5), die HR-Drittanbieter (v2-P10) und das Provider-Pattern für Postfach/Telefonie. Wenn das in v1 sauber steht, docken die v2-Integrationen ohne Kern-Umbau an.
|
||||||
|
|
||||||
|
### ⚠️ Zwei Gaps (vor Bau zu schließen)
|
||||||
|
- **HalloPetra (M105):** kommt in **keiner Spec** vor. M12 ist eine reine AirCall-Spec. HalloPetra wäre ein **zweiter Telefonie-Provider** über das vorhandene `TelephonyProviderInterface` — mechanisch klar, inhaltlich unspezifiziert. → eigene Vorlauf-Spec (API-Vertrag) nötig.
|
||||||
|
- **Memberspot/Boobora (M138):** kommt in **keiner Spec** vor. M14 nennt nur generische „HR-Onboarding + externe Systeme via Apps-Engine". → eigene Drittanbieter-Spec nötig.
|
||||||
|
|
||||||
|
### Wiederkehrendes Risiko: „Partner-API-Vertrag offen"
|
||||||
|
**KWP (P5), HalloPetra (P11), HR-Drittanbieter (P10)** hängen alle am selben Muster — externer Adapter über M33a — und sind alle durch einen noch ausstehenden Partner-API-Vertrag blockiert. KWP-Zugang ~20.07. ist der härteste Kalender-Anker.
|
||||||
|
|
||||||
|
### Hinweis: „phase:1"-Specs nur teilweise v2
|
||||||
|
M15 (Portal), M37/M32 (Admin), M38/M39 (Help), M20/M22/M30 (Querschnitt) sind in den Specs als `phase:1` markiert. **Das Fundament gehört laut Spec in v1** (großteils erledigt/gedünnt) — nur das **Komfort-/Tiefen-Delta** ist echtes v2. Die Phasen unten beschreiben das Delta.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phasen-Übersicht
|
||||||
|
|
||||||
|
| v2-Phase | Titel | MS | Owner | Slot | UI |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| v2-P1 | Public-API & Webhooks | M161-163, M027 | Raffael | W1 | yes |
|
||||||
|
| v2-P2 | Postfach-Sync (Email-Inbox) | M096-098 | Akeshan | W1 | yes |
|
||||||
|
| v2-P3 | Self-Service-Billing & Onboarding-Wizard | M157 (+M28-SB-Delta) | Akeshan | W1→W2 | yes |
|
||||||
|
| v2-P4 | **MCP-Server** *(ex „KI-Tiefe — HiveMind/RAG", [[AD-26]])* | [[VR-MCP]]/[[VD-MCP]] (kein M0xx) | Raffael | W1→W2 | yes |
|
||||||
|
| v2-P5 | KWP-Integration *(ex-P10, RECUT)* | M089-095, M074 | Raffael | W2 | yes |
|
||||||
|
| v2-P6 | Customer-Portal *(ex-P18)* | M141-146 | Akeshan | W2 | yes |
|
||||||
|
| v2-P7 | Mobile-PWA-Ausbau | M167-171 | Akeshan | W2→W3 | yes |
|
||||||
|
| v2-P8 | Plattform-Admin-Tiefe | M038/039/033/040 | Raffael+Akeshan | W3 | yes |
|
||||||
|
| v2-P9 | Help-Center & Help-Desk | M172-175 | Akeshan | W3 | yes |
|
||||||
|
| v2-P10 | Komfort & Querschnitt | M149/150/117/029/138 | Akeshan | W3 | yes |
|
||||||
|
| v2-P11 | Telefonie-Erweiterung & DSGVO-Vollausbau | M105, M166 | Raffael | W3 | yes |
|
||||||
|
|
||||||
|
**Execution-Order:** v2-P1/P2 (W1) → v2-P3/P4 (W1→W2) → v2-P5/P6 (W2) → v2-P7 (W2→W3) → v2-P8/P9/P10/P11 (W3). Tracks parallel: Raffael P1→P4→P5→P8→P11 · Akeshan P2→P3→P6→P7→P9→P10.
|
||||||
|
|
||||||
|
### Nummern-Mapping: v2-Px ↔ ROADMAP-Phase 22–34 ↔ ex-Pn (C-2)
|
||||||
|
|
||||||
|
> Drei Nummernkreise zeigen auf dieselben Phasen: diese Datei (`v2-Px`), die v1-`ROADMAP.md` (fortlaufend `Phase 22–34`, die **Plane-Tickets nutzen 22–34**) und die alte v1-Roadmap-Nummern (`ex-Pn`, soweit ein v1-Platzhalter existierte). **Insb. KWP = v2-P5 = Phase 32 = ex-P10.**
|
||||||
|
|
||||||
|
| v2-Px (diese Datei) | ROADMAP.md Phase | ex-Pn | Titel |
|
||||||
|
|---|---|---|---|
|
||||||
|
| v2-P1 | Phase 22 | — | Public-API & Webhooks |
|
||||||
|
| v2-P2 | Phase 23 | — | Postfach-Sync (Email-Inbox) |
|
||||||
|
| v2-P3 | Phase 24 | — | Self-Service-Billing & Onboarding-Wizard |
|
||||||
|
| v2-P4 | Phase 25 | — | MCP-Server |
|
||||||
|
| **v2-P5** | **Phase 32** | **ex-P10** | **KWP-Integration (RECUT)** |
|
||||||
|
| v2-P6 | Phase 26 | ex-P18 | Customer-Portal |
|
||||||
|
| v2-P7 | Phase 27 | — | Mobile-PWA-Ausbau |
|
||||||
|
| v2-P8 | Phase 28 | — | Plattform-Admin-Tiefe |
|
||||||
|
| v2-P9 | Phase 29 | — | Help-Center & Help-Desk |
|
||||||
|
| v2-P10 | Phase 30 (+ Phase 34 HR-Drittanbieter, M138) | — | Komfort & Querschnitt / Dashboard-Deluxe |
|
||||||
|
| v2-P11 | Phase 31 (DSGVO) + Phase 33 (HalloPetra, M105) | — | Telefonie-Erweiterung & DSGVO-Vollausbau |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase Details
|
||||||
|
|
||||||
|
### v2-P1: Public-API & Webhooks
|
||||||
|
**Owner:** Raffael · **Slot:** W1 (13.–17.07.) · **Goal:** Externe Systeme lesen HiveGrid-Hauptentitäten per versionierter REST-API und empfangen/senden Events über signierte Webhooks.
|
||||||
|
**Milestones:** M161 (OpenAPI + Read-Endpoints), M162 (API-Key-Auth + Scopes + Rate-Limit), M163 (Webhooks signiert), M027 (API-Keys + Tarif-Gates)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M34-public-api.md`
|
||||||
|
**Depends on:** v1-`ApiKey`-Modell (M027-Vorbereitung lag in v1 ungenutzt bereit) · Redis (Token-Bucket) · v1-Frozen/past_due-Middleware (Writes 402) · RLS via `app.tenant_id` · v1-P12 Automation (`external_event`-Trigger + ausgehende Webhook-Action)
|
||||||
|
**Host-Contract:** Public API nur `https://api.hivegrid.de/v1/...` (staging: `https://staging-api.hivegrid.de/v1/...`);
|
||||||
|
keine Public-API-Routen unter `app.hivegrid.de/api`.
|
||||||
|
**Success Criteria:**
|
||||||
|
1. GET contacts/companies/deals/projects/tasks/leads — cursor-paginiert, Filter/Sort/Sparse-Fieldsets/Embed (Tiefe 1); `read_only`-Scope lässt sensible Felder aus (nicht 403).
|
||||||
|
2. Eingehende Lead-Webhooks (`POST https://api.hivegrid.de/v1/webhooks/incoming/{tenant}/{slug}`) legen Leads an (API-Key/HMAC/URL-Token + Payload-Mapping + Auto-Match).
|
||||||
|
3. Ausgehende WebhookSubscriptions: HMAC-SHA256-Signatur, Idempotenz-ID, Retry mit exp. Backoff (max 5), Auto-Disable nach 10 Fehlern.
|
||||||
|
4. OpenAPI-3.1 auto-generiert (`https://api.hivegrid.de/v1/openapi.json`) + Swagger-UI; Rate-Limit (1k/h Key, 10k/h Tenant) mit `X-RateLimit-*` + Klartext-429.
|
||||||
|
**Screens (David):** API-Key-Verwaltung (Erweiterung) · Incoming-Webhook-Slug-Verwaltung + Ingestion-Log · Outgoing-Subscription-Liste/Detail (Secret-einmal-sichtbar, Delivery-Stats, Replay/Test) · API-Request-Logs + Usage-Aggregat
|
||||||
|
**Recut/Risiko:** Bewusst **Read-only + Webhooks** (Voll-CRUD/GraphQL/3-Legged-OAuth = später). Vor Bau: OpenAPI-Tooling wählen, HMAC-Format dokumentieren.
|
||||||
|
|
||||||
|
### v2-P2: Postfach-Sync (Email-Inbox)
|
||||||
|
**Owner:** Akeshan · **Slot:** W1 (13.–17.07.) · **Goal:** Gmail/Outlook-Postfächer werden bidirektional ins CRM gespiegelt, auto-gematcht und im Activity-Stream sichtbar.
|
||||||
|
**Milestones:** M096 (Gmail-OAuth via Apps-Engine), M097 (Sync + Inbox-UI + Threading + Auto-Verknüpfung), M098 (Versand + Vorlagen)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M09-email-inbox.md` (OAuth-Sync/Inbox/Threading-Teile)
|
||||||
|
**Depends on:** v1-Sende-Domain DKIM/SPF/DMARC (P14, NICHT neu bauen) · `EmailProviderInterface` (Apps-Engine-Pattern) · v1-Activity-Stream + Contact/Project-FKs (Matching) · Webhook-Ingest-Infra (geteilt mit P1) · v1-Files (Anhänge) · Token-Encryption (DEK)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. OAuth-Connect Gmail (Pub/Sub-Watch) + Microsoft (Graph-Subscription, 3-Tage-Renewal-Worker); Token-Refresh + Revoke.
|
||||||
|
2. Push-Sync (kein Primär-Polling) spiegelt Mails; Initial-Sync 90 Tage, resumebar mit Progress.
|
||||||
|
3. Auto-Match: From-Adresse → Contact/Lead, Subject-Pattern (`[Projekt #123]`), 1-offenes-Projekt-Heuristik; manueller Override sticht.
|
||||||
|
4. Inbox-Liste (Filter/Suche/Bulk) + Detail mit Thread, sicherem HTML-Render (CSP, externe Bilder blockiert), Reply/Forward via Mailbox.
|
||||||
|
5. `email.read_own` vs. `email.read_all` filtern Liste + Activity-Stream.
|
||||||
|
**Screens (David):** Mailbox-Connect-Settings (Sync-Status/Reconnect) · Inbox-Liste · Mail-Detail (Thread/Verknüpfungs-Editor/Reply) · Outbound-Compose
|
||||||
|
**Recut/Risiko:** ⚠️ **Gmail restricted scopes** (`gmail.modify/send`) → Google-Verifizierung + ggf. CASA-Assessment (Wochen Vorlauf, Antrag lief in v1 EXT-13). **Microsoft-Graph-Subscription** läuft ~3 Tage → Renewal-Worker kritisch. Versand über User-Mailbox (Provider-Quotas).
|
||||||
|
|
||||||
|
### v2-P3: Self-Service-Billing & Onboarding-Wizard
|
||||||
|
**Owner:** Akeshan · **Slot:** W1→W2 (Abo-UI 13.–17., Wizard 18./19.) · **Goal:** Tenants buchen/wechseln Pläne self-service über Web-Checkout und durchlaufen einen branchen-getriebenen Onboarding-Wizard.
|
||||||
|
**Milestones:** M157 (Wizard-Framework + State-Machine) + M28-Self-Service-Delta (In-App-Subscription, Block P)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M28-subscriptions-billing.md` (Block P), `M29-onboarding.md`
|
||||||
|
**Depends on:** v1-Payment-Checkout + Webhook-Handler + Legacy-ProviderWebhookLog · v1-`SubscriptionFeature`/`ProductFeature` (Feature-Gate-Modell) · v1-Read-Only-Middleware · v1-TenantUserInvitation · **deklaratives Branchen-Template-Verzeichnis** (geteilt mit P6/P10) · ~~v2-P4 (KI-Walkthrough-Coach)~~ → KI-Coach entfällt ([[AD-26]]: kein eigenes LLM; v2-P4 = MCP-Server)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Self-Service-Trial ohne Vertriebs-Freigabe (`requires_manual_activation=false`) mit Zahlungsmethoden-Pflicht.
|
||||||
|
2. Plan-Wechsel/Add-On-Käufe laufen über den Web-Checkout-Flow (PWA-only → kein App-Store, keine Store-Billing-Auflage).
|
||||||
|
3. Onboarding-Wizard resumebar nach Signup, Step-Validierung, Block der Rückwärts-Navigation nach irreversiblen Actions.
|
||||||
|
4. SHK-Branchen-Template (Pipelines/Rollen/Custom-Felder/Forms/Demo/Checkliste) deklarativ aus YAML geseedet; weitere Branchen „coming soon".
|
||||||
|
5. Erste-Schritte-Checkliste (Detection-Rules) + Demo-Daten-Bulk-Löschung.
|
||||||
|
**Screens (David):** Onboarding-Wizard (10 Steps, Vollbild) · Erste-Schritte-Checkliste-Widget + Detail · Demo-Daten-Verwaltung · Self-Service-Plan-Wechsel-Flow (Web) · Add-On-Kauf-Flächen
|
||||||
|
**Recut/Risiko:** Self-Service ist v2, weil **konkrete Preise feststehen müssen** (in v1 EXT-14 fixiert) und das Wizard-/Abo-Baukasten-Delta Komplexität trägt — **nicht** mehr wegen Apple-Store-Auflagen (PWA-only → kein App-Store, Plan-Wechsel direkt im Web). Wizard-Framework ist großteils v1-fähig; v2-Delta = weitere Branchen + ~~KI-Coach~~ (entfällt — [[AD-26]]) + Migration-Importer.
|
||||||
|
|
||||||
|
### v2-P4: MCP-Server *(ex „KI-Tiefe — HiveMind/RAG", umgeschnitten via [[AD-26]])*
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]):** HiveGrid hostet kein eigenes LLM/RAG/Whisper mehr. Diese Phase liefert stattdessen einen **Remote-MCP-Server**, über den externe KI-Clients (Claude, ChatGPT-Connectors u.a.) HiveGrid-Daten lesen und freigegebene Aktionen ausführen. Verbindliche Bau-Spec: [[VR-MCP]] (Backend) / [[VD-MCP]] (Screens). Die alten HiveMind/RAG/Whisper-Inhalte stehen darunter durchgestrichen als **v3-Kandidat (zurückgestellt)**.
|
||||||
|
**Owner:** Raffael · **Slot:** W1→W2 (Start 18./19.07.) · **Goal:** Ein produktiver, tenant-gescopeter Remote-MCP-Server stellt HiveGrid-Daten als Read-Ressourcen und freigegebene Aktionen als Action-Tools bereit — auditiert, permission-gegated, ohne eigenes LLM.
|
||||||
|
**Milestones:** kein M0xx (v2-Neuschnitt) → siehe [[VR-MCP]]/[[VD-MCP]]
|
||||||
|
**Source-Specs:** [[VR-MCP]] / [[VD-MCP]] · [[AD-26]]
|
||||||
|
**Depends on:** v1-OAuth 2.1/PKCE für MCP + Scopes + Rate-Limit aus der Public-API-Grundlage ([[VR-P22]]) · v1-`withTenantScope()`/RLS · v1-`withPermission()` (M004) · v1-M001-Audit · `@modelcontextprotocol/sdk`
|
||||||
|
**Host-/Runtime-Contract:** MCP nur `https://mcp.hivegrid.de` (staging: `https://staging-mcp.hivegrid.de`)
|
||||||
|
als eigener Service/Container `hivegrid-mcp` (`apps/mcp`); kein `/mcp`-Pfad, nicht in `app.hivegrid.de` oder `api.hivegrid.de`.
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Remote-MCP-Server (Streamable HTTP, `@modelcontextprotocol/sdk`) exponiert Read-Ressourcen (Kontakte/Firmen/Leads/Projekte/Aufträge u.a.) und Action-Tools (definierte Schreib-Aktionen).
|
||||||
|
2. Authentifizierung per **OAuth 2.1 + PKCE + Scopes + Rate-Limit**; Tenant wird aus dem Access Token abgeleitet,
|
||||||
|
jeder Zugriff läuft durch `withTenantScope()`/RLS. API-Key bleibt nur Fallback/Operator-Modus.
|
||||||
|
3. Jede Action ist `withPermission()`-gegated, verlangt bei schreibenden Operationen eine **Confirmation** und wird via M001-Audit protokolliert (Actor-Kind „MCP/Agent").
|
||||||
|
4. Tenant-Admin verwaltet MCP-Verbindungen/Scopes (UI aus [[VD-MCP]]); OAuth-Clients/Tokens/Grants sind getrennt
|
||||||
|
nachvollziehbar, keine neuen KI-Entitäten.
|
||||||
|
**Screens (David):** siehe [[VD-MCP]] (MCP-Connection-Verwaltung, Scope-Auswahl, Audit-/Aktivitäts-Sicht der MCP-Zugriffe).
|
||||||
|
**Recut/Risiko:** Kein LLM-Hosting → **kein Provider-AVV** und kein DSGVO-Provider-Constraint mehr; Sicherheit liegt vollständig in Tenant-Scope/RLS, Scope-Minimierung und Confirmation-Grenze für Schreib-Aktionen.
|
||||||
|
|
||||||
|
~~**Owner:** Raffael · **Slot:** W1→W2 (Start 18./19.07.) · **Goal:** Aus dem v1-LLM-Gateway wird semantische Tiefe — RAG über Tenant-Daten, EU-Whisper, perspektivisch der autonome HiveMind-Agent.~~ *(v3-Kandidat, zurückgestellt — [[AD-26]])*
|
||||||
|
~~**Milestones:** M087 (RAG-Layer + Aktions-Grenze) + Whisper-EU + pgvector-Hybrid-Suche + zweiter EU-Provider~~
|
||||||
|
~~**Source-Specs:** `_bmad-output/specs/M18-ki-layer.md` (RAG/HiveMind/Whisper-Teile)~~
|
||||||
|
~~**Depends on:** v1-LLM-Gateway (Multi-Provider-Abstraktion) · v1-`RetrievalProvider`-Interface + Outbox-Index-Events · v1-AiCredits/AiTokenUsage · v2-P9 Help-Center (RAG-Korpus) · v1-Activity-Stream/Custom-Felder/Forms (RAG-Quellen) · Promptfoo in CI~~
|
||||||
|
~~**Success Criteria:** Embedding-Pipeline → `TenantEmbedding` (pgvector, HNSW/IVFFlat) · RAG für Programm-Hilfe/Lead-Zusammenfassung/Hybrid-Suche (RRF) · Whisper-EU (Scaleway-GPU) async · HiveMind-Agent mit Action-Boundary · Multi-Provider-Failover (Mistral→Scaleway→AlephAlpha) + Promptfoo in CI.~~
|
||||||
|
~~**Screens (David):** KI-Chat/Assistent-Panel + History · HiveMind-Insight-Anzeige · Custom-Tool-Editor + Scheduled-Actions · AI-Usage-Dashboard · Whisper-Aufnahme/Transkription.~~
|
||||||
|
~~**Recut/Risiko:** DSGVO-Hard-Constraint (nur EU-Provider, AVV); HiveMind autonom erst nach Reifegrad-Gate; pgvector-Index- + Whisper-Modell-Wahl offen.~~
|
||||||
|
|
||||||
|
### v2-P5: KWP-Integration *(ex-P10 — RECUT auf REST/OAuth)*
|
||||||
|
**Owner:** Raffael · **Slot:** W2 (20.–26.07., E2E mit Geerkens Fr 24.07.) · **Goal:** KWP wird regulärer REST/OAuth-Adapter über die Apps-Engine — bidirektionaler Sync (Aufträge/Stammdaten/Belege/Plantafel/Dokumente) mit „KWP gewinnt"-Konfliktregel.
|
||||||
|
**Milestones:** M089 (API-Connector), M090 (Connection-Health), M091 (Push-Queue + Replay), M092 (Contract-Sentinel), M093 (Konflikt „KWP gewinnt"), M094 (Plantafel-Sync), M095 (Dokumenten-Archiv-Sync), M074 (Task-ERP-Sync)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M19-kwp-integration.md` + **`docs/milestones/M19-KWP-API-RECUT.md` (bindend)**
|
||||||
|
**Depends on:** **HART: v1-M33a Apps-Engine-Adapter-Interface (M008–M010)** · v1-Cloud-Outbox + Idempotency-Wrapper (M007) · v1-`@hivegrid/storage` + FileEntityLink · v1-Extension-Points an Auftrag/Abnahme/Material (P9) · v1-P12 Automation (`kwp.push_auftrag`-Action) · AVV/Subprozessoren (P11)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. KWP-API-Connector als erster konkreter Adapter hinterm M33a-Interface; Credentials per-Tenant-DEK-verschlüsselt in `DataConnection.config`.
|
||||||
|
2. Bidirektionaler Sync: Push (Won→Auftrag) via Outbox + Rate-Limited-Replay; Pull via Webhook (falls KWP-Support) oder Cron, idempotent über `AppSyncItem`.
|
||||||
|
3. Konflikt „KWP gewinnt" (LWW mit Audit-Restore) + Optimistic Locking HiveGrid-seitig.
|
||||||
|
4. API-Contract-Sentinel (zod-Validierung + Versions-Check) pausiert Sync bei Drift + alarmiert Plattform-Admin.
|
||||||
|
5. Plantafel-Sync + Dokumenten-Archiv-Sync (KWP-Doc → Storage) laufen über die API.
|
||||||
|
**Screens (David/Akeshan):** KWP-Setup-Wizard (OAuth/API-Key, Initial-Sync-Vorschau) · Connection-Health-View · Sync-Log + KwpErrorReport · Konflikt-Resolution (Diff + Restore) · Admin: KWP-Sync-Status pro Tenant + Contract-Diff + Sync-Freigabe
|
||||||
|
**Recut/Risiko:** ⚠️ **kwpsync.exe NICHT bauen** (3→2-Komponenten). **Größter Blocker: konkreter KWP-API-Vertrag offen** (Auth/Endpoints/Webhook-Support/Rate-Limits/Versionierung/Doc-API) — Zugang ~20.07. AVV-Neubewertung: Creds liegen jetzt verschlüsselt in der Cloud (Spec-Aussage „verlässt Kundennetz nie" gilt nicht mehr 1:1).
|
||||||
|
|
||||||
|
### v2-P6: Customer-Portal *(ex-P18)*
|
||||||
|
**Owner:** Akeshan · **Slot:** W2 (20.–22.07.) · **Goal:** Endkunden sehen über eine eigene Auth-Schicht ihre Projekte/Status/Dokumente, laden Dateien hoch, erhalten Auto-Status-Mails.
|
||||||
|
**Milestones:** M141 (Auth/Magic-Link), M142 (Projekt-Sicht + Status-Mails), M143 (Endkunden-Upload + Reklamation), M144 (Subunternehmer-Zugang), M145 (Skalierungs-Sicht/Service-Inbox), M146 (Lebensdauer + DSGVO + Konfig)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M15-customer-portal.md`
|
||||||
|
**Depends on:** v1-Auth-Pattern (parallel, NICHT geteilt) + Tenant-Lifecycle (`frozen`→read-only) · v1-Project-Stage-Trigger + Acceptance-PDF-Auto-Freigabe · **v1-Files/FileEntityLink** (Doc-Freigabe + Portal-Uploads, in P4 vorbereitet) · v1-Sende-Domain (Auto-Mails) · v1-Form-Builder (`portal_form`) · v1-Automation (`portal.*`) · v1-notify() · v1-DSGVO-Lösch-Workflow · v1-URL-Pfad `app.hivegrid.de/portal/<tenant>/…`
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Eigene `PortalUser`-Klasse strikt getrennt von TenantUser (eigene Cookies, Routes, keine Permission-Vermischung); Magic-Link primär.
|
||||||
|
2. Endkunde sieht nur eigene Projekte/konfigurierte Stages/freigegebene Dokumente; fehlender Zugang → 404 (keine Existenz-Offenlegung).
|
||||||
|
3. Upload (mobile-Kamera, Multi-File, Limits) → Files + Activity + PL-Notification.
|
||||||
|
4. Auto-Status-Mails bei `project.stage_changed` (Debounce, Bedingungen: sichtbare Stage/aktiver Access/Pref/nicht frozen).
|
||||||
|
5. Tenant-Admin konfiguriert Phasen-Sichtbarkeit/Doc-Auto-Freigabe/Templates; DSGVO-Lösch/Export für PortalUser.
|
||||||
|
**Screens (David — eigener Polish, extern sichtbar):** Endkunde: Login/Setup/Reset, Portal-Dashboard, Projekte-Liste, Project-Detail (Fortschritt/Docs/Upload/Reklamation), Settings · Tenant-Admin: Portal-Konfig, PortalUser-Verwaltung, Access-Matrix, Mail-Template-Editor
|
||||||
|
**Recut/Risiko:** Eigene Auth = eigenes Härtungs-Budget (Rate-Limits, Captcha, kein User-Enumeration, wasserdichte Cookie-Trennung). Spec ist als `phase:1 kritisch für Geerkens` markiert → **ggf. Vorzieh-Kandidat** (Scope-Schnitt AD-18 hat es bewusst v2 — bei Bedarf neu entscheiden). Ausgeklammert: Multi-Portal/Branding/Custom-Domain/PortalSubscription/PWA-Push.
|
||||||
|
|
||||||
|
### v2-P7: Mobile-PWA-Ausbau
|
||||||
|
**Owner:** Akeshan · **Slot:** W2→W3 (23.–27.07.) · **Goal:** Die mobile-first-PWA aus v1 wird zur vollwertigen installierbaren App — Add-to-Homescreen, Service-Worker-Offline-Härtung, Web-Push, Baustellen-tauglich. **Kein nativer Client, kein App-Store** (AD-17, PWA-only).
|
||||||
|
**Milestones:** M167 (PWA-Manifest + Installierbarkeit), M168 (Web-Features: Web-Push/Kamera/Foto), M169 (mobile Navigation + Routes), M170 (Service-Worker-Offline-Modus), M171 (Force-Update + PWA-Härtung) — auf PWA umzuschneiden
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M36-mobile-app.md` (⚠ Recut → PWA-only; Capacitor/Expo verworfen)
|
||||||
|
**Depends on:** **v1-OfflineSyncQueue (P9) + serverseitige Idempotency-Keys** · v1-notify()/NotificationDevice (→ Web-Push/VAPID, P21-Andockpunkt) · v1-Auth (Email/Pwd + Magic-Link + offline Permissions-Snapshot) · v1-Files (Foto), Abnahme/Tasks/Chat offline · mobile-first responsive Web (Voraussetzung)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Offline-Pflicht: Pre-Cache beim Login (Projekte/Tasks/Kontakte/Checklisten/Acceptance-Templates) über Service-Worker + IndexedDB, Offline-Read + Offline-Write-Queue (Foto/Note/Task-Status/Checklist/Acceptance/Chat).
|
||||||
|
2. Sync-on-Reconnect drainiert Queue idempotent (lokale UUID als Key), Append-only konfliktfrei, Status-Updates LWW mit Konflikt-Resolution.
|
||||||
|
3. Installierbar: Web-App-Manifest + Add-to-Homescreen + Standalone-Display; Web-Push (VAPID); Kamera/Foto via Web-APIs (lokaler Resize); 2FA bleibt.
|
||||||
|
4. Account-Löschung erreichbar; Force-Update via Service-Worker-Versionierung; Deeplinks.
|
||||||
|
**Screens (David — mobile-first PWA-Shell, Touch-Paradigma):** Login + Setup · mobile Navigation (Baustelle/Büro) · Sync-Queue + Konflikt-Resolution · Mobile-Settings (Pre-Cache/Storage/Geräte) · Web-Push-Pre-Prompt + Force-Update-Modal · Install-Hinweis (A2HS)
|
||||||
|
**Recut/Risiko:** ⚠️ **PWA-only-Recut** der M36-Spec (kein EAS-Build, keine Native-Module, keine Store-Compliance). iOS-Safari-PWA-Grenzen (Web-Push iOS ≥16.4 nur im installierten Standalone-Modus), Offline-Storage-Budget, Background-Sync-Verfügbarkeit. **Kein** Apple/Google-Review-Risiko mehr. Native-App + Stores → frühestens v3.
|
||||||
|
|
||||||
|
### v2-P8: Plattform-Admin-Tiefe
|
||||||
|
**Owner:** Raffael + Akeshan · **Slot:** W3 (27.–29.07.) · **Goal:** Getrennte AdminUser-Identität/RBAC auf `admin.hivegrid.de` + Feature-Flag-Massen-Statistik (löst die v1-Auflagen-Brücke ab).
|
||||||
|
**Milestones:** M038 (Mandanten-MA-Verwaltung), M039 (AdminUser-Konten + Rollen), M033 (Flag-Massen-Statistik), M040 (interne Lead-Pipeline)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M37-plattform-admin.md` (Block A–D), `M32-feature-flags.md` (Massen-Statistik)
|
||||||
|
**Depends on:** v1-Auth-Bausteine (TOTP/Bcrypt/Session — wiederverwendet, eigene Tabellen) · v1-FeatureFlag-Modell + `tenantHasFlag()` (P8 ergänzt nur Massen-UI) · v1-AdminAuditLog · v1-Admin-Welt-Auflagen (M034 Host-Routing/Cookie-Trennung/TOTP — die v1-Brücke) · Read-Replica (Filter-Vorschau) · Redis (Dashboard-Cache)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Eigene `AdminUser`-Klasse, hart getrennt (eigene Cookies SameSite=Strict, kein Cross-Routing, **kein BYPASSRLS** — Admin liest Tenant-Daten via RLS mit gesetztem `app.tenant_id`).
|
||||||
|
2. AdminRBAC mit eigenen Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer), 2FA-Pflicht, 8h-Session, Self-Permission-Schutz.
|
||||||
|
3. AdminAuditLog cross-tenant mit Reason-Pflicht bei sensitiven Aktionen; Impersonate mit Reason + Banner.
|
||||||
|
4. Flag-Massen-Statistik: Effektiv-Auswertung (X aktiv/Y nicht), Live-Filter-Vorschau, Bulk-Override; deterministische Auswertung (Override > Filter > Default) + Audit.
|
||||||
|
**Screens (David — interner Polish):** AdminUser-Verwaltung + AdminRole-Editor + Admin-Security-Settings · Feature-Flag Effektiv-Statistik + Filter-Editor (Live-Match) + Bulk-Override · interne Lead-Pipeline (HiveGrid-eigene Verkäufe) · Cross-Tenant-Audit-View
|
||||||
|
**Recut/Risiko:** Kein BYPASSRLS = bewusste Hardgrenze. Impersonate-Cookie-Scope offen. M032 Tenant-Self-Service-Flags (`/labs/`) = spätere Phase.
|
||||||
|
|
||||||
|
### v2-P9: Help-Center & Help-Desk
|
||||||
|
**Owner:** Akeshan · **Slot:** W3 (28.–30.07.) · **Goal:** Öffentliches file-basiertes Help-Center mit Deep-Links aus der App + In-App-Feedback-Widget → Plattform-Admin.
|
||||||
|
**Milestones:** M172 (Markdown-Artikel Git-PRs), M173 (Routes + Suche + SEO + kontextuelle Hilfe), M174 (Email-Ticket-System), M175 (In-App-Feedback-Widget)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M38-help-center.md`, `M39-help-desk.md`
|
||||||
|
**Depends on:** Public-Routing außerhalb Auth-Middleware + IP-Rate-Limiting · v1-Files (Feedback-Attachments) · **v1-Feedback-Widget → Support-Inbox (P21-Andockpunkt, generische Quelle)** · v2-P8 AdminAuditLog + Admin-Permissions · v2-P4 MCP-Resources optional für Help-Artikel · v2-P10 i18n (Sprachsegment)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Markdown mit Frontmatter, Build-Time-Index (Volltext + Kategorien + Sitemap), Build-Fail bei kaputten Referenzen.
|
||||||
|
2. Öffentliche Routen `/help/{lang}/{category}/{slug}` ohne Auth (vor Auth-Middleware), SEO-Defaults, Suche.
|
||||||
|
3. Deep-Link Route→Artikel (Hilfe-Icon pro App-Route, Fallback Help-Home).
|
||||||
|
4. Feedback-Widget (überall) → `Feedback` mit Auto-Kontext (tenant/user/route/browser/app-version), Screenshot-Option, Rate-Limit 10/h.
|
||||||
|
5. Plattform-Admin: Feedback-Liste + Detail (Status-Lifecycle/Assignee/Notes/Attachments) mit Audit.
|
||||||
|
**Screens (David):** Help-Home (Hero/Suche/Kategorien) · Kategorie-Seite · Artikel-Detail (TOC/verwandt/Vote) · Such-Ergebnisse · Feedback-Modal (in v1 schon klein da → ausbauen) · Admin-Feedback-Liste/Detail
|
||||||
|
**Recut/Risiko:** Bewusst klein (Git-PRs, kein Editor-UI, kein volles Ticket-System in Phase 1). Später: DB-Pflege, MCP-Resource-Expose, Mehrsprachigkeit, kontextuelle Inline-Hilfe, SLA/CSAT/Live-Chat. Support-Mailbox-Sync (Mails→Feedback) nutzt M9.
|
||||||
|
|
||||||
|
### v2-P10: Komfort & Querschnitt
|
||||||
|
**Owner:** Akeshan · **Slot:** W3 (29.–31.07.) · **Goal:** Querschnitts-Komfort — anpassbare Dashboards/Export, Notification-Bündelung/Quiet-Hours, Sprach-Wechsler/EN, HR-Drittanbieter-Onboarding.
|
||||||
|
**Milestones:** M149 (Custom-Widgets + Drilldown), M150 (Dashboard-Export/Report), M117 (Notif-Bündelung + Quiet-Hours), M029 (Sprach-Wechsler + EN), M138 (HR-Onboarding-Drittanbieter)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M20-dashboard.md`, `M22-notifications.md`, `M30-i18n.md`, `M14-hr-hub.md`
|
||||||
|
**Depends on:** v1-Dashboard/Widget-Registry (P11, voll gebaut) + Role-Default-Layouts (deklaratives Template, geteilt mit P3) · v1-notify() (P10 ergänzt Bundle-Manager/Quiet-Hours-Resolver) · v1-i18n-Library + DE-Locale (P10 füllt EN + DeepL) · v1-M33a Apps-Engine (HR-Drittanbieter) · WebSocket (Chat-geteilt) · v1-Forms/Tasks (Onboarding-Checklisten)
|
||||||
|
**Success Criteria:**
|
||||||
|
1. Dashboard: User passt Layout an (Drag/Resize, Widget-Catalog permission-gegated), Drilldown pro Kachel, CSV-Export, Realtime mit Opt-Out.
|
||||||
|
2. Notifications: Bündelung (gleicher event_type_group in 5-Min-Window → 1 Push/Mail mit count), Quiet-Hours (queued, Urgent-Override), Pro-User-Präferenzen Event×Kanal.
|
||||||
|
3. i18n: Sprach-Wechsler (Profil + Public), EN-Locale befüllt (DeepL DE→EN mit Review), vollständige Build-Validierung, Fallback DE; Empfänger-Sprach-Auflösung Outbound.
|
||||||
|
4. HR: Onboarding-Checklisten pro neuem MA (Forms/Tasks/Reminders) + Drittanbieter via Apps-Engine.
|
||||||
|
**Screens (David):** Dashboard-Edit-Modus (Grid + Widget-Picker + Config) · Notification-Präferenzen-Editor + Quiet-Hours · Sprach-Wechsler + Tenant-Default · HR-Onboarding-Checklisten + Drittanbieter-Setup
|
||||||
|
**Recut/Risiko:** ⚠️ **Gap M138:** Memberspot/Boobora nicht spezifiziert → eigene Drittanbieter-Spec (gleiche „API-Vertrag offen"-Abhängigkeit wie KWP). M20/M22/M30 großteils v1-fähig — v2-Delta = Custom-Dashboards/Export, Bundle/Quiet-Hours, EN+DeepL. Chat-Auto-Übersetzung (M30) koppelt an M13 + EU-LLM (P4).
|
||||||
|
|
||||||
|
### v2-P11: Telefonie-Erweiterung & DSGVO-Vollausbau
|
||||||
|
**Owner:** Raffael · **Slot:** W3 (29.–31.07.) · **Goal:** Zweiten Telefonie-Provider anbinden + DSGVO vertiefen (AVV-Versionierung, Subprozessoren-Workflow, Auskunfts-/Export-Workflow ersetzt manuelles Playbook).
|
||||||
|
**Milestones:** M105 (HalloPetra-Adapter), M166 (AVV + Subprozessoren + Auskunfts-Workflow)
|
||||||
|
**Source-Specs:** `_bmad-output/specs/M12-telefonie.md` (Provider-Pattern), `M35-dsgvo-export.md`
|
||||||
|
**Depends on:** **v1-TelephonyProviderInterface + AirCall-Adapter (P15) als Referenz** · v1-Automation-Trigger (`call.*`) · v1-notify() · v1-Files (Export-ZIP, AVV-PDF) · BullMQ-Worker · v1-Account-Löschung (P2/P21) · v1-Frozen→Deletion (P20) · v2-P8 AdminAuditLog + Legal-Verwaltung
|
||||||
|
**Success Criteria:**
|
||||||
|
1. HalloPetra als zusätzlicher Provider hinterm `TelephonyProviderInterface` ohne Kern-Umbau; Webhook-Auto-Match → Activity + Automation-Trigger.
|
||||||
|
2. Click-to-Call + Inbound + Logging providerunabhängig (E.164-Normalisierung, Match-Confidence, Notiz-Editor).
|
||||||
|
3. AVV-Versionierung mit dynamischem PDF + elektronischer Akzeptanz, Re-Akzeptanz bei Updates (14-Tage-Frist → Read-Only).
|
||||||
|
4. Subprozessoren-Liste mit Drittland-Warnung + 14-Tage-Widerspruchs-Workflow.
|
||||||
|
5. User-Daten-Export (Art. 15/20) + Tenant-Voll-Export (ZIP, async, 7-Tage-Window) + Tenant-Lösch-Workflow (30-Tage-Grace + Hard-Delete-Cron).
|
||||||
|
**Screens (David):** Telefonie-Setup (Provider-Connect, User-Bindings, Test) · Call-Session-Detail · DSGVO/Privacy-Hub (Export-Jobs, Tenant-Lösch-Multi-Step + Slug-Confirm, Subprozessoren, AVV-Download/History) · User-Daten-Export/Account-Löschung · Admin: Subprozessoren + AVV-Versions-Verwaltung
|
||||||
|
**Recut/Risiko:** ⚠️ **Gap HalloPetra:** keine Spec — API-Vertrag (Auth/Webhook-Events/Recording/Call-Lifecycle) erst erheben (eigener Vorlauf-Task). AVV-PDF-Inhalt anwaltlich finalisieren (in v1 EXT-03 beauftragt). Voicemail-Transkription/Whisper ist nach AD-26 zurückgestellt.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Geteilte v2-Mechanismen (einmal robust bauen)
|
||||||
|
- **Deklaratives Branchen-Template-Seeding** — zieht durch P3 (Onboarding), P6 (PortalConfig), P10 (Dashboard-/Notification-Defaults).
|
||||||
|
- **M33a-Adapter-Pattern** — trägt P5 (KWP), P2 (Email-Provider), P10 (HR-Drittanbieter), P11 (Telefonie-Provider). Alle mit „Partner-API-Vertrag offen"-Risiko.
|
||||||
|
- **Webhook-Ingest-Infra** — geteilt P1 (Public-API) + P2 (Email).
|
||||||
|
|
||||||
|
## Offene Vorlauf-Tasks (Specs/Verträge, vor Bau)
|
||||||
|
1. **KWP-API-Vertrag** (Zugang ~20.07.) → Recut-Detailplanung pro Milestone.
|
||||||
|
2. **HalloPetra-Spec** (Telefonie-Provider-Vertrag) — neu.
|
||||||
|
3. **Memberspot/Boobora-Spec** (HR-Drittanbieter) — neu.
|
||||||
|
4. **Konkrete Preise/Plans** (für Self-Service P3) — in v1 EXT-14 fixiert.
|
||||||
|
5. **AVV-PDF-Inhalt** anwaltlich (P11) — in v1 EXT-03 beauftragt.
|
||||||
|
|
||||||
|
---
|
||||||
|
*Erzeugt: 2026-06-15 aus 18 v2-relevanten Modul-Specs (Teilmenge der 36 Specs gesamt, vgl. PHASE-SOURCES.md) + KWP-Recut-Doku. Coverage: 43/43 v2-Milestones gemappt. Nächste Schritte (User): → Tickets pro Phase (Plane), Assignee-Klärung, v2-Screen-Map, dann sauberer Update-Pass.*
|
||||||
@@ -0,0 +1,589 @@
|
|||||||
|
# Roadmap: HiveGrid 2.0
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
HiveGrid 2.0 entsteht in einem Big-Bang-Launch (AD-19): erst live, wenn das vollständige Phase-1-Produkt steht. Die interne Bau-Reihenfolge folgt der Hybrid-Strategie AD-11 — zuerst ein Walking-Skeleton-Fundament (Boilerplate einziehen, EU-Sterilisation, Integration-Contracts **plus die Service-Kerne Audit, Notifications, i18n und Feature-Flags** — sie sind Vorbedingung des gesamten Auth-Blocks), dann Identität/Multi-Tenancy, die Querschnitts-Oberflächen (Audit-Viewer, Notification-Center, Sprach-UX) und die nutzerseitigen Primitive (Files, Tasks), darauf die Apps-Engine, das CRM-Datenmodell und die durchgängige SHK-Wertschöpfungskette Lead → Sales → Auftrag (KWP-Sync = erstes v2-Modul — API-Zugang erst ~19.07., nach v1-Launch; Scope-Schnitt #12). Erst danach kommt die Breite: globale Suche/Dashboard, die USP-Säulen Automation-Engine und ~~KI-Layer~~ (AD-16) **[⛔ KI→MCP-Pivot ([[AD-26]]): Die KI-Hälfte der USP entfällt in v1 — HiveGrid hostet kein eigenes LLM/RAG, sondern wird MCP-Server ([[VR-MCP]]). Die Automation-Säule bleibt unverändert.]**, die Kommunikations-Bausteine (Email/Marketing, Telefonie/Chat, Kalender/Booking/Forms/Signatur), HR-Hub, Customer-Portal und schließlich die Plattform- und Launch-Schicht (Admin, Billing/Onboarding/Branding, Public-API/DSGVO/Mobile/Help). Jede Phase liefert eine eigenständig verifizierbare Fähigkeit; Coverage über alle 90 v1-Requirements ist lückenlos (Scope-Schnitte 11./12.06.2026: 19 Reqs → v2). Die Kommunikations-Phasen hängen primär an der Apps-Engine (Connections) und am CRM (Contact-Matching) — sie brauchen NICHT die Automation/KI-Säulen als Vorbedingung. **Dependency-Inversion-Prinzip:** Es existieren keine unaufgelösten Vorwärts-Abhängigkeiten — spätere Module integrieren sich rückwirkend in frühere Oberflächen (Ownership-Register + Extension-Point-Pflichten in `PHASE-SOURCES.md`); jeder plan-phase-Lauf MUSS die Retro-Integrations-Aufgaben seiner Phase aus dem Register mit einplanen.
|
||||||
|
|
||||||
|
> 🔴 **MODELL-PIVOT 2026-06-13 (Projekt-zentrisch, AD-20):** Das CRM/Pipeline-Modell wird umgebaut — ein `Projekt`-Kern, Pipelines = konfigurierbare Views; „Deal"/„Auftrag" = Pipeline-Typen, keine eigenen Entitäten; **Lead → Projekt**; Abnahme bleibt v1 als Checklisten-Sub-Area; Rechnung = Sub-Entity v1. Betrifft **P6–P9** (siehe Phasen-Notizen unten). Die Success-Criteria/Requirements von P6–P9 werden gemeinsam mit dem neuen ER-Modell neu gefasst. Single Source: `.planning/ENTITY-MODEL.md`.
|
||||||
|
|
||||||
|
## Phases
|
||||||
|
|
||||||
|
**Phase Numbering:**
|
||||||
|
- Integer phases (1, 2, 3): Planned milestone work
|
||||||
|
- Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED)
|
||||||
|
|
||||||
|
Decimal phases appear between their surrounding integers in numeric order.
|
||||||
|
|
||||||
|
- [ ] **Phase 1: Fundament & Walking-Skeleton** - Boilerplate einziehen, EU-Sterilisation, Querschnitts-Neubauten + Service-Kerne (Audit, Notifications, i18n, Feature-Flags), Integration-Contracts als Bau-Vertrag
|
||||||
|
- [ ] **Phase 2: Identität & Mandantentrennung** - Auth, Multi-Tenancy, RLS-Baseline, RBAC, Sessions (API-Keys → v2 mit Public-API)
|
||||||
|
- [ ] **Phase 3: Querschnitts-Oberflächen** - Audit-Viewer/Export, Notification-Center/Settings, Sprach-Settings DE-only (Service-Kerne liegen in Phase 1)
|
||||||
|
- [ ] **Phase 4: Files & Tasks** - Nutzerseitige Plattform-Primitive: Datei-Verwaltung (chunked Upload, Preview inkl. HEIC→JPG) und Tasks
|
||||||
|
- [ ] **Phase 5: Apps-Engine & Integrations-Framework** - DataConnection, Adapter-Registry, OAuth/API-Key-Connect-Lifecycle
|
||||||
|
- [ ] **Phase 6: CRM-Kern** - Typisiertes CRM-Datenmodell, Listen/Detail-Views, Custom-Felder, Tags, Activity-Stream, Duplikate
|
||||||
|
- [ ] **Phase 7: Lead-Inbox** - Lead-Triage-Arbeitsplatz, Multi-Quellen-Auto-Anlage, Anti-Spam, Statistiken
|
||||||
|
- [ ] **Phase 8: Projekt & Pipelines (Kern)** - konfigurierbare Pipelines (Deal/Auftrag = Views, AD-20), Kanban, Forecast/KPIs, Field-Level-Rechte (PipelineFieldVisibility)
|
||||||
|
- [ ] **Phase 9: Projekt & Pipelines (Auftrag)** - Auftrags-Sub-Areas, Rechnung-Sub-Entity, Plantafel, digitale Abnahme (offline-fähig)
|
||||||
|
- [ ] ~~**Phase 10: KWP-Integration**~~ — **→ v2, ERSTES v2-Modul** (deferred 2026-06-12; API-Zugang ~19.07. > Launch; Nummer reserviert, Ausführung überspringt P10)
|
||||||
|
- [ ] **Phase 11: Globale Suche & Dashboard** - Keyword-Suche (Meilisearch, AD-5 sequenziert), Cmd+K, Widget-Dashboard mit festen Rollen-Layouts
|
||||||
|
- [ ] **Phase 12: Automation-Engine** - Visueller Flow-Editor, Trigger/Action-Library, Guards, Dry-Run, 24h-Undo
|
||||||
|
- [ ] ~~**Phase 13: KI-Layer**~~ — **entfällt in v1 (AD-26)**; kein LLM/RAG/Whisper, kein Sprach-zu-Automation-Unterbau. MCP-Server ist v2-P4.
|
||||||
|
- [ ] **Phase 14: Email & Marketing** - Sende-Domain-Verifikation, BCC-Logging-Brücke, DSGVO-konforme Marketing-Kampagnen (Postfach-Sync → v2)
|
||||||
|
- [ ] **Phase 15: Telefonie & Team-Chat** - AirCall-Click-to-Call/Inbound, Real-Time-Team-Chat mit entity-linked Channels
|
||||||
|
- [ ] **Phase 16: Kalender, Booking, Forms & Signatur** - Kalender-Sync, öffentliche Buchungsseiten, Form-Builder, Angebots-Signatur
|
||||||
|
- [ ] **Phase 17: HR-Hub** - Verschlüsselter HR-Hub, Passwort-Safe, Urlaubs-/Krank-Workflow
|
||||||
|
- [ ] ~~**Phase 18: Customer-Portal**~~ — **→ v2** (deferred 2026-06-11; Nummer reserviert, Ausführung überspringt P18)
|
||||||
|
- [ ] **Phase 19: Plattform-Admin** - Getrennte Admin-Welt (admin.hivegrid.de), Tenant-Management + Abo-Zusammenstellung, Queue-Monitoring, Support-Inbox
|
||||||
|
- [ ] **Phase 20: Billing, Onboarding & Branding** - Legacy-Provider-Billing/Trial/Dunning (Abo-Baukasten-Recut), Auto-SHK-Provisionierung, Theme-Preference
|
||||||
|
- [ ] **Phase 21: DSGVO & Launch-Reife** - DSGVO-Export + Lösch-Workflow (Crypto-Shredding), Feedback-Widget, Launch-Checkliste
|
||||||
|
|
||||||
|
### v2-Phasen (Sprint Mo 13.07.–Fr 31.07., nach Launch — 43 Milestones, 2 Tracks dependency-frei parallel)
|
||||||
|
|
||||||
|
> 🟦 **v2 = committed-deferred (kein Vielleicht-Backlog).** Voll ausgearbeitete Detail-Fassung (Success-Criteria · Screens · v1-Andockpunkte · Recut/Risiko) je Phase: `.planning/ROADMAP-V2.md`. Bei den „phase:1"-Modulen (P26/P28/P29/P30) ist nur das **v2-Delta** gemeint, nicht das v1-Fundament.
|
||||||
|
|
||||||
|
**Block 1 — sofort baubar (alle Infos vorhanden):**
|
||||||
|
- [ ] **Phase 22: Public-API & Webhooks** - Versionierte Read-REST-API + signierte Webhooks + Tenant-API-Keys mit Scopes/Rate-Limit
|
||||||
|
- [ ] **Phase 23: Postfach-Sync (Email-Inbox)** - Bidirektionale Gmail/Outlook-Inbox mit CRM-Matching, Threading, Versand über User-Mailbox
|
||||||
|
- [ ] **Phase 24: Self-Service-Billing & Onboarding-Wizard** - Self-Service-Abo-Zusammenstellung (Web-Checkout) + geführter branchen-getriebener Wizard
|
||||||
|
- [ ] **Phase 25: MCP-Server** - Remote-MCP-Server für externe KI-Clients mit Read-Ressourcen und bestätigungspflichtigen Action-Tools (ersetzt HiveMind/RAG, AD-26)
|
||||||
|
- [ ] **Phase 26: Customer-Portal** ⭐ - Endkunden-Portal (eigene Auth/Magic-Link, Projekt-Sicht, Upload, Reklamation) — **kritisch** (ex-P18)
|
||||||
|
- [ ] **Phase 27: Mobile-PWA-Ausbau** - Installierbare PWA (Add-to-Homescreen, Service-Worker-Offline, Web-Push) für den Baustellen-Einsatz — kein nativer Client/App-Store (AD-17, PWA-only)
|
||||||
|
- [ ] **Phase 28: Plattform-Admin-Tiefe** - Getrennte AdminUser-Identität/AdminRBAC + Feature-Flag-Massen-Statistik + interne Lead-Pipeline
|
||||||
|
- [ ] **Phase 29: Help-Center & Help-Desk** - Öffentliches Help-Center (SEO, kontextuell) + Email-Ticket-Desk + Feedback-Ausbau
|
||||||
|
- [ ] **Phase 30: Dashboard-Deluxe & Querschnitt** - Custom-Widgets/Export + Notif-Bündelung/Quiet-Hours + EN-Locale (DeepL)
|
||||||
|
- [ ] **Phase 31: DSGVO-Vollausbau** - AVV-Versionierung + Subprozessoren-Workflow + Auskunfts-/Voll-Export-Workflow (ersetzt manuelles Playbook)
|
||||||
|
|
||||||
|
**Block 2 — Partner-API-Vertrag offen → ans Ende, agil vorziehbar, sobald Zugang/Spec da:**
|
||||||
|
- [ ] **Phase 32: KWP-Integration** *(Recut)* - Bidirektionaler Sync HiveGrid↔KWP über die offizielle REST-API (ex-P10; Zugang ~20.07.; kwpsync.exe NICHT bauen)
|
||||||
|
- [ ] **Phase 33: Telefonie-Erweiterung (HalloPetra)** - HalloPetra als zweiter Provider hinterm TelephonyProviderInterface (⚠ Spec offen)
|
||||||
|
- [ ] **Phase 34: HR-Drittanbieter-Onboarding** - Memberspot/Boobora via Apps-Engine (⚠ Spec offen)
|
||||||
|
|
||||||
|
## Phase Details
|
||||||
|
|
||||||
|
### Phase 1: Fundament & Walking-Skeleton
|
||||||
|
**Goal**: Das Repo ist eine lauffähige Codebasis, EU-steril, mit den Querschnitts-Neubauten, den Service-Kernen (Audit, Notifications, i18n, Feature-Flags) und den verbindlichen Integration-Contracts als Bau-Vertrag für alle Folgephasen.
|
||||||
|
**Depends on**: Nothing (first phase)
|
||||||
|
**Requirements**: REQ-integration-sidebar, REQ-integration-routes, REQ-integration-activity-wiring, REQ-integration-audit-wiring, REQ-integration-notification-wiring, REQ-integration-view-model-pflicht, REQ-integration-smoke-tests, REQ-audit-datenmodell, REQ-notification-datenmodell, REQ-i18n-architektur, REQ-feature-flags-system
|
||||||
|
**Source-Specs**: `docs/ARCHITECTURE-DECISIONS.md`, `docs/INTEGRATION-CONTRACTS.md`; Service-Kern-Teile aus `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md`, `M32-feature-flags.md`
|
||||||
|
**Milestone-PLANs**: 15 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 1)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Die HiveGrid-Codebase baut lokal durch; Workspace-Pakete, CLI, Env-Namen, Cookies, Header und Queue-Namen nutzen HiveGrid-Contracts ohne Alt-Aliase (AD-10). *Planner-Hinweis: historische Boilerplate-Reste sind Arbeitsmaterial und kein Upstream-Merge-Ziel.*
|
||||||
|
2. GitHub/Google-OAuth-Reste und `User.githubId/googleId` sind entfernt; keine US-Kern-Abhängigkeit mehr im Auth-Pfad (EU-Sterilisation).
|
||||||
|
3. `logActivity()`, Search-Registry, Subframe-Adapter und Mass-Action-Schutz existieren als aufrufbare Querschnittsdienste mit Smoke-Test.
|
||||||
|
4. Die Service-Kerne existieren als aufrufbare Dienste mit Smoke-Test: AuditEvent mit SHA-256-Hash-Kette via Prisma-Middleware (default-on), `notify()` mit Kanal-Abstraktion (In-App/Email; Push-Kanal als Stub bis v2), `packages/i18n` mit Build-Lint gegen Hard-Strings und Resolution User → Tenant → DE, Feature-Flag-Engine mit `tenantHasFlag()` + Redis-Cache (Admin-UI folgt in P19).
|
||||||
|
5. **Entitlement-Gate-Pflicht (Konnektor-Prinzip):** Das Gate-Muster `tenantHasModule('<modul>')` existiert mit Beispiel-Anwendung an der Walking-Skeleton-Route — jede Modul-Phase registriert damit ihren Feature-Konnektor (Sidebar/Routes/Actions plan-gebunden schaltbar). Vorlage: `archive/hivegrid-cloud/app/config/pricing-plans.ts`.
|
||||||
|
6. Eine Beispiel-Route gibt im Loader ein View-Model zurück, ist in der Sidebar registriert und hat einen grünen Smoke-Test gegen `packages/ui-mock`.
|
||||||
|
7. Die verbindlichen URL-Schemata (App, Admin, Portal, Forms, Booking, Help, API) sind als geprüfte Konvention dokumentiert.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 2: Identität & Mandantentrennung
|
||||||
|
**Goal**: Ein Handwerksbetrieb kann sich selbst registrieren, sicher anmelden und in einem vollständig RLS-isolierten Mandanten mit rollenbasierten Rechten arbeiten.
|
||||||
|
**Depends on**: Phase 1
|
||||||
|
**Requirements**: REQ-auth-multi-tenancy, REQ-auth-methoden, REQ-auth-rbac, REQ-auth-user-lifecycle
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M27-auth-multi-tenancy.md`
|
||||||
|
**Milestone-PLANs**: 9 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 2); Scope-Schnitt 12.06.: M027 (API-Keys) → v2 mit Public-API — Boilerplate-`ApiKey`-Modell bleibt ungenutzt im Code
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Nutzer kann sich per Self-Service registrieren, erhält einen auto-generierten Tenant-Slug (Reserved-Words geblockt) und landet unter app.hivegrid.de.
|
||||||
|
2. Login mit Email+Passwort (NIST/Breach-Check) plus TOTP-2FA funktioniert; Sessions sind in Postgres serverseitig (Geräte-Liste, Revoke, „von allen Geräten abmelden") mit Redis-Cache (AD-4).
|
||||||
|
3. RLS-Policies (USING/WITH CHECK, `SET LOCAL app.tenant_id`, App-Rolle ohne BYPASSRLS) verhindern nachweisbar mandantenübergreifenden Datenzugriff (AD-1).
|
||||||
|
4. 6 SHK-Standard-Rollen sind geseedet *(Staging/Dev; Produktion startet admin-only, AD-29)*; ein Admin kann Nutzer einladen (48h-Token), deaktivieren und DSGVO-konform per PII-Anonymisierung löschen.
|
||||||
|
5. *(→ v2, Scope-Schnitt 12.06.)* ~~Ein Nutzer kann API-Keys mit Scopes und Rate-Limit erstellen~~ — wandert mit der Public-API (M161–163) nach v2.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 3: Querschnitts-Oberflächen
|
||||||
|
**Goal**: Die Bedien-Oberflächen der in Phase 1 gebauten Plattformdienste stehen — Audit-Viewer mit Export, Notification-Center mit Nutzer-Einstellungen und die Sprach-Settings (v1 DE-only).
|
||||||
|
**Depends on**: Phase 2
|
||||||
|
**Requirements**: REQ-audit-retention-export, REQ-audit-permissions, REQ-notification-versand-pipeline, REQ-i18n-outbound
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M21-audit-log.md`, `_bmad-output/specs/M22-notifications.md`, `_bmad-output/specs/M30-i18n.md` (Oberflächen-Teile; Service-Kerne → Phase 1)
|
||||||
|
**Milestone-PLANs**: 5 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 3); Scope-Schnitt 12.06.: M029 (Sprach-Wechsler) + M117 (Bündelung/Quiet-Hours) → v2; M028/M152 gedünnt
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Nutzer mit Audit-Permission sieht den Audit-Viewer (gefiltert, permission-gegated); Export als NDJSON/CSV ins Object Storage (Hetzner-S3) funktioniert mit fixer Default-Retention. *(Scope-Schnitt 12.06.: konfigurierbare Retention-Policy/Legal-Hold/Saved-Views → v2; Boilerplate liefert Retention-Cron + PDF-Export.)*
|
||||||
|
2. Die Versand-Pipeline stellt Notifications über BullMQ in alle Kanäle zu (In-App via SSE, Email; Push-Stub bis v2) — sofort, ohne Bündelung; ein Nutzer sieht das Notification-Center und schaltet Kategorien pro Kanal an/aus. *(Scope-Schnitt 12.06.: Quiet-Hours/Bündelung/Push-Limits = M117 → v2, bewusste Entscheidung.)*
|
||||||
|
3. Alle Oberflächen-Strings laufen durch `t()` mit vollständiger `de`-Locale (`verify:i18n`-Gate grün); Contact.language ist als Feld vorhanden und steuert die Outbound-Sprache ab v2. *(Scope-Schnitt 12.06.: v1 DE-only; Wechsler + Fallback-UX + EN-Templates → v2 — alles i18n-ready, Nachrüsten ohne Refactoring.)*
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 4: Files & Tasks
|
||||||
|
**Goal**: Die nutzerseitigen Plattform-Primitive stehen bereit — Dateien lassen sich an jede Entität hängen (chunked Upload, Preview inkl. HEIC→JPG) und Tasks mit Fälligkeit/Reminder an CRM-/Sales-/Projekt-Entitäten.
|
||||||
|
**Depends on**: Phase 2
|
||||||
|
**Requirements**: REQ-files-datenmodell, REQ-files-upload-preview, REQ-tasks-datenmodell, REQ-tasks-reminder-archivierung
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M23-files.md`, `_bmad-output/specs/M26-tasks.md`
|
||||||
|
**Milestone-PLANs**: 7 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 4); M074 (Task-ERP-Sync) → Phase 10; Scope-Schnitt 12.06.: M054/M055 gedünnt
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Nutzer kann Dateien chunked hochladen (TUS) mit RLS auf Storage-Pfaden (S3-kompatibles Hetzner Object Storage, Infra-ADR-009); Previews (PDF→PNG, Bild→WebP, **HEIC→JPG — Pflicht für iPhone-Monteur-Fotos**) sind sichtbar. *(Scope-Schnitt 12.06.: Versionierung, Office-/Video-Previews, Resume-Upload, OCR → v2; Permissions/Sharing + Tags + Archiv-Flag bleiben.)*
|
||||||
|
2. Dateien lassen sich über FileEntityLink an Entitäten hängen; Customer-Portal-Upload ist vorbereitet.
|
||||||
|
3. Ein Nutzer kann Tasks mit Status, Priorität, Fälligkeit und Entitäts-Verknüpfung (Contact/Company/Lead/Projekt) anlegen, sich als Watcher eintragen und einen Reminder (via notify()) erhalten.
|
||||||
|
4. Abgeschlossene Tasks werden nach 30 Tagen per Cron auto-archiviert.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 5: Apps-Engine & Integrations-Framework
|
||||||
|
**Goal**: Externe Systeme werden über ein einziges, typsicheres Integrations-Framework angebunden — der Vertrag, über den später Gmail, Outlook, AirCall, Signatur-Adapter (SES-Default/PandaDoc-BYOK), Legacy-Provider und KWP laufen.
|
||||||
|
**Depends on**: Phase 2
|
||||||
|
**Requirements**: REQ-apps-engine-datenmodell, REQ-apps-engine-lifecycle
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M33a-apps-engine.md`
|
||||||
|
**Milestone-PLANs**: 3 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 5)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Admin kann eine DataConnection über einen OAuth2-Connect-Flow (Gmail, Outlook, AirCall, optional PandaDoc-BYOK) oder API-Key-Connect (KWP, Legacy-Provider, Signatur-Adapter) in der Settings-UI herstellen.
|
||||||
|
2. Die type-safe Adapter-Registry erlaubt das Registrieren neuer Connection-Typen ohne Änderung am Kern; AppSyncRun/AppSyncItem protokollieren Sync-Läufe.
|
||||||
|
3. Connection-Health-Monitoring zeigt den Status jeder Verbindung; OAuth-Tokens sind per-Tenant-DEK-verschlüsselt gespeichert (AD-8).
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 6: CRM-Kern
|
||||||
|
> 🔴 **Pivot-Note (AD-20, 13.06.):** Kontaktmodell wird umgebaut: `Kontakt` = Oberbegriff mit `Kontakttyp` (Privatperson/Organisation), `Kontaktstatus` (Kontakt/Kunde/Bestandskunde), `Kontaktart` (Haupt-/Sekundärkontakt als Rolle/Relation). Zwei Listen-Einstiege (Unternehmen/Organisationen + Kontakte). Custom-Fields + Pipeline-Feld-Config-Layer. SC/Reqs werden mit dem ER-Modell neu gefasst.
|
||||||
|
|
||||||
|
**Goal**: Ein Vertriebler kann Kontakte, Firmen und Leads als typisierte First-Class-Entitäten verwalten — mit Custom-Feldern, Tags, Activity-Stream und Duplikat-Schutz.
|
||||||
|
**Depends on**: Phase 5, Phase 4
|
||||||
|
**Requirements**: REQ-crm-datenmodell, REQ-crm-listen-views, REQ-crm-detail-views, REQ-lead-projekt-konvertierung, REQ-crm-activity-stream, REQ-crm-custom-felder, REQ-crm-duplikat-erkennung, REQ-crm-tags, REQ-crm-permissions
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M01-crm-kern.md`
|
||||||
|
**Milestone-PLANs**: 5 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 6)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Alle CRM-Kernentitäten (Contact, Company, Lead, Relation, Activity, CustomField, Tag) sind typisierte Prisma-Tabellen mit RLS-Policies; der Boilerplate-Entity-Builder ist entfernt (AD-2).
|
||||||
|
2. Ein Nutzer kann Kontakt-/Firmen-Listen server-seitig filtern, sortieren, paginieren, per Bulk-Action bearbeiten und als CSV exportieren.
|
||||||
|
3. Eine Detailansicht zeigt Inline-Edit, Activity-Stream (append-only Event-Sourcing), verknüpfte Entitäten und Custom-Felder; SHK-Branchen-Custom-Felder sind als Template geseedet.
|
||||||
|
4. Beim Anlegen warnt ein Live-Match-Check vor Duplikaten; ein Lead wird bei `Weiterverarbeitungsfreigabe` zum `Projekt` konvertiert (Lead-Daten vererbt, Kontakt separat verknüpft — kein Promotions-Modal, AD-20).
|
||||||
|
5. crm.*-Permission-Bundle (read_own/read_all/write/delete/admin) filtert serverseitig nach Owner; ein Nutzer ohne read_all sieht nur eigene Datensätze.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 7: Lead-Inbox
|
||||||
|
> 🔴 **Pivot-Note (AD-20, 13.06.):** Lead/LeadInput ist Vorstufe mit Datenpunkt `Weiterverarbeitungsfreigabe` (Ja/Nein/Unklar). **Lead → Projekt** statt Lead→Contact-Promotion (4-Optionen-Modal entfällt); Kontakt wird separat verknüpft. Vererbung relevanter Lead-Daten ins Projekt bei Freigabe. SC/Reqs werden mit dem ER-Modell neu gefasst.
|
||||||
|
|
||||||
|
**Goal**: Eingehende Leads aus allen Quellen landen in einem Triage-Arbeitsplatz, werden automatisch angelegt, gegen Spam geschützt und sind auswertbar.
|
||||||
|
**Depends on**: Phase 6
|
||||||
|
**Requirements**: REQ-lead-inbox-liste, REQ-lead-quellen-auto-anlage, REQ-lead-status-workflow, REQ-lead-anti-spam, REQ-lead-statistiken, REQ-lead-permissions
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M02-lead-inbox.md`
|
||||||
|
**Milestone-PLANs**: 4 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 7); M049 (Auto-Projekt) → Phase 8 (braucht den Projekt-Kern); P7 liefert das `lead.qualified`-Event als Extension-Point
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Bearbeiter sieht die Lead-Inbox mit Status-Filter, Quick-Actions, Bulk-Operationen und Real-time-Refresh.
|
||||||
|
2. Leads aus Form-Submission, eingehender Email und AirCall-Inbound werden automatisch angelegt und stoßen Automation-Trigger an (sofern Automation aktiv).
|
||||||
|
3. Der Status-Workflow (new|qualified|converted|lost|spam) erlaubt nur definierte Übergänge; ein DSGVO-Auto-Lösch-Cron räumt alte Leads ab.
|
||||||
|
4. Rate-Limiting/Anomalie-Detection schiebt verdächtige Leads in Quarantäne und benachrichtigt den Tenant-Admin.
|
||||||
|
5. Eine Statistiken-Page zeigt KPI-Kacheln, Quellen-Aufschlüsselung und Trends, permission-aware (leads.*-Bundle mit Owner-Check).
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 8: Sales-Pipeline → **Projekt & Pipelines (Teil 1: Kern + Pipeline-Engine)**
|
||||||
|
> 🔴 **Pivot-Note (AD-20, 13.06.):** P8+P9 verschmelzen konzeptionell zu „Projekt & Pipelines". P8 baut den **`Projekt`-Kern** (typisierte Superset-Tabelle + CustomFields) + die **Pipeline-Engine** (frei konfigurierbare Views: Pipeline anlegen/benennen, Zugriff je Rolle, Feld-Sichtbarkeit + Pflichtfelder pro Pipeline/Status, Statuswerte) + konfigurierbaren **Kanban** (ein Board statt Sales-Kanban + Projekt-Kanban). „Deal"/„Auftrag" = Pipeline-Typen. Forecast/Volumen-Field-Level-Rechte bleiben als Pipeline-typ-bedingte Features. SC/Reqs werden mit dem ER-Modell neu gefasst.
|
||||||
|
|
||||||
|
**Goal**: Ein Vertriebler führt Projekte durch mehrere SHK-Pipelines (Sales-Sicht) mit konfigurierbarem Kanban, Forecast und feingranularer Field-Level-Sichtbarkeit von Volumen-Daten — ein `Projekt`-Kern, „Deal" ist nur der Pipeline-Typ.
|
||||||
|
**Depends on**: Phase 7
|
||||||
|
**Requirements**: REQ-projekt-kern-datenmodell, REQ-pipeline-rechte-config, REQ-projekt-kanban-listen-view, REQ-projekt-pipeline-wechsel, REQ-projekt-forecast-kpis
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M03-sales-pipeline.md`
|
||||||
|
**Milestone-PLANs**: 7 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 8); inkl. M049 (Auto-Projekt, aus Phase 7 hierher)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Der `Projekt`-Kern (typisierte Superset-Tabelle + CustomFields) existiert mit fortlaufenden Projekt-Nummern (HiveNumberSeq); mehrere Pipelines (Pipeline mit typ_hint sales/auftrag/custom, PipelineStage = Status, Verlust-/Gewinn-Gründe) sind als geseedete SHK-Pipelines konfigurierbar.
|
||||||
|
2. Ein Nutzer kann Projekte im konfigurierbaren Kanban per Drag-&-Drop verschieben (mit Stage-Wechsel-Validation) oder in der Listen-View mit Filter/Bulk-Actions bearbeiten; Updates kommen in Real-Time (SSE, AD-9).
|
||||||
|
3. Ein qualifizierter Lead erzeugt automatisch ein Projekt in der Sales-Pipeline (M049, konsumiert das `lead.qualified`-Event aus P7); ein gewonnenes Projekt wechselt nur die Pipeline (Auftrags-Sicht in Phase 9) — kein Won-Handoff, kein zweiter Datensatz; ein Auto-Archive-Cron räumt abgeschlossene Projekte.
|
||||||
|
4. Forecast, KPIs pro Vertriebler, Stage-Conversion-Rates und Verlust-Grund-Auswertung werden mit Aggregat-Cache berechnet.
|
||||||
|
5. Pipeline-Field-Level-Rechte (PipelineFieldVisibility, z.B. Auftragsvolumen nur für Vertrieb) blenden Felder für Nutzer ohne Recht aus.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 9: Auftrags-/Projektpipeline → **Projekt & Pipelines (Teil 2: Auftrags-Features + Sub-Areas)**
|
||||||
|
> 🔴 **Pivot-Note (AD-20, 13.06.):** Kein separates Project-Objekt mehr — die Auftrags-Welt ist eine **Pipeline-View auf denselben `Projekt`-Kern** (kein Won-Handoff, das Projekt wechselt nur die Pipeline/erhält Auftrags-Felder). P9 liefert die auftragsspezifischen Features: **Plantafel** (Scheduling pro Monteur), **Sub-Areas** am Projekt (Termine, **Rechnungen = neues Sub-Entity v1**, Checklisten, Aufgaben, Aktivitäten, Dokumente) und die **Abnahme als Checklisten/Protokoll-Sub-Area** (v1, rechtlich bindend, Touch-Signatur, offline; Mängel = Checkliste). Material/Zeiterfassung/Leistungspositionen/Baustelle/Support → v2-Backlog. SC/Reqs werden mit dem ER-Modell neu gefasst.
|
||||||
|
|
||||||
|
**Goal**: Ein gewonnenes Projekt erhält in der Auftrags-Pipeline-Sicht seine Auftrags-Features — Plantafel-Scheduling pro Monteur, Sub-Areas (inkl. Rechnung-Sub-Entity v1) und eine digitale, offline-fähige Abnahme auf der Baustelle (kein neuer Datensatz, nur Pipeline-Wechsel).
|
||||||
|
**Depends on**: Phase 8
|
||||||
|
**Requirements**: REQ-projekt-sub-areas, REQ-rechnung-sub-entity, REQ-projekt-abnahme
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M04-auftragspipeline.md`
|
||||||
|
**Milestone-PLANs**: 6 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 9); Scope-Schnitt 12.06.: M070 gedünnt — Lagerist-Sicht/Material-Ausgang → v2 (Material-Listen am Auftrag bleiben; Noah-Frage auf E-Liste)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Die Auftrags-Welt ist eine Pipeline-View auf denselben `Projekt`-Kern (kein separates Project-/ProjectPipeline-Objekt, kein Won-Handoff — das Projekt wechselt nur die Pipeline und erhält Auftrags-Felder); Sub-Areas am Projekt: Termine, **Rechnung = neues Sub-Entity v1 (HiveNumberSeq)**, Checklisten, Aufgaben, Aktivitäten, Dokumente, ProjektMitglied/Monteure.
|
||||||
|
2. Ein Disponent kann auf einer Plantafel Aufträge pro Monteur/Tag einplanen; die Ansicht ist offline-fähig.
|
||||||
|
3. Ein Monteur kann ein immutables AbnahmeProtokoll (+ AbnahmeSignatur) als Sub-Area am Projekt mit Touch-Unterschrift erfassen — auch offline, mit späterem Sync und M05-Form-Template-Unterstützung; „Mängel" = Checkliste (typ=maengel).
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 10: KWP-Integration — **→ v2 (KOMPLETT DEFERRED, 2026-06-12 — ERSTES v2-Modul)**
|
||||||
|
|
||||||
|
> 🔴 **Scope-Schnitt #12 (Kalender-Realität):** KWP-API-Zugang lt. Hersteller-Mail erst ~**19.07.** — nach dem v1-Launch (~10.07.). KWP bleibt USP; v2 startet damit. **Sofort erledigt:** Callback-URL gemeldet (`https://app.hivegrid.de/integrations/kwp/oauth/callback`, PKCE-Flow), bnWin.net-Update 8.1 N3 bei Geerkens angestoßen. v1 behält Apps-Engine + Extension-Points (Auftrag/Abnahme/Material). Beschreibung unten gilt für die v2-Planung.
|
||||||
|
|
||||||
|
**Goal**: HiveGrid synchronisiert Auftrags- und Stammdaten bidirektional mit dem im SHK-Markt verbreiteten ERP KWP (Kernsystem des Erstkunden) — über die offizielle KWP-API als DataConnection, mit Schema-Drift-Schutz. Damit ist die Kette Lead → Sales → Auftrag → KWP durchgängig.
|
||||||
|
**Depends on**: Phase 9, Phase 5
|
||||||
|
**Requirements**: REQ-kwp-datenmodell, REQ-kwp-architektur, REQ-kwp-schema-drift
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M19-kwp-integration.md` (⚠ M089–M095-Recut — siehe Phase-Note)
|
||||||
|
**Milestone-PLANs**: 8 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 10); inkl. M074 (Task-ERP-Sync, aus Phase 4 hierher)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. KWP ist als `DataConnection type='rest-api'` in der Apps-Engine angebunden; keine KWP-DB-Credentials liegen in der Cloud (KwpSettings, KwpRegistry, KwpProjectQueue, KwpApiKey).
|
||||||
|
2. Auftrags-/Stammdaten fließen bidirektional zwischen HiveGrid und KWP; bei Konflikten gilt „KWP gewinnt" (AD-14/AD-17).
|
||||||
|
3. Ein Schema-Drift-Sentinel erkennt MSSQL-Schema-Änderungen per Snapshot-Vergleich (KwpSchemaSnapshot) und benachrichtigt den Tenant-Admin.
|
||||||
|
**Plans**: TBD
|
||||||
|
**Note**: M089-M095-Recut bindend — das offizielle KWP-API macht das Windows-Sync-Programm M089 obsolet (M090/091/092/094/095 vereinfachen sich, M093 bleibt). M089-M095 sind in der Plan-Phase neu zu schneiden, bevor Code entsteht; die alte kwpsync.exe-Drei-Komponenten-Architektur aus der M19-Spec ist NICHT zu bauen. KWP bleibt Backend-Sync ohne eigene UI (kein UI hint).
|
||||||
|
|
||||||
|
### Phase 11: Globale Suche & Dashboard
|
||||||
|
**Goal**: Ein Nutzer findet jede Entität per Hotkey über das gesamte System und sieht seine Kennzahlen in einem rollenbasierten Widget-Dashboard.
|
||||||
|
**Depends on**: Phase 9
|
||||||
|
**Requirements**: REQ-suche-datenmodell, REQ-suche-hybrid, REQ-suche-ui, REQ-dashboard-datenmodell, REQ-dashboard-widgets
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M24-globale-suche.md`, `_bmad-output/specs/M20-dashboard.md`
|
||||||
|
**Milestone-PLANs**: 5 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 11); Scope-Schnitt 11.06.: Custom-Widgets (M149) + Export (M150) → v2; 12.06.: M147 gedünnt (feste Rollen-Layouts)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Self-hosted Meilisearch liefert permission-aware Keyword-Treffer über den SearchAdapter. Kein pgvector/RAG/Embedding in v1/v2 nach AD-26.
|
||||||
|
2. Entity-Mutationen aktualisieren den Index über das Outbox-Pattern; SearchIndexEntry und RecentSearch sind befüllt.
|
||||||
|
3. Ein Nutzer öffnet per Cmd+K ein debounced Such-Modal mit RecentSearch und kann in eine Vollbild-Such-View wechseln.
|
||||||
|
4. Ein Nutzer sieht ein rollenbasiertes Dashboard (3 feste Rollen-Layouts GF/Büro/Monteur, SHK-Default geseedet) mit Widgets aus Sales, Projekte, Tasks und HR. *(Scope-Schnitt 12.06.: Drag&Drop-Grid + User-Layout-Persistenz → v2; KI-Widgets → Backlog/v3 nach AD-26.)*
|
||||||
|
5. Dashboard-Widgets aktualisieren sich live (WebSocket/SSE) mit Aggregat-Cache.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 12: Automation-Engine
|
||||||
|
**Goal**: Die erste USP-Säule steht in voller Tiefe (AD-16): ein visueller Automation-Editor über alle Module mit vollständiger Trigger-/Action-Library, Guards, Dry-Run und 24h-Undo. Sprach-zu-Automation entfällt nach AD-26.
|
||||||
|
**Depends on**: Phase 11
|
||||||
|
**Requirements**: REQ-automation-datenmodell, REQ-automation-trigger-library, REQ-automation-action-library, REQ-automation-flow-editor, REQ-automation-schutz
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M17-automation-engine.md`
|
||||||
|
**Milestone-PLANs**: 8 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 12)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Nutzer baut im Graph-Editor Flows aus der vollständigen Trigger-Library (CRM, Sales, Projekte, Email, Forms, Kalender, Zeit, Webhooks) und Action-Library (CRM, Notifications, HTTP, Tasks, If/Else, Delay, Loop; KWP-Push registriert sich mit v2-P10 nach — Registry ist erweiterbar gebaut).
|
||||||
|
2. Ein Nutzer erstellt eine Automation im visuellen Editor, testet sie als Dry-Run und kann Ausführungen innerhalb von 24h zurückrollen.
|
||||||
|
3. Loop-Guard, Rate-Limit, Idempotenz-Key, Resume-Mode und Trigger-Volumen-Metering pro Tenant verhindern Runaway-Automationen.
|
||||||
|
4. AutomationRule (JSON-Graph), AutomationExecution, AutomationStepExecution und AutomationTemplate persistieren Flows und Läufe nachvollziehbar.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 13: KI-Layer
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]): Phase 13 (KI-Layer) entfällt in v1; Phase 25 (HiveMind/RAG) zurückgestellt → ersetzt durch MCP-Server ([[VR-MCP]]).** HiveGrid hostet kein eigenes LLM/RAG/Whisper mehr, sondern stellt seine Daten/Aktionen als Remote-MCP-Server externen KI-Clients bereit. Tickets R-P13/D-P13/EXT-11 sowie die Milestones M083–M086/M088 sind gelöscht. Success-Criteria unten sind **überholt** und nur historisch erhalten.
|
||||||
|
**Goal**: ~~Der EU-only KI-Unterbau steht produktiv: Multi-Provider-LLM-Gateway mit Kostenschutz und die Sprach-zu-Automation als exklusives Automation-Feature.~~ *(Scope-Schnitt 11.06.: HiveMind/RAG, Whisper, AlephAlpha → v2 — v1 baut die Andock-Adapter.)* **→ entfällt, siehe Pivot-Banner.**
|
||||||
|
**Depends on**: Phase 12
|
||||||
|
**Requirements**: ~~REQ-ki-llm-gateway~~ → entfernt ([[AD-26]]); ersetzt durch `REQ-mcp-server`
|
||||||
|
**Source-Specs**: ~~`_bmad-output/specs/M18-ki-layer.md`~~ (KI-Layer entfällt — [[AD-26]])
|
||||||
|
**Milestone-PLANs**: ~~5 PLANs in `docs/milestones/`~~ → M083–M086/M088 gelöscht ([[AD-26]])
|
||||||
|
**Success Criteria** ~~(what must be TRUE)~~ — **überholt durch [[AD-26]]**:
|
||||||
|
1. ~~Das EU-LLM-Gateway (Mistral La Plateforme primär, Provider-Abstraktion — zweiter EU-Provider folgt v2; Infra-Wechsel 12.06.: Scaleway entfällt) trackt Tokens und bucht gegen das lokale AiCredits-Konto; harte Limits + Drossel greifen; keine US-Kern-Abhängigkeit.~~
|
||||||
|
2. ~~Sprach-zu-Automation (M086) läuft EXKLUSIV im Automation-Kontext: Satz → visueller Flow-Vorschlag mit Rückfragen + Existenz-Prüfungen; aktiviert nie selbst.~~
|
||||||
|
3. ~~Promptfoo-Suite (A.14) testet die ausgelieferten KI-Funktionen.~~
|
||||||
|
4. ~~v2-Andock-Adapter existieren: `RetrievalProvider`-Interface, Outbox-Index-Events (via P11), Bestätigungs-Grenze als wiederverwendbares Muster.~~
|
||||||
|
**Plans**: ~~TBD~~ → entfällt
|
||||||
|
**UI hint**: ~~yes~~ → entfällt
|
||||||
|
|
||||||
|
### Phase 14: Email & Marketing
|
||||||
|
**Goal**: Der Betrieb arbeitet seinen Email-Verkehr direkt in HiveGrid ab — bidirektionale Gmail/Outlook-Inbox mit CRM-Matching — und versendet DSGVO-konforme Marketing-Kampagnen.
|
||||||
|
**Depends on**: Phase 6, Phase 5
|
||||||
|
**Requirements**: REQ-email-datenmodell, REQ-marketing-datenmodell, REQ-marketing-double-optin, REQ-marketing-versand
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M09-email-inbox.md` (nur Sende-Domain/Inbound-Teile; OAuth-Sync → v2), `_bmad-output/specs/M10-email-marketing.md`
|
||||||
|
**Milestone-PLANs**: 6 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 14); Scope-Schnitt 11.06.: M096–M098 (Postfach-Sync) → v2
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Die Sende-Domain pro Mandant ist verifiziert (DKIM/SPF/DMARC, Auto-Probe); Mails aus HiveGrid (Automation, Marketing, manuell) gehen über Mailjet raus und erscheinen am Kontakt.
|
||||||
|
2. Eingehende Mails an die Tenant-Inbound-Adresse erzeugen Leads/Aktivitäten; die **BCC-Logging-Brücke** protokolliert in Gmail/Outlook geschriebene Mails am Kontakt (kein OAuth nötig).
|
||||||
|
3. Marketing-Kampagnen versenden DSGVO-konform (Double-Opt-In, Suppression-Check, One-Click-Unsubscribe) über BullMQ mit Rate-Limiting und Bounce-Handling.
|
||||||
|
4. Der Versand läuft über eine SMTP-Provider-Abstraktion (Mailjet — AD-6 gelockt 11.06.) ohne US-Kern-Abhängigkeit.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 15: Telefonie & Team-Chat
|
||||||
|
**Goal**: Telefonie und interne Kommunikation laufen in HiveGrid — Click-to-Call/Inbound über AirCall mit Auto-Lead-Anlage und Real-Time-Team-Chat mit entity-linked Channels.
|
||||||
|
**Depends on**: Phase 6, Phase 5
|
||||||
|
**Requirements**: REQ-telefonie-datenmodell, REQ-telefonie-provider-adapter, REQ-chat-datenmodell, REQ-chat-realtime, REQ-chat-features
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M12-telefonie.md`, `_bmad-output/specs/M13-team-chat.md`
|
||||||
|
**Milestone-PLANs**: 9 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 15); Scope-Schnitt 11.06.: HalloPetra (M105) → v2
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Click-to-Call und Inbound-Anrufe laufen über den AirCall-Adapter (Apps-Engine-Connection, verschlüsselte OAuth-Tokens); unbekannte Nummern legen automatisch einen Lead an; Anruf-Events stehen als Automation-Trigger bereit (verpasster Anruf → Rückruf-Aufgabe).
|
||||||
|
2. Team-Chat bietet Real-Time-Messaging (WebSocket, Presence, Typing, Read-Receipts, Redis-Pub/Sub) für drei Channel-Typen (public, private, entity-linked), AD-9.
|
||||||
|
3. Chat unterstützt @Mentions, File-Uploads (via Files), Link-Previews und Chat-Verlaufs-Suche.
|
||||||
|
4. Entity-linked Channels erscheinen im Projekt-Detail und verknüpfen die Konversation mit der CRM-/Projekt-Entität.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 16: Kalender, Booking, Forms & Signatur
|
||||||
|
**Goal**: Termin- und Dokument-Workflows sind abgedeckt — bidirektionaler Kalender-Sync, öffentliche Buchungsseiten, ein Drag-&-Drop-Form-Builder und Multi-Signer-Angebots-Signatur.
|
||||||
|
**Depends on**: Phase 7, Phase 5
|
||||||
|
**Requirements**: REQ-kalender-datenmodell, REQ-kalender-sync-adapter, REQ-booking-datenmodell, REQ-booking-slot-kalkulierung, REQ-booking-integrationen, REQ-form-datenmodell, REQ-form-editor, REQ-form-actions, REQ-signatur-datenmodell, REQ-signatur-provider
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M25-calendar-sync.md`, `_bmad-output/specs/M06-booking.md`, `_bmad-output/specs/M05-form-builder.md`, `_bmad-output/specs/M07-angebot-signatur.md`
|
||||||
|
**Milestone-PLANs**: 15 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 16); Scope-Schnitt 12.06.: M122 gedünnt — personalisierte Links + JS-Snippet → v2 (URL/QR/iFrame bleiben); M129 bleibt explizit voll
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Kalender synchronisiert bidirektional mit **Google** (CalendarAdapter, Auto-Token-Refresh, Webhook-Subscriptions) und legt HiveGrid-Termine an. *(Scope-Schnitt 11.06.: Outlook-Adapter → v2; Interface ist provider-agnostisch gebaut. Booking: eine Zuteilungs-Strategie „Erster der frei ist", Round-Robin/Wahl → v2.)*
|
||||||
|
2. Öffentliche Booking-Seiten berechnen Slots timezone-aware (Verfügbarkeitsregeln, Ausnahmen, Kalender-Sync, Puffer) und legen nach Buchung Lead, Activity und Bestätigungs-Email an (iFrame-Embed).
|
||||||
|
3. Ein Nutzer baut Formulare per Drag-&-Drop mit 12 Feld-Typen, Conditional Logic, SHK-Templates und iFrame-Embed; Post-Submit-Actions (Lead/Projekt/Task, Webhook, Email, Automation-Trigger) feuern mit Field-Mapping und ActionLog.
|
||||||
|
4. Angebote durchlaufen Multi-Signer-Signaturen über den self-hosted SES-Standardpfad (AD-25); PandaDoc/DocuSign bleiben optionale BYOK-/Opt-in-Adapter via Apps-Engine.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 17: HR-Hub
|
||||||
|
**Goal**: Interne Personalprozesse sind in einem verschlüsselten HR-Hub abgedeckt — Personalakten, Passwort-Safe und Urlaubs-/Krank-Workflow.
|
||||||
|
**Depends on**: Phase 4
|
||||||
|
**Requirements**: REQ-hr-datenmodell, REQ-hr-passwort-safe, REQ-hr-urlaub-krank
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M14-hr-hub.md`
|
||||||
|
**Milestone-PLANs**: 7 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 17); Scope-Schnitt 11.06.: Memberspot/Boobora (M138) → v2; Surveys bleiben
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. HR-Profile, Urlaubs-/Krank-/Payslip-/Request-Daten liegen AES-256-GCM-verschlüsselt vor; sensible Felder nutzen KMS-backed Envelope-Encryption (AD-8).
|
||||||
|
2. Jeder Mitarbeiter hat einen verschlüsselten Passwort-Safe mit Audit-Trail und DSGVO-Export.
|
||||||
|
3. Ein mehrstufiger Urlaubs-Approval-Workflow und Krankmeldungs-Erfassung speisen einen Abwesenheits-Kalender.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 18: Customer-Portal — **→ v2 (deferred 2026-06-11)**
|
||||||
|
**Goal**: *(v2)* Getrenntes Endkunden-Portal mit Magic-Link und freigegebener Projekt-Sicht. AD-18 revidiert — komplette Phase nach v2 verschoben; Phasen-Nummer bleibt reserviert.
|
||||||
|
**Depends on**: — (v2-Planung)
|
||||||
|
**Requirements**: *(→ v2: REQ-portal-datenmodell, REQ-portal-auth-magic-link, REQ-portal-projekt-sicht)*
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M15-customer-portal.md`
|
||||||
|
**Milestone-PLANs**: 0 in v1 (M141–M146 → v2)
|
||||||
|
**v1-Andockpunkte (bleiben):** P4-Portal-Upload-Vorbereitung (FileEntityLink), `portal.hivegrid.de` im P1-URL-Schema.
|
||||||
|
**Plans**: — (v2)
|
||||||
|
|
||||||
|
### Phase 19: Plattform-Admin
|
||||||
|
**Goal**: Die Plattform ist aus einer getrennten Admin-Welt betreibbar — Tenant-Management, Subscription-Overrides, Feature-Flag-Verwaltung (UI zur Engine aus Phase 1), Queue-Monitoring und Support-Inbox.
|
||||||
|
**Depends on**: Phase 2
|
||||||
|
**Requirements**: REQ-plattform-admin-identität, REQ-plattform-admin-features
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M37-plattform-admin.md`, `_bmad-output/specs/M32-feature-flags.md` (Admin-UI-Teile)
|
||||||
|
**Milestone-PLANs**: 7 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 19); Scope-Schnitt 11.06.: M033 (Flag-Massen-Statistik) + M040 (Plattform-Lead-Pipeline) → v2; 12.06.: M038/M039 (getrennte AdminUser-Identität) → v2, M035 gedünnt. **Neu:** Admin stellt Tenant-Abos zusammen (Konnektoren schalten + Legacy-Provider-Positionen — Abo-Baukasten-Mechanik; Self-Service-UI → v2)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Plattform-Admin meldet sich auf `admin.hivegrid.de` an (Host-Routing auf die Admin-Routen, **Cookie-Domain-Trennung** zu app.hivegrid.de, TOTP-Pflicht + MFA-Step-up); Admin-User haben **keinen Tenant-Workspace** und erscheinen in keiner Mandanten-Mitgliederliste; kein Generalschlüssel zwischen Plattform und Mandanten. *(Scope-Schnitt 12.06.: getrennte AdminUser-Identität/AdminRBAC-Parallelwelt = M038/M039 → v2; v1 nutzt Boilerplate-Modell User-Extension + `admin-mfa-gate`.)*
|
||||||
|
2. Ein Admin verwaltet Tenants, Subscription-Overrides und Feature-Flags aus einer zentralen Konsole; das Admin-Dashboard zeigt die Boilerplate-KPIs (Tenants/User/MRR). *(Churn/ARPU/Health-Kacheln → v2.)*
|
||||||
|
3. Ein Admin überwacht BullMQ-Queues und bearbeitet eine Support-Inbox; AdminAuditLog protokolliert plattformweite Aktionen (tenantId=null) über die Audit-Hash-Kette.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 20: Billing, Onboarding & Branding
|
||||||
|
**Goal**: Ein neuer Betrieb kommt vom Self-Service-Signup per Auto-SHK-Provisionierung ins Produkt (Wizard-UI → v2), läuft auf Legacy-Provider-Billing und kann sein Theme wählen.
|
||||||
|
**Depends on**: Phase 19, Phase 6
|
||||||
|
**Requirements**: REQ-billing-datenmodell, REQ-billing-trial-dunning, REQ-onboarding-demo-daten, REQ-branding-theme-phase1
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M28-subscriptions-billing.md` (⚠ M154-Recut: Abo-Baukasten statt Seat-Typen), `_bmad-output/specs/M29-onboarding.md` (Wizard-UI → v2), `_bmad-output/specs/M31-branding.md`; **Legacy-Referenz:** `archive/hivegrid-cloud/app/config/pricing-plans.ts`
|
||||||
|
**Milestone-PLANs**: 8 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 20); Scope-Schnitt 11.06.: M157 (Wizard-UI) → v2; 12.06.: M030 + M160 gedünnt
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Billing läuft über Legacy-Provider als **Abo-Baukasten**: Basis-Preis pro Nutzer + Feature-Module als daten-getriebene Positionen (keine Seat-Typen — M154-Recut); Trial mit Dunning (Tag 1/3/7) und Frozen-Modus (Read-Only-Middleware) greift; konkrete Preise geparkt (AD-15, Kostenmatrix folgt). Verbrauchs-Zähler + Drossel aktiv, Aufschlags-Abrechnung → v2.
|
||||||
|
2. Ein neuer Tenant wird nach Signup automatisch SHK-provisioniert (Seeds M158, ohne Wizard-UI — die folgt v2); Trial-Freischaltung durch Plattform-Admin (wie spec'd).
|
||||||
|
3. Optionale Demo-Daten (Kontakte, Projekte in Sales-/Auftragssichten, Tasks) lassen sich per Settings-Knopf provisionieren und via is_demo_data-Flag löschen. *(Scope-Schnitt 12.06. + AD-26: KI-Walkthrough entfällt; einfaches Löschen statt Multi-Step-Bulk.)*
|
||||||
|
4. Ein Nutzer schaltet zwischen Hell und Dunkel um, flash-frei (SSR-Cookie). *(Scope-Schnitt 12.06.: kein System-Modus — bewusst nur 2 Optionen; `next-themes` aus Boilerplate.)*
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 21: DSGVO & Launch-Reife
|
||||||
|
**Goal**: Der DSGVO-Lebenszyklus ist abgedeckt und die Plattform launch-fertig. Damit ist der Big-Bang-Launch (AD-19) auslösbar. *(Scope-Schnitt 11.06.: Public-API, Mobile-PWA-Ausbau, Help-Center/Desk, DSGVO-Auskunfts-Tooling → v2.)*
|
||||||
|
**Depends on**: Phase 20, Phase 10, Phase 4
|
||||||
|
**Requirements**: REQ-dsgvo-export, REQ-dsgvo-tenant-deletion, REQ-feedback-widget
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M35-dsgvo-export.md` (M34/M36/M38/M39 → v2)
|
||||||
|
**Milestone-PLANs**: 2 PLANs in `docs/milestones/` → siehe `.planning/PHASE-SOURCES.md` (Phase 21)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Ein Nutzer kann einen DSGVO-ZIP-Export (72h-signed-URL) anstoßen; eine Tenant-Löschung führt Crypto-Shredding (Per-Tenant-DEK), Legacy-Provider-Cancel und Storage/Cache-Bereinigung durch (AD-8).
|
||||||
|
2. DSGVO-Auskunft funktioniert als dokumentiertes manuelles Playbook: Suche → Kontakt-Detail (Activity-Stream) → CSV-Export → Anwalts-Vorlage → Frist-Task (+25 Tage). AVV-Vorlage liegt vor (Externals E6).
|
||||||
|
3. Das In-App-Feedback-Widget (Bug/Feature/Frage, Screenshot, Rate-Limit) ist live und speist die Admin-Support-Inbox (P19, generische Quelle); eine Minimal-FAQ-Seite existiert.
|
||||||
|
4. Monteure arbeiten mobil über die PWA/responsive Web-App (mobile-first Screens + P9-Offline) — der PWA-Ausbau (Installierbarkeit/Web-Push) folgt v2; ein nativer Client ist nicht vorgesehen (AD-17, PWA-only).
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## v2 — Phase Details (22–34)
|
||||||
|
|
||||||
|
> Detail-Quelle mit allen Success-Criteria/Screens/Recut-Hinweisen: `.planning/ROADMAP-V2.md`. Dependency-Prinzip wie v1: keine Vorwärts-Abhängigkeiten; spätere Phasen integrieren sich rückwirkend.
|
||||||
|
|
||||||
|
### Phase 22: Public-API & Webhooks (v2)
|
||||||
|
**Goal**: Externe Systeme lesen HiveGrid-Hauptentitäten per versionierter REST-API und empfangen/senden Events über signierte Webhooks.
|
||||||
|
**Depends on**: Phase 2 (ApiKey-Modell), Phase 12 (Automation `external_event`-Trigger)
|
||||||
|
**Milestones**: M161, M162, M163, M027
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M34-public-api.md`
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. GET contacts/companies/deals/projects/tasks/leads — cursor-paginiert, Filter/Sort/Sparse-Fieldsets/Embed (Tiefe 1); `read_only`-Scope lässt sensible Felder aus (nicht 403).
|
||||||
|
2. Eingehende Lead-Webhooks legen Leads an (API-Key/HMAC/URL-Token + Payload-Mapping + Auto-Match); ausgehende Subscriptions HMAC-signiert mit Idempotenz, Retry/Backoff, Auto-Disable nach 10 Fehlern.
|
||||||
|
3. OpenAPI-3.1 auto-generiert + Swagger-UI; Rate-Limit (1k/h Key, 10k/h Tenant) mit `X-RateLimit-*` + Klartext-429.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 23: Postfach-Sync (Email-Inbox) (v2)
|
||||||
|
**Goal**: Gmail/Outlook-Postfächer werden bidirektional ins CRM gespiegelt, auto-gematcht und im Activity-Stream sichtbar.
|
||||||
|
**Depends on**: Phase 5 (Apps-Engine/Provider-Pattern), Phase 6 (CRM-Matching), Phase 14 (Sende-Domain — nicht neu bauen)
|
||||||
|
**Milestones**: M096, M097, M098
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M09-email-inbox.md` (OAuth-Sync/Inbox/Threading-Teile)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. OAuth-Connect Gmail (Pub/Sub-Watch) + Microsoft (Graph-Subscription, 3-Tage-Renewal-Worker); Push-Sync, Initial-Sync 90 Tage resumebar.
|
||||||
|
2. Auto-Match (From-Adresse, Subject-Pattern `[Projekt #123]`, 1-offenes-Projekt-Heuristik) mit manuellem Override; Inbox-Liste + Detail mit Thread, sicherem HTML-Render, Reply/Forward.
|
||||||
|
3. `email.read_own`/`read_all` filtern Liste + Activity-Stream.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
**Risiko**: Gmail restricted scopes → Google-Verifizierung/CASA (Antrag lief in v1 EXT-13); Graph-Subscription-Renewal kritisch.
|
||||||
|
|
||||||
|
### Phase 24: Self-Service-Billing & Onboarding-Wizard (v2)
|
||||||
|
**Goal**: Tenants buchen/wechseln Pläne self-service über Web-Checkout und durchlaufen einen branchen-getriebenen Onboarding-Wizard.
|
||||||
|
**Depends on**: Phase 20 (Legacy-Provider/Billing-Fundament)
|
||||||
|
**Retro-Integration**: Kein KI-Walkthrough-Coach nach AD-26; Phase 25 liefert MCP-Server statt eigenem LLM/Coach.
|
||||||
|
**Milestones**: M157 (+ M28-Self-Service-Delta, Block P)
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M28-subscriptions-billing.md` (Block P), `M29-onboarding.md`
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Self-Service-Trial ohne Vertriebs-Freigabe (Zahlungsmethode-Pflicht); Plan-Wechsel/Add-Ons über Web-Checkout (PWA-only → kein App-Store, keine Store-Billing-Auflage).
|
||||||
|
2. Onboarding-Wizard resumebar, Step-Validierung, Rückwärts-Block nach irreversiblen Actions.
|
||||||
|
3. SHK-Branchen-Template (Pipelines/Rollen/Felder/Forms/Demo/Checkliste) deklarativ geseedet; Erste-Schritte-Checkliste + Demo-Daten-Bulk-Löschung.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
**Risiko**: Grund für Self-Service-v2 sind die noch fehlenden konkreten Preise (v1 EXT-14, Kostenmatrix mit Partner) — **nicht** Apple-Store-Auflagen (PWA-only, kein App-Store, Cut #14/AD-17); Web-Checkout direkt.
|
||||||
|
|
||||||
|
### Phase 25: MCP-Server (v2)
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]]):** HiveGrid hostet kein eigenes LLM/RAG/Whisper. Phase 25 ist der Remote-MCP-Server für externe KI-Clients. HiveMind/RAG/Whisper sind v3-Kandidaten und keine v2-Baugrundlage.
|
||||||
|
**Goal**: Externe KI-Clients können HiveGrid-Daten über tenant-gescopete Read-Ressourcen lesen und freigegebene Schreib-Aktionen über bestätigungspflichtige Action-Tools ausführen.
|
||||||
|
**Depends on**: Phase 22 (API-Key/Auth/Scopes/Rate-Limit), Phase 2 (Tenant/RLS), Phase 1 (Audit/Permissions)
|
||||||
|
**Retro-Integration**: Help-Artikel und andere Daten können optional als MCP-Resources exponiert werden; keine RAG-/Embedding-Pipeline.
|
||||||
|
**Milestones**: [[VR-MCP]] / [[VD-MCP]] (kein M0xx-Milestone)
|
||||||
|
**Source-Specs**: [[VR-MCP]] / [[VD-MCP]] · [[AD-26]]
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Remote-MCP-Server mit Streamable HTTP und `@modelcontextprotocol/sdk` exponiert Read-Ressourcen für Hauptentitäten.
|
||||||
|
2. Auth = API-Key + Scopes + Rate-Limit aus Phase 22; Tenant wird aus dem Token abgeleitet; jeder Zugriff läuft durch `withTenantScope()`/RLS.
|
||||||
|
3. Action-Tools sind `withPermission()`-gegated, verlangen bei Schreib-Operationen Confirmation und schreiben Audit-Events mit Actor-Kind `MCP/Agent`.
|
||||||
|
**Plans**: TBD → siehe [[VR-MCP]]/[[VD-MCP]]
|
||||||
|
**UI hint**: yes
|
||||||
|
**Constraint**: ~~ausschließlich EU-Provider (DSGVO), AVV mit allen Providern.~~ → MCP: kein LLM-Hosting, daher kein Provider-AVV; Tenant-Scope/RLS + API-Key-Auth gelten.
|
||||||
|
|
||||||
|
### Phase 26: Customer-Portal (v2) ⭐ *(ex-P18)*
|
||||||
|
**Goal**: Endkunden sehen über eine eigene Auth-Schicht ihre Projekte/Status/Dokumente, laden Dateien hoch, erhalten Auto-Status-Mails. **Kritisch** — wenn der Sprint im Plan liegt, in v2 liefern.
|
||||||
|
**Depends on**: Phase 4 (FileEntityLink — in v1 vorbereitet), Phase 6 (CRM/Project), Phase 9 (Project-Stages/Acceptance), Phase 14 (Sende-Domain)
|
||||||
|
**Milestones**: M141, M142, M143, M144, M145, M146
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M15-customer-portal.md`
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Eigene `PortalUser`-Klasse strikt getrennt von TenantUser (eigene Cookies/Routes, Magic-Link primär); kein Permission-Leak, fehlender Zugang → 404.
|
||||||
|
2. Endkunde sieht nur eigene Projekte/konfigurierte Stages/freigegebene Dokumente; Upload (Kamera, Multi-File) → Files + Activity + PL-Notification.
|
||||||
|
3. Auto-Status-Mails bei `project.stage_changed` (Debounce/Bedingungen); Tenant-Admin konfiguriert Sichtbarkeit/Templates; DSGVO-Lösch/Export für PortalUser.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes (extern sichtbar, eigener Polish)
|
||||||
|
|
||||||
|
### Phase 27: Mobile-PWA-Ausbau (v2)
|
||||||
|
**Goal**: Die mobile-first-PWA aus v1 wird zur vollwertigen installierbaren App — Add-to-Homescreen, Service-Worker-Offline-Härtung, Web-Push, schneller Baustellen-Einsatz. **Kein nativer Client** (Expo/Capacitor) und **kein App-Store** — native → frühestens v3 (AD-17, PWA-only).
|
||||||
|
**Depends on**: Phase 9 (OfflineSyncQueue), Phase 21 (notify()-Push-Kanal → Web-Push), Phase 2 (Auth/Magic-Link)
|
||||||
|
**Milestones**: M167, M168, M169, M170, M171 (auf PWA umzuschneiden — kein EAS-Build, keine Store-Compliance)
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M36-mobile-app.md` (⚠ Recut → PWA-only; Capacitor/Expo verworfen)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Offline: Pre-Cache beim Login + Offline-Write-Queue (Foto/Note/Task-Status/Checklist/Acceptance/Chat) über Service-Worker + IndexedDB; Sync-on-Reconnect idempotent (lokale UUID), Konflikt-Resolution.
|
||||||
|
2. Installierbar: Web-App-Manifest + Add-to-Homescreen + Standalone-Display; Kamera/Foto via Web-APIs mit lokalem Resize.
|
||||||
|
3. Web-Push (VAPID) aktiviert den in P1 ruhenden notify()-Push-Kanal; Account-Löschung erreichbar; Force-Update via Service-Worker-Versionierung.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes (mobile-first PWA-Shell, Touch-Paradigma)
|
||||||
|
**Risiko**: PWA-Offline-Storage-Budget + iOS-Safari-PWA-Grenzen (Web-Push iOS ≥16.4 nur im Standalone-Modus); Background-Sync-Verfügbarkeit. **Kein** App-Store-Review-Risiko (entfällt vollständig).
|
||||||
|
|
||||||
|
### Phase 28: Plattform-Admin-Tiefe (v2)
|
||||||
|
**Goal**: Getrennte AdminUser-Identität/RBAC auf admin.hivegrid.de + Feature-Flag-Massen-Statistik (löst die v1-Auflagen-Brücke ab).
|
||||||
|
**Depends on**: Phase 19 (Admin-Welt-Fundament/M034: Host-Routing/Cookie-Trennung/TOTP), Phase 2 (Auth-Bausteine)
|
||||||
|
**Milestones**: M038, M039, M033, M040
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M37-plattform-admin.md` (Block A–D), `M32-feature-flags.md` (Massen-Statistik)
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Eigene `AdminUser`-Klasse hart getrennt (eigene Cookies SameSite=Strict, **kein BYPASSRLS** — Admin liest Tenant-Daten via RLS mit gesetztem `app.tenant_id`); AdminRBAC + 2FA-Pflicht + Self-Permission-Schutz.
|
||||||
|
2. AdminAuditLog cross-tenant mit Reason-Pflicht; Impersonate mit Reason + Banner.
|
||||||
|
3. Flag-Massen-Statistik (Effektiv-Auswertung + Live-Filter-Vorschau + Bulk-Override), deterministische Auswertung (Override > Filter > Default); interne Lead-Pipeline.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 29: Help-Center & Help-Desk (v2)
|
||||||
|
**Goal**: Öffentliches file-basiertes Help-Center mit Deep-Links aus der App + In-App-Feedback-Widget (Ausbau), das im Plattform-Admin landet.
|
||||||
|
**Depends on**: Phase 21 (Feedback-Widget→Support-Inbox-Andockpunkt), Phase 19 (Admin)
|
||||||
|
**Retro-Integration**: Help-Artikel können optional als MCP-Resources in Phase 25 exponiert werden; kein RAG-/Embedding-Korpus.
|
||||||
|
**Milestones**: M172, M173, M174, M175
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M38-help-center.md`, `M39-help-desk.md`
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Markdown mit Frontmatter, Build-Time-Index (Volltext/Kategorien/Sitemap), Build-Fail bei kaputten Referenzen; öffentliche Routen `/help/{lang}/{category}/{slug}` ohne Auth + SEO + Suche.
|
||||||
|
2. Deep-Link Route→Artikel (Hilfe-Icon pro App-Route); Feedback-Widget → `Feedback` mit Auto-Kontext + Screenshot + Rate-Limit.
|
||||||
|
3. Plattform-Admin: Feedback-Liste + Detail (Status-Lifecycle/Assignee/Notes) mit Audit.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 30: Dashboard-Deluxe & Querschnitt (v2)
|
||||||
|
**Goal**: Querschnitts-Komfort — anpassbare Dashboards/Export, Notification-Bündelung/Quiet-Hours, Sprach-Wechsler/EN.
|
||||||
|
**Depends on**: Phase 11 (Dashboard/Widget-Registry), Phase 3 (Notification-Center), Phase 1 (i18n-Library)
|
||||||
|
**Milestones**: M149, M150, M117, M029
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M20-dashboard.md`, `M22-notifications.md`, `M30-i18n.md`
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. Dashboard: Layout anpassbar (Drag/Resize, permission-gegateter Widget-Catalog), Drilldown, CSV-Export, Realtime mit Opt-Out.
|
||||||
|
2. Notifications: Bündelung (5-Min-Window → 1 Push/Mail mit count), Quiet-Hours (queued, Urgent-Override), Pro-User-Präferenzen Event×Kanal.
|
||||||
|
3. i18n: Sprach-Wechsler + EN-Locale (DeepL DE→EN mit Review), Build-Validierung, Fallback DE, Empfänger-Sprach-Auflösung Outbound.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
### Phase 31: DSGVO-Vollausbau (v2)
|
||||||
|
**Goal**: DSGVO vertiefen — AVV-Versionierung, Subprozessoren-Workflow, Auskunfts-/Voll-Export-Workflow (ersetzt das manuelle v1-Playbook).
|
||||||
|
**Depends on**: Phase 21 (DSGVO-Export/Lösch-Fundament), Phase 28 (Admin-Legal-Verwaltung/AdminAuditLog)
|
||||||
|
**Milestones**: M166
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M35-dsgvo-export.md`
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. AVV-Versionierung mit dynamischem PDF + elektronischer Akzeptanz, Re-Akzeptanz bei Updates (14-Tage-Frist → Read-Only).
|
||||||
|
2. Subprozessoren-Liste mit Drittland-Warnung + 14-Tage-Widerspruchs-Workflow.
|
||||||
|
3. User-Daten-Export (Art. 15/20) + Tenant-Voll-Export (ZIP, async, 7-Tage-Window) + Tenant-Lösch-Workflow (30-Tage-Grace + Hard-Delete-Cron).
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
**Risiko**: AVV-PDF-Inhalt anwaltlich finalisieren (v1 EXT-03 beauftragt).
|
||||||
|
|
||||||
|
### Phase 32: KWP-Integration (v2 — RECUT) *(ex-P10)*
|
||||||
|
**Goal**: KWP wird regulärer REST/OAuth-Adapter über die Apps-Engine — bidirektionaler Sync (Aufträge/Stammdaten/Belege/Plantafel/Dokumente) mit „KWP gewinnt"-Konfliktregel.
|
||||||
|
**Depends on**: Phase 5 (M33a Apps-Engine-Adapter-Interface — HART), Phase 9 (Auftrag/Abnahme/Material-Extension-Points), Phase 12 (Automation `kwp.push`-Action)
|
||||||
|
**Trigger (Block 2)**: KWP-API-Zugang ~20.07.; agil vorziehbar, sobald Vertrag/Zugang da.
|
||||||
|
**Milestones**: M089, M090, M091, M092, M093, M094, M095, M074
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M19-kwp-integration.md` + **`docs/milestones/M19-KWP-API-RECUT.md` (bindend)**
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. KWP-API-Connector als erster konkreter Adapter hinterm M33a-Interface; Credentials per-Tenant-DEK in `DataConnection.config`.
|
||||||
|
2. Bidirektionaler Sync (Push via Outbox+Replay, Pull via Webhook/Cron, idempotent über `AppSyncItem`); Konflikt „KWP gewinnt" (LWW + Audit-Restore) + Optimistic Locking.
|
||||||
|
3. API-Contract-Sentinel (zod-Validierung + Versions-Check) pausiert Sync bei Drift + alarmiert Admin; Plantafel- + Dokumenten-Archiv-Sync über die API.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
**Note**: ⚠ kwpsync.exe NICHT bauen (3→2-Komponenten). Konkreter KWP-API-Vertrag (Auth/Endpoints/Webhook-Support/Doc-API) ist der Bau-Blocker.
|
||||||
|
|
||||||
|
### Phase 33: Telefonie-Erweiterung (HalloPetra) (v2)
|
||||||
|
**Goal**: HalloPetra als zweiter Telefonie-Provider hinterm vorhandenen `TelephonyProviderInterface` — ohne Kern-Umbau.
|
||||||
|
**Depends on**: Phase 15 (TelephonyProviderInterface + AirCall-Adapter als Referenz)
|
||||||
|
**Trigger (Block 2)**: HalloPetra-API-Vertrag/Spec; agil vorziehbar, sobald spezifiziert.
|
||||||
|
**Milestones**: M105
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M12-telefonie.md` (Provider-Pattern) — ⚠ **HalloPetra selbst ist in keiner Spec; Vorlauf-Spec nötig.**
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. HalloPetra-Adapter implementiert `TelephonyProviderInterface` (connect/triggerOutboundCall/subscribeToWebhooks/verifyWebhookSignature/parseWebhookEvent/getRecordingUrl) ohne Kern-Änderung.
|
||||||
|
2. Webhook-Auto-Match auf Contact/Lead/Projekt, Activity + Automation-Trigger; Click-to-Call + Inbound providerunabhängig.
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes (Setup-/Binding-Flächen)
|
||||||
|
|
||||||
|
### Phase 34: HR-Drittanbieter-Onboarding (v2)
|
||||||
|
**Goal**: Externe HR-Onboarding-/Lohn-Drittanbieter (Memberspot/Boobora) über die Apps-Engine anbinden.
|
||||||
|
**Depends on**: Phase 5 (Apps-Engine), Phase 17 (HR-Hub)
|
||||||
|
**Trigger (Block 2)**: Memberspot/Boobora-API-Vertrag/Spec; agil vorziehbar, sobald spezifiziert.
|
||||||
|
**Milestones**: M138
|
||||||
|
**Source-Specs**: `_bmad-output/specs/M14-hr-hub.md` — ⚠ **Memberspot/Boobora in keiner Spec; Vorlauf-Spec nötig.**
|
||||||
|
**Success Criteria** (what must be TRUE):
|
||||||
|
1. HR-Onboarding-Checklisten pro neuem MA (verlinkte Forms/Tasks/Reminders).
|
||||||
|
2. Drittanbieter (Memberspot/Boobora/Lohn) als DataConnection über die Apps-Engine angebunden (gleicher Adapter-Mechanismus wie KWP).
|
||||||
|
**Plans**: TBD
|
||||||
|
**UI hint**: yes
|
||||||
|
|
||||||
|
## Progress
|
||||||
|
|
||||||
|
**Execution Order:**
|
||||||
|
Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9 → 10 → 11 → 12 → 13 → 14 → 15 → 16 → 17 → 18 → 19 → 20 → 21
|
||||||
|
**v1-Launch nach Phase 21 (~10.07.).** Danach **v2 (Phasen 22–34, ~13.–31.07.):** Block 1 (22→31) in 2 dependency-freien Tracks; Block 2 (32 KWP, 33 HalloPetra, 34 HR-Drittanbieter) ans Ende, agil vorziehbar sobald Partner-API/Spec vorliegt. P10/P18 sind als v1-Nummern reserviert und werden in v2 als Phase 32 (KWP) bzw. Phase 26 (Portal) ausgeführt.
|
||||||
|
|
||||||
|
| Phase | Plans Complete | Status | Completed |
|
||||||
|
|-------|----------------|--------|-----------|
|
||||||
|
| 1. Fundament & Walking-Skeleton | 0/TBD | Not started | - |
|
||||||
|
| 2. Identität & Mandantentrennung | 0/TBD | Not started | - |
|
||||||
|
| 3. Querschnitts-Oberflächen | 0/TBD | Not started | - |
|
||||||
|
| 4. Files & Tasks | 0/TBD | Not started | - |
|
||||||
|
| 5. Apps-Engine & Integrations-Framework | 0/TBD | Not started | - |
|
||||||
|
| 6. CRM-Kern | 0/TBD | Not started | - |
|
||||||
|
| 7. Lead-Inbox | 0/TBD | Not started | - |
|
||||||
|
| 8. Sales-Pipeline | 0/TBD | Not started | - |
|
||||||
|
| 9. Auftrags-/Projektpipeline | 0/TBD | Not started | - |
|
||||||
|
| 10. KWP-Integration | 0/TBD | Not started | - |
|
||||||
|
| 11. Globale Suche & Dashboard | 0/TBD | Not started | - |
|
||||||
|
| 12. Automation-Engine | 0/TBD | Not started | - |
|
||||||
|
| 13. KI-Layer | 0/TBD | Not started | - |
|
||||||
|
| 14. Email & Marketing | 0/TBD | Not started | - |
|
||||||
|
| 15. Telefonie & Team-Chat | 0/TBD | Not started | - |
|
||||||
|
| 16. Kalender, Booking, Forms & Signatur | 0/TBD | Not started | - |
|
||||||
|
| 17. HR-Hub | 0/TBD | Not started | - |
|
||||||
|
| 18. Customer-Portal | → v2 | Deferred (11.06.) | - |
|
||||||
|
| 19. Plattform-Admin | 0/TBD | Not started | - |
|
||||||
|
| 20. Billing, Onboarding & Branding | 0/TBD | Not started | - |
|
||||||
|
| 21. DSGVO & Launch-Reife | 0/TBD | Not started | - |
|
||||||
|
| — v2 (Sprint 13.–31.07.) — | | | |
|
||||||
|
| 22. Public-API & Webhooks | 0/TBD | Not started (v2) | - |
|
||||||
|
| 23. Postfach-Sync (Email-Inbox) | 0/TBD | Not started (v2) | - |
|
||||||
|
| 24. Self-Service-Billing & Onboarding-Wizard | 0/TBD | Not started (v2) | - |
|
||||||
|
| 25. MCP-Server | 0/TBD | Not started (v2) | ersetzt alten HiveMind/RAG-Slot |
|
||||||
|
| 26. Customer-Portal ⭐ | 0/TBD | Not started (v2, ex-P18) | - |
|
||||||
|
| 27. Mobile-PWA-Ausbau | 0/TBD | Not started (v2) | - |
|
||||||
|
| 28. Plattform-Admin-Tiefe | 0/TBD | Not started (v2) | - |
|
||||||
|
| 29. Help-Center & Help-Desk | 0/TBD | Not started (v2) | - |
|
||||||
|
| 30. Dashboard-Deluxe & Querschnitt | 0/TBD | Not started (v2) | - |
|
||||||
|
| 31. DSGVO-Vollausbau | 0/TBD | Not started (v2) | - |
|
||||||
|
| 32. KWP-Integration (Recut) | 0/TBD | Block 2 — API-Zugang ~20.07. | - |
|
||||||
|
| 33. Telefonie-Erweiterung (HalloPetra) | 0/TBD | Block 2 — Spec offen | - |
|
||||||
|
| 34. HR-Drittanbieter-Onboarding | 0/TBD | Block 2 — Spec offen | - |
|
||||||
|
|
||||||
|
---
|
||||||
|
*Roadmap erzeugt: 2026-06-07 via /gsd:new-project (Stufe 2 — Phasenstruktur). Revidiert: 2026-06-07 — 14 → 21 Phasen (dicke Buckets aufgeteilt: Automation/KI, Kommunikation, HR/Portal, Plattform/Launch; Querschnittsdienste in Plumbing + Files/Tasks). 109/109 v1-Requirements gemappt. Bau-Reihenfolge nach AD-11; Go-Live Big-Bang nach AD-19.*
|
||||||
|
*Revidiert: 2026-06-10 nach Dependency-Audit (61 Vorwärts-Verletzungen geprüft) — Service-Kerne M001/M003/M006/M011 von P3 → P1 (P3 umbenannt zu „Querschnitts-Oberflächen"), M074 → P10, M031–M033 → P19; Deps von P4/P5/P19 auf Phase 2 gelockert.*
|
||||||
|
*Revidiert: 2026-06-10 (zweiter Pass) — Dependency-Inversion vollständig: M049 → P8 (einziger echter Entity-Move); alle 40 verbleibenden Vorwärts-Refs per Retro-Integrations-Ownership invertiert (Register + Extension-Point-Pflichten + Audit-Kontrakt in PHASE-SOURCES.md). 0 unaufgelöste Vorwärts-Abhängigkeiten.*
|
||||||
|
*Revidiert: 2026-06-11/12 — **Scope-Schnitt v1/v2** (10 Entscheidungs-Blöcke, Historie in SCOPE-V1-CUTS.md): v1 = 146 MS / 94 Reqs; 30 MS → v2 (Mobile→PWA-Ausbau, Portal, Postfach-Sync, Public-API, Help, HiveMind/Whisper, HalloPetra, Wizard-UI, Dashboard-Deluxe, Admin-Teile, M166). P18 deferred, P21 umbenannt. Neu: Entitlement-Gate-Pflicht (Konnektor je Modul, P1-Contract) + M154-Recut „Abo-Baukasten" (Legacy-Referenz pricing-plans.ts: Core/Swarm/Colony). AD-5 sequenziert, AD-17/AD-18 revidiert.*
|
||||||
|
*Revidiert: 2026-06-12 — **Scope-Schnitt #11 (Boilerplate-Recheck):** v1 = 141 MS / 93 Reqs; M027 (API-Keys), M029 (Sprach-Wechsler — v1 DE-only), M038/M039 (getrennte AdminUser-Identität — v1 = Boilerplate-Modell mit Auflagen: kein Tenant-Workspace, admin.hivegrid.de-Host-Routing + Cookie-Trennung, TOTP-Pflicht), M117 (Bündelung/Quiet-Hours) → v2. Dünnungen: M028, M035, M054 (HEIC→JPG bleibt Pflicht), M055, M147 (feste Rollen-Layouts), M152. Stale-Fixes: P11/P13/P14-Übersichtszeilen, URL-Schema Portal = Pfad gemäß INTEGRATION-CONTRACTS §6.*
|
||||||
|
*Revidiert: 2026-06-12 (dritter Pass) — **Scope-Schnitt #12:** v1 = **133 MS / 90 Reqs**, v2 = 43 MS. **P10 KWP komplett → v2 als ERSTES v2-Modul** (Kalender-Realität: API-Zugang ~19.07. > Launch ~10.07.; Callback-URL gemeldet, bnWin.net 8.1 N3 angestoßen, Andockpunkte bleiben). Dünnungen: M030 (nur Hell/Dunkel), M070 (Lagerist → v2), M122 (personalisierte Links/JS-Snippet → v2), M160 (KI-Walkthrough → v2). M129 bleibt explizit voll. Inversions-Register 31→28 (KWP-Inversionen wandern mit v2-Owner).*
|
||||||
|
*Ergänzt: 2026-06-15 — **v2-Phasen ausgebaut (Phase 22–34, GSD-Format).** Die 43 v2-Milestones thematisch zu 13 Phasen geschnitten (Coverage 43/43), Detail-Fassung in `.planning/ROADMAP-V2.md`. Block 1 (22–31) sofort baubar; Block 2 (32 KWP / 33 HalloPetra / 34 HR-Drittanbieter) ans Ende — „Partner-API-Vertrag offen", agil vorziehbar. Dependencies geprüft: keine Vorwärts-Abhängigkeiten (KI-Coach→Wizard und Help→RAG-Korpus per Retro-Integration aufgelöst). Bei den „phase:1"-Modulen (26/28/29/30) ist nur das v2-Delta verplant, nicht das v1-Fundament. HalloPetra (M105) + Memberspot/Boobora (M138) sind in keiner Spec → Vorlauf-Spec nötig.*
|
||||||
Binary file not shown.
@@ -0,0 +1,187 @@
|
|||||||
|
# Scope-Verengung v1 — Cut-Log (laufende Entscheidungen)
|
||||||
|
|
||||||
|
**Begonnen:** 2026-06-11 · Wird am Ende der Streich-Session in einem Batch propagiert (ROADMAP, REQUIREMENTS, PHASE-SOURCES, SPRINT-4W, EXTERNALS, Report).
|
||||||
|
|
||||||
|
**Definition v2 (User, verbindlich):** *„v2 ist alles, was gemacht werden MUSS, aber halt erst in der v2."* → v2 = committed Scope, nur sequenziert. Kein Streichen, kein Vielleicht-Backlog. Nach v1-Launch wird v2 regulär geplant (eigene Phasen).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Cut #1 — Mobile-Store-App → v2 (2026-06-11) · ⚠ Tech-Teil „Expo" überholt durch #14 (PWA-only)
|
||||||
|
|
||||||
|
- **Raus aus v1:** M167–M171 (P21: 15 → 10 MS) · REQ-mobile-capacitor, REQ-mobile-offline-sync, REQ-mobile-push → v2
|
||||||
|
- **Tech-Entscheidung:** ~~v2-App mit Expo (React Native) statt Capacitor~~ → **überholt durch Entscheidung #14 (16.06.): PWA-only, kein Expo/Capacitor.** M36-Spec auf PWA recutten; M167–M171 bei v2-Planung als PWA-Ausbau neu schneiden
|
||||||
|
- **Bleibt v1-Pflicht:** Monteure via **PWA/responsive Web** — (a) mobile-first für Monteur-Screens (Plantafel, Abnahme, Auftrag, Tasks, Foto), (b) Mobile-Viewport im Visual-Reg-Gate (P1), (c) P9-Offline (Plantafel/Abnahme) unverändert. AD-17-*Absicht* bleibt erfüllt; native Hülle = v2
|
||||||
|
- **Expo-Readiness jetzt (gratis):** P9-OfflineSyncQueue als pures TS mit Storage-Interface (Web: IndexedDB / Expo: SQLite) · P1-Push-Kanal-Stub bleibt · P21-Public-API perspektivisch VM-förmige Endpoints
|
||||||
|
- **Externals:** A3 Apple ✅ **Konto bereits vorhanden** · A4 Google Play → v2-Vorbereitung, unkritisch · B7 FCM/APNs → v2
|
||||||
|
- **AD-Wirkung:** AD-17 revidiert (Offline v1 via PWA; native App v2/Expo) — **⚠ weiter revidiert durch Entscheidung #14 (16.06.): PWA-only in v1 UND v2; Expo/Capacitor/App-Store komplett verworfen; native → frühestens v3.**
|
||||||
|
|
||||||
|
## Cut #2 — Customer-Portal (P18) → v2 (2026-06-11)
|
||||||
|
|
||||||
|
- **Raus aus v1:** M141–M146 (P18 komplett, −6 MS) · REQ-portal-datenmodell, REQ-portal-auth-magic-link, REQ-portal-projekt-sicht → v2
|
||||||
|
- **Mitwandernde Retro-Integrationen (→ v2):** Theme→Portal (`M141→M030`, war P20-Aufgabe) · Portal-DSGVO-Löschung (`M146→M165`, war P21-Aufgabe)
|
||||||
|
- **Bleibt v1 (kostenlos, für friktionsfreies v2-Andocken):** P4-Portal-Upload-Vorbereitung (FileEntityLink) · `portal.hivegrid.de` im P1-URL-Schema
|
||||||
|
- **Sprint-Wirkung:** Dev C in W4 deutlich entlastet (P16 → ~~P18~~ → P21)
|
||||||
|
- **AD-Wirkung:** AD-18 revidiert (Portal voll = v2)
|
||||||
|
|
||||||
|
## Entscheidung #3 — USP-Säulen (2026-06-11)
|
||||||
|
|
||||||
|
- **P12 Automation: bleibt VOLL** („wir brauchen dringend Automation") — inkl. Editor, Dry-Run, 24h-Undo, Guards, Klartext-Logs (Bauprinzipien A.10/LP-10 unangetastet). Trigger/Action-Library skaliert automatisch mit v1-Modulen (Dependency-Inversion) — v2-Modul-Trigger registrieren sich in v2 nach.
|
||||||
|
- **P13 KI: OFFEN** — Dünnungs-Kandidaten (HiveMind/RAG→v2 inkl. pgvector-Synergie in P11, Whisper→v2, AlephAlpha→v2, Pay-as-you-go-Verdrahtung→v2) notiert, keine Entscheidung. Sprach-zu-Automation + Gateway + Promptfoo bleiben in jedem Fall.
|
||||||
|
|
||||||
|
## Entscheidung #4 — Email-Marketing: bleibt VOLL (Option A, 2026-06-11)
|
||||||
|
|
||||||
|
- **M100–M104 bleiben komplett in v1** (Kampagnen-Builder, Segmente, Versand-Engine, A/B+Reporting, Unsubscribe/Bounces). Bestätigt die ursprüngliche User-Hochstufung in der Spec („Phase-1-Voll-Modul — kritisch für Launch, löst HubSpot-Marketing-Hub ab", LP-7).
|
||||||
|
- **Konsequenz 1 — P14-Email-Hälfte:** Die **Versand-Infrastruktur muss in v1 bleiben** (TenantSendingDomain + Verifizierung, Mailjet-Anbindung — Marketing-Spec setzt verifizierte Sending-Domain aus M9 voraus). Der Dünnungs-Kandidat bleibt nur der **Gmail/Outlook-OAuth-Postfach-Sync** (M096/M097: Inbox-View, Threading) → Entscheidung offen.
|
||||||
|
- **Konsequenz 2 — External A6 steigt in der Priorität:** Domain-Warm-up/Reputation ist bei Massen-Kampagnen (Tagesbudget 10K) kritisch — SPF/DKIM/DMARC + Warm-up ab Tag 1 zwingend.
|
||||||
|
|
||||||
|
## Entscheidung #5 — KI-Tiefe (P13) entschieden (2026-06-11)
|
||||||
|
|
||||||
|
- **Sprach-zu-Automation (M086): bleibt v1 — EXKLUSIV im Automation-Kontext.** Wird als Feature des Flow-Editors gebaut (direkte DB-Existenzprüfungen, kein RAG), NICHT als HiveMind-Fähigkeit. Architektur-Vorgabe: keine Kopplung an HiveMind, damit v2-HiveMind die Automation nie blockiert oder übernimmt.
|
||||||
|
- **HiveMind/RAG (M087): → v2 — v1 baut die Andock-Adapter:** (a) Outbox-Index-Events (existiert via P11-Indexer), (b) `RetrievalProvider`-Interface im KI-Unterbau, (c) Bestätigungs-Grenze („KI schreibt nie ohne User-OK") entsteht v1 via M086 und wird von HiveMind geerbt. REQ-ki-hivemind + REQ-ki-rag-embeddings → v2.
|
||||||
|
- **Whisper: → v2** (REQ-ki-whisper). „Cool, aber aktuell nicht nötig."
|
||||||
|
- **Unterbau bleibt v1:** M083 Gateway, M084 Multi-Provider-Fallback, M085 Promptfoo, M088 Token-Limits (Pay-as-you-go-Abrechnung weiterhin per Inversion → P20/v2; lokales Credits-Konto bleibt).
|
||||||
|
- **Folge-Entscheidung:** P11-Suche bleibt Keyword-only (Meilisearch); pgvector/Hybrid-RRF/HiveMind entfällt nach AD-26 bzw. ruht als v3-Kandidat. REQ-suche-hybrid ist entsprechend auf Meilisearch gedünnt.
|
||||||
|
|
||||||
|
## Entscheidung #6 — Keep-Entscheidungen (2026-06-11)
|
||||||
|
|
||||||
|
- **Team-Chat (M110–M114): bleibt v1** — „ultra wichtig". WebSocket-Layer (AD-9) damit ebenfalls v1.
|
||||||
|
- **HR-Hub (M133–M140): bleibt v1 komplett** — „genau wie HR".
|
||||||
|
- **Booking + Kalender-Sync (M118–M120, M126–M129): bleiben v1** („und ähnliches" → Signatur M130–M132 vermutlich auch — Bestätigung ausstehend).
|
||||||
|
- **Legacy-Provider (M153–M156): bleibt v1.** ⚠ Offen: Rücksprache mit Partner zu **pauschalem Pricing** — falls pauschal, dünnt M156 (Metering nur als Datensammlung, keine Aufschlags-Abrechnung; Seat-Quota-Logik vereinfacht).
|
||||||
|
- **Konsequenz Externals:** Google-OAuth-Verifizierung (A2) bleibt im Sprint relevant (Kalender-Lesepfad braucht Calendar-Scope!), Legacy-Provider-Live (A5) bleibt, PandaDoc (B4) bleibt (falls Signatur bestätigt).
|
||||||
|
|
||||||
|
## Entscheidung #7 — Kommunikation & Billing-Modell (2026-06-11)
|
||||||
|
|
||||||
|
- **Mail-Inbox/Postfach-Sync → v2:** M096-OAuth-Teil, M097 (Inbox/Threading/Auto-Verknüpfung), M098-Provider-Versand, M099-Teile → v2. **Bleibt v1:** Sende-Domain-Verifikation (aus M096 herausgelöst), Mailjet-Versand, Bounce/Sperrliste (Marketing-Anteil), Inbound-Adresse→Lead. **Empfohlen (klein, ~½ MS): BCC-Logging-Brücke** (`crm@tenant…` als BCC → Mail wird am Kontakt protokolliert, nutzt Inbound-Infrastruktur, kein Google-OAuth). → **Google-Verifizierung (A2) nur noch für Kalender-Scopes nötig, Gmail-Scopes raus.**
|
||||||
|
- **Telefonie bleibt v1** (AirCall M106–M109, Anruf-Trigger für Automation). ⚠ **~~inkl. HalloPetra~~ überholt durch #10:** HalloPetra (M105) → v2 (Phase 33). AirCall bleibt v1.
|
||||||
|
- **Marketing bleibt voll** (Re-Bestätigung von #4).
|
||||||
|
- **Legacy-Provider: einheitliches Billing** — keine Büro-/Monteur-**Seat**-Unterscheidung mehr (M154 kollabiert; Interpretation „Seats" vom User rückbestätigen lassen — NICHT die SHK-Seeds!). Varianten-Entscheidung (pro Nutzer einheitlich / pauschal pro Mandant / Größenstaffel) liegt beim Partner-Gespräch. M156-Aufschlags-Billing entfällt; Verbrauchs-Counter + Fair-Use-Drossel bleiben als Kostenschutz.
|
||||||
|
|
||||||
|
## Entscheidung #8 — Abschluss der Streich-Session (2026-06-11)
|
||||||
|
|
||||||
|
- **Signatur (M130–M132): bleibt v1** (bestätigt — war Teil von „Booking, Kalender und ähnliches").
|
||||||
|
- **Onboarding-Wizard-UI (M157): → v2.** Seeds (M158) + Demo-Daten (M160) bleiben; Branchen-Framework (M159) v1 nur SHK. Signup → Auto-SHK-Seed ohne Wizard.
|
||||||
|
- **Billing-Modell final: „Abo-Baukasten"** — Basis-Preis pro Nutzer (keine Seat-Typen) + Feature-Module als zubuchbare Legacy-Provider-Positionen. **M154-Recut:** Seat-Typ-Modell ersetzt durch Entitlement-Schicht = Feature-Flag-Engine (P1) × `packages/entitlements` × daten-getriebene Legacy-Provider-Items (M153). **v1 = Mechanik** (Admin stellt Tenant-Abos in P19 zusammen), **v2 = Self-Service-Baukasten-UI** (Kunde toggelt Features mit Preis-Vorschau). **Kostenmatrix** = Business-Aufgabe mit Partner, blockt Bau nicht (AD-15). Zähler + Drossel bleiben v1; Extra-Usage-Abrechnung wird separat besprochen (offen, blockt nicht).
|
||||||
|
|
||||||
|
## Entscheidung #9 — Konnektor-Pflicht + Legacy-Plan-Referenz (2026-06-11)
|
||||||
|
|
||||||
|
- **Konnektor-Pflicht pro Feature (v1, hart):** Jedes Modul ist eigenständig enable-/disable-bar und plan-gebunden schaltbar. Wird **neuer Integration-Contract in P1** („Entitlement-Gate-Pflicht": Modul registriert Gate, Sidebar/Routes/Actions prüfen `tenantHasModule()`), Pflicht-Checkpunkt jeder Modul-Phase. Mechanik: Boilerplate-Flag-Engine (hat bereits `plan-tier`-Targeting!) × `packages/entitlements` × Legacy-Provider-Items.
|
||||||
|
- **Legacy-Plan-Namen gefunden:** **Core / Swarm / Colony** (D006, 29€/49€/Contact-Sales pro Seat) in `~/Documents/GitHub/archive/hivegrid-cloud/app/config/pricing-plans.ts`. Datei enthält komplette Konnektor-Blaupause: 14 gegatete Module, 6 Quota-Dimensionen (inkl. aiTokensPerMonth), 6 Plan-Flags. **→ Als Source-Spec für den P20-Recut (M154→Abo-Baukasten) übernehmen**; Struktur portieren, Inhalte (Preise/Tiers vs. À-la-carte) = Kostenmatrix-Gespräch mit Partner.
|
||||||
|
|
||||||
|
## Entscheidung #10 — Feature-Tiefe-Runde (2026-06-11)
|
||||||
|
|
||||||
|
**→ v2:** Public-API (M161–163) · Help-Center+Help-Desk (M172–175; Minimal-FAQ + Feedback→Admin-Inbox bleiben) · Dashboard Custom-Widgets+Export (M149, M150; 7 Standard-Widgets bleiben) · Plattform-Lead-Pipeline (M040) + Flag-Massen-Statistik (M033) · HR-Drittanbieter-Onboarding Memberspot/Boobora (M138) · HalloPetra (M105; **AirCall bleibt v1**) · Kalender: **Outlook → v2, Google bidirektional v1** (halbiert Verifizierungs-Risiko)
|
||||||
|
|
||||||
|
**Gedünnt (Modul bleibt):** Sales-Analytik → Basis-KPIs (Forecast/Stage-Conversion-Tiefe v2) · Booking: eine Zuteilungs-Strategie („Erster der frei ist"), Round-Robin/Endkunde-wählt v2
|
||||||
|
|
||||||
|
**Explizit BEHALTEN (User):** Mitarbeiter-Surveys (HR) · Conditional Logic (Forms) · Chat komplett (inkl. Threads/Reactions/Pins) · CRM komplett (inkl. Bulk-Merge-Tool) · Marketing inkl. A/B (Option A bestätigt)
|
||||||
|
|
||||||
|
**Offen:** DSGVO-Auskunft (M166) — Detail-Erklärung angefordert, Entscheidung ausstehend.
|
||||||
|
|
||||||
|
**Bilanz nach #10: v1 ≈ 147 Milestones** (−13 ganze + Dünnungen) ≈ 2,45 MS/Dev/Tag — erstmals echter Puffer.
|
||||||
|
|
||||||
|
## FINALER SCHNITT (alle Entscheidungen getroffen)
|
||||||
|
|
||||||
|
**→ v2 (committed, sequenziert):** Mobile-PWA-Ausbau (PWA-Recut, M167–171; Expo/Capacitor verworfen — AD-17) · Customer-Portal (M141–146) · HiveMind/RAG (M087) + Whisper + pgvector/Hybrid-Suche · Postfach-Sync (M096-OAuth/M097/M098; Domain-Verifikation bleibt) · Onboarding-Wizard-UI (M157) · Self-Service-Abo-Baukasten-UI · AlephAlpha-Provider · Pay-as-you-go-Abrechnung
|
||||||
|
|
||||||
|
**Bleibt v1 (User-Entscheidung):** komplette Kern-Kette P1–P10 · Suche (Keyword) + Dashboard · Automation VOLL · KI-Unterbau + Sprach-zu-Automation (exklusiv Automation) · **Marketing voll** · **Telefonie (AirCall) voll** ~~(inkl. HalloPetra)~~ *(überholt durch #10: HalloPetra/M105 → v2, Phase 33)* · **Team-Chat voll** · **HR voll** · Booking + Kalender + Forms + **Signatur** · Legacy-Provider (Abo-Baukasten-Mechanik) · Plattform-Admin · Seeds + Demo-Daten
|
||||||
|
|
||||||
|
**Bilanz: v1 ≈ 160 Milestones** (–16 vs. 176) ≈ 2,7 MS/Dev/Tag — weiterhin straff; Gates + neue Notfall-Leiter zwingend. Verbleibende harte Externals: **KWP, Google (nur noch Calendar-Scopes), Legacy-Provider-Live, PandaDoc/DocuSign, AirCall/HalloPetra, Mailjet-Domain-Warm-up.**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Laufende Bilanz
|
||||||
|
|
||||||
|
| | v1-Milestones | v1-Requirements | W4-Last (Dev C) |
|
||||||
|
|---|---:|---:|---|
|
||||||
|
| Start | 176 | 109 | P16-Rest + P18 + P21(15) |
|
||||||
|
| nach Cut #1+#2 | **165** | **103** | P16-Rest + P21(10) |
|
||||||
|
|
||||||
|
## Externals-Änderungen
|
||||||
|
|
||||||
|
- A3 Apple Developer: ✅ vorhanden (User-Info 2026-06-11)
|
||||||
|
- A4 Google Play, B7 FCM/APNs: → v2-Vorbereitung, nicht sprint-kritisch
|
||||||
|
|
||||||
|
## Noch zu diskutieren (🟢-Kandidaten aus der Gesamtliste)
|
||||||
|
|
||||||
|
- [ ] Team-Chat (P15-Hälfte, 5 MS) — Quiply existiert
|
||||||
|
- [ ] HR-Hub (P17, 8 MS)
|
||||||
|
- [ ] Marketing (P14-Hälfte, 5 MS)
|
||||||
|
- [ ] Public-API + Help-Center/Desk (P21, 7 MS)
|
||||||
|
- [ ] Booking / Signatur / Kalender-Sync (P16-Teile, 10 MS)
|
||||||
|
- [ ] Billing/Legacy-Provider + Onboarding-Wizard (P20-Teile, ~7 MS)
|
||||||
|
- [ ] USP-Tiefe P12/P13 (RAG/HiveMind/Whisper dünnen?)
|
||||||
|
|
||||||
|
## Entscheidung #11 — Boilerplate-Recheck-Runde (2026-06-12)
|
||||||
|
|
||||||
|
Basis: historischer Sweep über die inzwischen entfernten Boilerplate-Mapping-Reports + Code-Stichproben. Erkenntnis: Boilerplate-HIGH-Coverage-Milestones (Auth, Billing, i18n, Mail, Worker, Impersonation) NICHT cutten — fast geschenkt. Geschnitten/gedünnt werden die teuren Spec-Deltas.
|
||||||
|
|
||||||
|
**→ v2 (5 ganze Milestones):**
|
||||||
|
- **M027 API-Keys & Tarif-Gates** — Public-API ist v2; Keys ohne Endpoints sinnlos. Boilerplate-`ApiKey`-Modell + Routen bleiben ungenutzt im Code liegen (Vorbereitung gratis). Lead-Push von Fremd-Websites läuft über M047-Quellen-Token, nicht über API-Keys.
|
||||||
|
- **M038 + M039 (getrennte AdminUser-Identität/AdminRBAC)** — v1 = Boilerplate-Modell (User-Extension + MFA-Step-up). **Auflagen in M034:** TOTP-Pflicht hart · Admin-User bekommen **keinen Tenant-Workspace** (Boilerplate-Default abschalten!) · Host-Routing `admin.hivegrid.de` (Code routet bisher `/admin`-Pfad) · **Cookie-Domain-Trennung** App↔Admin.
|
||||||
|
- **M117 Notification-Bündelung/Quiet-Hours/Push-Limits** — bewusst v2 (User-Entscheidung). v1: Sofort-Zustellung + Center (M115) + Kategorie-An/Aus (M116).
|
||||||
|
- **M029 Sprach-Wechsler/Fallback** — v1 = **DE-only**. Hart: i18n-Pflicht-Wiring (M003) + `verify:i18n`-CI-Gate unantastbar — alles i18n-ready, v2 = Locales + Wechsler andocken ohne Refactoring.
|
||||||
|
|
||||||
|
**Gedünnt (Modul bleibt):**
|
||||||
|
- **M028:** DE-only-Defaults (Auflösungskette/Timezone-Prefs → v2)
|
||||||
|
- **M054:** Datei-Versionierung + Office-/Video-Previews + Resume-Upload → v2; **HEIC→JPG-Konvertierung bleibt Pflicht** (iPhone-Fotos der Monteure!), Bild-/PDF-Preview bleibt
|
||||||
|
- **M055:** OCR/Inhalts-Volltext → v2; Dateiname+Tags via Meilisearch + Archiv-Flag bleiben
|
||||||
|
- **M147:** 3 feste Rollen-Layouts (GF/Büro/Monteur) statt Drag&Drop-Grid (react-grid-layout wäre Neueinkauf); Widget-Registry bleibt (Inversion `M064→M147` braucht sie)
|
||||||
|
- **M152:** fixe Default-Retention + direkter CSV/PDF-Export; konfigurierbare Policy/Legal-Hold/Saved-Views → v2
|
||||||
|
- **M035:** Boilerplate-KPIs (Tenants/User/MRR); Churn/ARPU/Health-Kacheln → v2
|
||||||
|
|
||||||
|
**Beifang — Doku-Drift korrigiert:** EXTERNALS-C5 + P18-Note listeten Portal/Forms/Booking/Help/API als Subdomains — `INTEGRATION-CONTRACTS.md` §6 (Quelle) definiert sie als **Pfade unter `app.hivegrid.de`**; einzige zweite Subdomain ist `admin.hivegrid.de`. Ferner stale Stellen aus #5 gefixt (ROADMAP-P11-Übersicht „pgvector-Hybrid", REQ-suche-Texte).
|
||||||
|
|
||||||
|
**Bilanz nach #11: v1 = 141 MS / 93 Reqs / v2 = 35 MS** ≈ 2,35 MS/Dev/Tag (effektiv ~2,3 mit Dünnungen).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ PROPAGIERT (2026-06-12)
|
||||||
|
|
||||||
|
Alle 10 Entscheidungs-Blöcke in einem Batch propagiert: ROADMAP.md (P18 deferred, P21 umbenannt, 9 Phasen umgeschnitten, Konnektor-SC in P1, Recut-Notes M36→Expo + M154→Abo-Baukasten) · REQUIREMENTS.md (15 REQs → v2, 94 v1, Traceability/Verteilung neu) · PHASE-SOURCES.md (v2-Sektion 30 MS, Register 40→31, Konnektor-Contract) · SPRINT-4W.md (Rewrite: 146 MS, neue Notfall-Leiter, Externals) · EXTERNALS-CHECKLISTE.md (A2 nur Calendar, A3 ✓, 6 Einträge → v2, E6 AVV neu) · PROJECT.md (AD-5 sequenziert, AD-6/7 gelockt, AD-17/18 revidiert) · Report-PDF neu.
|
||||||
|
**Verifiziert:** 146 v1 + 30 v2 = 176 ✓ · Traceability 94 ✓ · Inversions-Register 31/31 deckungsgleich, 0 unaufgelöst, 0 stale ✓
|
||||||
|
|
||||||
|
## ✅ PROPAGIERT Batch #11 (2026-06-12, Boilerplate-Recheck)
|
||||||
|
|
||||||
|
M027/M029/M038/M039/M117 → v2 (v1 = 141, v2 = 35) · Dünnungen M028/M035/M054/M055/M147/M152 als Notes in PHASE-SOURCES/ROADMAP/REQUIREMENTS · REQ-auth-api-keys → v2 (93 v1-Reqs) · URL-Schema-Drift C5/P18 bereinigt · stale pgvector-Reste gefixt.
|
||||||
|
|
||||||
|
## Entscheidung #12 — Abschluss-Runde (2026-06-12)
|
||||||
|
|
||||||
|
**P10 KWP-Integration KOMPLETT → v2 (−8 MS: M074, M089–M095; −3 Reqs).** Auslöser: **Kalender-Realität** — KWP-Mail (an Noah) bestätigt: API-Zugang kommt erst ~**19.07.**, v1-Launch ist ~10.07. Das W3-Gate „KWP-Kette E2E" wäre nie haltbar gewesen; Mock-Bau gegen Doku = Schema-Drift-Risiko. **KWP bleibt USP und wird ERSTES v2-Modul** (Geerkens hat den Sync ~2–3 Wochen nach Launch). Sofort-Aktionen (kosten nichts, beschleunigen v2): (a) **Callback-URL an KWP melden**: `https://app.hivegrid.de/integrations/kwp/oauth/callback` (+ Staging intern; eine feste URL, Tenant im `state`), (b) **kwp-bnWin.net auf 8.1 N3** bei Geerkens-IT, (c) Andockpunkte bleiben v1 (Apps-Engine P5, Extension-Points Auftrag/Abnahme/Material). v1-Kern-Kette endet bei Auftrag; Doppelerfassung für ~2–3 Wochen akzeptiert.
|
||||||
|
|
||||||
|
**Dünnungen:**
|
||||||
|
- **M160:** KI-Walkthrough → v2 („hat nichts in v1 zu suchen"; gehört zum Wizard M157 = eh v2). Demo-Daten-Seed bleibt (Knopf in Settings statt Wizard-Schritt), einfaches Löschen statt Multi-Step-Bulk.
|
||||||
|
- **M122:** personalisierte Links (Tracking/Ablauf/Limit) + JS-Snippet → v2; öffentliche URL + QR + iFrame-Embed bleiben.
|
||||||
|
- **M070:** Lagerist-Sicht + Material-Ausgangs-Doku → v2; Material-Listen am Auftrag bleiben (KWP-Daten folgen mit v2-P10). **Noah-Frage auf E-Liste:** gehört der Lager-Arbeitsplatz zum Validierungs-Versprechen?
|
||||||
|
- **M030:** nur Hell/Dunkel-Toggle — **kein System-Modus** (User-Entscheidung; weniger Testfläche). Capacitor-Teil stirbt durch Mobile-Cut.
|
||||||
|
|
||||||
|
**Explizit voll behalten:** M129 (Booking-Verwaltung inkl. Verschiebung/Re-Assignment/No-Show — „lassen wir so, wie er vorher war").
|
||||||
|
|
||||||
|
**Bilanz nach #12: v1 = 133 MS / 90 Reqs / v2 = 43 MS** ≈ 2,2 MS/Dev/Tag. Notfall-Leiter: „NIEMALS opfern" = P1–P9. W4 massiv entlastet (Dev A frei für E2E-Härtung).
|
||||||
|
|
||||||
|
## Entscheidung #13 — Modell-Pivot: Projekt-zentrisch (2026-06-13)
|
||||||
|
|
||||||
|
Auslöser: Davids (UX) konsolidiertes CRM/Pipeline-Briefing wird zur Bau-Grundlage gemacht — Raffael richtet die Planung daran aus (statt David einzunormen). **Voll adoptiert.** Anker: `.planning/ENTITY-MODEL.md`. Neu: **AD-20**; **AD-2** + **AD-11** revidiert.
|
||||||
|
|
||||||
|
- **E1 — Architektur (voll adoptiert):** Deal + Auftrag verschmelzen zu EINEM `Projekt`-Kern; Pipelines = frei konfigurierbare Views; „Deal"/„Auftrag" = Pipeline-Typen, keine eigenen Entitäten. Ein Projekt = genau eine Pipeline; `Status` pipeline-intern (kein globaler Projektstatus). Admin steuert pro Pipeline: Zugriff, Feld-Sichtbarkeit, Pflichtfelder/Status, Statuswerte (Pipeline-Feld-Config-Layer). Betrifft P6–P9, ENTITY-MODEL, SCREEN-MAP (Sales-Kanban + Projekt-Kanban → ein konfigurierbarer Kanban).
|
||||||
|
- **E2 — Abnahme bleibt v1:** als Checklisten/Protokoll-Sub-Area am Projekt (Mängel = Checkliste), nicht eigenes Modul. Eigenschaften bleiben (rechtlich bindend, immutable, 6 J., Touch-Signatur, offline). **→ v2-Backlog:** Materialbedarf, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets.
|
||||||
|
- **E3 — Rechnung = neues Sub-Entity v1** am Projekt (Liste/Anlegen/Verknüpfen). *Einziger echter v1-Scope-Zuwachs durch den Pivot.*
|
||||||
|
- **E4 — Lead-Flow:** Lead/LeadInput → Projekt (Datenpunkt `Weiterverarbeitungsfreigabe` Ja/Nein/Unklar). Das bisherige Lead→Contact-Promotions-Modal (REQ-crm-lead-promotion) entfällt; Kontakt wird separat verknüpft.
|
||||||
|
- **Kontaktmodell:** `Kontakt` = Oberbegriff mit `Kontakttyp` (Privatperson/Organisation), `Kontaktstatus` (Kontakt/Kunde/Bestandskunde), `Kontaktart` (Haupt-/Sekundärkontakt als Rolle/Relation). Zwei Listen (Unternehmen/Organisationen + Kontakte).
|
||||||
|
- **KWP:** unverändert v2; v1 nur Feld-Halter/Extension-Point (kein Sync-UI).
|
||||||
|
|
||||||
|
**MS/Reqs-Bilanz (neu gezählt 16.06. — R-REFIT):** Reqs **= 90 v1 unverändert** — REQ-crm-lead-promotion entfällt (−1), REQ-rechnung-sub-entity NEU (+1), Sales/Projekt-Reqs zu „Projekt & Pipelines" konsolidiert (Netto 0). Milestones **= 176** (133 v1 / 43 v2) — die P6–P9-Milestones (M01–M04) sind **inhaltlich** projekt-zentrisch re-gemappt (Deal+Project → ein `Projekt`-Kern; Rechnung-Sub-Entity ergänzt; Lead→Projekt statt Promotion), die Milestone-Bezeichner bleiben als Datei-Referenz erhalten — keine Stück-Zahl-Änderung, nur Re-Map (Detail in PHASE-SOURCES.md P8/P9).
|
||||||
|
|
||||||
|
**Status (15.06.):** ✅ ER-Modell **APPROVED & LOCKED** — `ENTITY-MODEL.md` (Kern auf Projekt-zentrisch umgeschrieben, übrige Domänen erhalten), `entity-model.dbml` (kanonisch) + `entity-model.svg` (Diagramm) + `ENTITY-MODELL-ERKLAERUNG.pdf` (Laienfassung). Decisions (PROJECT/ARCHITECTURE-DECISIONS AD-20), ROADMAP (P6–P9), STATE propagiert. Scratch gelöscht. **Offen:** Detail-Re-Fit von REQUIREMENTS/PHASE-SOURCES/SCREEN-MAP gegen das gelockte Modell (+ MS/Reqs-Neuzählung).
|
||||||
|
|
||||||
|
## Entscheidung #14 — Mobile: PWA-only in v1 UND v2 (2026-06-16)
|
||||||
|
|
||||||
|
**Auslöser (User):** „Wir bauen in v1 und v2 nur die PWA. Noch keine Expo-Shenanigans — erstmal nur PWA." → der Mobile-Tech-Teil von Cut #1 (Expo in v2) wird zurückgenommen; es gibt **keinen nativen Client** im gesamten v1+v2-Scope.
|
||||||
|
|
||||||
|
- **Verworfen:** Expo/React-Native, Capacitor, native iOS/Android-App, App-Store-Einreichung (Apple + Google), TestFlight/interner Track, APNs/FCM-Push, Store-Compliance/Store-Metadaten/Store-Badges.
|
||||||
|
- **Bleibt/wird:** installierbare **PWA** — v1 mobile-first + Offline (P9); v2-P7 = **PWA-Ausbau** (Web-App-Manifest/Add-to-Homescreen, Service-Worker-Offline-Härtung, **Web-Push via VAPID**, Force-Update via SW-Versionierung). Der P1-Push-Kanal-Stub wird in v2 als Web-Push aktiviert.
|
||||||
|
- **M36 / M167–M171:** Recut auf PWA (kein EAS-Build, keine Native-Module, keine Store-Compliance).
|
||||||
|
- **Tickets:** VA-P27a/b + VD-3 → **PWA-Ausbau** umgewidmet; App-Store-Block (VEXT-4, VJ-1, App-Store-Teil von VD-6 / EXT-13 / VJ-3) → **v3-Backlog** (aus Cycle raus, `v3`-Label). Billing-„App-Store-konform"-Auflage (Apple 3.1.3) entfällt — Self-Service-Plan-Wechsel direkt im Web-Checkout.
|
||||||
|
- **Externals:** A3 Apple, A4 Google Play, B7 FCM/APNs, E5 App-Store-Metadaten → **v3 statt v2** (kein App-Store in v1/v2).
|
||||||
|
- **AD-Wirkung:** **AD-17** auf „PWA-only (v1+v2), kein nativer Client; native → frühestens v3" gesetzt; Scope-Muster-Note (AD-13/16/17/18) in ARCHITECTURE-DECISIONS angepasst.
|
||||||
|
- **Native → v3:** als Backlog vermerkt, nicht beauftragt.
|
||||||
Binary file not shown.
@@ -0,0 +1,206 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 14mm
|
||||||
|
css: |-
|
||||||
|
body { font-size: 10px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
|
||||||
|
h1 { font-size: 18px; } h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
|
||||||
|
h3 { font-size: 11.5px; margin-top: 14px; break-after: avoid; page-break-after: avoid; }
|
||||||
|
table { font-size: 8.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
|
||||||
|
thead { display: table-header-group; }
|
||||||
|
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
|
||||||
|
td, th { break-inside: avoid !important; page-break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; text-align: left; vertical-align: top; }
|
||||||
|
th { background: #fff7e8; }
|
||||||
|
li { break-inside: avoid; page-break-inside: avoid; }
|
||||||
|
p { orphans: 3; widows: 3; }
|
||||||
|
code { background: #f4f4f4; padding: 1px 3px; font-size: 8px; }
|
||||||
|
.pagebreak { page-break-after: always; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# SCREEN-MAP — HiveGrid 2.0 v1 (präzise Bau-Liste für David)
|
||||||
|
|
||||||
|
**Stand:** 12.06.2026 (nach Scope-Schnitt #12 + Infra-Wechsel) · **Quelle:** 36 Specs (requirements-pur) + TIMELINE-Deadlines + Playbook-Archetypen
|
||||||
|
**Regeln:** (1) Screens beschreiben WAS angezeigt wird — Layout/Anordnung ist Davids Freiheit. (2) Hot-Swap: kein Screen blockt den Dev-Bau; Deadlines = Demo-/Politur-Termine. (3) Pro Screen vor Übergabe: Reconciliation-Checkliste (Playbook §6a) — jedes Feld hat eine Datenquelle, jeder Button eine Aktion, 4 Zustände designt (leer/laden/Fehler/keine Berechtigung).
|
||||||
|
**Legende:** `[A2]` = aus Archetyp komponiert (Stunden) · **BESPOKE** = Sonder-UI (Tage) · 🌐 = öffentlich (höchster Polish) · 📱 = Monteur-mobile-first + offline
|
||||||
|
|
||||||
|
> 🔴 **MODELL-PIVOT (AD-20) — §2/§3/§4 nachgezogen 2026-06-16 (ENTITY-MODEL.md LOCKED):** Projekt-zentrisch. **Sales-Kanban + Projekt-Kanban → EIN konfigurierbarer Pipeline-Kanban** (Pipeline = View; „Deal"/„Auftrag" = Pipeline-Typen `typ_hint` sales/auftrag/custom, KEINE eigenen Entitäten). **Projekt-Detail** mit Sub-Areas (Kontakte, Termine, **Rechnungen [v1 NEU]**, Checklisten, Aufgaben, Aktivitäten, Dokumente). **KEIN Won-Handoff** (Projekt wechselt nur die Pipeline, kein zweiter Datensatz). **Lead → Projekt** bei Weiterverarbeitungsfreigabe (Lead-Promotion-Modal mit 4 Optionen entfällt; Kontakt separat verknüpft). **Abnahme** bleibt als immutable Checklisten/Protokoll-Sub-Area am Projekt (Mängel = Checkliste). Neuer **Pipeline-Config-Admin-Screen** (Zugriff/Feld-Sichtbarkeit inkl. **Field-Level-Rechte je Rolle/Gruppe/User** `PipelineFieldVisibility`/Pflichtfelder/Statuswerte je Pipeline). Kontaktmodell: Kontakttyp (Privatperson/**Organisation** — nicht „Unternehmen")/Kontaktstatus (Kontakt/Kunde/Bestandskunde)/Kontaktart=Rolle. **KWP komplett v2** (auch kein Feld-Halter v1). Die §2–§4-Tabellen sind nachgezogen; David finalisiert sein PDF gegen `.planning/ENTITY-MODEL.md`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## §0 BASELINE — Sprint D0 (Fertig: So 21.06.) — blockt ~70 % aller Screens
|
||||||
|
|
||||||
|
### 0.1 App-Shell (Archetyp A1) — wird von JEDEM Screen konsumiert
|
||||||
|
|
||||||
|
| Komponente | Muss enthalten |
|
||||||
|
|---|---|
|
||||||
|
| **Sidebar** | Modul-Navigation mit Icons + Labels · **Konnektor-Gating-Zustand** (Modul ausgeblendet/gesperrt je `tenantHasModule()`) · Sektionen: Arbeit (Dashboard, Kontakte, Leads, **Projekte** (eine Liste/Kanban über alle Pipelines, Pipeline-Switcher im Header), Plantafel, Aufgaben, Dateien, Kalender, Buchungen, Formulare, Chat, Telefonie, Marketing, HR) + Verwaltung (Settings, Admin) · Collapse-Zustand · aktiver Eintrag · Mobile: Drawer/Bottom-Nav-Variante 📱 |
|
||||||
|
| **Topbar** | Tenant-Switcher (Dropdown, Liste mit zuletzt-genutzt, Suchfeld ab 5 Tenants) · **Cmd+K-Suchfeld-Trigger** · Notification-Bell mit Unread-Badge · User-Menü (Profil, Settings, Hell/Dunkel-Toggle, Logout) |
|
||||||
|
| **Breadcrumb** | Pfad bis Entität (z. B. Projekte → Pipeline Heizung (Sales-Sicht) → P-2026-0042) |
|
||||||
|
| **Status-Banner-System** | Tenant-Status-Banner: `past_due` / `frozen` / `deletion_pending` / `suspended` — je eigener Text + Action-Button · stapelbar mit System-Hinweisen |
|
||||||
|
| **Toast/Inline-Feedback** | Erfolg / **Klartext-Fehler mit Lösungs-Knopf** (Bauprinzip A.1!) / Warnung |
|
||||||
|
|
||||||
|
### 0.2 Archetypen A2–A7 — einmal designen, überall komponieren
|
||||||
|
|
||||||
|
| # | Kit | Muss enthalten |
|
||||||
|
|---|---|---|
|
||||||
|
| A2 | **List-View-Kit** | Filterbar (Multi-Select, Datum-Range, Toggle-Chips) · Tabelle mit sortierbaren Headern · Karten-Alternative · Bulk-Select + Bulk-Action-Bar · Pagination (50/Seite) · Spalten-Konfiguration · CSV-Export-Button · Suchfeld · Archiviert-Toggle · Leerzustand mit CTA |
|
||||||
|
| A3 | **Detail-View-Kit** | Header mit Titel + Quick-Actions (Anrufen, Email, Termin, Task, Notiz) · Inline-Edit-Feld (Klick → Edit → Save/Cancel) · Related-Panels (verknüpfte Entitäten gruppiert) · **Activity-Stream-Komponente** (chronologisch, Typ-Icons, Filter) · Custom-Felder-Sektion (typ-abhängige Eingaben) · Tags-Zeile · Sub-Tabs |
|
||||||
|
| A4 | **Form/Input-Kit** | Alle 12 Feldtypen: Text, Textarea (Markdown), Zahl, Währung, Datum, Datum-Range, Select, Multi-Select, Boolean, Email, Telefon, Datei · Validierungs-Zustände + Klartext-Fehler · Auto-Complete-Picker (Kontakt/User/Entity) · Pflichtfeld-Markierung |
|
||||||
|
| A5 | **Modal/Wizard-Kit** | Einfacher Dialog · mehrstufiger Wizard mit Progress · Bestätigungs-Dialog (mit Confirm-Phrase-Variante für destruktive Aktionen) · Side-Panel/Drawer |
|
||||||
|
| A6 | **Settings/Connection-Kit** | Settings-Seitenlayout mit Sektionen · Toggle-Zeile mit Klartext-Beschreibung · **Connection-Card** (App-Logo, Status-Ampel grün/gelb/rot/grau, Klartext-Status, letzte-Sync-Zeit, Buttons Verbinden/Trennen/Re-Sync) · Key/Secret-Eingabe mit Reveal |
|
||||||
|
| A7 | **Zustands-Kit** | Leer (Illustration + CTA) · Laden (Skeleton) · Fehler (Klartext + Lösungs-Knopf) · Keine-Berechtigung · Offline-Hinweis 📱 |
|
||||||
|
|
||||||
|
### 0.3 Basis-Primitives
|
||||||
|
|
||||||
|
Buttons (primär/sekundär/destruktiv/ghost) · Badges + Status-Pills · Tags (farbig) · Avatare + Avatar-Stapel · Tabs · Dropdown-Menü · Date/Time-Picker · Tooltip · KPI-Kachel (Wert, Label, Trend-Pfeil, Vergleich) · Chart-Basis (Linie, Balken, Donut) · Drawer · Markdown-Editor + -Renderer · Datei-Dropzone mit Upload-Progress · Unterschriften-Feld (Touch) 📱 · Emoji-Picker · Mention-Highlight
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## §1 AUTH-SCREENS (P2) — Fertig: So 21.06. (mit D0)
|
||||||
|
|
||||||
|
| Screen [Route] | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| Signup [`/signup`] | Email, Passwort (Stärke-Anzeige), Firmenname, Vor-/Nachname, Telefon, USt-ID, AGB/DSGVO/AVV-Checkboxen → erzeugt Tenant + Auto-SHK-Seed (kein Wizard!) | [A4] |
|
||||||
|
| Login [`/login`] | Email, Passwort, mCaptcha ab 3. Fehlversuch, Magic-Link-Alternative | [A4] |
|
||||||
|
| 2FA-Eingabe | 6-stelliger TOTP-Code, Trust-Device-Checkbox | [A4/A5] |
|
||||||
|
| Passwort vergessen [`/forgot-password`] | Email-Eingabe → Magic-Link | [A4] |
|
||||||
|
| Tenant-Auswahl | Tenant-Liste mit zuletzt-genutzt, Suchfeld | [A2] |
|
||||||
|
| Session-Verwaltung [`/settings/security`] | Aktive Sessions (Gerät, Browser, IP, Standort, letzte Aktivität) + Abmelden je Session + „überall abmelden" · Trust-Device-Liste mit Revoke | [A2/A6] |
|
||||||
|
| Profil [`/settings/profile`] | Name, Avatar, Telefon, Passwort ändern, 2FA einrichten (QR), Hell/Dunkel-Toggle. *(Sprache: fest DE — kein Wechsler v1)* | [A6] |
|
||||||
|
| Rollen-Editor [`/admin/roles`] | Rollen-Liste (Name, User-Anzahl) · Editor: Name, Beschreibung, Permission-Bundles + Advanced-Einzelrechte · 6 SHK-Rollen vorgeseedet | [A2+A6] |
|
||||||
|
| Gruppen [`/admin/groups`] | Gruppen-Liste mit Mitgliederzahl, Bulk-Add/Remove | [A2] |
|
||||||
|
| Mitarbeiter [`/admin/users`] | User-Liste (Name, Email, Rolle, Status, 2FA) · Einladungs-Modal (Email, Rolle, Gruppen, Nachricht) · Einladungs-Status-Liste · Deaktivieren mit **Reassign-Workflow** (offene Verknüpfungen anzeigen, Bulk-Übertragung) | [A2+A5] |
|
||||||
|
| Konto löschen [`/settings/account`] | Multi-Step: Erklärung → optional Daten-Export → Passwort+2FA → Countdown-Bestätigung | [A5] |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## §2 CRM-CLUSTER (P6/P7) — Fertig: Mi 24.06. → Noah-Demo #1
|
||||||
|
|
||||||
|
| Screen [Route] | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| Kontakt-Liste [`/contacts`] | Avatar+Name, Organisation, Kontaktstatus (Kontakt/Kunde/Bestandskunde), Email, Telefon, Tags, Verantwortlicher, letzte Activity · Filter: Verantwortlicher, Kontakttyp (Privatperson/Organisation), Kontaktstatus, Tags (UND/ODER), Organisation, Datum · Bulk: Tag/Zuweisen/Archiv/CSV | [A2] |
|
||||||
|
| Organisationen-Liste [`/contacts/organizations`] | Name, org_merkmal, Branche, Kontakt-Anzahl, Verantwortlicher, letzte Activity · *(Kontakt mit Kontakttyp=organisation; Label „Organisation", NICHT „Unternehmen")* | [A2] |
|
||||||
|
| **Kontakt-Detail** [`/contacts/:id`] | Stammdaten inline-editierbar · verknüpfte Kontakte/Organisationen mit **Kontaktart=Rolle** (Haupt-/Sekundärkontakt) · Tags · **Projekte**-Panel (alle verknüpften Projekte über ProjektKontakt, Pipeline-Sicht erkennbar)/Dateien/Tasks-Panels · Custom-Felder · Notizen (Markdown) · **Activity-Stream** (inkl. BCC-gelogde Mails + Anrufe!) · Quick-Actions: Anrufen (AirCall), Email (mailto), Termin, Task, Tag | [A3] — **das Muster-Template für alle Detail-Views** |
|
||||||
|
| Organisation-Detail [`/contacts/organizations/:id`] | Analog Kontakt + Kontakt-Verknüpfungen mit Primär-Markierung + Kontaktart (Rolle der Relation) | [A3] |
|
||||||
|
| **Lead-Inbox** [`/leads`] | Tabelle/Karten: Name, Email/Telefon, **Quelle**, Status, **Weiterverarbeitungsfreigabe (ja/nein/unklar)**, Verantwortlicher, Eingegangen, 80-Zeichen-Vorschau · Marker: „Mögliches Duplikat", „Spam-Verdacht" · Quick-Actions inline: Zuweisen, Status, **„Zu Projekt"** (Freigabe ja), Spam · Toggle „Spam ausblenden" | [A2 + Triage-Akzente] |
|
||||||
|
| Lead-Detail [`/leads/:id`] | Stammdaten · Quellen-Detail (Formular-Name/IP bzw. Inbound-Mail) · Spam-Score mit Begründung · **Match-Hinweise** (existierende Kontakte gleiche Email/Telefon, zum separaten Verknüpfen) · Re-Submission-Verlauf · Status-Wechsler (new/qualified/converted/lost/spam) · **Weiterverarbeitungsfreigabe-Schalter** | [A3] |
|
||||||
|
| **Lead → Projekt** (Konvertierung) | Bei `Weiterverarbeitungsfreigabe=ja`: Aktion „Zu Projekt" → erzeugt **Projekt** (`konvertiert_aus_lead_id`), Lead-Daten vorausgefüllt, Ziel-Pipeline + Start-Status wählbar, **Kontakt separat verknüpfen** (existierenden zuordnen über Match-Hinweise ODER neu anlegen) · Mängel-Banner bei fehlendem Namen · *(KEIN 4-Optionen-Promotion-Modal mehr — Kontakt-Anlage entkoppelt)* | [A5] — Kern-Moment der Kette! |
|
||||||
|
| Lead-Statistiken [`/leads/statistics`] | KPI-Kacheln: Eingegangen, Konversion Lead→Projekt, Reaktionszeit, Spam-Quote · Aufschlüsselung nach Quelle/Verantwortlichem · Trend-Chart mit Vorperioden-Vergleich | [A2+KPI-Kit] |
|
||||||
|
| Custom-Felder [`/admin/custom-fields`] | Felder je Entity-Ziel (projekt/kontakt/lead/rechnung), Typ, Nutzungs-Anzahl, Quelle (SHK-Template/eigen), Sortierung, Archiv · *(pro Pipeline via PipelineFieldConfig schaltbar)* | [A2] |
|
||||||
|
| Tag-Verwaltung [`/admin/tags`] | Name, Farbe, Verknüpfungs-Anzahl, Merge-Funktion | [A2] |
|
||||||
|
| Duplikat-Tool [`/admin/duplicates`] | Duplikat-Paare mit Match-Kriterium · **Side-by-Side-Merge** mit Feld-für-Feld-Auswahl | [A5 + Side-by-Side] |
|
||||||
|
| Quellen-Verwaltung [`/admin/lead-sources`] | Quellen mit Typ, 30-Tage-Lead-Count, Status + **Webhook-URL mit Token** (für Fremd-Website-Leads) | [A2/A6] |
|
||||||
|
| Anti-Spam-Settings [`/admin/lead-anti-spam`] | Limits pro Quelle/IP, Disposable-Domain-Check, Honeypot, Quarantäne-Modus | [A6] |
|
||||||
|
|
||||||
|
### Dazu im selben Paket (P3/P4/P5-Oberflächen — Archetyp-Compose, Bau läuft schon):
|
||||||
|
|
||||||
|
| Screen | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| Audit-Viewer [`/admin/audit`] | Zeit, Actor (+Kind-Marker: User/Automation/KI/Admin), Aktion, Subjekt, **deutscher Summary-Text** · Filter: Zeitraum, Actor, Kategorie, Subjekt-Typ · Detail-Drawer mit Diff-Ansicht · Export-Button (CSV/NDJSON, Zweck-Pflichtfeld). *(Kein Retention-Editor/Legal-Hold/Saved-Views — v2)* | [A2+Drawer] |
|
||||||
|
| Notification-Center [Topbar-Drawer + `/notifications`] | Einträge: Titel, Body, Actor, Zeit, Read-Status · Tabs Alle/Ungelesen · Mark-read/unread, Klick→Deeplink · Bulk | [A2] |
|
||||||
|
| Notification-Settings [`/settings/notifications`] | Event-Typen nach Modul gruppiert, je **In-App/Email-Toggle** · Master-Toggle „alle Emails aus". *(Keine Quiet-Hours/Bündelung/Push — v2)* | [A6] |
|
||||||
|
| Files-Browser [`/files`] | Tabelle/Grid-Umschalter: Name, Größe, Datum, Tags, verknüpfte Entität, Thumbnail · Filter: Entität, MIME-Gruppe, Tags, Verantwortlicher · Bulk: Tag/Verknüpfen/Archiv/ZIP. *(Keine Versions-Spalte — v2)* | [A2] |
|
||||||
|
| Upload-View + Datei-Dropzone | Drag&Drop, Multi-Datei-Queue mit Fortschritt je Datei, Fehler+Retry · **HEIC-Hinweis: „wird zu JPG konvertiert"** | [A4] |
|
||||||
|
| File-Detail [`/files/:id`] | Stammdaten, **Vorschau (Bild/PDF; HEIC→JPG)**, Tags, Notizen, verknüpfte Entitäten mit Rolle, Activity · Download, Ersetzen, Archiv. *(Kein Versionsverlauf — v2)* | [A3] |
|
||||||
|
| Task-Liste [`/tasks`] | Titel, Prioritäts-Marker, Fälligkeit (überfällig rot), verknüpfte Entität, Assignee, Status, Quelle · Presets: Meine/Erstellt/Alle · Bulk | [A2] — **als wiederverwendbare Komponente bauen** (P12/P14/P16 betten sie ein!) |
|
||||||
|
| Task-Detail + Anlage-Modal | Titel, Beschreibung (Markdown), Status/Priorität/Fälligkeit inline, Assignee (Person/Gruppe), Verknüpfung, Watcher, Kommentare, Quelle (manuell/Chat/Form/Automation) | [A3+A5] |
|
||||||
|
| Integrations-Katalog [`/admin/integrations`] | App-Karten nach Kategorie (ERP/Kommunikation/Kalender/Signatur/Payment/KI) · je: Logo, Beschreibung, Status-Ampel, aktive Connections | [A6] |
|
||||||
|
| Connection-Setup-Wizard | Voraussetzungen-Check → Credential-Formular (auto-generiert) → Health-Check → Initial-Sync-Option · Sync-History-Liste mit Klartext-Zusammenfassung je Lauf | [A5+A6] |
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## §3 PAKET Fr 26.06. — Kanban, Form-Builder, Kampagnen-Editor, HR
|
||||||
|
|
||||||
|
| Screen [Route] | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| **Pipeline-Kanban (Sales-Sicht)** [`/projects?pipeline=…`] | EIN Projekt-Kanban, Pipeline = View (`typ_hint=sales`). Spalten je Status (PipelineStage): Name, Projekt-Anzahl, Aggregat-Volumen, Win-% · Karten: Titel, Volumen (**field-level-gegated via PipelineFieldVisibility, z.B. nur Vertrieb!**), Avatar, Termin-Datum, max. 3 Tags, Stuck-Marker · **Drag&Drop** zwischen Status · **Verloren-Status → Begründung-Pflicht** · *(KEIN Won-Handoff/„Projekt anlegen?"-Dialog — Projekt wechselt zum Gewinn nur in die Auftrags-Pipeline, kein zweiter Datensatz)* · Filter + „nur meine" | **BESPOKE** |
|
||||||
|
| Projekt-Liste [`/projects/list`] | Nummer (P-…), Projektname, Pipeline, Status, Volumen (gegated), Kontakt+Organisation, Termin-Datum · Cross-Pipeline mit Pipeline-Filter | [A2] |
|
||||||
|
| Projekt-Detail (Sales-Sicht) [`/projects/:id`] | Ein Projekt-Detail (gleicher Datensatz wie Auftrags-Sicht, §4). Stammdaten inline · **Status-Visualisierung klickbar** (pipeline-interne Statuswerte) · Lead-Herkunft-Hinweis (`konvertiert_aus_lead_id`) · Status-Historie mit Verweildauer · Gewonnen/Verloren-Banner mit **24h-Rückgängig** · Sub-Areas Kontakte/Termine/**Rechnungen**/Aktivität/Dateien/Tasks/Formulare · **„Angebot zur Signatur senden"-Button** | [A3+Status-Bar] |
|
||||||
|
| **Pipeline-Config** [`/admin/pipelines`] | Pipelines-Liste (typ_hint sales/auftrag/custom) · Editor: Statuswerte (PipelineStage) mit Drag&Drop, je Name, Art (offen/gewonnen/verloren), Win-%, Farbe · **Zugriff (PipelineAccess: wer sieht/bearbeitet je Rolle/User/Gruppe)** · **Feld-Config (PipelineFieldConfig: sichtbar/pflicht je Feld+Status)** · **Field-Level-Rechte (PipelineFieldVisibility: kann_sehen/kann_bearbeiten je Rolle/Gruppe/User — z.B. Volumen nur Vertrieb)** · Verloren-Gründe als Checklisten-Werte/Status-Metadaten | [A2+A6] **— v1-Pflicht-Feature (Entsch. 16.06.)** |
|
||||||
|
| **Form-Builder-Canvas** [`/forms/:id/edit`] | Feld-Palette (12 Typen) · Canvas mit Drag&Drop-Feldliste · Feld-Konfiguration (Label, Pflicht, Optionen) · **Conditional-Logic-Editor** („zeige Feld X wenn Y = Z") · Live-Vorschau · Publish-Toggle · Sharing: **öffentliche URL + QR-Code + iFrame-Code** *(personalisierte Links/JS-Snippet — v2)* · Post-Submit-Actions (Lead/**Projekt**/Task anlegen, Email, Webhook, Automation-Trigger) mit Field-Mapping | **BESPOKE** (schwerste UI nach Flow-Editor) |
|
||||||
|
| 🌐 Öffentliches Formular [`/f/{tenant}/{slug}`] | Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text oder Redirect · Tenant-Logo | **BESPOKE-Public** |
|
||||||
|
| Submissions [`/forms/:id/submissions`] | Tabelle der Antworten, Spalten = Felder, Filter, CSV, Detail mit Action-Log + PDF-Export | [A2/A3] |
|
||||||
|
| **Kampagnen-Editor** [`/email-marketing/campaigns/new`] | Schritte: Basis (Name, Sender, Betreff, Preheader) → **Inhalt** (Rich-Text + Personalisierungs-Tokens, Bild-Upload, Pflicht-Footer mit Impressum + Unsubscribe) → Empfänger (Segment-Wahl, **Vorschau mit Ausschluss-Aufschlüsselung**: Abgemeldet/Bounce/Suppression) → Test-Versand (max. 5 Adressen) → Zeitpunkt (sofort/geplant) → **Bestätigung mit Klartext-Checkliste** (Domain verifiziert? Unsubscribe? Impressum?) — Versand blockiert bei rotem Check | **BESPOKE** |
|
||||||
|
| Kampagnen-Liste + -Detail | Liste: Name, Status, Empfänger, Versanddatum, Stats · Detail: KPI-Header (Zugestellt/Geöffnet/Geklickt/Bounces/Abmeldungen in %), **Klick-Map** (URLs mit Counts), Pro-Empfänger-Tabelle, **A/B-Varianten-Vergleich** | [A2/A3+KPI] |
|
||||||
|
| Segmente [`/email-marketing/segments`] | Filter-Baum lesbar dargestellt, Live-Empfänger-Anzahl, Sample-Vorschau (50), dynamisch/statisch | [A2+Filter-Builder] |
|
||||||
|
| Sender + Suppression | Sender: From-Name/-Email, Domain-DKIM-Status, Default-Marker · Suppression-Liste: Adresse, Grund (Bounce/Beschwerde/manuell) | [A2/A6] |
|
||||||
|
| 🌐 Unsubscribe-Page [`/unsubscribe/{token}`] | Klartext, Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung | [A4-Public] |
|
||||||
|
| HR-Hub-Start [`/hr`] | Angepinnte Announcements, offene Bestätigungen, ausstehende Anträge, Team heute (Urlaub/krank), Geburtstage, Quick-Links | [Compose aus KPI+Listen] |
|
||||||
|
| Announcements + Detail | Feed mit Ungelesen-Filter · Detail: Markdown, Anhänge, Reaktionen, Kommentare (1 Ebene), **Bestätigungs-Button + Read-Receipt-Tabelle** (nur Autor/HR) | [A2/A3] |
|
||||||
|
| Urlaub & Krankmeldung [`/hr/leave`] | Tabs: Meine / Genehmigungen / Team · Antrag (M05-Form): Zeitraum, Art, Genehmiger · Genehmiger-Sicht: Approve/Reject/Rückfrage + **Konflikt-Hinweise** (Plantafel!) · Krankmeldung: Start, Rückkehr, **AU-Upload (verschlüsselt)** · Admin-Kalender-Monatssicht + KPI-Kacheln | [A2+A4+A5] |
|
||||||
|
| Lohnabrechnungen [`/hr/payslips`] | Eigene: Liste nach Periode + PDF-Viewer · Admin: alle MA, Einzel-/Bulk-Upload mit **Auto-Match-Vorschau** | [A2] |
|
||||||
|
| MA-Anträge [`/hr/requests`] | Template-Wahl (Spesen, Hardware, Schulung, Zeugnis), M05-Form, Genehmiger, Kommentar-Stream (interne Notizen verborgen), Entscheidung | [A2/A3] |
|
||||||
|
| Passwort-Safe [`/hr/password-safe`] | Vault-Liste → Eintrags-Liste (Titel, Tags — **keine Werte!**) → Detail: Reveal-Button je Wert (audit-geloggt!), Copy mit 30s-Auto-Clear, Access-Verwaltung | [A2/A3+Reveal] |
|
||||||
|
| Surveys [`/hr/surveys`] | Teilnahme: Items (Text/Rating/NPS/Choice/Boolean) · Auswertung: Häufigkeits-Charts, Durchschnitte, Textantworten · Admin-Editor mit Audience + Sichtbarkeit | [A4+Charts] |
|
||||||
|
| MA-Verzeichnis + Standorte | Karten/Tabelle: Avatar, Name, Position, Team, Standort, Click-to-Call/Mail/Chat · Standorte mit Karte | [A2] |
|
||||||
|
|
||||||
|
### Plattform-Admin (`admin.hivegrid.de` — eigene Shell, interner Polish reicht):
|
||||||
|
|
||||||
|
| Screen | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| Admin-Dashboard | **Basis-KPIs: Tenants, aktive User, MRR** + System-Health-Ampel + Queue-Status. *(Churn/ARPU/Sales-Pipeline — v2)* | [KPI] |
|
||||||
|
| Tenant-Liste + Detail | Liste: Name, Slug, Status, Plan, MRR, User-Anzahl · Detail: Stammdaten, Status-Wechsler, **Abo-Zusammenstellung (Feature-Konnektoren togglen + Legacy-Provider-Positionen — Abo-Baukasten!)**, Trial-Verlängerung, Notizen (Markdown, gepinnt), **Impersonate mit Begründungs-Pflicht** | [A2/A3+A6] |
|
||||||
|
| Manuelle Tenant-Anlage | Name, Slug, Branche, Admin-Email, Initial-Module, Trial-Dauer, Demo-Daten-Häkchen, Begründung | [A4] |
|
||||||
|
| User-Liste + Detail | Email, Name, Tenants, 2FA-Status, Sessions · Ops: 2FA-Reset, Session-Revoke, Deaktivieren | [A2/A3] |
|
||||||
|
| Feature-Flags [`/admin/feature-flags`] | Flag-Liste (Key, Status, Targeting), Filter-Editor (plan-tier!), Tenant-Override mit Ablauf. *(Massen-Statistik — v2)* | [A2+A6] |
|
||||||
|
| Health + Worker-Queues | Service-Ampeln (Web/API/Worker), DB/Redis, Storage · BullMQ-Queues: Active/Waiting/Failed je Queue, Job-Detail mit Error-Stack, Retry/Pause | [A2+KPI] |
|
||||||
|
| Support-Inbox | Tickets: Betreff, Tenant, Status, Priorität, Zugewiesen · Detail: Konversation, Antwort (Markdown), interne Notiz · **speist sich aus Feedback-Widget!** | [A2/A3] |
|
||||||
|
| Admin-Audit | Cross-Tenant-AuditLog mit Filter + Export | [A2] |
|
||||||
|
|
||||||
|
*(Entfällt v1: AdminUser-/AdminRole-Verwaltung, Plattform-Lead-Pipeline + Deal-Kanban, KWP-Sync-Status — alles v2.)*
|
||||||
|
|
||||||
|
<div class="pagebreak"></div>
|
||||||
|
|
||||||
|
## §4 PAKET Mi 01.07. — Plantafel + Chat
|
||||||
|
|
||||||
|
| Screen [Route] | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| 📱 **Plantafel** [`/projects/plantafel`] | Desktop: Y = Mitarbeiter, X = Zeit (Tag/Woche/Monat) · Einträge: Projekt-Titel, Status-Farbe, Adresse-Kurzform · **Drag&Drop verschieben/resizen** · **Konflikt-Indikatoren** (Doppelbelegung, Urlaub/krank aus HR!) · MA-Filter, Projekt-Filter · **Monteur-Mobil-Modus: „Meine Termine heute"** — Liste mit Adresse + Navigations-Link, Tap-Statuswechsel (bestätigt→unterwegs→fertig), **offline-fähig** + „Meine Woche" kompakt | **BESPOKE** (höchste Priorität nach Flow-Editor) |
|
||||||
|
| Projekt-Kanban (Auftrags-Sicht) + Liste [`/projects?pipeline=…`] | Derselbe Projekt-Kanban (Pipeline `typ_hint=auftrag`), Karten zusätzlich: Mitglieder-Avatare (PL hervorgehoben), Zeitraum, Mängel-Marker · Status-Wechsel mit **Abnahme-Pflicht-Block** | [Kanban-Reuse] |
|
||||||
|
| 📱 Projekt-Detail [`/projects/:id`] | EIN Projekt-Datensatz (gleiche Route/Entität wie Sales-Sicht §3). Stammdaten, Lead-Herkunft-Hinweis (`konvertiert_aus_lead_id`), PL + Mitglieder (ProjektMitglied) mit Rollen, Tabs: Übersicht/Mitglieder/Tasks/Termine/**Rechnungen**/Dateien/Formulare/**Abnahmen**/Aktivität (inkl. früherer Sales-Status-Historie — derselbe Datensatz, kein read-only Fremd-Objekt) · **Mobil-Modus: Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload** · *(kein KWP-Felder-Tab — KWP komplett v2)* | [A3 + 📱-Variante] |
|
||||||
|
| 📱 **Abnahme-Workflow** [`/projects/:id/acceptance/new`] | SHK-Abnahme-Formular (Datum, Anwesende, Druckprobe ja/nein+Wert, Funktionsprüfung, Zählerstände, Dokumente-Checkliste, **Mängel-Repeater mit Foto je Mangel**, Bemerkungen) → Mängel-Klassifizierung (kritisch/klein/kosmetisch) → **Touch-Unterschriften Kunde + Monteur** → PDF + Auto-Email · **offline-fähig, Sync bei Verbindung** | **BESPOKE-Mobile** |
|
||||||
|
| **Chat** [`/chat`] | Channel-Index: Name, Avatar, Snippet (80 Z.), Unread-Badge, Mention-Marker, Pin/Mute, Projekt-Stage bei Projekt-Chats · **Channel-Detail:** Verlauf mit Datums-Separatoren, Nachricht = Avatar+Name+Zeit, Markdown-Body, **Reactions** (Emoji+Count), **Thread-Indikator**, Anhänge inline, Edited-Marker, „X von Y gelesen" · Composer: Markdown, Emoji, @-Mention, Anhang, Entwurf-Autosave · **Tipp-Indikator** · Thread-Detail-Ansicht · Pinned-Übersicht (max 50) · Mentions-Aggregat · Cross-Channel-Suche · Neuer Channel/DM-Modal · Channel-Settings (Mitglieder, Archiv) · Admin: DM-Audit mit Begründungs-Pflicht-Banner | **BESPOKE** |
|
||||||
|
|
||||||
|
## §5 PAKET Fr 03.07. — Flow-Editor, Dashboard, Booking, Kalender
|
||||||
|
|
||||||
|
| Screen [Route] | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| **Flow-/Node-Editor** [`/automations/:id/edit`] | Graph-Canvas: Knoten + Kanten, **Knoten-Katalog nach Modul** (Trigger: CRM/Sales/Projekte/Email/Forms/Kalender/Zeit/Webhook · Aktionen: CRM/Notification/HTTP/Task/If-Else/Delay/Loop) · Konfigurations-Panel je Knoten mit **Klartext-Label** · Mini-Map, Zoom, Undo/Redo · **Dry-Run-Vorschau:** „trifft X Datensätze, sendet an: [Liste]" + Bestätigungs-Pflicht · **Sprach-zu-Automation:** Text-/Spracheingabe-Feld → KI baut Flow-Vorschau → User bestätigt (nie Auto-Aktivierung!) · Loop-Guard-Warnmodal mit Abhängigkeits-Graph | **BESPOKE — schwerste UI der App, ab 22.06. täglich 1h** |
|
||||||
|
| Automation-Liste + Executions | Liste: Name, Trigger, Status, Läufe (30d) · Execution-Detail: **Step-by-Step-Verlauf mit Klartext je Schritt**, Dauer, **24h-Rückgängig-Button**, Retry | [A2/A3] |
|
||||||
|
| Template-Katalog [`/automations/templates`] | SHK-Vorlagen nach Kategorie mit Beschreibung + Use-Case, „Verwenden"-Button | [A2] |
|
||||||
|
| **Dashboard** [`/dashboard`] | **3 feste Rollen-Layouts** (kein Drag&Drop!): **GF:** Begrüßung, Sales-KPIs, Umsatz-Forecast (einfach), Projekt-KPIs, Auslastung, offene Mängel, Team-heute · **Büro:** Begrüßung, Projekt-KPIs, meine Tasks, Anrufe heute, HR-Anträge · **Monteur 📱:** meine Termine heute, meine Projekte, meine Tasks · Widgets: KPI-Kachel, Liste, Trend-Chart · Edit = nur Widget-Filter/Zeitraum konfigurieren | [KPI+Widget-Compose] |
|
||||||
|
| **Cmd+K-Suche** [global] | Modal: Live-Suche (300ms debounce), Treffer gruppiert nach Entity-Typ mit Icon, Titel, Kontext-Snippet mit **Match-Highlight**, Tastatur-Navigation · Leer-Zustand: letzte Suchen · Vollbild-Variante [`/search`] mit Filter-Sidebar (Typ, Datum, Verantwortlicher, Tags) + Trefferzahl | **BESPOKE** (klein) |
|
||||||
|
| 🌐 **Booking-Page** [`/b/{tenant}/{slug}`] | Slot-Picker (Kalender-Grid mit freien Slots, timezone-aware), Intake-Formular (M05), mCaptcha, Bestätigung + **Add-to-Calendar (.ics)** · Tenant-Logo · iFrame-Embed-Variante | **BESPOKE-Public** (höchster Polish!) |
|
||||||
|
| Buchungen intern [`/bookings`] | Liste: Termin, Endkunde, Page, Status, Mitarbeiter · Detail: Daten, Form-Antworten, Kalender-Status · Ops: **stattgefunden/No-Show markieren, Storno mit Begründung + Auto-Mail, Verschieben mit Slot-Picker, Mitarbeiter-Re-Assignment** (M129 voll!) | [A2/A3] |
|
||||||
|
| Booking-Page-Editor + Verfügbarkeit | Grunddaten, Dauer, Mitarbeiter-Auswahl (eine Zuteilungs-Strategie: „erster freier"), Bestätigungs-Mail-Template, Intake-Form-Wahl, Embed-Code · Verfügbarkeit: Wochenregel-Tabelle + Ausnahme-Daten | [A6+A4] |
|
||||||
|
| Kalender [`/calendar`] | Monats-/Wochen-Grid mit Terminen aus Google-Sync + HiveGrid-Quellen (Booking, Plantafel) · Verbindungs-Settings: Google-Connect-Card, Kalender-Auswahl, Sync-Richtung, Konflikt-Log *(kein Outlook — v2)* | **BESPOKE** (mittel) |
|
||||||
|
| Signatur-Wizard [im Projekt] | PDF-Upload → Unterzeichner (Name, Email, Reihenfolge) → Provider (PandaDoc) → Senden · Status-Tracking je Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt) + Erinnerung + Widerruf | [A5+A6] |
|
||||||
|
|
||||||
|
## §6 PAKET Mo 06.07. — KI, Telefonie-Reste, Billing, DSGVO (Compose)
|
||||||
|
|
||||||
|
| Screen | Inhalt | Typ |
|
||||||
|
|---|---|---|
|
||||||
|
| KI-Settings [`/admin/ai`] | Use-Case-Toggles, Modell-Wahl (Mistral), Token-Limit, **EU-Datenresidenz-Klartext** | [A6] |
|
||||||
|
| AI-Credits [`/admin/usage/ai`] | Saldo, Verbrauch je Use-Case (Donut), Verlauf, Top-User, **80%-Warnbanner**, Hochrechnung | [KPI+Charts] |
|
||||||
|
| AirCall-Setup + Anrufe | Connect-Card + **User-Binding** (AirCall-User ↔ HiveGrid-User mit Auto-Match) · Anruf-Liste: Nummer, Richtung, Dauer, gematchter Kontakt, Notiz-Snippet · Anruf-Detail: Match-Override, Notiz-Editor (Markdown), Aufnahme-Link · Click-to-Call-Button + eingehender-Anruf-Notification | [A6+A2/A3] |
|
||||||
|
| Sende-Domain [`/settings/integrations/email`] | Domain-Eingabe, **DNS-Records (DKIM/SPF/DMARC) mit Copy-Button**, Verifikations-Status-Ampel, 5-Min-Prüf-Indikator · **BCC-Logging:** Toggle + angezeigte BCC-Adresse + Klartext „Mails erscheinen am Kontakt" *(kein Postfach/Inbox/Compose — v2!)* | [A6] |
|
||||||
|
| Abo-Übersicht [`/admin/subscription`] | Basis-Plan + **gebuchte Feature-Module als Positionsliste mit Preisen** · Status/Trial-Countdown · Verbrauch: Automation-Läufe, AI-Tokens, Speicher mit Quota-Balken · Legacy-Provider-Portal-Embed (Rechnungen, Zahlungsmethode) · Pausieren/Kündigen *(kein Self-Service-Modul-Toggle — Admin macht das, v2)* | [A6+KPI] |
|
||||||
|
| Demo-Daten [`/admin/onboarding/demo-data`] | **Settings-Knopf „Beispieldaten anlegen"** (25 Datensätze, Klartext-Liste was kommt) · Demo-Liste mit Zähler + Lösch-Funktion · „Demo ausblenden"-Filter erscheint in allen Listen *(kein Wizard, kein KI-Walkthrough — v2)* | [A6] |
|
||||||
|
| Erste-Schritte-Checkliste [`/onboarding/checklist`] | Items mit Status-Häkchen, Klartext, CTA-Link je Item (KWP verbinden → v2-Item ausgeblendet), manuell abhakbar, ausblendbar | [A2] |
|
||||||
|
| Privacy-Hub [`/admin/privacy`] | Export: Job-Liste mit Status/Progress/Download (72h-Link) · **Tenant-Löschung: Multi-Step** (Erklärung 30-Tage-Grace → Export-Angebot → Legacy-Provider-Hinweis → Passwort+2FA → **Slug als Bestätigungs-Phrase**) + Grace-Countdown mit Abbruch · Subprozessoren-Tabelle (Name, Land, EU-Marker, Zweck, DPA-Link) · AVV: aktuelle Version als PDF + Akzeptanz-Historie | [A2+A5] |
|
||||||
|
| User-Daten-Export [`/settings/account/data-export`] | Klartext was exportiert wird, Start-Button, Job-Status mit Download | [A6] |
|
||||||
|
| **Feedback-Widget** [global, klein] | Schwebender Button → Mini-Form (Kategorie, Text, Screenshot-Häkchen) → landet in Admin-Support-Inbox | [A5-klein] |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## §7 Zähl-Übersicht & Diskussionspunkte
|
||||||
|
|
||||||
|
**~95 v1-Screens** = **~12 BESPOKE** (Flow-Editor, Form-Builder + Public-Form, Plantafel, Abnahme, Chat, Sales-Kanban, Kampagnen-Editor, Booking-Page, Kalender, Cmd+K, Dashboard-Compose) + **~83 Archetyp-Composes** (Stunden-Arbeit nach D0).
|
||||||
|
|
||||||
|
**Offene Punkte (Raffael entscheiden):**
|
||||||
|
1. **Dashboard-Rollen-Layouts:** Spec definiert 7 Presets (auch Vertriebsleiter, Vertriebler, PL, Marketing) — beschlossen sind 3 (GF/Büro/Monteur). Weitere Presets sind nur Widget-Listen (~0 Aufwand) — bei Zeit via Beschleunigungs-Leiter nachschieben oder v2?
|
||||||
|
2. **KI-Lead-Zusammenfassung** (Widget im Kontakt/Projekt-Detail, on-demand): nicht in den 5 v1-KI-Milestones — v2 oder Beschleunigungs-Kandidat?
|
||||||
|
3. **Notification-Test-Tool** (Admin sendet Test-Notification): Mini-Screen, hilft beim Demo-Vorbereiten — drin lassen?
|
||||||
|
|
||||||
|
---
|
||||||
|
*Quellen: 36 Specs `_bmad-output/specs/` · Scope-Schnitte #1–#12 (`SCOPE-V1-CUTS.md`) · Archetypen (`DESIGNER-FIRST-PLAYBOOK.md`) · Deadlines (`TIMELINE.md`). Entfallene Screens (Portal, Mobile-PWA, Help-Center, Wizard, Postfach-Inbox, KWP-UI, AdminUser-Verwaltung, Quiet-Hours, Datei-Versionen) sind bewusst NICHT gelistet — v2-Planung erzeugt ihre eigene Map.*
|
||||||
Binary file not shown.
@@ -0,0 +1,134 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 16mm
|
||||||
|
css: |-
|
||||||
|
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
|
||||||
|
h1 { font-size: 19px; } h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; }
|
||||||
|
table { font-size: 9.5px; border-collapse: collapse; width: 100%; }
|
||||||
|
th, td { border: 1px solid #ccc; padding: 3px 5px; text-align: left; vertical-align: top; }
|
||||||
|
th { background: #fff7e8; }
|
||||||
|
code, pre { background: #f4f4f4; font-size: 9px; }
|
||||||
|
pre { padding: 8px; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# 4-Wochen-Sprint-Plan — HiveGrid 2.0 v1 (nach Scope-Schnitt)
|
||||||
|
|
||||||
|
**Stand:** 2026-06-12 (ersetzt Fassung vom 10.06.) · **Frist:** fix, 4 Wochen (20 Arbeitstage) · **Team:** Dev A, Dev B, Dev C (je eigene Claude/GSD-Instanz) + Designer
|
||||||
|
**Scope:** **v1 = 133 Milestones / 90 Requirements** (Scope-Schnitte #1–#12, Historie: `SCOPE-V1-CUTS.md`; v2 = 43 MS committed-deferred, **KWP = erstes v2-Modul**)
|
||||||
|
**Velocity:** 133 / 3 Devs / 20 Tage ≈ **2,2 MS/Dev/Tag** (effektiv ~2,1 mit den 10 Dünnungen) — komfortabler Puffer.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Tag-1-Pflichten (kalendergebunden — KI kann das nicht beschleunigen)
|
||||||
|
|
||||||
|
| # | Was | Blockt | Status / Vorlauf |
|
||||||
|
|---|---|---|---|
|
||||||
|
| A1 | **KWP:** Callback-URL zurückmelden (`https://app.hivegrid.de/integrations/kwp/oauth/callback`) + **bnWin.net auf 8.1 N3** bei Geerkens-IT | v2-P10 (erstes v2-Modul) | ✅ entschärft — Zugang lt. KWP-Mail ~**19.07.** (nach Launch); kein Sprint-Risiko mehr, nur Vorbereitung |
|
||||||
|
| A2 | **Google Cloud OAuth-App: nur noch Calendar-API-Scope** beantragen | P16 Kalender | 🟠 Verifizierung Tage–Wochen; Gmail-Scopes durch Postfach-Cut NICHT mehr nötig |
|
||||||
|
| A5 | **Legacy-Provider-Konto + Live-Verifizierung** | P20 | 🟠 Tage; Test-Mode reicht für Dev |
|
||||||
|
| A6 | **Sende-Domain: SPF/DKIM/DMARC für Mailjet + Warm-up** | P1/P2/P14 — **Marketing-Kampagnen brauchen Reputation!** | 🔴 sofort, Warm-up braucht Laufzeit |
|
||||||
|
| B2 | **AirCall**-Konto + Sandbox + Webhooks | P15 | 🟡 Tage |
|
||||||
|
| B4 | **PandaDoc** (Standard) Konto + Sandbox; DocuSign optional | P16 Signatur | 🟡 Tage |
|
||||||
|
| B5 | **Hetzner-Projekt `HiveGrid`** (Infra-ADR-009): Object-Storage-Bucket (S3) + Token · **Mistral**-Key (LLM) · DEK-Master-Key in Coolify-Secrets (AD-8 revidiert — kein Cloud-KMS) | P4/P5/P13/P17 | 🟢 Stunden (Infra-Repo-Muster) |
|
||||||
|
| B6 | **Mistral**-API-Key (AlephAlpha → v2) | P13 Fallback | 🟡 kurz |
|
||||||
|
| B10 | **Subframe**-Lizenzen Designer + Devs | Designer ab W1 | 🔴 sofort |
|
||||||
|
| C1–C5 | Eigene Infra: Meilisearch (bis Ende W2) · mCaptcha (`infra/mcaptcha/`, Ende W1) · Hosting/Staging (Mitte W1) · Postgres/Redis/PgBouncer · Domains+Wildcard-TLS | CI/Gates | Ops parallel W1–W2 |
|
||||||
|
| E1 | **Noah: 4 Freitags-Slots** blocken | Gates | sofort terminieren |
|
||||||
|
| E2 | ~~KWP-Ansprechpartner identifizieren~~ ✅ läuft (KWP-Mail an Noah, 12.06.) · **NEU: Noah fragen — gehört der Lagerist-Arbeitsplatz (M070) zum Validierungs-Versprechen?** | A1 / v2-Planung | erledigt / bei Demo #1 |
|
||||||
|
| E3 | Echte SHK-Beispieldaten (Pipelines, Felder, Rollen) für Seeds | bis W2 | |
|
||||||
|
| **E6** | **AVV-Vertragsvorlage + DSGVO-Auskunfts-Vorlage vom Anwalt** | Launch (Auftragsverarbeiter-Pflicht!) | 🟠 diese Woche beauftragen |
|
||||||
|
|
||||||
|
**Erledigt/entfallen:** Apple-Konto ✅ vorhanden · Google Play, FCM/APNs, Microsoft Entra, HalloPetra, Memberspot/Boobora → v2-Vorbereitung, nicht sprint-kritisch. **AD-6 (Mailjet) + AD-7 (mCaptcha) gelockt** — Boilerplate-verdrahtet.
|
||||||
|
|
||||||
|
## 2. Arbeitsweise
|
||||||
|
|
||||||
|
- **1 Phase = 1 Branch/Worktree = 1 Dev**; tägliche Integration auf `main`; CI ist der Sheriff (Smoke, Visual-Reg inkl. **Mobile-Viewport**, Hot-Swap-Drill, i18n-Lint).
|
||||||
|
- **Konnektor-Pflicht (NEU):** Jede Modul-Phase registriert ihr Entitlement-Gate (`tenantHasModule()`) — Merge-Checkpunkt wie Sidebar-/Audit-Wiring.
|
||||||
|
- Pro Phase: `/gsd-plan-phase N` (liest PHASE-SOURCES inkl. Scope-Schnitt-Notes + Retro-Integrationen) → kurzes Review → `/gsd-execute-phase N`.
|
||||||
|
- Designer läuft 1–2 Phasen voraus (D0-Archetypen → CRM → Bespoke: Kanban, Plantafel, Flow-Editor, Form-Builder). Monteur-Screens **mobile-first** (PWA ersetzt native App in v1).
|
||||||
|
|
||||||
|
## 3. Wochenplan (133 MS auf 3 Tracks)
|
||||||
|
|
||||||
|
### Woche 1 — Fundament & Identität *(Ziel: P1 ✓, P2 ✓, P4 ≥ 50 %)*
|
||||||
|
| Wer | Mo–Mi | Do–Fr |
|
||||||
|
|---|---|---|
|
||||||
|
| **Alle 3** | **P1 in 3 Strängen:** A: Ist-Stand + EU-Sterilisation (inkl. GA/ConvertKit raus) + Contracts/URL-Schemata · B: Service-Kerne (Audit/notify/i18n/**Flag-Engine+Konnektor-Muster**) · C: Hot-Swap-Maschine + Walking-Skeleton + PWA-Manifest | A+B: **P2** (Auth/RLS/RBAC + Subscription-Stub; API-Keys → v2) · C: **P4** (Files/Tasks, polymorphe EntityLink, HEIC→JPG) |
|
||||||
|
| Designer | **D0:** System + App-Shell + Archetypen + Zustände | CRM-Screens briefen |
|
||||||
|
|
||||||
|
**Gate Fr W1:** Hot-Swap-Drill grün · **RLS-Cross-Tenant-Beweis** · Konnektor-Muster am Skeleton demonstriert.
|
||||||
|
|
||||||
|
### Woche 2 — Plattform + CRM *(Ziel: P3, P4, P5, P6 ✓; P19 ≥ 80 %)*
|
||||||
|
| Wer | Mo–Mi | Do–Fr |
|
||||||
|
|---|---|---|
|
||||||
|
| Dev A | **P5** Apps-Engine (Vertrag für 5 Phasen!) | **P6** CRM (mit B) |
|
||||||
|
| Dev B | P4 fertig → **P3** Querschnitts-Oberflächen (5, DE-only) | **P6** CRM (mit A) |
|
||||||
|
| Dev C | **P19** Plattform-Admin (7, inkl. Abo-Zusammenstellung; Boilerplate-Identitätsmodell + admin.hivegrid.de-Host-Routing) | **P17** HR (7) Start |
|
||||||
|
| Designer | CRM-Cluster (Liste/Detail/Modal) | Bespoke: Kanban, Plantafel; Flow-Editor briefen |
|
||||||
|
|
||||||
|
**Gate Fr W2:** CRM klickbar (**Noah-Demo #1**) · Konnektoren an P3–P6-Modulen aktiv.
|
||||||
|
|
||||||
|
### Woche 3 — Kern-Kette + Kommunikation *(Ziel: P7, P8, P9, P14, P15 ✓; P17 ✓; P20 ≥ 80 %)*
|
||||||
|
| Wer | Mo–Mi | Do–Fr |
|
||||||
|
|---|---|---|
|
||||||
|
| Dev A *(kritischer Pfad)* | **P7** Lead (4) → **P8** Sales (7) | **P9** Projekte (6, Plantafel offline!) |
|
||||||
|
| Dev B | **P14** Email & Marketing (6, inkl. BCC-Brücke + Kampagnen) | **P15** Telefonie & Chat (9) |
|
||||||
|
| Dev C | **P17** fertig → **P20** Billing (8, Abo-Baukasten-Recut!) | **P16** Start (15 — größte Phase) |
|
||||||
|
| Designer | Plantafel + Kanban liefern; Form-Builder, Kampagnen-Editor | Booking-Pages (public!), Wizard entfällt |
|
||||||
|
|
||||||
|
**Gate Fr W3:** Kette **Lead → Sales → Auftrag** E2E (**Noah-Demo #2**) · P14-Kampagne an Test-Segment versendet.
|
||||||
|
|
||||||
|
### Woche 4 — USP, Härtung, Launch *(Do = Freeze, Fr = Go/No-Go)*
|
||||||
|
| Wer | Mo–Mi | Do–Fr |
|
||||||
|
|---|---|---|
|
||||||
|
| Dev A | **P11** Suche/Dashboard (5) → E2E-Härtung der Kette (Lead→Auftrag), Lasttest, Bug-Bash | E2E-Integration + Launch-Stützen (KWP entfällt — v2) |
|
||||||
|
| Dev B | **P12** Automation (8, voll!) → **P13** KI (5) | USP-Härtung (Promptfoo, Guards, Sprach-zu-Automation) |
|
||||||
|
| Dev C | **P16** fertig (Kalender nur Google!) → **P21** (2 + Feedback-Widget + FAQ) | Launch-Checkliste, DSGVO-E2E, AVV-Check |
|
||||||
|
| Designer | Politur extern sichtbarer Flächen (Booking public, Marketing-Mails) | Visual-Reg-Baselines final |
|
||||||
|
|
||||||
|
**Do W4: Feature-Freeze. Fr W4: Voll-Walkthrough mit Noah (#3) → Go/No-Go Big-Bang.**
|
||||||
|
|
||||||
|
## 4. Engstellen (ehrlich)
|
||||||
|
|
||||||
|
1. **W4 trägt P11–P13 + P16-Rest (~20 MS auf A+B+C)** — durch den P10-Wegfall (#12) deutlich entspannt; Dev A gewinnt 2–3 Tage für E2E-Härtung/Bug-Bash. Der KWP-Recut wandert komplett in die v2-Planung (API-Zugang ~19.07.).
|
||||||
|
2. **P16 bleibt die größte Phase (15)** — Dev C hat sie über W3-Do bis W4-Mi. Form-Builder-Design muss Ende W2 vorliegen.
|
||||||
|
3. **Marketing-Zustellbarkeit:** Kampagnen ohne Domain-Reputation = Spam-Ordner. Warm-up (A6) läuft ab Tag 1, erste echte Kampagne frühestens W3.
|
||||||
|
4. **Google-Calendar-Verifizierung** kann W4 reißen → Kalender-Feature ggf. im Testmodus launchen (interne Workspace-Konten), Verifizierung läuft parallel.
|
||||||
|
|
||||||
|
## 5. Notfall-Leiter (NEU — nur wenn ein Gate reißt; vorab beschlossen)
|
||||||
|
|
||||||
|
```
|
||||||
|
NIEMALS opfern: P1–P9 (Kette; P10 KWP = v2 seit #12) · P12 Automation · Marketing-Kern · Konnektor-Pflicht
|
||||||
|
Sprosse 4 (zuerst): A/B-Tests (M103-Teil) · Sales-Tiefen-Analytik · Chat-Polish (Threads/Reactions/Pins)
|
||||||
|
Sprosse 3: Signatur (M130–132) → PandaDoc manuell, Status händisch
|
||||||
|
Sprosse 2: Booking + Kalender (M118–120, M126–129) → Terminanfragen via Formular
|
||||||
|
Sprosse 1 (letzte): HR-Komfort (M137 Bekanntmachungen, M139 Berichte/Surveys) — Urlaub/Krank/Plantafel-Konflikt bleiben
|
||||||
|
```
|
||||||
|
|
||||||
|
Alle Sprossen sind durch Dependency-Inversion sauber abtrennbar; Chat-Kern und HR-Kern fallen NIE (User-Priorität „ultra wichtig").
|
||||||
|
|
||||||
|
## 5b. Beschleunigungs-Leiter (Gegenstück — wenn wir SCHNELLER sind)
|
||||||
|
|
||||||
|
Vorab beschlossen wie die Notfall-Leiter; Detail in `TIMELINE.md`. Kurzform:
|
||||||
|
|
||||||
|
```
|
||||||
|
Sprosse 1: nächste eigene Phase sofort ziehen (9:00-Sync)
|
||||||
|
Sprosse 2: Track-übergreifend aushelfen (kritischer Pfad: P16, P8/P9)
|
||||||
|
Sprosse 3: Puffer ≥3 Tage → Launch-Vorzieh-Prüfung mit Noah (Legacy-Provider live + Staging-Abnahme)
|
||||||
|
Sprosse 4: v2-Vorzieher: (a) KWP-Recut-Vorarbeit (Doku, kein Mock-E2E) → (b) Self-Service-Abo-UI → (c) Postfach-Sync
|
||||||
|
Pflicht: pro gewonnener Woche ≥1 Tag Härtung (Bug-Bash/Lasttest/Security)
|
||||||
|
NIEMALS: Cut-Rückholung in Eigenregie · Goldrand an internen Screens · Gates verschieben (außer Sprosse 3)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 6. Gates
|
||||||
|
|
||||||
|
| Gate | Beweis | Bei Riss |
|
||||||
|
|---|---|---|
|
||||||
|
| Fr W1 | Hot-Swap grün + RLS-Beweis + Konnektor-Demo | Sprosse 4 |
|
||||||
|
| Fr W2 | CRM klickbar (Noah #1) | Sprosse 3–4 |
|
||||||
|
| Fr W3 | Kette E2E (Noah #2) + Test-Kampagne | Sprosse 2–3 |
|
||||||
|
| Do W4 | Feature-Freeze | — |
|
||||||
|
| Fr W4 | Voll-Walkthrough (Noah #3) → **Go/No-Go Big-Bang** | Launch = Kern + Fast-Follow-Liste |
|
||||||
|
|
||||||
|
---
|
||||||
|
*HiveGrid ist Multi-Kunden-SaaS; Geerkens = erster Kunde + Investor. Nichts hartkodieren — alle Seeds/Flows generisch pro Mandant. v2 startet direkt nach Launch mit eigener Planung (30 MS + Mobile-PWA-Ausbau — PWA-only, kein nativer Client/Store, AD-17).*
|
||||||
Binary file not shown.
@@ -0,0 +1,555 @@
|
|||||||
|
---
|
||||||
|
pdf_options:
|
||||||
|
format: A4
|
||||||
|
margin: 13mm
|
||||||
|
printBackground: true
|
||||||
|
css: |-
|
||||||
|
body { font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; font-size: 9px; color: #1f2937; line-height: 1.4; }
|
||||||
|
h1 { font-size: 21px; margin: 0 0 2px; color: #0f172a; }
|
||||||
|
p.lead { color: #475569; font-size: 10.5px; margin: 0 0 4px; }
|
||||||
|
p.meta { color: #64748b; font-size: 8.5px; margin: 0 0 10px; }
|
||||||
|
h2 { font-size: 14px; color: #b45309; border-bottom: 2.5px solid #f5a623; padding-bottom: 4px; margin: 0 0 8px; page-break-before: always; break-before: page; break-after: avoid; page-break-after: avoid; }
|
||||||
|
h2.idx { page-break-before: always; }
|
||||||
|
h3 { font-size: 10.5px; margin: 12px 0 3px; color: #0f766e; break-after: avoid; page-break-after: avoid; }
|
||||||
|
h3.gate { color: #b91c1c; }
|
||||||
|
table { font-size: 8.5px; border-collapse: collapse; width: 100%; margin: 0 0 5px; break-inside: avoid; page-break-inside: avoid; }
|
||||||
|
thead { display: table-header-group; }
|
||||||
|
tr { break-inside: avoid; page-break-inside: avoid; }
|
||||||
|
td, th { border: 1px solid #e2e8f0; padding: 3px 6px; text-align: left; vertical-align: top; break-inside: avoid; page-break-inside: avoid; }
|
||||||
|
th { background: #fff7e8; color: #92400e; font-size: 8px; text-transform: uppercase; letter-spacing: 0.3px; }
|
||||||
|
td:nth-child(1) { font-family: "SF Mono", Menlo, monospace; font-weight: 600; color: #0f172a; white-space: nowrap; width: 70px; }
|
||||||
|
td:nth-child(2) { white-space: nowrap; width: 62px; color: #334155; }
|
||||||
|
td:nth-child(3) { white-space: nowrap; width: 42px; color: #64748b; }
|
||||||
|
tr.b2 td:nth-child(1) { color: #b91c1c; }
|
||||||
|
strong { color: #b45309; }
|
||||||
|
---
|
||||||
|
|
||||||
|
# HiveGrid 2.0 — Sprint-Tagesplan (ticket-genau)
|
||||||
|
|
||||||
|
> ⛔ **KI→MCP-Pivot ([[AD-26]], 2026-06-22):** **R-P13** (KI-Layer), **D-P13**, **EXT-11** (Mistral-Key) und Milestones **M083–M088** entfallen. **R-P12b** ist das letzte v1-Glied der Raffael-Kette; Sprach→Automation ist gestrichen. In v2 ersetzt **[[VR-MCP]]/[[VD-MCP]]** den alten P25-HiveMind/RAG-Slot.
|
||||||
|
|
||||||
|
<p class="lead">Jedes Ticket an seinem Start-Tag · ID · Wer · Fenster (Start→Ziel) · Aufgabe · 149 Sprint-Tickets (v1: 107 · v2: 42) + 2 v3-Backlog</p>
|
||||||
|
<p class="meta">Generiert aus Plane (Single Source) · Arbeitsrhythmus Mo–So ≥8 h · „bis" = Ziel-/Fertig-Datum (Mehrtages-Tickets laufen bis dahin) · rot = Meilenstein/Gate-Tag · <span style="color:#b91c1c">rote Ticket-ID</span> = Block 2 (Partner-API offen, agil). Neu erzeugen: <code>python3 .planning/plane-sync/gen_dayplan.py</code></p>
|
||||||
|
|
||||||
|
## Woche 1 · Di 16.–Fr 19.06. — Fundament & Identität · 40 Tickets
|
||||||
|
*→ Gate W1 (Fr 19.06.)*
|
||||||
|
### Di 16.06. · 23 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-INFRA1 | Akeshan | 17.06. | Infra-Live: Staging + Coolify-Apps + PG/Redis/PgBouncer |
|
||||||
|
| D-D0a | David | 18.06. | D0 Design-System + App-Shell (A1) |
|
||||||
|
| D-WEB | David | 16.06. | Website-Screens + Brand-Tokens |
|
||||||
|
| EXT-02 | Raffael | 16.06. | Mailjet Sende-Domain (SPF/DKIM/DMARC) + Warm-up |
|
||||||
|
| EXT-03 | Dejan | 19.06. | Anwalt: AVV + DSGVO-Auskunft + Website-Rechtstexte |
|
||||||
|
| EXT-04 | Raffael | 17.06. | KWP: Callback-URLs melden + bnWin.net 8.1 N3 |
|
||||||
|
| EXT-05 | Raffael | 16.06. | Noah: 4 Gate-Freitags-Slots blocken |
|
||||||
|
| EXT-06 | Raffael | 17.06. | Hetzner-Projekt HiveGrid: S3+Token + DEK-Master-Key |
|
||||||
|
| EXT-07 | Raffael | 26.06. | Legacy-Provider-Konto + Live-Verifizierung |
|
||||||
|
| EXT-08 | Raffael | 30.06. | AirCall-Konto + Sandbox + Webhooks |
|
||||||
|
| EXT-09 | Raffael | 03.07. | Signatur-Provider-Entscheid: SES default, PandaDoc optional BYOK |
|
||||||
|
| EXT-10 | Raffael | 18.06. | Google-Cloud OAuth + Calendar-Scope-Antrag |
|
||||||
|
| EXT-12 | Raffael | 19.06. | Geo-IP + HIBP prüfen/anbinden |
|
||||||
|
| H-LISTE | Haris | 17.06. | Zielkundenliste SHK (KWP-Nutzer-Fokus) |
|
||||||
|
| H-PAIN | Haris | 17.06. | Painpoint-Gespräch mit Noah |
|
||||||
|
| J-SETUP | Dejan | 16.06. | Domain/Hosting/Stack + Setup |
|
||||||
|
| J-STRUKTUR | Dejan | 17.06. | Seitenstruktur + Davids Screens einbauen |
|
||||||
|
| N-KWP | Dejan/Haris | 17.06. | KWP-Mail freigeben + bnWin.net 8.1 N3 anstoßen |
|
||||||
|
| N-PAIN | Dejan/Haris | 17.06. | Painpoint-Input liefern (mit Haris) |
|
||||||
|
| N-SLOTS | Dejan/Haris | 16.06. | 4 Gate-Freitags-Slots bestätigen |
|
||||||
|
| R-P1a | Raffael | 17.06. | P1 EU-Sterilisation + Contracts + URL-Schemata |
|
||||||
|
| R-P1c | Raffael | 17.06. | P1 Hot-Swap-Maschine + Walking-Skeleton + PWA |
|
||||||
|
| R-REFIT | Raffael | 21.06. | ER-Modell-Re-Fit P6–P9 (Requirements/Screen-Map/Phase-Sources) |
|
||||||
|
### Mi 17.06. · 7 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-INFRA2 | Akeshan | 18.06. | DNS + Wildcard-TLS + zentrale Dienste anbinden |
|
||||||
|
| H-TXT | Haris | 17.06. | Website-Texte schreiben |
|
||||||
|
| J-CONTENT | Dejan | 17.06. | Content/Texte einbauen |
|
||||||
|
| J-LAW | Dejan | 18.06. | Rechtstexte einbauen (Anwalt) |
|
||||||
|
| J-QA | Dejan | 18.06. | QA + Lead-Routing-Test |
|
||||||
|
| N-TXTABN | Dejan/Haris | 17.06. | Website-Texte abnehmen |
|
||||||
|
| R-P1b | Raffael | 18.06. | P1 Service-Kerne (Audit/notify/i18n/Flags) + Konnektor-Muster |
|
||||||
|
### Do 18.06. · 7 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P4a | Akeshan | 19.06. | P4 Files (chunked Upload, HEIC→JPG, ClamAV) |
|
||||||
|
| D-D0b | David | 20.06. | D0 Archetypen A2–A7 + Zustands-Kit + Primitives |
|
||||||
|
| D-FLOW | David | 03.07. | Flow-/Node-Editor (Bespoke, Langläufer ab 18.06.) |
|
||||||
|
| H-INBOUND | Haris | 19.06. | Lead-Sheet + Inbound-Prozess (<24h) |
|
||||||
|
| H-PITCH | Haris | 19.06. | Pitch-Deck + Gesprächsskript |
|
||||||
|
| J-LIVE | Dejan | 18.06. | WEBSITE LIVE |
|
||||||
|
| R-P2a | Raffael | 19.06. | P2 Mandant + Auth (Email/PW/HIBP) + Sessions + TOTP |
|
||||||
|
<h3 class="gate">Fr 19.06. · 2 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P4b | Akeshan | 19.06. | P4 Tasks + polymorphe EntityLink-Tabelle |
|
||||||
|
| R-P2b | Raffael | 19.06. | P2 RLS-Härtung (Gate-Beweis) + RBAC + User-Lifecycle |
|
||||||
|
|
||||||
|
## Woche 2 · Sa 20.–Fr 26.06. — Plattform + CRM · 27 Tickets
|
||||||
|
*→ Gate W2 + Noah-Demo 1 (Fr 26.06.)*
|
||||||
|
### Sa 20.06. · 9 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P3 | Akeshan | 21.06. | P3 Querschnitts-Oberflächen (Audit/Notif/Sprache DE) |
|
||||||
|
| D-P2 | David | 21.06. | Screens P2 — Identität & Mandantentrennung |
|
||||||
|
| D-P3 | David | 21.06. | Screens P3 — Querschnitts-Oberflächen |
|
||||||
|
| D-P4 | David | 19.06. | Screens P4 — Files & Tasks |
|
||||||
|
| D-P5 | David | 21.06. | Screens P5 — Apps-Engine |
|
||||||
|
| J-SEO | Dejan | 26.06. | SEO + Conversion + Pricing-Seite vorbereiten |
|
||||||
|
| N-DATEN | Dejan/Haris | 26.06. | SHK-Beispieldaten liefern |
|
||||||
|
| N-LAGER | Dejan/Haris | 26.06. | Lagerist-Frage beantworten (M070-Scope) |
|
||||||
|
| R-P5 | Raffael | 21.06. | P5 Apps-Engine & Integrations-Framework |
|
||||||
|
### Mo 22.06. · 3 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P19 | Akeshan | 24.06. | P19 Plattform-Admin (admin.hivegrid.de) |
|
||||||
|
| D-CRM | David | 24.06. | CRM-Cluster-Screens |
|
||||||
|
| R-P6 | Raffael | 24.06. | P6 CRM-Kern |
|
||||||
|
### Di 23.06. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| H-CALLS | Haris | 26.06. | Erste Discovery-Calls |
|
||||||
|
### Mi 24.06. · 3 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| D-FORM | David | 26.06. | Form-Builder-Canvas + öffentliches Formular (Bespoke) |
|
||||||
|
| D-KANBAN | David | 26.06. | Pipeline-Kanban (Bespoke, konfigurierbar) |
|
||||||
|
| EXT-14 | Raffael | 25.06. | Kostenmatrix/Preise mit Partner fixieren |
|
||||||
|
### Do 25.06. · 6 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P17a | Akeshan | 25.06. | P17 HR-Kern (Stammdaten, Doku, Passwort-Safe) |
|
||||||
|
| D-HR | David | 26.06. | HR-Compose-Screens |
|
||||||
|
| D-KAMP | David | 26.06. | Kampagnen-Editor + Segmente (Bespoke) |
|
||||||
|
| D-P7 | David | 26.06. | Screens P7 — Lead-Inbox |
|
||||||
|
| H-FOUND | Haris | 26.06. | Founding-Member-Angebot strukturieren |
|
||||||
|
| R-P7 | Raffael | 26.06. | P7 Lead-Inbox |
|
||||||
|
<h3 class="gate">Fr 26.06. · 5 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-DEMO1 | Akeshan | 26.06. | Demo-Tenant + SHK-Demo-Daten für Noah-Demo 1 |
|
||||||
|
| AK-P17b | Akeshan | 26.06. | P17 HR Urlaub/Krank + Surveys + Self-Service |
|
||||||
|
| D-ADMIN | David | 26.06. | Plattform-Admin-Compose |
|
||||||
|
| H-PAYLINK | Haris | 26.06. | Mollie Payment Link (Founding-Deal) |
|
||||||
|
| N-DEMO1 | Dejan/Haris | 26.06. | Demo 1 abnehmen (CRM klickbar) |
|
||||||
|
|
||||||
|
## Woche 3 · Sa 27.06.–Fr 03.07. — Kern-Kette + Kommunikation · 23 Tickets
|
||||||
|
*→ Gate W3 + Noah-Demo 2 (Fr 03.07.)*
|
||||||
|
### Sa 27.06. · 4 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P14a | Akeshan | 28.06. | P14 Sende-Domain-Verifikation + BCC-Brücke + Tracking |
|
||||||
|
| D-P14 | David | 29.06. | Screens P14 — Email & Marketing (ohne Kampagnen-Editor) |
|
||||||
|
| D-P8 | David | 29.06. | Screens P8 — Projekt & Pipelines (Kern, ohne Kanban) |
|
||||||
|
| R-P8a | Raffael | 28.06. | P8 Pipeline-Engine + Projekt-CRUD + Auto-Projekt |
|
||||||
|
### So 28.06. · 2 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P14b | Akeshan | 29.06. | P14 Email-Marketing (Kampagnen + A/B) |
|
||||||
|
| R-P8b | Raffael | 29.06. | P8 Konfigurierbarer Kanban + Forecast/Reporting |
|
||||||
|
### Mo 29.06. · 4 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| D-ABN | David | 01.07. | Abnahme-Workflow (Bespoke-Mobile) |
|
||||||
|
| D-PLAN | David | 01.07. | Plantafel (Bespoke-Mobile, offline) |
|
||||||
|
| EXT-13 | Raffael | 29.06. | v2-Vorlauf-Externals (Gmail-Scope/Entra) |
|
||||||
|
| J-WEBINAR | Dejan | 03.07. | Webinar-Landing + Anmelde-Flow |
|
||||||
|
### Di 30.06. · 6 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P15a | Akeshan | 01.07. | P15 Telefonie (AirCall) |
|
||||||
|
| D-CHAT | David | 01.07. | Chat-UI (Bespoke) |
|
||||||
|
| D-P15 | David | 01.07. | Screens P15 — Telefonie (ohne Chat) |
|
||||||
|
| D-P9 | David | 01.07. | Screens P9 — Auftrags-Sub-Areas (ohne Plantafel/Abnahme) |
|
||||||
|
| H-DEMO | Haris | 03.07. | Klick-Demos + echte Produkt-Demos |
|
||||||
|
| R-P9a | Raffael | 01.07. | P9 Projekt-Pipeline + Sub-Areas + Rechnung (Sub-Entity v1) |
|
||||||
|
### Mi 01.07. · 3 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P15b | Akeshan | 02.07. | P15 Team-Chat (Realtime) |
|
||||||
|
| D-DASH | David | 03.07. | Dashboard (3 Rollen-Layouts) + Cmd+K |
|
||||||
|
| R-P9b | Raffael | 02.07. | P9 Plantafel (offline) + Abnahme-Protokoll (offline) |
|
||||||
|
### Do 02.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| D-BOOK | David | 03.07. | Booking-Page (Public, Polish) + Kalender-View |
|
||||||
|
<h3 class="gate">Fr 03.07. · 3 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P16a | Akeshan | 04.07. | P16 Kalender-Sync (Google) |
|
||||||
|
| N-DEMO2 | Dejan/Haris | 03.07. | Demo 2 abnehmen (Kette E2E) |
|
||||||
|
| R-P11a | Raffael | 04.07. | P11 Globale Suche (Meilisearch, Cmd+K) |
|
||||||
|
|
||||||
|
## Woche 4 · Sa 04.–Fr 10.07. — USP, Härtung, Launch · 20 Tickets
|
||||||
|
*→ Freeze (Do 09.) · LAUNCH (Fr 10.07.)*
|
||||||
|
### Sa 04.07. · 4 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P16b | Akeshan | 05.07. | P16 Booking (Slots + Verfügbarkeit + Storno) |
|
||||||
|
| D-P16 | David | 07.07. | Screens P16 — Kalender/Signatur (ohne Form/Booking) |
|
||||||
|
| J-WEBTECH | Dejan | 10.07. | Webinar-Technik (Plattform/Aufzeichnung) |
|
||||||
|
| R-P11b | Raffael | 05.07. | P11 Dashboard (3 Rollen-Layouts) |
|
||||||
|
### So 05.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P16c | Akeshan | 06.07. | P16 Form-Builder (Editor + Submission + Actions) |
|
||||||
|
### Mo 06.07. · 6 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P16d | Akeshan | 07.07. | P16 Angebot/Signatur (Self-hosted SES; PandaDoc optional BYOK) |
|
||||||
|
| D-P12 | David | 07.07. | Screens P12 — Automation (ohne Flow-Editor) |
|
||||||
|
| D-POLISH | David | 09.07. | Politur extern sichtbarer Flächen + Visual-Reg-Baselines |
|
||||||
|
| H-WEBINAR | Haris | 10.07. | Webinar-Einladungen + Moderation |
|
||||||
|
| J-LAUNCHUPD | Dejan | 10.07. | Launch-Update Website |
|
||||||
|
| R-P12a | Raffael | 07.07. | P12 Automation-Engine + Trigger/Action-Registry + Guards |
|
||||||
|
### Di 07.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| R-P12b | Raffael | 08.07. | P12 Visueller Flow-Editor + Dry-Run + 24h-Undo |
|
||||||
|
### Mi 08.07. · 2 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P20 | Akeshan | 08.07. | P20 Billing (Legacy-Provider Abo-Baukasten) + Onboarding + Branding |
|
||||||
|
| D-P20 | David | 08.07. | Screens P20 — Billing/Onboarding/Branding (ex-D-REST) |
|
||||||
|
<h3 class="gate">Do 09.07. · 3 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AK-P21 | Akeshan | 09.07. | P21 DSGVO (Export + Lösch-Workflow) + Feedback-Widget |
|
||||||
|
| D-P21 | David | 09.07. | Screens P21 — DSGVO/Launch (ex-D-REST) |
|
||||||
|
| H-FOLLOW | Haris | 10.07. | Trial-Follow-ups + Bilanz |
|
||||||
|
<h3 class="gate">Fr 10.07. · 1 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| N-GONOGO | Dejan/Haris | 10.07. | Voll-Walkthrough + Go/No-Go |
|
||||||
|
|
||||||
|
## v2-Woche 1 · Mo 13.–So 19.07. — Public-API / Postfach / Abo / MCP · 11 Tickets
|
||||||
|
*→ Webinar Nr. 1 (Di/Mi 14./15.07.)*
|
||||||
|
### Mo 13.07. · 7 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P23 | Akeshan | 17.07. | Postfach-Sync: Gmail/Outlook OAuth + Inbox + Threading + Versand (M096-098) |
|
||||||
|
| VA-P24a | Akeshan | 15.07. | Self-Service-Abo-Baukasten-UI (M28-Delta) |
|
||||||
|
| VD-P22 | David | 17.07. | Screens P22 — Public-API-Keys (ex-VD-5) |
|
||||||
|
| VD-P23 | David | 17.07. | Screens P23 — Postfach-Inbox (ex-VD-1) |
|
||||||
|
| VD-P24 | David | 15.07. | Screens P24 — Abo-Baukasten + Wizard (ex-VD-1) |
|
||||||
|
| VEXT-5 | Raffael | 19.07. | Gmail-Restricted-Scope-Verifizierung nachhalten |
|
||||||
|
| VR-P22a | Raffael | 15.07. | Public-API: OpenAPI + Read-Endpoints (M161) |
|
||||||
|
### Mi 15.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VR-P22b | Raffael | 17.07. | Public-API: API-Key-Auth/Scopes/Rate-Limit (M162/M027) + Webhooks (M163) |
|
||||||
|
### Do 16.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VD-MCP | David | 20.07. | Screens MCP — MCP-Connection-Verwaltung + Scope/Audit |
|
||||||
|
### Sa 18.07. · 2 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P24b | Akeshan | 20.07. | Onboarding-Wizard-UI (M157) |
|
||||||
|
| VR-MCP | Raffael | 20.07. | MCP-Server: Read-Ressourcen + bestätigungspflichtige Action-Tools |
|
||||||
|
|
||||||
|
## v2-Woche 2 · Mo 20.–So 26.07. — KWP / Portal / Mobile · 15 Tickets
|
||||||
|
*→ KWP-Sync-E2E mit Geerkens (Fr 24.07.)*
|
||||||
|
### Mo 20.07. · 7 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P26a | Akeshan | 21.07. | Customer-Portal: Auth/Magic-Link + Projekt-Sicht + Status-Mails (M141/142) ⭐ |
|
||||||
|
| VD-P26 | David | 22.07. | Screens P26 — Customer-Portal |
|
||||||
|
| VD-P27 | David | 22.07. | Screens P27 — Mobile-PWA-Shell (PWA-only) |
|
||||||
|
| VD-P32 | David | 22.07. | Screens P32 — KWP-Setup (ex-VD-5) |
|
||||||
|
| VEXT-1 •B2 | Raffael | 20.07. | KWP-API-Zugang nutzen + Recut-Detailplanung gegen API-Doku |
|
||||||
|
| VN-1 •B2 | Dejan/Haris | 23.07. | KWP-Test-Instanz/Testdaten bereitstellen |
|
||||||
|
| VR-P32a •B2 | Raffael | 22.07. | KWP: Connector + Health + Push-Queue (M089/090/091) |
|
||||||
|
### Di 21.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P26b | Akeshan | 22.07. | Customer-Portal: Upload/Reklamation + Subunternehmer/Skalierung/DSGVO (M143-146) ⭐ |
|
||||||
|
### Mi 22.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VR-P32b •B2 | Raffael | 24.07. | KWP: Contract-Sentinel + Konflikt 'KWP gewinnt' (M092/093) |
|
||||||
|
### Do 23.07. · 2 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P27a | Akeshan | 25.07. | Mobile-PWA-Ausbau: Installierbarkeit + Service-Worker-Offline + Web-Push/Kamera (M167/168) |
|
||||||
|
| VD-P29 | David | 27.07. | Screens P29 — Help-Center |
|
||||||
|
<h3 class="gate">Fr 24.07. · 3 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VH-1 | Haris | 31.07. | KWP-Sync als Verkaufsargument + weitere Onboardings/Conversions |
|
||||||
|
| VN-2 •B2 | Dejan/Haris | 24.07. | KWP-Sync-E2E-Verprobung mit Geerkens |
|
||||||
|
| VR-P32c •B2 | Raffael | 26.07. | KWP: Plantafel-Sync + Doku-Archiv + Task-ERP-Sync (M094/095/074) |
|
||||||
|
### Sa 25.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P27b | Akeshan | 27.07. | Mobile-PWA-Ausbau: mobile Navigation + Offline-Sync + PWA-Härtung (M169/170/171) |
|
||||||
|
|
||||||
|
## v2-Woche 3 · Mo 27.–Fr 31.07. — Admin / Help / Dashboard · 16 Tickets
|
||||||
|
*→ v2 KOMPLETT LIVE (Fr 31.07.)*
|
||||||
|
### Mo 27.07. · 4 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VD-P28 | David | 29.07. | Screens P28 — Plattform-Admin-Tiefe (ex-VD-5) |
|
||||||
|
| VEXT-2 •B2 | Raffael | 29.07. | HalloPetra-Spec erheben (API-Vertrag) |
|
||||||
|
| VEXT-3 •B2 | Akeshan | 29.07. | Memberspot/Boobora-Spec erheben (HR-Drittanbieter) |
|
||||||
|
| VR-P28a | Raffael | 29.07. | AdminUser-Welt + AdminRBAC (M038/039) |
|
||||||
|
### Di 28.07. · 3 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P29 | Akeshan | 30.07. | Help-Center + Help-Desk (M172-175) |
|
||||||
|
| VD-6 | David | 31.07. | Screens: v2-Politur (extern) + Visual-Reg-Baselines |
|
||||||
|
| VJ-2 | Dejan | 28.07. | Help-Center-Inhalte einpflegen |
|
||||||
|
### Mi 29.07. · 7 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P28b | Akeshan | 31.07. | Flag-Massen-Statistik (M033) + interne Lead-Pipeline (M040) |
|
||||||
|
| VA-P30a | Akeshan | 30.07. | Dashboard-Deluxe: Custom-Widgets + Export (M149/150) |
|
||||||
|
| VA-P34 •B2 | Akeshan | 31.07. | HR-Drittanbieter-Onboarding Memberspot/Boobora (M138) |
|
||||||
|
| VD-P30 | David | 30.07. | Screens P30 — Dashboard-Deluxe |
|
||||||
|
| VD-P31 | David | 31.07. | Screens P31 — DSGVO-Vollausbau |
|
||||||
|
| VR-P31 | Raffael | 31.07. | DSGVO-Vollausbau: AVV/Subprozessoren/Auskunft (M166) |
|
||||||
|
| VR-P33 •B2 | Raffael | 31.07. | Telefonie-Erweiterung HalloPetra (M105) |
|
||||||
|
### Do 30.07. · 1 Ticket(s)
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VA-P30b | Akeshan | 31.07. | Querschnitt: Notif-Bündelung/Quiet-Hours (M117) + Sprach-Wechsler/EN (M029) |
|
||||||
|
<h3 class="gate">Fr 31.07. · 1 Ticket(s)</h3>
|
||||||
|
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VJ-3 | Dejan | 31.07. | Website-Update: Portal/Mobile-PWA/KWP als Features live |
|
||||||
|
|
||||||
|
## v3-Backlog (zurückgestellt — NICHT im Sprint) · 2
|
||||||
|
*PWA-only (AD-17): native App + App-Store erst v3. Diese Tickets sind keinem Cycle zugeordnet.*
|
||||||
|
|
||||||
|
| Ticket | Wer | bis | Aufgabe |
|
||||||
|
|---|---|---|---|
|
||||||
|
| VEXT-4 | Akeshan | 28.07. | [v3] App-Store-Einreichung Apple + Google (zurückgestellt — PWA-only) |
|
||||||
|
| VJ-1 | Dejan | 27.07. | [v3] App-Store-Metadaten (zurückgestellt — PWA-only) |
|
||||||
|
|
||||||
|
<h2 class="idx">Ticket-Index — alle 152 Tickets (nach Track)</h2>
|
||||||
|
*Zum Nachschlagen, je Track nach Start sortiert. •B2 = Block 2 (Partner-API offen, agil).*
|
||||||
|
|
||||||
|
### Raffael · 40 Tickets
|
||||||
|
|
||||||
|
| Ticket | Start | bis | v | Aufgabe |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| EXT-02 | 16.06. | 16.06. | v1 | Mailjet Sende-Domain (SPF/DKIM/DMARC) + Warm-up |
|
||||||
|
| EXT-04 | 16.06. | 17.06. | v1 | KWP: Callback-URLs melden + bnWin.net 8.1 N3 |
|
||||||
|
| EXT-05 | 16.06. | 16.06. | v1 | Noah: 4 Gate-Freitags-Slots blocken |
|
||||||
|
| EXT-06 | 16.06. | 17.06. | v1 | Hetzner-Projekt HiveGrid: S3+Token + DEK-Master-Key |
|
||||||
|
| EXT-07 | 16.06. | 26.06. | v1 | Legacy-Provider-Konto + Live-Verifizierung |
|
||||||
|
| EXT-08 | 16.06. | 30.06. | v1 | AirCall-Konto + Sandbox + Webhooks |
|
||||||
|
| EXT-09 | 16.06. | 03.07. | v1 | Signatur-Provider-Entscheid: SES default, PandaDoc optional BYOK |
|
||||||
|
| EXT-10 | 16.06. | 18.06. | v1 | Google-Cloud OAuth + Calendar-Scope-Antrag |
|
||||||
|
| EXT-12 | 16.06. | 19.06. | v1 | Geo-IP + HIBP prüfen/anbinden |
|
||||||
|
| R-P1a | 16.06. | 17.06. | v1 | P1 EU-Sterilisation + Contracts + URL-Schemata |
|
||||||
|
| R-P1c | 16.06. | 17.06. | v1 | P1 Hot-Swap-Maschine + Walking-Skeleton + PWA |
|
||||||
|
| R-REFIT | 16.06. | 21.06. | v1 | ER-Modell-Re-Fit P6–P9 (Requirements/Screen-Map/Phase-Sources) |
|
||||||
|
| R-P1b | 17.06. | 18.06. | v1 | P1 Service-Kerne (Audit/notify/i18n/Flags) + Konnektor-Muster |
|
||||||
|
| R-P2a | 18.06. | 19.06. | v1 | P2 Mandant + Auth (Email/PW/HIBP) + Sessions + TOTP |
|
||||||
|
| R-P2b | 19.06. | 19.06. | v1 | P2 RLS-Härtung (Gate-Beweis) + RBAC + User-Lifecycle |
|
||||||
|
| R-P5 | 20.06. | 21.06. | v1 | P5 Apps-Engine & Integrations-Framework |
|
||||||
|
| R-P6 | 22.06. | 24.06. | v1 | P6 CRM-Kern |
|
||||||
|
| EXT-14 | 24.06. | 25.06. | v1 | Kostenmatrix/Preise mit Partner fixieren |
|
||||||
|
| R-P7 | 25.06. | 26.06. | v1 | P7 Lead-Inbox |
|
||||||
|
| R-P8a | 27.06. | 28.06. | v1 | P8 Pipeline-Engine + Projekt-CRUD + Auto-Projekt |
|
||||||
|
| R-P8b | 28.06. | 29.06. | v1 | P8 Konfigurierbarer Kanban + Forecast/Reporting |
|
||||||
|
| EXT-13 | 29.06. | 29.06. | v1 | v2-Vorlauf-Externals (Gmail-Scope/Entra) |
|
||||||
|
| R-P9a | 30.06. | 01.07. | v1 | P9 Projekt-Pipeline + Sub-Areas + Rechnung (Sub-Entity v1) |
|
||||||
|
| R-P9b | 01.07. | 02.07. | v1 | P9 Plantafel (offline) + Abnahme-Protokoll (offline) |
|
||||||
|
| R-P11a | 03.07. | 04.07. | v1 | P11 Globale Suche (Meilisearch, Cmd+K) |
|
||||||
|
| R-P11b | 04.07. | 05.07. | v1 | P11 Dashboard (3 Rollen-Layouts) |
|
||||||
|
| R-P12a | 06.07. | 07.07. | v1 | P12 Automation-Engine + Trigger/Action-Registry + Guards |
|
||||||
|
| R-P12b | 07.07. | 08.07. | v1 | P12 Visueller Flow-Editor + Dry-Run + 24h-Undo |
|
||||||
|
| VEXT-5 | 13.07. | 19.07. | v2 | Gmail-Restricted-Scope-Verifizierung nachhalten |
|
||||||
|
| VR-P22a | 13.07. | 15.07. | v2 | Public-API: OpenAPI + Read-Endpoints (M161) |
|
||||||
|
| VR-P22b | 15.07. | 17.07. | v2 | Public-API: API-Key-Auth/Scopes/Rate-Limit (M162/M027) + Webhooks (M163) |
|
||||||
|
| VR-MCP | 18.07. | 20.07. | v2 | MCP-Server: Read-Ressourcen + bestätigungspflichtige Action-Tools |
|
||||||
|
| VEXT-1 •B2 | 20.07. | 20.07. | v2 | KWP-API-Zugang nutzen + Recut-Detailplanung gegen API-Doku |
|
||||||
|
| VR-P32a •B2 | 20.07. | 22.07. | v2 | KWP: Connector + Health + Push-Queue (M089/090/091) |
|
||||||
|
| VR-P32b •B2 | 22.07. | 24.07. | v2 | KWP: Contract-Sentinel + Konflikt 'KWP gewinnt' (M092/093) |
|
||||||
|
| VR-P32c •B2 | 24.07. | 26.07. | v2 | KWP: Plantafel-Sync + Doku-Archiv + Task-ERP-Sync (M094/095/074) |
|
||||||
|
| VEXT-2 •B2 | 27.07. | 29.07. | v2 | HalloPetra-Spec erheben (API-Vertrag) |
|
||||||
|
| VR-P28a | 27.07. | 29.07. | v2 | AdminUser-Welt + AdminRBAC (M038/039) |
|
||||||
|
| VR-P31 | 29.07. | 31.07. | v2 | DSGVO-Vollausbau: AVV/Subprozessoren/Auskunft (M166) |
|
||||||
|
| VR-P33 •B2 | 29.07. | 31.07. | v2 | Telefonie-Erweiterung HalloPetra (M105) |
|
||||||
|
|
||||||
|
### Akeshan · 32 Tickets
|
||||||
|
|
||||||
|
| Ticket | Start | bis | v | Aufgabe |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| AK-INFRA1 | 16.06. | 17.06. | v1 | Infra-Live: Staging + Coolify-Apps + PG/Redis/PgBouncer |
|
||||||
|
| AK-INFRA2 | 17.06. | 18.06. | v1 | DNS + Wildcard-TLS + zentrale Dienste anbinden |
|
||||||
|
| AK-P4a | 18.06. | 19.06. | v1 | P4 Files (chunked Upload, HEIC→JPG, ClamAV) |
|
||||||
|
| AK-P4b | 19.06. | 19.06. | v1 | P4 Tasks + polymorphe EntityLink-Tabelle |
|
||||||
|
| AK-P3 | 20.06. | 21.06. | v1 | P3 Querschnitts-Oberflächen (Audit/Notif/Sprache DE) |
|
||||||
|
| AK-P19 | 22.06. | 24.06. | v1 | P19 Plattform-Admin (admin.hivegrid.de) |
|
||||||
|
| AK-P17a | 25.06. | 25.06. | v1 | P17 HR-Kern (Stammdaten, Doku, Passwort-Safe) |
|
||||||
|
| AK-DEMO1 | 26.06. | 26.06. | v1 | Demo-Tenant + SHK-Demo-Daten für Noah-Demo 1 |
|
||||||
|
| AK-P17b | 26.06. | 26.06. | v1 | P17 HR Urlaub/Krank + Surveys + Self-Service |
|
||||||
|
| AK-P14a | 27.06. | 28.06. | v1 | P14 Sende-Domain-Verifikation + BCC-Brücke + Tracking |
|
||||||
|
| AK-P14b | 28.06. | 29.06. | v1 | P14 Email-Marketing (Kampagnen + A/B) |
|
||||||
|
| AK-P15a | 30.06. | 01.07. | v1 | P15 Telefonie (AirCall) |
|
||||||
|
| AK-P15b | 01.07. | 02.07. | v1 | P15 Team-Chat (Realtime) |
|
||||||
|
| AK-P16a | 03.07. | 04.07. | v1 | P16 Kalender-Sync (Google) |
|
||||||
|
| AK-P16b | 04.07. | 05.07. | v1 | P16 Booking (Slots + Verfügbarkeit + Storno) |
|
||||||
|
| AK-P16c | 05.07. | 06.07. | v1 | P16 Form-Builder (Editor + Submission + Actions) |
|
||||||
|
| AK-P16d | 06.07. | 07.07. | v1 | P16 Angebot/Signatur (Self-hosted SES; PandaDoc optional BYOK) |
|
||||||
|
| AK-P20 | 08.07. | 08.07. | v1 | P20 Billing (Legacy-Provider Abo-Baukasten) + Onboarding + Branding |
|
||||||
|
| AK-P21 | 09.07. | 09.07. | v1 | P21 DSGVO (Export + Lösch-Workflow) + Feedback-Widget |
|
||||||
|
| VA-P23 | 13.07. | 17.07. | v2 | Postfach-Sync: Gmail/Outlook OAuth + Inbox + Threading + Versand (M096-098) |
|
||||||
|
| VA-P24a | 13.07. | 15.07. | v2 | Self-Service-Abo-Baukasten-UI (M28-Delta) |
|
||||||
|
| VA-P24b | 18.07. | 20.07. | v2 | Onboarding-Wizard-UI (M157) |
|
||||||
|
| VA-P26a | 20.07. | 21.07. | v2 | Customer-Portal: Auth/Magic-Link + Projekt-Sicht + Status-Mails (M141/142) ⭐ |
|
||||||
|
| VA-P26b | 21.07. | 22.07. | v2 | Customer-Portal: Upload/Reklamation + Subunternehmer/Skalierung/DSGVO (M143-146) ⭐ |
|
||||||
|
| VA-P27a | 23.07. | 25.07. | v2 | Mobile-PWA-Ausbau: Installierbarkeit + Service-Worker-Offline + Web-Push/Kamera (M167/168) |
|
||||||
|
| VA-P27b | 25.07. | 27.07. | v2 | Mobile-PWA-Ausbau: mobile Navigation + Offline-Sync + PWA-Härtung (M169/170/171) |
|
||||||
|
| VEXT-3 •B2 | 27.07. | 29.07. | v2 | Memberspot/Boobora-Spec erheben (HR-Drittanbieter) |
|
||||||
|
| VA-P29 | 28.07. | 30.07. | v2 | Help-Center + Help-Desk (M172-175) |
|
||||||
|
| VA-P28b | 29.07. | 31.07. | v2 | Flag-Massen-Statistik (M033) + interne Lead-Pipeline (M040) |
|
||||||
|
| VA-P30a | 29.07. | 30.07. | v2 | Dashboard-Deluxe: Custom-Widgets + Export (M149/150) |
|
||||||
|
| VA-P34 •B2 | 29.07. | 31.07. | v2 | HR-Drittanbieter-Onboarding Memberspot/Boobora (M138) |
|
||||||
|
| VA-P30b | 30.07. | 31.07. | v2 | Querschnitt: Notif-Bündelung/Quiet-Hours (M117) + Sprach-Wechsler/EN (M029) |
|
||||||
|
|
||||||
|
### David · 41 Tickets
|
||||||
|
|
||||||
|
| Ticket | Start | bis | v | Aufgabe |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| D-D0a | 16.06. | 18.06. | v1 | D0 Design-System + App-Shell (A1) |
|
||||||
|
| D-WEB | 16.06. | 16.06. | v1 | Website-Screens + Brand-Tokens |
|
||||||
|
| D-D0b | 18.06. | 20.06. | v1 | D0 Archetypen A2–A7 + Zustands-Kit + Primitives |
|
||||||
|
| D-FLOW | 18.06. | 03.07. | v1 | Flow-/Node-Editor (Bespoke, Langläufer ab 18.06.) |
|
||||||
|
| D-P2 | 20.06. | 21.06. | v1 | Screens P2 — Identität & Mandantentrennung |
|
||||||
|
| D-P3 | 20.06. | 21.06. | v1 | Screens P3 — Querschnitts-Oberflächen |
|
||||||
|
| D-P4 | 20.06. | 19.06. | v1 | Screens P4 — Files & Tasks |
|
||||||
|
| D-P5 | 20.06. | 21.06. | v1 | Screens P5 — Apps-Engine |
|
||||||
|
| D-CRM | 22.06. | 24.06. | v1 | CRM-Cluster-Screens |
|
||||||
|
| D-FORM | 24.06. | 26.06. | v1 | Form-Builder-Canvas + öffentliches Formular (Bespoke) |
|
||||||
|
| D-KANBAN | 24.06. | 26.06. | v1 | Pipeline-Kanban (Bespoke, konfigurierbar) |
|
||||||
|
| D-HR | 25.06. | 26.06. | v1 | HR-Compose-Screens |
|
||||||
|
| D-KAMP | 25.06. | 26.06. | v1 | Kampagnen-Editor + Segmente (Bespoke) |
|
||||||
|
| D-P7 | 25.06. | 26.06. | v1 | Screens P7 — Lead-Inbox |
|
||||||
|
| D-ADMIN | 26.06. | 26.06. | v1 | Plattform-Admin-Compose |
|
||||||
|
| D-P14 | 27.06. | 29.06. | v1 | Screens P14 — Email & Marketing (ohne Kampagnen-Editor) |
|
||||||
|
| D-P8 | 27.06. | 29.06. | v1 | Screens P8 — Projekt & Pipelines (Kern, ohne Kanban) |
|
||||||
|
| D-ABN | 29.06. | 01.07. | v1 | Abnahme-Workflow (Bespoke-Mobile) |
|
||||||
|
| D-PLAN | 29.06. | 01.07. | v1 | Plantafel (Bespoke-Mobile, offline) |
|
||||||
|
| D-CHAT | 30.06. | 01.07. | v1 | Chat-UI (Bespoke) |
|
||||||
|
| D-P15 | 30.06. | 01.07. | v1 | Screens P15 — Telefonie (ohne Chat) |
|
||||||
|
| D-P9 | 30.06. | 01.07. | v1 | Screens P9 — Auftrags-Sub-Areas (ohne Plantafel/Abnahme) |
|
||||||
|
| D-DASH | 01.07. | 03.07. | v1 | Dashboard (3 Rollen-Layouts) + Cmd+K |
|
||||||
|
| D-BOOK | 02.07. | 03.07. | v1 | Booking-Page (Public, Polish) + Kalender-View |
|
||||||
|
| D-P16 | 04.07. | 07.07. | v1 | Screens P16 — Kalender/Signatur (ohne Form/Booking) |
|
||||||
|
| D-P12 | 06.07. | 07.07. | v1 | Screens P12 — Automation (ohne Flow-Editor) |
|
||||||
|
| D-POLISH | 06.07. | 09.07. | v1 | Politur extern sichtbarer Flächen + Visual-Reg-Baselines |
|
||||||
|
| D-P20 | 08.07. | 08.07. | v1 | Screens P20 — Billing/Onboarding/Branding (ex-D-REST) |
|
||||||
|
| D-P21 | 09.07. | 09.07. | v1 | Screens P21 — DSGVO/Launch (ex-D-REST) |
|
||||||
|
| VD-P22 | 13.07. | 17.07. | v2 | Screens P22 — Public-API-Keys (ex-VD-5) |
|
||||||
|
| VD-P23 | 13.07. | 17.07. | v2 | Screens P23 — Postfach-Inbox (ex-VD-1) |
|
||||||
|
| VD-P24 | 13.07. | 15.07. | v2 | Screens P24 — Abo-Baukasten + Wizard (ex-VD-1) |
|
||||||
|
| VD-MCP | 16.07. | 20.07. | v2 | Screens MCP — MCP-Connection-Verwaltung + Scope/Audit |
|
||||||
|
| VD-P26 | 20.07. | 22.07. | v2 | Screens P26 — Customer-Portal |
|
||||||
|
| VD-P27 | 20.07. | 22.07. | v2 | Screens P27 — Mobile-PWA-Shell (PWA-only) |
|
||||||
|
| VD-P32 | 20.07. | 22.07. | v2 | Screens P32 — KWP-Setup (ex-VD-5) |
|
||||||
|
| VD-P29 | 23.07. | 27.07. | v2 | Screens P29 — Help-Center |
|
||||||
|
| VD-P28 | 27.07. | 29.07. | v2 | Screens P28 — Plattform-Admin-Tiefe (ex-VD-5) |
|
||||||
|
| VD-6 | 28.07. | 31.07. | v2 | Screens: v2-Politur (extern) + Visual-Reg-Baselines |
|
||||||
|
| VD-P30 | 29.07. | 30.07. | v2 | Screens P30 — Dashboard-Deluxe |
|
||||||
|
| VD-P31 | 29.07. | 31.07. | v2 | Screens P31 — DSGVO-Vollausbau |
|
||||||
|
|
||||||
|
### Dejan · 13 Tickets
|
||||||
|
|
||||||
|
| Ticket | Start | bis | v | Aufgabe |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| EXT-03 | 16.06. | 19.06. | v1 | Anwalt: AVV + DSGVO-Auskunft + Website-Rechtstexte |
|
||||||
|
| J-SETUP | 16.06. | 16.06. | v1 | Domain/Hosting/Stack + Setup |
|
||||||
|
| J-STRUKTUR | 16.06. | 17.06. | v1 | Seitenstruktur + Davids Screens einbauen |
|
||||||
|
| J-CONTENT | 17.06. | 17.06. | v1 | Content/Texte einbauen |
|
||||||
|
| J-LAW | 17.06. | 18.06. | v1 | Rechtstexte einbauen (Anwalt) |
|
||||||
|
| J-QA | 17.06. | 18.06. | v1 | QA + Lead-Routing-Test |
|
||||||
|
| J-LIVE | 18.06. | 18.06. | v1 | WEBSITE LIVE |
|
||||||
|
| J-SEO | 20.06. | 26.06. | v1 | SEO + Conversion + Pricing-Seite vorbereiten |
|
||||||
|
| J-WEBINAR | 29.06. | 03.07. | v1 | Webinar-Landing + Anmelde-Flow |
|
||||||
|
| J-WEBTECH | 04.07. | 10.07. | v1 | Webinar-Technik (Plattform/Aufzeichnung) |
|
||||||
|
| J-LAUNCHUPD | 06.07. | 10.07. | v1 | Launch-Update Website |
|
||||||
|
| VJ-2 | 28.07. | 28.07. | v2 | Help-Center-Inhalte einpflegen |
|
||||||
|
| VJ-3 | 31.07. | 31.07. | v2 | Website-Update: Portal/Mobile-PWA/KWP als Features live |
|
||||||
|
|
||||||
|
### Haris · 12 Tickets
|
||||||
|
|
||||||
|
| Ticket | Start | bis | v | Aufgabe |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| H-LISTE | 16.06. | 17.06. | v1 | Zielkundenliste SHK (KWP-Nutzer-Fokus) |
|
||||||
|
| H-PAIN | 16.06. | 17.06. | v1 | Painpoint-Gespräch mit Noah |
|
||||||
|
| H-TXT | 17.06. | 17.06. | v1 | Website-Texte schreiben |
|
||||||
|
| H-INBOUND | 18.06. | 19.06. | v1 | Lead-Sheet + Inbound-Prozess (<24h) |
|
||||||
|
| H-PITCH | 18.06. | 19.06. | v1 | Pitch-Deck + Gesprächsskript |
|
||||||
|
| H-CALLS | 23.06. | 26.06. | v1 | Erste Discovery-Calls |
|
||||||
|
| H-FOUND | 25.06. | 26.06. | v1 | Founding-Member-Angebot strukturieren |
|
||||||
|
| H-PAYLINK | 26.06. | 26.06. | v1 | Mollie Payment Link (Founding-Deal) |
|
||||||
|
| H-DEMO | 30.06. | 03.07. | v1 | Klick-Demos + echte Produkt-Demos |
|
||||||
|
| H-WEBINAR | 06.07. | 10.07. | v1 | Webinar-Einladungen + Moderation |
|
||||||
|
| H-FOLLOW | 09.07. | 10.07. | v1 | Trial-Follow-ups + Bilanz |
|
||||||
|
| VH-1 | 24.07. | 31.07. | v2 | KWP-Sync als Verkaufsargument + weitere Onboardings/Conversions |
|
||||||
|
|
||||||
|
### Dejan/Haris (Noah-Zulieferungen) · 11 Tickets
|
||||||
|
|
||||||
|
| Ticket | Start | bis | v | Aufgabe |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| N-KWP | 16.06. | 17.06. | v1 | KWP-Mail freigeben + bnWin.net 8.1 N3 anstoßen |
|
||||||
|
| N-PAIN | 16.06. | 17.06. | v1 | Painpoint-Input liefern (mit Haris) |
|
||||||
|
| N-SLOTS | 16.06. | 16.06. | v1 | 4 Gate-Freitags-Slots bestätigen |
|
||||||
|
| N-TXTABN | 17.06. | 17.06. | v1 | Website-Texte abnehmen |
|
||||||
|
| N-DATEN | 20.06. | 26.06. | v1 | SHK-Beispieldaten liefern |
|
||||||
|
| N-LAGER | 20.06. | 26.06. | v1 | Lagerist-Frage beantworten (M070-Scope) |
|
||||||
|
| N-DEMO1 | 26.06. | 26.06. | v1 | Demo 1 abnehmen (CRM klickbar) |
|
||||||
|
| N-DEMO2 | 03.07. | 03.07. | v1 | Demo 2 abnehmen (Kette E2E) |
|
||||||
|
| N-GONOGO | 10.07. | 10.07. | v1 | Voll-Walkthrough + Go/No-Go |
|
||||||
|
| VN-1 •B2 | 20.07. | 23.07. | v2 | KWP-Test-Instanz/Testdaten bereitstellen |
|
||||||
|
| VN-2 •B2 | 24.07. | 24.07. | v2 | KWP-Sync-E2E-Verprobung mit Geerkens |
|
||||||
Binary file not shown.
Loaded 100 of 5989 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user