From 1e6450eed653692379b65a7775d5ce2c42137d67 Mon Sep 17 00:00:00 2001
From: "laurent.deleers@gmail.com" <laurent.deleers@gmail.com>
Date: Sun, 8 Feb 2026 16:53:22 +0100
Subject: [PATCH] autocomit

---
 ...Y-4-Environments-WONT-IMPLEMENT-AS-SUCH.md | 104 ++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 doc/stories/STORY-4-Environments-WONT-IMPLEMENT-AS-SUCH.md

diff --git a/doc/stories/STORY-4-Environments-WONT-IMPLEMENT-AS-SUCH.md b/doc/stories/STORY-4-Environments-WONT-IMPLEMENT-AS-SUCH.md
new file mode 100644
index 0000000..9903e89
--- /dev/null
+++ b/doc/stories/STORY-4-Environments-WONT-IMPLEMENT-AS-SUCH.md
@@ -0,0 +1,104 @@
+# Story 4: Environment Management (Enhancement)
+
+## Story Overview
+
+**As a** system administrator  
+**I want** to enhance environment management  
+**So that** I can better organize and categorize deployment targets
+
+**Story Type**: Enhancement  
+**Priority**: Medium  
+**Estimated Effort**: 2-3 days  
+**Dependencies**: Story 0 (Foundation - basic Environment CRUD exists)
+
+---
+
+## Business Value
+
+Story 0 created basic Environment CRUD. This story enhances it with:
+- Better organization and categorization
+- Production environment safety controls
+- Criticality-based filtering and alerts
+- Foundation for environment-specific permissions
+
+---
+
+## Scope
+
+### In Scope (Enhancements to Story 0)
+✅ Add environment categorization/tags  
+✅ Add environment deactivation (soft delete)  
+✅ Add production environment warnings  
+✅ Add environment groups (e.g., "Production EU", "Development")  
+✅ Enhanced search and filtering  
+
+### Out of Scope
+❌ Environment-specific user permissions (future)  
+❌ Environment health monitoring (future)  
+
+---
+
+## Database Migration
+
+```sql
+-- Add new columns to existing environment table
+ALTER TABLE environment
+ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true,
+ADD COLUMN environment_group VARCHAR(100),
+ADD COLUMN tags VARCHAR(255);
+
+-- Index for filtering
+CREATE INDEX idx_environment_active ON environment(is_active);
+CREATE INDEX idx_environment_group ON environment(environment_group);
+```
+
+---
+
+## Key Enhancements
+
+### Backend
+- [ ] Add `isActive` field to Environment entity (soft delete)
+- [ ] Add `environmentGroup` field (e.g., "Production", "Non-Production")
+- [ ] Add `tags` field (comma-separated or JSON array)
+- [ ] Update `EnvironmentRepository` with new queries:
+  - `findByIsActive(boolean)`
+  - `findByEnvironmentGroup(String)`
+  - `findByIsProductionAndIsActive(boolean, boolean)`
+- [ ] Add deactivate/reactivate methods to service
+- [ ] Update DTOs with new fields
+
+### Frontend
+- [ ] Add "Active/Inactive" filter toggle
+- [ ] Add "Group" filter dropdown
+- [ ] Show warning dialog when creating/editing production environments
+- [ ] Show "Deactivate" instead of "Delete" (with reactivate option)
+- [ ] Add visual indicators for inactive environments (grayed out)
+- [ ] Add environment group badges
+
+---
+
+## Acceptance Criteria
+
+- [ ] Environments can be deactivated (soft delete)
+- [ ] Inactive environments are hidden by default
+- [ ] User can view inactive environments via filter
+- [ ] Inactive environments can be reactivated
+- [ ] Production environments show warning before modifications
+- [ ] Environments can be organized into groups
+- [ ] Environments can be tagged
+- [ ] Search includes tags and groups
+
+---
+
+## Testing Scenarios
+
+1. **Deactivate Environment**: Deactivate an environment, verify it's hidden from default list
+2. **Reactivate Environment**: Reactivate an environment, verify it appears again
+3. **Production Warning**: Attempt to edit production environment, verify warning shown
+4. **Group Filtering**: Filter by environment group, verify correct results
+5. **Tag Search**: Search by tag, verify matching environments shown
+
+---
+
+**Story Status**: Ready for Development  
+**Estimated Completion**: 2-3 days