Add complete planning documentation for CSS architecture refactoring project: - 7-phase implementation plan (92-120 hours) - 123 detailed tasks across all phases - Target: ~3,260 lines CSS reduction (40-50%) - Complete requirements analysis - Progress tracking system - Phase-by-phase breakdown with acceptance criteria Documentation structure: - features/README.md - Project overview and quick start - features/CSS_REFACTORING_PLAN.md - Implementation strategy - features/CSS_REFACTORING_REQUIREMENTS.md - Detailed requirements - features/PROGRESS_TRACKER.md - Live progress tracking - features/phases/*.md - 7 phase documents with tasks Ready to begin Phase 1: Forms Standardization 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
466 lines
12 KiB
Markdown
466 lines
12 KiB
Markdown
# ROA2WEB CSS Refactoring - Progress Tracker
|
|
|
|
**Last Updated:** 2025-11-18
|
|
**Overall Status:** ⏸️ Not Started (Awaiting Approval)
|
|
**Branch:** `feature/css-refactoring`
|
|
|
|
---
|
|
|
|
## Overall Progress
|
|
|
|
```
|
|
Progress: [░░░░░░░░░░░░░░░░░░░░] 0% Complete
|
|
|
|
Phases Complete: 0/7
|
|
Tasks Complete: 0/117
|
|
Hours Spent: 0h / 92-120h
|
|
CSS Lines Eliminated: 0 / ~3,260
|
|
```
|
|
|
|
---
|
|
|
|
## Phase Status Overview
|
|
|
|
| Phase | Status | Progress | Tasks | Time | Lines Saved | Started | Completed |
|
|
|-------|--------|----------|-------|------|-------------|---------|-----------|
|
|
| **Phase 1: Forms** | ⏸️ Not Started | 0% | 0/18 | 0h/12h | 0/150 | - | - |
|
|
| **Phase 2: Foundation** | ⏸️ Not Started | 0% | 0/15 | 0h/10h | 0/0 | - | - |
|
|
| **Phase 3: PrimeVue** | ⏸️ Not Started | 0% | 0/12 | 0h/8h | 0/150 | - | - |
|
|
| **Phase 4: Cards** | ⏸️ Not Started | 0% | 0/22 | 0h/20h | 0/800 | - | - |
|
|
| **Phase 5: Dashboard** | ⏸️ Not Started | 0% | 0/28 | 0h/32h | 0/1710 | - | - |
|
|
| **Phase 6: Views** | ⏸️ Not Started | 0% | 0/16 | 0h/20h | 0/400 | - | - |
|
|
| **Phase 7: Docs** | ⏸️ Not Started | 0% | 0/12 | 0h/16h | 0/0 | - | - |
|
|
|
|
**Legend:**
|
|
- ⏸️ Not Started
|
|
- 🔄 In Progress
|
|
- ⏸️ Paused
|
|
- ✅ Complete
|
|
- ❌ Blocked
|
|
|
|
---
|
|
|
|
## Current Sprint
|
|
|
|
### Active Phase
|
|
**None** - Awaiting project approval
|
|
|
|
### Today's Focus
|
|
- Planning and documentation
|
|
- Awaiting approval to start Phase 1
|
|
|
|
### Blockers
|
|
- [ ] Plan approval required
|
|
- [ ] Resources allocation needed
|
|
- [ ] Testing environment confirmation
|
|
|
|
---
|
|
|
|
## Detailed Phase Progress
|
|
|
|
### Phase 1: Standardizare Formulare ⚡
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/18 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/18 complete)</summary>
|
|
|
|
#### Setup & Preparation (0/3)
|
|
- [ ] Create feature branch `feature/css-refactoring`
|
|
- [ ] Capture Playwright baseline snapshots
|
|
- [ ] Review existing forms.css capabilities
|
|
|
|
#### LoginView.vue Refactoring (0/6)
|
|
- [ ] Update template: `.field` → `.form-group`
|
|
- [ ] Update template: `.field-label` → `.form-label`
|
|
- [ ] Remove custom form CSS (lines 234-243)
|
|
- [ ] Remove PrimeVue `:deep()` overrides (lines 269-288)
|
|
- [ ] Test login functionality
|
|
- [ ] Visual regression test
|
|
|
|
#### InvoicesView.vue Refactoring (0/5)
|
|
- [ ] Update template: `.filter-group` → `.form-group`
|
|
- [ ] Update template: `.filter-label` → `.form-label`
|
|
- [ ] Convert `.filters-row` to `.form-row`
|
|
- [ ] Remove custom filter CSS (lines 545-578)
|
|
- [ ] Visual regression test
|
|
|
|
#### Testing & Validation (0/3)
|
|
- [ ] Playwright snapshot comparison
|
|
- [ ] Manual testing all breakpoints
|
|
- [ ] Browser compatibility check
|
|
|
|
#### Documentation (0/1)
|
|
- [ ] Create form template documentation
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 10-12h | **CSS Eliminated:** 0 / ~150 lines
|
|
|
|
---
|
|
|
|
### Phase 2: Fundație Pattern-uri Globale 🏗️
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/15 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/15 complete)</summary>
|
|
|
|
#### File Creation (0/5)
|
|
- [ ] Create `assets/css/patterns/interactive.css`
|
|
- [ ] Create `assets/css/patterns/dashboard.css`
|
|
- [ ] Create `assets/css/patterns/animations.css`
|
|
- [ ] Create `assets/css/core/tokens.css`
|
|
- [ ] Create `assets/css/vendor/primevue-overrides.css`
|
|
|
|
#### Pattern Implementation (0/7)
|
|
- [ ] Implement loading spinner patterns
|
|
- [ ] Implement trend indicator patterns
|
|
- [ ] Implement collapse/expand patterns
|
|
- [ ] Implement page header patterns
|
|
- [ ] Implement section header patterns
|
|
- [ ] Implement breakdown patterns
|
|
- [ ] Implement card hover effects
|
|
|
|
#### Integration (0/2)
|
|
- [ ] Update `main.css` with new imports
|
|
- [ ] Verify no visual changes
|
|
|
|
#### Testing (0/1)
|
|
- [ ] Build verification (no errors)
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 8-10h | **CSS Eliminated:** 0 lines (setup phase)
|
|
|
|
---
|
|
|
|
### Phase 3: PrimeVue Centralizare 🎨
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/12 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/12 complete)</summary>
|
|
|
|
#### Global Override Setup (0/3)
|
|
- [ ] Move input overrides to `primevue-overrides.css`
|
|
- [ ] Move button overrides to `primevue-overrides.css`
|
|
- [ ] Move datatable overrides to `primevue-overrides.css`
|
|
|
|
#### Component Cleanup (0/6)
|
|
- [ ] Remove `:deep()` from LoginView.vue
|
|
- [ ] Remove `:deep()` from InvoicesView.vue
|
|
- [ ] Remove `:deep()` from card components
|
|
- [ ] Replace hardcoded colors with design tokens
|
|
- [ ] Remove all `!important` from components
|
|
- [ ] Verify 0 `:deep()` in codebase
|
|
|
|
#### Testing (0/3)
|
|
- [ ] Test all PrimeVue components
|
|
- [ ] Playwright snapshot comparison
|
|
- [ ] Browser compatibility check
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 6-8h | **CSS Eliminated:** 0 / ~150 lines
|
|
|
|
---
|
|
|
|
### Phase 4: Card Components 📊
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/22 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/22 complete)</summary>
|
|
|
|
#### Global Pattern Extraction (0/5)
|
|
- [ ] Add base card styles to `cards.css`
|
|
- [ ] Add sparkline patterns to `dashboard.css`
|
|
- [ ] Add breakdown patterns to `dashboard.css`
|
|
- [ ] Add metric display patterns
|
|
- [ ] Add trend indicator integration
|
|
|
|
#### MetricCard.vue (0/3)
|
|
- [ ] Update template to use global classes
|
|
- [ ] Remove duplicate CSS (331 → 80 lines)
|
|
- [ ] Visual regression test
|
|
|
|
#### CashFlowMetricCard.vue (0/3)
|
|
- [ ] Update template to use global classes
|
|
- [ ] Remove duplicate CSS (179 → 60 lines)
|
|
- [ ] Visual regression test
|
|
|
|
#### ClientiBalanceCard.vue (0/3)
|
|
- [ ] Update template to use global classes
|
|
- [ ] Remove duplicate CSS (260 → 90 lines)
|
|
- [ ] Visual regression test
|
|
|
|
#### FurnizoriBalanceCard.vue (0/3)
|
|
- [ ] Update template to use global classes
|
|
- [ ] Remove duplicate CSS (~260 → 90 lines)
|
|
- [ ] Visual regression test
|
|
|
|
#### TreasuryDualCard.vue (0/3)
|
|
- [ ] Update template to use global classes
|
|
- [ ] Remove duplicate CSS (~200 → 60 lines)
|
|
- [ ] Visual regression test
|
|
|
|
#### Final Testing (0/2)
|
|
- [ ] Test all cards together
|
|
- [ ] Performance measurement
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 16-20h | **CSS Eliminated:** 0 / ~800 lines
|
|
|
|
---
|
|
|
|
### Phase 5: DashboardView Major Refactoring 🚀
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/28 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/28 complete)</summary>
|
|
|
|
#### Preparation (0/2)
|
|
- [ ] Full backup of DashboardView.vue
|
|
- [ ] Detailed analysis of all 2,010 CSS lines
|
|
|
|
#### Page Structure (0/4)
|
|
- [ ] Convert page header to global pattern
|
|
- [ ] Convert section headers to global pattern
|
|
- [ ] Simplify dashboard container layout
|
|
- [ ] Remove duplicate container CSS
|
|
|
|
#### Table Styles (0/3)
|
|
- [ ] Replace custom table CSS with `tables.css`
|
|
- [ ] Remove 400 lines of table-specific CSS
|
|
- [ ] Test table functionality
|
|
|
|
#### Stats & Metrics (0/3)
|
|
- [ ] Use metric card patterns from Phase 4
|
|
- [ ] Remove duplicate stat displays
|
|
- [ ] Test all dashboard metrics
|
|
|
|
#### Responsive Consolidation (0/6)
|
|
- [ ] Audit all 4 media query sections
|
|
- [ ] Extract common patterns to global
|
|
- [ ] Consolidate to single mobile breakpoint
|
|
- [ ] Remove 500+ lines of duplicate responsive CSS
|
|
- [ ] Test on all screen sizes
|
|
- [ ] Test on real mobile devices
|
|
|
|
#### Loading & Animations (0/3)
|
|
- [ ] Replace loading spinner with global pattern
|
|
- [ ] Use animation patterns from Phase 2
|
|
- [ ] Remove 100 lines of animation CSS
|
|
|
|
#### Testing (0/5)
|
|
- [ ] Playwright visual regression (critical)
|
|
- [ ] Desktop testing (1920x1080, 1366x768)
|
|
- [ ] Tablet testing (768x1024)
|
|
- [ ] Mobile testing (375x667, 414x896)
|
|
- [ ] All dashboard features functional
|
|
|
|
#### Validation (0/2)
|
|
- [ ] Measure CSS reduction (target: 1,710 lines)
|
|
- [ ] Performance comparison
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 24-32h | **CSS Eliminated:** 0 / ~1,710 lines
|
|
|
|
⚠️ **Critical Phase:** Most complex refactoring - requires extensive testing
|
|
|
|
---
|
|
|
|
### Phase 6: View-uri Rămase 📄
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/16 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/16 complete)</summary>
|
|
|
|
#### TelegramView.vue (0/5)
|
|
- [ ] Convert page header to global pattern
|
|
- [ ] Replace custom buttons with `buttons.css`
|
|
- [ ] Use standard card patterns
|
|
- [ ] Remove 138 lines of CSS (218 → 80)
|
|
- [ ] Visual regression test
|
|
|
|
#### BankCashRegisterView.vue (0/4)
|
|
- [ ] Audit current CSS patterns
|
|
- [ ] Apply global patterns
|
|
- [ ] Remove duplicate CSS
|
|
- [ ] Visual regression test
|
|
|
|
#### CacheStatsView.vue (0/4)
|
|
- [ ] Audit current CSS patterns
|
|
- [ ] Apply global patterns
|
|
- [ ] Remove duplicate CSS
|
|
- [ ] Visual regression test
|
|
|
|
#### Final Validation (0/3)
|
|
- [ ] All views use consistent patterns
|
|
- [ ] Playwright full suite test
|
|
- [ ] Performance measurement all views
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 16-20h | **CSS Eliminated:** 0 / ~400 lines
|
|
|
|
---
|
|
|
|
### Phase 7: Documentare & Finalizare 📚
|
|
**Status:** ⏸️ Not Started | **Progress:** 0/12 tasks (0%)
|
|
|
|
<details>
|
|
<summary>View Tasks (0/12 complete)</summary>
|
|
|
|
#### Pattern Documentation (0/4)
|
|
- [ ] Create `docs/CSS_PATTERNS.md` with examples
|
|
- [ ] Create `docs/FORM_TEMPLATE.md` standard template
|
|
- [ ] Create `docs/COMPONENT_STYLING.md` guidelines
|
|
- [ ] Create `docs/STYLING_GUIDELINES.md` best practices
|
|
|
|
#### Code Documentation (0/2)
|
|
- [ ] Add JSDoc comments to CSS files
|
|
- [ ] Document design token usage
|
|
|
|
#### Performance Report (0/3)
|
|
- [ ] CSS bundle size before/after
|
|
- [ ] Lighthouse score before/after
|
|
- [ ] Page load metrics comparison
|
|
|
|
#### Final Deliverables (0/3)
|
|
- [ ] Complete pattern library
|
|
- [ ] Developer onboarding guide
|
|
- [ ] Project completion report
|
|
|
|
</details>
|
|
|
|
**Time Spent:** 0h / 12-16h | **Deliverables:** 0/4 documents
|
|
|
|
---
|
|
|
|
## Metrics Dashboard
|
|
|
|
### Code Quality Metrics
|
|
|
|
| Metric | Baseline | Current | Target | Progress |
|
|
|--------|----------|---------|--------|----------|
|
|
| Total scoped CSS | ~6,000 lines | ~6,000 lines | ~2,500 lines | 0% |
|
|
| DashboardView CSS | 2,010 lines | 2,010 lines | 300 lines | 0% |
|
|
| CSS duplication | ~70% | ~70% | ~20% | 0% |
|
|
| Hardcoded values | ~150 | ~150 | ~20 | 0% |
|
|
| `:deep()` overrides | ~50 | ~50 | 0 | 0% |
|
|
| Form patterns | 3 | 3 | 1 | 0% |
|
|
|
|
### Performance Metrics
|
|
|
|
| Metric | Baseline | Current | Target | Status |
|
|
|--------|----------|---------|--------|--------|
|
|
| CSS bundle size | TBD | - | -30% | ⏸️ Not measured |
|
|
| Page load time | TBD | - | -15% | ⏸️ Not measured |
|
|
| First Contentful Paint | TBD | - | -10% | ⏸️ Not measured |
|
|
| Lighthouse Performance | TBD | - | +10pts | ⏸️ Not measured |
|
|
|
|
### Time Tracking
|
|
|
|
| Category | Estimated | Actual | Variance | Status |
|
|
|----------|-----------|--------|----------|--------|
|
|
| Phase 1 | 10-12h | 0h | - | ⏸️ |
|
|
| Phase 2 | 8-10h | 0h | - | ⏸️ |
|
|
| Phase 3 | 6-8h | 0h | - | ⏸️ |
|
|
| Phase 4 | 16-20h | 0h | - | ⏸️ |
|
|
| Phase 5 | 24-32h | 0h | - | ⏸️ |
|
|
| Phase 6 | 16-20h | 0h | - | ⏸️ |
|
|
| Phase 7 | 12-16h | 0h | - | ⏸️ |
|
|
| **TOTAL** | **92-120h** | **0h** | **-** | **0%** |
|
|
|
|
---
|
|
|
|
## Commit History
|
|
|
|
_No commits yet - project not started_
|
|
|
|
---
|
|
|
|
## Issues & Blockers
|
|
|
|
### Current Blockers
|
|
1. **Plan Approval** - Awaiting stakeholder approval
|
|
- **Impact:** Cannot start Phase 1
|
|
- **Status:** ⏸️ Pending
|
|
- **ETA:** TBD
|
|
|
|
### Resolved Issues
|
|
_None yet_
|
|
|
|
---
|
|
|
|
## Testing Results
|
|
|
|
### Visual Regression Tests
|
|
- **Baseline Snapshots:** Not captured
|
|
- **Last Test Run:** N/A
|
|
- **Failures:** 0
|
|
- **Status:** ⏸️ Awaiting Phase 1
|
|
|
|
### Performance Tests
|
|
- **Last Run:** N/A
|
|
- **CSS Bundle:** Not measured
|
|
- **Lighthouse:** Not measured
|
|
|
|
---
|
|
|
|
## Risk Assessment
|
|
|
|
### Active Risks
|
|
| Risk | Severity | Probability | Status | Mitigation |
|
|
|------|----------|-------------|--------|------------|
|
|
| Visual regressions | High | High | ⚠️ Active | Playwright snapshots |
|
|
| DashboardView breaking | Very High | Medium | ⚠️ Active | Incremental changes |
|
|
| PrimeVue conflicts | High | Medium | ⚠️ Active | Comprehensive testing |
|
|
| Timeline overrun | Medium | Medium | ⚠️ Active | Phase flexibility |
|
|
|
|
---
|
|
|
|
## Next Steps
|
|
|
|
### Immediate Actions (Once Approved)
|
|
1. ✅ Create feature branch `feature/css-refactoring`
|
|
2. ✅ Capture Playwright baseline snapshots
|
|
3. ✅ Start Phase 1: Forms Standardization
|
|
|
|
### This Week Goals
|
|
- Complete Phase 1 (Forms)
|
|
- Complete Phase 2 (Foundation)
|
|
- Start Phase 3 (PrimeVue)
|
|
|
|
### This Sprint Goals
|
|
- Complete Phases 1-3
|
|
- Begin Phase 4 (Cards)
|
|
|
|
---
|
|
|
|
## Notes & Observations
|
|
|
|
### 2025-11-18
|
|
- Initial project planning complete
|
|
- 117 total tasks identified across 7 phases
|
|
- Detailed requirements and plan documented
|
|
- Awaiting approval to proceed
|
|
|
|
---
|
|
|
|
## Approvals
|
|
|
|
### Required Sign-offs
|
|
- [ ] Technical Lead: Plan approved
|
|
- [ ] Product Owner: Scope approved
|
|
- [ ] QA Lead: Testing strategy approved
|
|
- [ ] Team: Resources committed
|
|
|
|
### Change Log
|
|
- 2025-11-18: Initial tracker created
|
|
|
|
---
|
|
|
|
**Last Updated:** 2025-11-18 by Claude Code
|
|
**Next Update:** Upon Phase 1 start
|