105 lines
3.1 KiB
Markdown
105 lines
3.1 KiB
Markdown
# 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
|