Merge branch 'feature/unified-app-pragmatic-monolith'

2025-12-22 10:55:31 +02:00
parent ee239eb3f3 0bdf079a20
commit 7e67163fb2
11 changed files with 5010 additions and 0 deletions
--- a/.auto-build-data/specs/unified-app/MIGRATION_CHECKLIST.md
+++ b/.auto-build-data/specs/unified-app/MIGRATION_CHECKLIST.md
@@ -0,0 +1,406 @@
+# Unified App Migration Checklist
+
+**Track your progress** as you implement the unified app.
+
+---
+
+## Phase 1: Project Setup (0.5 days)
+
+### Directory Structure
+- [ ] Create directory structure in root (`/mnt/e/proiecte/roa2web/`)
+- [ ] Create `src/` subdirectories:
+  - [ ] `src/modules/reports/views/`
+  - [ ] `src/modules/reports/stores/`
+  - [ ] `src/modules/reports/services/`
+  - [ ] `src/modules/data-entry/views/receipts/`
+  - [ ] `src/modules/data-entry/components/ocr/`
+  - [ ] `src/modules/data-entry/stores/`
+  - [ ] `src/modules/data-entry/services/`
+  - [ ] `src/shared/components/`
+  - [ ] `src/shared/stores/`
+  - [ ] `src/shared/styles/`
+  - [ ] `src/config/`
+  - [ ] `src/router/`
+  - [ ] `src/assets/css/`
+
+### Core Configuration Files
+- [ ] Create `package.json` (merge dependencies from both apps)
+- [ ] Create `vite.config.js` (dual proxy + lazy loading)
+- [ ] Create `src/main.js` (PrimeVue setup)
+- [ ] Create `.env.example` (environment variables)
+- [ ] Create `.gitignore`
+- [ ] Create `README.md`
+
+### Copy Shared Resources
+- [ ] Copy `shared/frontend/components/` → `src/shared/components/`
+- [ ] Copy `shared/frontend/stores/` → `src/shared/stores/`
+- [ ] Copy `shared/frontend/styles/` → `src/shared/styles/`
+- [ ] Copy `reports-app/frontend/src/assets/css/` → `src/assets/css/`
+
+### Verification
+- [ ] Run `npm install` - succeeds
+- [ ] Run `npm run dev` - starts on port 3000
+- [ ] No console errors
+
+---
+
+## Phase 2: Module Migration (1 day)
+
+### Reports Module - Views
+- [ ] Copy `DashboardView.vue` → `src/modules/reports/views/`
+- [ ] Copy `InvoicesView.vue` → `src/modules/reports/views/`
+- [ ] Copy `BankCashRegisterView.vue` → `src/modules/reports/views/`
+- [ ] Copy `TrialBalanceView.vue` → `src/modules/reports/views/`
+- [ ] Copy `TelegramView.vue` → `src/modules/reports/views/`
+- [ ] Copy `CacheStatsView.vue` → `src/modules/reports/views/`
+- [ ] Update imports in all views (if needed)
+
+### Reports Module - Stores
+- [ ] Copy `dashboard.js` → `src/modules/reports/stores/`
+- [ ] Copy `invoices.js` → `src/modules/reports/stores/`
+- [ ] Copy `treasury.js` → `src/modules/reports/stores/`
+- [ ] Copy `trialBalance.js` → `src/modules/reports/stores/`
+- [ ] Copy `cacheStore.js` → `src/modules/reports/stores/`
+- [ ] Update imports in all stores (if needed)
+
+### Reports Module - Services
+- [ ] Copy `api.js` → `src/modules/reports/services/` (in root)
+- [ ] Update base URL to `/api/reports/` in api.js
+- [ ] Test API calls route to localhost:8001
+
+### Data Entry Module - Views
+- [ ] Copy `ReceiptsListView.vue` → `src/modules/data-entry/views/receipts/`
+- [ ] Copy `ReceiptCreateView.vue` → `src/modules/data-entry/views/receipts/`
+- [ ] Update imports in views (if needed)
+
+### Data Entry Module - Components
+- [ ] Copy `OCRUploadZone.vue` → `src/modules/data-entry/components/ocr/`
+- [ ] Copy `OCRPreview.vue` → `src/modules/data-entry/components/ocr/`
+- [ ] Copy `OCRConfidenceIndicator.vue` → `src/modules/data-entry/components/ocr/`
+- [ ] Update imports in components (if needed)
+
+### Data Entry Module - Stores
+- [ ] Copy `receiptsStore.js` → `src/modules/data-entry/stores/`
+- [ ] Update imports in store (if needed)
+
+### Data Entry Module - Services
+- [ ] Copy `api.js` → `src/modules/data-entry/services/` (in root)
+- [ ] Update base URL to `/api/data-entry/` in api.js
+- [ ] Test API calls route to localhost:8003
+
+### CSS Merge
+- [ ] Review `data-entry-app/frontend/src/assets/css/main.css`
+- [ ] Merge unique styles into `src/assets/css/` (in root)
+- [ ] Resolve any style conflicts
+- [ ] Test responsive design
+
+### Verification
+- [ ] All Reports views render without errors
+- [ ] All Data Entry views render without errors
+- [ ] No import errors in console
+- [ ] CSS loads correctly
+- [ ] No style conflicts
+
+---
+
+## Phase 3: Routing & Navigation (0.5 days)
+
+### Router Configuration
+- [ ] Create `src/router/index.js` (in root)
+- [ ] Add `/login` route (eager loaded)
+- [ ] Add `/reports/*` routes (lazy loaded)
+- [ ] Add `/data-entry/*` routes (lazy loaded)
+- [ ] Add redirect `/` → `/reports/dashboard`
+- [ ] Add authentication guard
+- [ ] Add 404 handling
+- [ ] Test all routes work
+
+### Menu Configuration
+- [ ] Create `src/config/menu.js` (in root)
+- [ ] Define "Rapoarte" section
+- [ ] Define "Introduceri Date" section
+- [ ] Define "Sistem" section
+- [ ] Export menu configuration
+
+### Feature Flags
+- [ ] Create `src/config/features.js` (in root)
+- [ ] Add reports.enabled flag
+- [ ] Add dataEntry.enabled flag
+- [ ] Add module-level flags
+- [ ] Export isFeatureEnabled function
+
+### Root Component
+- [ ] Create `src/App.vue` (in root)
+- [ ] Integrate AppHeader with unified menu
+- [ ] Integrate SlideMenu with menu sections
+- [ ] Add router-view
+- [ ] Add Toast and ConfirmDialog
+- [ ] Test menu navigation
+
+### Verification
+- [ ] Can navigate to all routes
+- [ ] Menu highlights active route
+- [ ] Authentication guard works
+- [ ] Login redirects to dashboard
+- [ ] 404 redirects work
+
+---
+
+## Phase 4: Error Boundaries & Resilience (0.25 days)
+
+### Error Boundary Component
+- [ ] Create `src/shared/components/ErrorBoundary.vue` (in root)
+- [ ] Implement onErrorCaptured hook
+- [ ] Add user-friendly error display
+- [ ] Add retry functionality
+- [ ] Add navigate away option
+- [ ] Test with intentional error
+
+### Module Layouts
+- [ ] Create `src/modules/reports/ReportsLayout.vue` (in root)
+- [ ] Wrap with ErrorBoundary component
+- [ ] Create `src/modules/data-entry/DataEntryLayout.vue` (in root)
+- [ ] Wrap with ErrorBoundary component
+
+### Error Isolation Testing
+- [ ] Introduce error in Reports module
+- [ ] Verify Data Entry still works
+- [ ] Introduce error in Data Entry module
+- [ ] Verify Reports still works
+- [ ] Test retry functionality
+- [ ] Test navigate away functionality
+
+### Feature Flags Testing
+- [ ] Disable Reports module
+- [ ] Verify menu items hidden
+- [ ] Disable Data Entry module
+- [ ] Verify menu items hidden
+- [ ] Re-enable all modules
+
+### Loading States
+- [ ] Add loading spinner for lazy routes
+- [ ] Test module switching loading
+- [ ] Add skeleton screens (optional)
+
+### Verification
+- [ ] Error boundary catches component errors
+- [ ] User sees friendly error message
+- [ ] Can retry or navigate away
+- [ ] Module isolation works (error in one doesn't crash other)
+- [ ] Feature flags work
+
+---
+
+## Phase 5: Build & Deploy (0.25 days)
+
+### Production Build
+- [ ] Run `npm run build`
+- [ ] Build succeeds without errors
+- [ ] Check `dist/` output
+- [ ] Verify chunks created:
+  - [ ] vendor-core.[hash].js
+  - [ ] vendor-primevue.[hash].js
+  - [ ] vendor-utils.[hash].js
+  - [ ] reports.[hash].js (lazy)
+  - [ ] data-entry.[hash].js (lazy)
+  - [ ] main.[hash].js
+  - [ ] main.[hash].css
+
+### Bundle Analysis
+- [ ] Install `rollup-plugin-visualizer`
+- [ ] Analyze bundle sizes
+- [ ] Verify total size ≤ sum of current apps
+- [ ] Check for duplicate dependencies
+
+### Local Preview
+- [ ] Run `npm run preview`
+- [ ] Test all routes work
+- [ ] Test API calls work
+- [ ] Test error boundaries
+- [ ] Test lazy loading
+
+### IIS Configuration
+- [ ] Create `web.config` (in root) with URL rewrite rules
+- [ ] Add SPA routing rule (all → index.html)
+- [ ] Add proxy rule: `/api/reports/*` → `http://localhost:8001/api/*`
+- [ ] Add proxy rule: `/api/data-entry/*` → `http://localhost:8003/api/*`
+- [ ] Add proxy rule: `/uploads/*` → `http://localhost:8003/uploads/*`
+
+### Staging Deployment
+- [ ] Deploy to staging IIS site
+- [ ] Test all routes
+- [ ] Test API calls
+- [ ] Test error boundaries
+- [ ] Test on different browsers
+- [ ] Test on mobile devices
+
+### Production Deployment
+- [ ] Backup current IIS configuration
+- [ ] Backup current builds
+- [ ] Deploy unified app
+- [ ] Test all routes
+- [ ] Test API calls
+- [ ] Monitor error logs
+
+### Verification
+- [ ] Build succeeds
+- [ ] Chunks split correctly
+- [ ] IIS deployment works
+- [ ] API routing correct
+- [ ] All features work in production
+
+---
+
+## Testing Checklist
+
+### Manual Testing
+- [ ] Login flow works
+- [ ] Navigate to all Reports views
+- [ ] Navigate to all Data Entry views
+- [ ] Switch between modules
+- [ ] Test company selector
+- [ ] Test period selector
+- [ ] Test logout
+- [ ] Test on mobile (375px)
+- [ ] Test on tablet (768px)
+- [ ] Test on desktop (1920px)
+
+### E2E Tests
+- [ ] Create `tests/e2e/login.spec.js` (in root)
+- [ ] Create `tests/e2e/reports-navigation.spec.js` (in root)
+- [ ] Create `tests/e2e/data-entry-navigation.spec.js` (in root)
+- [ ] Create `tests/e2e/module-switching.spec.js` (in root)
+- [ ] Create `tests/e2e/error-isolation.spec.js` (in root)
+- [ ] Run all E2E tests - pass
+
+### Performance Testing
+- [ ] Run Lighthouse audit
+- [ ] Performance score ≥ 90
+- [ ] Initial load < 2 seconds
+- [ ] Module switching < 500ms (cached)
+
+---
+
+## Post-Implementation Checklist
+
+### Documentation Updates
+- [ ] Update `CLAUDE.md` - Architecture section
+- [ ] Update `CLAUDE.md` - Deployment section
+- [ ] Update `README.md` - Quick start
+- [ ] Update `README.md` - URL structure
+- [ ] Update `DEPLOYMENT_GUIDE.md` - IIS configuration
+- [ ] Update `docs/ARCHITECTURE_SCHEMA.md` - Diagrams
+- [ ] Update `deployment/windows/README.md` - Deployment steps
+
+### Cleanup (After 1 Week)
+- [ ] Archive `reports-app/frontend/` → `reports-app/frontend-archived/`
+- [ ] Archive `data-entry-app/frontend/` → `data-entry-app/frontend-archived/`
+- [ ] Update `start-test.sh` to use root directory
+- [ ] Update `start-data-entry.sh` to use root directory
+- [ ] Update CI/CD pipelines (if any)
+- [ ] Document migration in CHANGELOG.md
+
+### Monitoring (First Week)
+- [ ] Day 1: Review error logs
+- [ ] Day 2: Review error logs
+- [ ] Day 3: Review error logs
+- [ ] Day 4: Review error logs
+- [ ] Day 5: Review error logs
+- [ ] Day 6: Review error logs
+- [ ] Day 7: Review error logs + user feedback
+
+### Optimization (First Month)
+- [ ] Week 2: Analyze bundle sizes
+- [ ] Week 2: Optimize images/assets
+- [ ] Week 3: Consider further code splitting
+- [ ] Week 3: Add performance monitoring
+- [ ] Week 4: Evaluate feature flag usage
+- [ ] Week 4: Plan next improvements
+
+---
+
+## Common Issues & Solutions
+
+### Issue: CSS Conflicts
+**Solution**: Use CSS modules, check `docs/CSS_PATTERNS.md`
+
+### Issue: Import Errors
+**Solution**: Update import paths, check alias configuration in vite.config.js
+
+### Issue: API Calls Failing
+**Solution**: Verify proxy configuration, check backend is running
+
+### Issue: Error Boundary Not Catching
+**Solution**: Check onErrorCaptured implementation, add global error handler
+
+### Issue: Large Bundle Size
+**Solution**: Review manualChunks, enable tree shaking, lazy load more
+
+### Issue: IIS Routing Not Working
+**Solution**: Check web.config URL rewrite rules, verify IIS URL Rewrite module installed
+
+### Issue: Store Contamination
+**Solution**: Use module-scoped stores, check for global state
+
+### Issue: PrimeVue Theme Conflicts
+**Solution**: Use single theme (saga-blue), override in vendor CSS
+
+---
+
+## Progress Tracking
+
+**Phase 1: Setup**
+- Started: ___________
+- Completed: ___________
+- Time Spent: ___________ hours
+
+**Phase 2: Migration**
+- Started: ___________
+- Completed: ___________
+- Time Spent: ___________ hours
+
+**Phase 3: Routing**
+- Started: ___________
+- Completed: ___________
+- Time Spent: ___________ hours
+
+**Phase 4: Error Boundaries**
+- Started: ___________
+- Completed: ___________
+- Time Spent: ___________ hours
+
+**Phase 5: Build & Deploy**
+- Started: ___________
+- Completed: ___________
+- Time Spent: ___________ hours
+
+**Total Time**: ___________ hours (Estimated: 20 hours)
+
+---
+
+## Success Metrics
+
+### Deployment
+- [ ] Single IIS site running (not 2)
+- [ ] Single build process (not 2)
+- [ ] Zero downtime during deployment
+
+### Performance
+- [ ] Initial load < 2 seconds
+- [ ] Module switching < 500ms
+- [ ] Lighthouse score ≥ 90
+- [ ] Bundle size ≤ sum of old apps
+
+### Quality
+- [ ] 100% feature parity
+- [ ] All E2E tests passing
+- [ ] Zero user-reported bugs (first week)
+- [ ] Error isolation verified
+
+---
+
+**Status**: ⬜ Not Started | 🔵 In Progress | ✅ Complete
+
+**Last Updated**: ___________
+**Completed By**: ___________
+**Production Deploy Date**: ___________
--- a/.auto-build-data/specs/unified-app/SUMMARY.md
+++ b/.auto-build-data/specs/unified-app/SUMMARY.md
@@ -0,0 +1,346 @@
+# Unified App Specification - Executive Summary
+
+**Created**: 2025-12-22
+**Status**: Implementation-Ready
+**Estimated Effort**: 2.5 days
+
+---
+
+## What We're Building
+
+A single unified SPA that consolidates the Reports App and Data Entry App into one application with:
+- Unified menu navigation between modules
+- Module isolation via error boundaries
+- Lazy loading for optimal performance
+- Single build and deployment process
+
+---
+
+## Key Requirements (Top 5)
+
+1. **Unified Navigation**: Single menu with Reports and Data Entry sections
+2. **Module Isolation**: Error in one module doesn't crash the other
+3. **Lazy Loading**: Modules loaded on-demand, not upfront
+4. **Simplified Deployment**: Single IIS site instead of 2
+5. **Zero Backend Changes**: Both backends (8001, 8003) remain unchanged
+
+---
+
+## Technical Approach
+
+### Architecture: Pragmatic Monolith
+
+**NOT using micro-frontends** because:
+- Only 1 developer (not 20+ team)
+- Weekly deploys (not multiple times per day)
+- 1-5 concurrent users (not millions)
+- Same tech stack (Vue 3 only)
+
+**Using instead**:
+- Error boundaries for isolation (50-70% blast radius reduction)
+- Lazy loading for performance
+- Feature flags for module control
+- Shared dependencies for smaller bundles
+
+### URL Structure
+
+```
+/login                     → Login
+/                          → Redirect to /reports/dashboard
+
+/reports/dashboard         → Dashboard
+/reports/invoices          → Invoices
+/reports/bank-cash         → Bank/Cash
+/reports/trial-balance     → Trial Balance
+/reports/telegram          → Telegram Bot
+/reports/cache-stats       → Cache Stats
+
+/data-entry                → Receipts List
+/data-entry/create         → New Receipt
+/data-entry/:id            → View Receipt
+/data-entry/:id/edit       → Edit Receipt
+```
+
+### API Routing
+
+**Vite Dev Proxy**:
+- `/api/reports/*` → `http://localhost:8001/api/*`
+- `/api/data-entry/*` → `http://localhost:8003/api/*`
+- `/uploads/*` → `http://localhost:8003/uploads/*`
+
+**IIS Production Proxy**:
+- Same routing via web.config URL rewrite rules
+
+---
+
+## Critical Files (Top 10)
+
+### To Create (in root directory)
+
+1. `package.json` - Merged dependencies
+2. `vite.config.js` - Dual proxy + lazy loading
+3. `src/main.js` - App initialization
+4. `src/App.vue` - Root with unified menu
+5. `src/router/index.js` - Unified router
+6. `src/config/menu.js` - Menu configuration
+7. `src/shared/components/ErrorBoundary.vue` - Error isolation
+8. `src/modules/reports/ReportsLayout.vue` - Reports wrapper
+9. `src/modules/data-entry/DataEntryLayout.vue` - Data Entry wrapper
+10. `web.config` - IIS configuration
+
+### To Migrate
+
+**Reports Module** (7 views, 5 stores, 1 service):
+- Views: Dashboard, Invoices, BankCash, TrialBalance, Telegram, CacheStats
+- Stores: dashboard, invoices, treasury, trialBalance, cacheStore
+- Service: api.js (change base URL to `/api/reports/`)
+
+**Data Entry Module** (2 views, 3 components, 1 store, 1 service):
+- Views: ReceiptsList, ReceiptCreate
+- Components: OCRUploadZone, OCRPreview, OCRConfidenceIndicator
+- Store: receiptsStore
+- Service: api.js (change base URL to `/api/data-entry/`)
+
+**Shared** (5 components, 3 stores):
+- Components: LoginView, AppHeader, SlideMenu, CompanySelector, PeriodSelector
+- Stores: auth, companies, accountingPeriod (factories)
+
+**CSS**: Copy entire `reports-app/frontend/src/assets/css/` structure
+
+---
+
+## Implementation Phases
+
+### Phase 1: Setup (0.5 days)
+- Create directory structure
+- Setup package.json, vite.config.js
+- Copy shared components and CSS
+
+**Verify**: `npm install` and `npm run dev` work
+
+### Phase 2: Migration (1 day)
+- Migrate all views, components, stores
+- Update API service base URLs
+- Merge CSS
+
+**Verify**: All views render, no import errors
+
+### Phase 3: Routing & Navigation (0.5 days)
+- Create unified router with lazy loading
+- Create menu configuration
+- Create error boundaries
+- Integrate AppHeader and SlideMenu
+
+**Verify**: Navigation works, lazy loading works
+
+### Phase 4: Error Boundaries & Resilience (0.25 days)
+- Test error isolation
+- Test feature flags
+- Add loading states
+
+**Verify**: Error in one module doesn't crash other
+
+### Phase 5: Build & Deploy (0.25 days)
+- Production build
+- IIS configuration
+- Deploy to staging
+- Test all routes
+
+**Verify**: Build succeeds, IIS works, APIs route correctly
+
+---
+
+## Expected Build Output
+
+```
+dist/
+├── index.html
+├── assets/
+│   ├── vendor-core.[hash].js        (~150KB) - Vue, Router, Pinia
+│   ├── vendor-primevue.[hash].js    (~200KB) - PrimeVue components
+│   ├── vendor-utils.[hash].js       (~80KB)  - Axios, date-fns
+│   ├── vendor-charts.[hash].js      (~150KB) - Chart.js (lazy)
+│   ├── vendor-export.[hash].js      (~200KB) - XLSX, jsPDF (lazy)
+│   ├── reports.[hash].js            (~150KB) - Reports module (lazy)
+│   ├── data-entry.[hash].js         (~100KB) - Data Entry module (lazy)
+│   ├── main.[hash].js               (~50KB)  - App shell
+│   └── main.[hash].css              (~80KB)  - Global CSS
+```
+
+---
+
+## Success Criteria
+
+### Must Have (Before Production)
+- [ ] All Reports views work correctly
+- [ ] All Data Entry views work correctly
+- [ ] Navigation preserves auth and company/period
+- [ ] Error in one module doesn't crash other
+- [ ] Single IIS site deployment works
+- [ ] API routing to both backends works
+
+### Performance Targets
+- [ ] Initial load < 2 seconds
+- [ ] Module switching < 500ms (cached)
+- [ ] Bundle size ≤ sum of current apps
+- [ ] Lighthouse score ≥ 90
+
+### Testing
+- [ ] E2E tests pass for login
+- [ ] E2E tests pass for Reports navigation
+- [ ] E2E tests pass for Data Entry navigation
+- [ ] E2E tests pass for module switching
+- [ ] E2E tests verify error isolation
+
+---
+
+## Risks & Mitigations
+
+| Risk | Mitigation |
+|------|------------|
+| CSS conflicts | Use design tokens, test thoroughly |
+| Large bundle size | Lazy loading, code splitting, tree shaking |
+| Error boundary gaps | Test error scenarios, add global handler |
+| IIS deployment complexity | Document config, test on staging first |
+| Store contamination | Module-scoped stores, test isolation |
+
+---
+
+## Rollback Plan
+
+**If deployment fails**:
+
+1. **Keep both apps running** (zero downtime)
+   - Leave `/roa2web/` and `/data-entry/` running
+   - Add unified app at `/unified/` for testing
+
+2. **Quick rollback** (15 minutes)
+   - Restore IIS config from backup
+   - Restore builds from `dist-backup/`
+
+3. **Git rollback**
+   - Tag before merge: `v1.0-pre-unified`
+   - Revert if needed: `git reset --hard v1.0-pre-unified`
+
+---
+
+## Post-Implementation
+
+### After 1 Week of Stability
+
+**Archive old frontends**:
+```bash
+mv reports-app/frontend reports-app/frontend-archived
+mv data-entry-app/frontend data-entry-app/frontend-archived
+```
+
+**Update documentation**:
+- CLAUDE.md - Architecture and deployment
+- DEPLOYMENT_GUIDE.md - IIS configuration
+- README.md - Quick start and commands
+
+**Update scripts**:
+- `./start-test.sh` - Point to root directory
+- `./start-data-entry.sh` - Point to root directory
+
+### Monitoring (First Month)
+
+**Week 1**: Daily error log review
+**Week 2-4**: Performance optimization
+- Bundle size optimization
+- Further code splitting
+- Cache optimization
+
+---
+
+## Open Questions & Recommendations
+
+### 1. PrimeVue Theme
+**Question**: Use `saga-blue` (reports-app) or `lara-light-blue` (data-entry-app)?
+**Recommendation**: `saga-blue` (reports-app is primary)
+
+### 2. Feature Flags
+**Question**: Config file or environment variables?
+**Recommendation**: Config file for simplicity, env vars for override
+
+### 3. Module Activation
+**Question**: All active by default or opt-in?
+**Recommendation**: All active by default (disable via config if needed)
+
+### 4. Monitoring
+**Question**: Console logs only or add Sentry/similar?
+**Recommendation**: Console logs for MVP, add monitoring later
+
+---
+
+## Key Decisions Made
+
+1. **Architecture**: Pragmatic monolith (not micro-frontends)
+2. **Error Isolation**: Error boundaries per module
+3. **Code Splitting**: Lazy loading with manual chunks
+4. **URL Structure**: `/reports/*` and `/data-entry/*`
+5. **API Routing**: Proxy via Vite (dev) and IIS (prod)
+6. **CSS System**: Use reports-app CSS structure
+7. **PrimeVue Theme**: saga-blue (from reports-app)
+8. **Shared Components**: Use existing from `shared/frontend/`
+9. **Deployment**: Single IIS site at root `/`
+10. **Backends**: No changes (remain at 8001, 8003)
+
+---
+
+## Documentation Locations
+
+**Complete Spec**: `.auto-build-data/specs/unified-app/spec.md`
+**Critical Files**: `.auto-build-data/specs/unified-app/critical-files.md`
+**This Summary**: `.auto-build-data/specs/unified-app/SUMMARY.md`
+
+**Note**: All implementation files will be created in the project root directory (`.` or `/mnt/e/proiecte/roa2web/`)
+
+**Reference Docs**:
+- `IMPLEMENTATION_PLAN_UNIFIED_APP.md` - Original plan
+- `CLAUDE.md` - Project documentation (update after)
+- `docs/ONBOARDING_CSS.md` - CSS system guide
+- `docs/CSS_PATTERNS.md` - Available CSS patterns
+
+---
+
+## Next Steps
+
+1. **Read the complete spec**: `spec.md` (detailed technical specification)
+2. **Review critical files**: `critical-files.md` (files to migrate/create)
+3. **Start Phase 1**: Project setup (0.5 days)
+4. **Follow implementation plan**: 5 phases over 2.5 days
+5. **Test thoroughly**: E2E tests before production
+6. **Deploy to staging**: Test IIS configuration
+7. **Deploy to production**: Single site deployment
+8. **Monitor for 1 week**: Daily error log review
+9. **Archive old apps**: After stability confirmed
+10. **Update docs**: Complete documentation updates
+
+---
+
+## Quick Stats
+
+- **Files to create**: ~15
+- **Files to migrate**: ~20
+- **CSS files to copy**: ~30
+- **Total files affected**: ~65
+- **Estimated time**: 2.5 days (20 hours)
+- **Complexity**: Medium
+- **Risk level**: Medium-Low (with mitigations)
+
+---
+
+**Specification Status**: ✅ Implementation-Ready
+**All Technical Decisions**: ✅ Made
+**Rollback Plan**: ✅ Defined
+**Success Criteria**: ✅ Defined
+
+**Ready to implement!** 🚀
+
+---
+
+**Version**: 1.0
+**Created**: 2025-12-22
+**Author**: Claude (Specification Agent)
+**For**: ROA2WEB Unified App Feature
--- a/.auto-build-data/specs/unified-app/critical-files.md
+++ b/.auto-build-data/specs/unified-app/critical-files.md
@@ -0,0 +1,477 @@
+# Unified App - Critical Files Reference
+
+**Quick Reference**: Files that will be most affected during implementation
+
+---
+
+## Files to Analyze (Before Implementation)
+
+### Configuration Files
+
+**Reports App**:
+- `/mnt/e/proiecte/roa2web/reports-app/frontend/package.json` - Dependencies to merge
+- `/mnt/e/proiecte/roa2web/reports-app/frontend/vite.config.js` - Proxy config, build settings
+- `/mnt/e/proiecte/roa2web/reports-app/frontend/src/main.js` - PrimeVue setup
+
+**Data Entry App**:
+- `/mnt/e/proiecte/roa2web/data-entry-app/frontend/package.json` - Dependencies to merge
+- `/mnt/e/proiecte/roa2web/data-entry-app/frontend/vite.config.js` - Proxy config
+- `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/main.js` - PrimeVue setup
+
+### Application Entry Points
+
+**Reports App**:
+- `/mnt/e/proiecte/roa2web/reports-app/frontend/src/App.vue` - Root component, menu integration
+- `/mnt/e/proiecte/roa2web/reports-app/frontend/src/router/index.js` - Router config
+
+**Data Entry App**:
+- `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/App.vue` - Root component, menu integration
+- `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/router/index.js` - Router config
+
+### Shared Components (Already Created)
+
+- `/mnt/e/proiecte/roa2web/shared/frontend/components/LoginView.vue`
+- `/mnt/e/proiecte/roa2web/shared/frontend/components/layout/AppHeader.vue`
+- `/mnt/e/proiecte/roa2web/shared/frontend/components/layout/SlideMenu.vue`
+- `/mnt/e/proiecte/roa2web/shared/frontend/components/CompanySelector.vue`
+- `/mnt/e/proiecte/roa2web/shared/frontend/components/PeriodSelector.vue`
+
+### Shared Stores (Factories)
+
+- `/mnt/e/proiecte/roa2web/shared/frontend/stores/auth.js`
+- `/mnt/e/proiecte/roa2web/shared/frontend/stores/companies.js`
+- `/mnt/e/proiecte/roa2web/shared/frontend/stores/accountingPeriod.js`
+
+---
+
+## Views to Migrate
+
+### Reports Module (7 views)
+
+Source: `/mnt/e/proiecte/roa2web/reports-app/frontend/src/views/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/reports/views/`
+
+1. `DashboardView.vue` - Main dashboard with metrics
+2. `InvoicesView.vue` - Invoices table and filters
+3. `BankCashRegisterView.vue` - Bank and cash register transactions
+4. `TrialBalanceView.vue` - Trial balance report
+5. `TelegramView.vue` - Telegram bot management
+6. `CacheStatsView.vue` - Cache statistics
+7. ~~`LoginView.vue`~~ - USE SHARED VERSION
+
+### Data Entry Module (2 views + 3 components)
+
+**Views**:
+Source: `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/views/receipts/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/data-entry/views/receipts/`
+
+1. `ReceiptsListView.vue` - List of receipts with filters
+2. `ReceiptCreateView.vue` - Create/edit receipt form
+
+**Components**:
+Source: `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/components/ocr/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/data-entry/components/ocr/`
+
+1. `OCRUploadZone.vue` - File upload zone for receipts
+2. `OCRPreview.vue` - Preview uploaded receipt image
+3. `OCRConfidenceIndicator.vue` - OCR confidence indicator
+
+---
+
+## Stores to Migrate
+
+### Reports Module (5 stores)
+
+Source: `/mnt/e/proiecte/roa2web/reports-app/frontend/src/stores/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/reports/stores/`
+
+1. `dashboard.js` - Dashboard data and metrics
+2. `invoices.js` - Invoices data and filters
+3. `treasury.js` - Bank/cash register data
+4. `trialBalance.js` - Trial balance data
+5. `cacheStore.js` - Cache statistics
+
+**SKIP** (use shared):
+- ~~`auth.js`~~ - Use `/mnt/e/proiecte/roa2web/shared/frontend/stores/auth.js`
+- ~~`companies.js`~~ - Use `/mnt/e/proiecte/roa2web/shared/frontend/stores/companies.js`
+- ~~`accountingPeriod.js`~~ - Use `/mnt/e/proiecte/roa2web/shared/frontend/stores/accountingPeriod.js`
+
+### Data Entry Module (1 store)
+
+Source: `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/stores/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/data-entry/stores/`
+
+1. `receiptsStore.js` - Receipts data and CRUD operations
+
+**SKIP** (use shared):
+- ~~`auth.js`~~ - Use shared
+- ~~`companies.js`~~ - Use shared
+- ~~`accountingPeriod.js`~~ - Use shared
+
+---
+
+## Services to Migrate
+
+### Reports Module
+
+Source: `/mnt/e/proiecte/roa2web/reports-app/frontend/src/services/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/reports/services/`
+
+1. `api.js` - **MODIFY**: Change base URL to `/api/reports/`
+
+**Current**:
+```javascript
+const api = axios.create({
+  baseURL: '/api'
+})
+```
+
+**New**:
+```javascript
+const api = axios.create({
+  baseURL: '/api/reports'
+})
+```
+
+### Data Entry Module
+
+Source: `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/services/`
+Destination: `/mnt/e/proiecte/roa2web/src/modules/data-entry/services/`
+
+1. `api.js` - **MODIFY**: Change base URL to `/api/data-entry/`
+
+**Current**:
+```javascript
+const api = axios.create({
+  baseURL: '/api'
+})
+```
+
+**New**:
+```javascript
+const api = axios.create({
+  baseURL: '/api/data-entry'
+})
+```
+
+---
+
+## CSS to Migrate
+
+### Reports Module CSS (COPY ENTIRE STRUCTURE)
+
+Source: `/mnt/e/proiecte/roa2web/reports-app/frontend/src/assets/css/`
+Destination: `/mnt/e/proiecte/roa2web/src/assets/css/`
+
+**Copy ALL files** (this is the main CSS system):
+- `core/` - Design tokens (colors, spacing, typography)
+- `components/` - Reusable UI patterns (buttons, forms, cards, tables, stats)
+- `patterns/` - Interactive patterns (animations, dashboard, interactive)
+- `layout/` - Page structure (containers, grid, navigation)
+- `utilities/` - Utility classes (colors, spacing, flex, text, display)
+- `vendor/` - PrimeVue overrides
+- `global.css` - Global styles
+- `main.css` - Main entry point
+- `mobile.css` - Mobile responsive styles
+
+### Data Entry Module CSS (MERGE)
+
+Source: `/mnt/e/proiecte/roa2web/data-entry-app/frontend/src/assets/css/`
+
+**Analyze and merge unique styles**:
+- `main.css` - Merge with reports-app main.css
+- Any component-specific styles - Integrate into unified system
+
+### Shared CSS
+
+Source: `/mnt/e/proiecte/roa2web/shared/frontend/styles/`
+Destination: `/mnt/e/proiecte/roa2web/src/shared/styles/`
+
+1. `login.css` - Login page styles
+2. `layout/header.css` - Header styles
+3. `layout/navigation.css` - Navigation styles
+
+---
+
+## Critical Implementation Files
+
+### 1. Package Configuration
+
+**File**: `/mnt/e/proiecte/roa2web/package.json`
+
+**Dependencies to merge**:
+- From reports-app: axios, chart.js, date-fns, jspdf, jspdf-autotable, qrcode.vue, xlsx
+- From data-entry-app: All covered by reports-app
+- Shared: vue@^3.4.0, vue-router@^4.2.5, pinia@^2.1.7, primevue@^3.46.0
+
+### 2. Vite Configuration
+
+**File**: `/mnt/e/proiecte/roa2web/vite.config.js`
+
+**Key sections**:
+- Dual proxy for `/api/reports/` → `http://localhost:8001`
+- Dual proxy for `/api/data-entry/` → `http://localhost:8003`
+- Lazy loading configuration (manualChunks)
+- Alias configuration (@, @shared, @reports, @data-entry)
+
+### 3. Application Entry
+
+**File**: `/mnt/e/proiecte/roa2web/src/main.js`
+
+**Key setup**:
+- PrimeVue configuration (theme: saga-blue)
+- Global components registration
+- Router, Pinia, ToastService, ConfirmationService
+- CSS imports
+
+### 4. Root Component
+
+**File**: `/mnt/e/proiecte/roa2web/src/App.vue`
+
+**Key elements**:
+- AppHeader with unified menu
+- SlideMenu with module sections
+- router-view
+- Toast, ConfirmDialog
+
+### 5. Router Configuration
+
+**File**: `/mnt/e/proiecte/roa2web/src/router/index.js`
+
+**Key routes**:
+- `/login` - LoginView (eager loaded)
+- `/reports/*` - ReportsLayout (lazy loaded) with children
+- `/data-entry/*` - DataEntryLayout (lazy loaded) with children
+- Authentication guard
+
+### 6. Menu Configuration
+
+**File**: `/mnt/e/proiecte/roa2web/src/config/menu.js`
+
+**Sections**:
+- Rapoarte (Reports)
+- Introduceri Date (Data Entry)
+- Sistem (System)
+
+### 7. Feature Flags
+
+**File**: `/mnt/e/proiecte/roa2web/src/config/features.js`
+
+**Flags**:
+- reports.enabled
+- dataEntry.enabled
+- Module-level flags
+
+### 8. Error Boundary Component
+
+**File**: `/mnt/e/proiecte/roa2web/src/shared/components/ErrorBoundary.vue`
+
+**Key features**:
+- onErrorCaptured hook
+- User-friendly error display
+- Retry functionality
+- Navigate away option
+
+### 9. Module Layouts
+
+**File**: `/mnt/e/proiecte/roa2web/src/modules/reports/ReportsLayout.vue`
+
+**Wrapper**:
+```vue
+<ErrorBoundary module-name="Reports">
+  <router-view />
+</ErrorBoundary>
+```
+
+**File**: `/mnt/e/proiecte/roa2web/src/modules/data-entry/DataEntryLayout.vue`
+
+**Wrapper**:
+```vue
+<ErrorBoundary module-name="Data Entry">
+  <router-view />
+</ErrorBoundary>
+```
+
+---
+
+## Deployment Files
+
+### IIS Configuration
+
+**File**: `/mnt/e/proiecte/roa2web/web.config`
+
+**Key rules**:
+- SPA routing (all routes → index.html)
+- API proxy: `/api/reports/*` → `http://localhost:8001/api/*`
+- API proxy: `/api/data-entry/*` → `http://localhost:8003/api/*`
+- Uploads proxy: `/uploads/*` → `http://localhost:8003/uploads/*`
+
+### Environment Variables
+
+**File**: `/mnt/e/proiecte/roa2web/.env.example`
+
+**Variables**:
+```bash
+# API Endpoints (dev only, production uses IIS proxy)
+VITE_REPORTS_API=http://localhost:8001
+VITE_DATA_ENTRY_API=http://localhost:8003
+
+# Feature Flags
+VITE_ENABLE_REPORTS=true
+VITE_ENABLE_DATA_ENTRY=true
+```
+
+---
+
+## Testing Files
+
+### E2E Tests
+
+**New files to create**:
+- `/mnt/e/proiecte/roa2web/tests/e2e/login.spec.js`
+- `/mnt/e/proiecte/roa2web/tests/e2e/reports-navigation.spec.js`
+- `/mnt/e/proiecte/roa2web/tests/e2e/data-entry-navigation.spec.js`
+- `/mnt/e/proiecte/roa2web/tests/e2e/module-switching.spec.js`
+- `/mnt/e/proiecte/roa2web/tests/e2e/error-isolation.spec.js`
+
+**Existing tests to adapt**:
+- `/mnt/e/proiecte/roa2web/reports-app/frontend/tests/` - Update routes
+- `/mnt/e/proiecte/roa2web/data-entry-app/frontend/tests/` - Update routes
+
+---
+
+## Documentation Files to Update
+
+### Primary Documentation
+
+1. **CLAUDE.md** (root)
+   - Update architecture diagram
+   - Add unified-app section
+   - Mark old apps as archived
+   - Update deployment instructions
+
+2. **README.md** (root)
+   - Update quick start
+   - Update deployment section
+   - Update URL structure
+
+3. **DEPLOYMENT_GUIDE.md**
+   - Update IIS configuration
+   - Update build process
+   - Add rollback instructions
+
+4. **docs/ARCHITECTURE_SCHEMA.md**
+   - Update architecture diagrams
+   - Document module structure
+   - Add error boundary architecture
+
+### Deployment Documentation
+
+5. **deployment/windows/README.md**
+   - Update deployment steps
+   - Update IIS configuration
+   - Update proxy rules
+
+6. **deployment/windows/docs/WINDOWS_DEPLOYMENT.md**
+   - Complete Windows guide updates
+
+---
+
+## File Count Summary
+
+**To Create**: ~15 new files
+- 9 core files (package.json, vite.config.js, main.js, App.vue, router, menu, features, ErrorBoundary, 2 layouts)
+- 3 configuration files (.env.example, web.config, README.md)
+- 3 documentation updates
+
+**To Migrate**: ~20 files
+- 7 Reports views
+- 2 Data Entry views
+- 3 Data Entry components
+- 5 Reports stores
+- 1 Data Entry store
+- 2 API services
+
+**To Copy**: ~30 CSS files
+- Entire reports-app CSS structure
+
+**Total Files Affected**: ~65 files
+
+---
+
+## Time Estimates per File Type
+
+| Task | Files | Avg Time | Total |
+|------|-------|----------|-------|
+| Create core files | 9 | 30 min | 4.5 hours |
+| Migrate views | 9 | 20 min | 3 hours |
+| Migrate components | 3 | 15 min | 45 min |
+| Migrate stores | 6 | 20 min | 2 hours |
+| Migrate services | 2 | 30 min | 1 hour |
+| Copy CSS | 1 | 1 hour | 1 hour |
+| Configuration | 3 | 30 min | 1.5 hours |
+| Documentation | 6 | 30 min | 3 hours |
+| Testing & fixes | - | - | 4 hours |
+
+**Total**: ~20 hours (~2.5 days)
+
+---
+
+## Verification Checklist
+
+After migrating each category:
+
+### Configuration Files ✓
+- [ ] package.json has all dependencies
+- [ ] vite.config.js has dual proxy
+- [ ] main.js initializes correctly
+- [ ] npm install succeeds
+- [ ] npm run dev starts
+
+### Views ✓
+- [ ] All Reports views render
+- [ ] All Data Entry views render
+- [ ] No import errors
+- [ ] Routes work
+
+### Stores ✓
+- [ ] All stores import correctly
+- [ ] No duplicate store instances
+- [ ] Shared stores work
+- [ ] Module stores isolated
+
+### Services ✓
+- [ ] API calls route to correct backend
+- [ ] /api/reports/ → :8001
+- [ ] /api/data-entry/ → :8003
+- [ ] Auth headers preserved
+
+### CSS ✓
+- [ ] No style conflicts
+- [ ] Design tokens work
+- [ ] PrimeVue theme consistent
+- [ ] Responsive works
+
+### Router ✓
+- [ ] All routes accessible
+- [ ] Lazy loading works
+- [ ] Auth guard works
+- [ ] 404 redirects
+
+### Error Boundaries ✓
+- [ ] Catches component errors
+- [ ] Displays user message
+- [ ] Module isolation works
+- [ ] Can retry/navigate
+
+### Build ✓
+- [ ] npm run build succeeds
+- [ ] Chunks split correctly
+- [ ] Bundle size acceptable
+- [ ] Preview works
+
+---
+
+**Last Updated**: 2025-12-22
+**For**: Unified App Implementation
+**Reference**: See spec.md for complete specification
--- a/.auto-build-data/specs/unified-app/spec.md
+++ b/.auto-build-data/specs/unified-app/spec.md
--- a/.auto-build-data/specs/unified-app/status.json
+++ b/.auto-build-data/specs/unified-app/status.json
@@ -0,0 +1,30 @@
+{
+  "feature": "unified-app",
+  "status": "SPEC_COMPLETE",
+  "created": "2025-12-22T01:09:00Z",
+  "updated": "2025-12-22T01:13:00Z",
+  "complexity": "medium",
+  "estimated_effort": "2.5 days",
+  "history": [
+    {
+      "status": "SPEC_DRAFT",
+      "at": "2025-12-22T01:09:00Z"
+    },
+    {
+      "status": "SPEC_COMPLETE",
+      "at": "2025-12-22T01:13:00Z"
+    }
+  ],
+  "files": {
+    "spec": "spec.md",
+    "summary": "SUMMARY.md",
+    "critical_files": "critical-files.md",
+    "migration_checklist": "MIGRATION_CHECKLIST.md"
+  },
+  "stats": {
+    "files_to_create": 15,
+    "files_to_migrate": 20,
+    "css_files_to_copy": 30,
+    "total_files_affected": 65
+  }
+}
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -0,0 +1,5 @@
+{
+  "enabledPlugins": {
+    "ab@roa2web-tools": true
+  }
+}
--- a/.claude_settings.json
+++ b/.claude_settings.json
@@ -0,0 +1,32 @@
+{
+  "sandbox": {
+    "enabled": true,
+    "autoAllowBashIfSandboxed": true
+  },
+  "permissions": {
+    "defaultMode": "acceptEdits",
+    "allow": [
+      "Read(./**)",
+      "Write(./**)",
+      "Edit(./**)",
+      "Glob(./**)",
+      "Grep(./**)",
+      "Bash(*)",
+      "mcp__puppeteer__puppeteer_connect_active_tab",
+      "mcp__puppeteer__puppeteer_navigate",
+      "mcp__puppeteer__puppeteer_screenshot",
+      "mcp__puppeteer__puppeteer_click",
+      "mcp__puppeteer__puppeteer_fill",
+      "mcp__puppeteer__puppeteer_select",
+      "mcp__puppeteer__puppeteer_hover",
+      "mcp__puppeteer__puppeteer_evaluate",
+      "mcp__context7__resolve-library-id",
+      "mcp__context7__get-library-docs",
+      "mcp__graphiti-memory__search_nodes",
+      "mcp__graphiti-memory__search_facts",
+      "mcp__graphiti-memory__add_episode",
+      "mcp__graphiti-memory__get_episodes",
+      "mcp__graphiti-memory__get_entity_edge"
+    ]
+  }
+}
--- a/.gitignore
+++ b/.gitignore
@@ -510,3 +510,6 @@ TELEGRAM_EMAIL_AUTH_PLAN*.md
 secrets-backup/**/*.env
 secrets-backup/**/.env.*
 !secrets-backup/**/*.gpg
+
+.playwright-mcp/*
+data-entry-app/backend/data/*
--- a/IMPLEMENTATION_PLAN_UNIFIED_APP.md
+++ b/IMPLEMENTATION_PLAN_UNIFIED_APP.md
@@ -0,0 +1,285 @@
+# Plan: Consolidare ROA2WEB - Pragmatic Monolith
+
+> **Branch**: `feature/unified-app-pragmatic-monolith`
+> **Status**: APROBAT - Ready for Implementation
+> **Efort estimat**: ~2.5 zile
+
+---
+
+## Context și Problema
+
+### Situația Curentă
+- 2 aplicații frontend separate în IIS: `/roa2web/` și `/data-entry/`
+- Deploy greoi (2 build-uri, 2 configurații IIS separate)
+- Componentele shared cauzează probleme CSS cross-app (text alb pe fundal alb)
+- Nu există meniu unificat între aplicații
+
+### Obiectiv
+- Un singur meniu cu ambele aplicații (Reports + Data Entry)
+- Deploy simplificat (un build, un site IIS)
+- Izolare între module (bug în Reports să nu afecteze DataEntry)
+- URL-uri pe root: `/reports/*`, `/data-entry/*`
+
+---
+
+## Decizie Arhitecturală: Pragmatic Monolith
+
+### De ce NU Micro-frontends?
+| Criteriu pentru MFE | ROA2WEB | Necesită MFE? |
+|---------------------|---------|---------------|
+| 20+ dezvoltatori | 1 dev | ❌ Nu |
+| Deploy de multe ori/zi | Săptămânal | ❌ Nu |
+| Milioane de utilizatori | 1-5 concurenți | ❌ Nu |
+| Framework-uri diferite | Vue only | ❌ Nu |
+
+**Verdict**: Module Federation / Single-SPA = OVERKILL
+
+### Abordare Aleasă: Monolith cu Mecanisme de Izolare
+- **Error Boundaries** per modul (bug în Reports nu strică DataEntry)
+- **Lazy Loading** (bundle-uri separate, încărcate la nevoie)
+- **Stores izolate** per modul
+- **Feature flags** pentru control
+
+**Blast radius cu protecții: 50-70%** (aproape ca 2 apps separate!)
+
+---
+
+## Arhitectura Finală
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    ROA2WEB Unified SPA                       │
+│                                                              │
+│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────────┐ │
+│  │ Reports Module  │  │ DataEntry Module │  │   Shared     │ │
+│  │ /reports/*      │  │ /data-entry/*    │  │  - Auth      │ │
+│  │ (lazy loaded)   │  │ (lazy loaded)    │  │  - Company   │ │
+│  │                 │  │                  │  │  - Period    │ │
+│  │ ErrorBoundary   │  │ ErrorBoundary    │  │  - Header    │ │
+│  └────────┬────────┘  └────────┬─────────┘  └──────────────┘ │
+│           │                    │                              │
+│  ┌────────┴────────────────────┴─────────┐                   │
+│  │      Vue Router + Global Error Handler │                   │
+│  └────────────────────────────────────────┘                   │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                    ┌─────────┴─────────┐
+                    │    IIS Proxy      │
+                    └─────────┬─────────┘
+              ┌───────────────┴───────────────┐
+              │                               │
+     ┌────────▼────────┐           ┌──────────▼────────┐
+     │ Reports Backend │           │ DataEntry Backend │
+     │   port 8001     │           │   port 8003       │
+     │   (Oracle RO)   │           │ (SQLite + Oracle) │
+     └─────────────────┘           └───────────────────┘
+```
+
+---
+
+## Structura Proiect Unified
+
+```
+roa2web/
+├── src/
+│   ├── main.js
+│   ├── App.vue                    # Meniu unificat
+│   ├── router/index.js            # Rute unificate cu lazy loading
+│   │
+│   ├── modules/
+│   │   ├── reports/               # MODUL IZOLAT
+│   │   │   ├── ReportsLayout.vue  # Error boundary pentru modul
+│   │   │   ├── views/
+│   │   │   │   ├── DashboardView.vue
+│   │   │   │   ├── InvoicesView.vue
+│   │   │   │   ├── BankCashRegisterView.vue
+│   │   │   │   ├── TrialBalanceView.vue
+│   │   │   │   ├── TelegramView.vue
+│   │   │   │   └── CacheStatsView.vue
+│   │   │   ├── stores/
+│   │   │   └── services/
+│   │   │
+│   │   └── data-entry/            # MODUL IZOLAT
+│   │       ├── DataEntryLayout.vue
+│   │       ├── views/
+│   │       │   ├── ReceiptsListView.vue
+│   │       │   └── ReceiptCreateView.vue
+│   │       ├── stores/
+│   │       └── services/
+│   │
+│   ├── shared/                    # Shared între module
+│   │   ├── components/            # AppHeader, SlideMenu, CompanySelector, etc.
+│   │   ├── stores/                # Auth, Company, Period
+│   │   └── styles/
+│   │
+│   └── config/
+│       ├── menu.js                # Configurație meniu unificat
+│       └── features.js            # Feature flags
+│
+├── vite.config.js
+└── package.json
+```
+
+---
+
+## Pași Implementare
+
+### Faza 1: Setup Proiect (0.5 zile)
+1. Creează directorul `roa2web/`
+2. Setup `package.json` cu dependencies combinate din ambele apps
+3. Setup `vite.config.js` cu:
+   - Dual proxy: `/api/reports/*` → `:8001`, `/api/data-entry/*` → `:8003`
+   - Lazy loading chunks configuration
+   - Base path `/`
+4. Setup `main.js` cu Pinia, PrimeVue, Router
+
+### Faza 2: Migrare Module (1 zi)
+1. Copiază views din `reports-app/frontend/src/views/` → `modules/reports/views/`
+2. Copiază views din `data-entry-app/frontend/src/views/` → `modules/data-entry/views/`
+3. Copiază stores specifice fiecărui modul
+4. Creează `ReportsLayout.vue` și `DataEntryLayout.vue` cu error boundaries
+5. Setup router unificat:
+   ```javascript
+   const routes = [
+     { path: '/login', component: LoginView },
+     {
+       path: '/reports',
+       component: () => import('./modules/reports/ReportsLayout.vue'),
+       children: [
+         { path: 'dashboard', component: () => import('./modules/reports/views/DashboardView.vue') },
+         { path: 'invoices', component: () => import('./modules/reports/views/InvoicesView.vue') },
+         // ...
+       ]
+     },
+     {
+       path: '/data-entry',
+       component: () => import('./modules/data-entry/DataEntryLayout.vue'),
+       children: [
+         { path: '', component: () => import('./modules/data-entry/views/ReceiptsListView.vue') },
+         { path: 'create', component: () => import('./modules/data-entry/views/ReceiptCreateView.vue') },
+       ]
+     },
+     { path: '/', redirect: '/reports/dashboard' }
+   ]
+   ```
+
+### Faza 3: Izolare și Resilience (0.5 zile)
+1. Implementează `ErrorBoundary.vue`:
+   ```vue
+   <template>
+     <div v-if="error" class="module-error">
+       <h3>⚠️ {{ moduleName }} a întâmpinat o eroare</h3>
+       <p>{{ error.message }}</p>
+       <button @click="retry">Reîncearcă</button>
+     </div>
+     <slot v-else />
+   </template>
+   ```
+2. Separă stores per modul (nu global)
+3. Adaugă feature flags în `config/features.js`
+4. Testează izolarea: introduce bug în Reports, verifică că DataEntry funcționează
+
+### Faza 4: Build & Deploy (0.5 zile)
+1. Verifică bundle splitting cu `npm run build`:
+   ```
+   dist/assets/
+   ├── index-[hash].js      # Shell + shared (~150KB)
+   ├── reports-[hash].js    # Reports module (~200KB)
+   └── data-entry-[hash].js # DataEntry module (~100KB)
+   ```
+2. Update IIS web.config pentru SPA routing (toate rutele → index.html)
+3. Update deployment scripts pentru single app
+4. Test end-to-end pe server
+5. Deploy în producție
+
+---
+
+## Meniu Unificat
+
+```javascript
+// config/menu.js
+export const menuSections = [
+  {
+    title: 'Rapoarte',
+    items: [
+      { to: '/reports/dashboard', icon: 'pi pi-home', label: 'Dashboard' },
+      { to: '/reports/invoices', icon: 'pi pi-file', label: 'Facturi' },
+      { to: '/reports/bank-cash', icon: 'pi pi-money-bill', label: 'Casa și Banca' },
+      { to: '/reports/trial-balance', icon: 'pi pi-calculator', label: 'Balanță' },
+    ]
+  },
+  {
+    title: 'Introduceri Date',
+    items: [
+      { to: '/data-entry', icon: 'pi pi-list', label: 'Lista Bonuri' },
+      { to: '/data-entry/create', icon: 'pi pi-plus', label: 'Bon Nou' },
+    ]
+  },
+  {
+    title: 'Sistem',
+    items: [
+      { to: '/reports/telegram', icon: 'pi pi-telegram', label: 'Telegram' },
+      { to: '/reports/cache-stats', icon: 'pi pi-chart-bar', label: 'Cache Stats' },
+    ]
+  }
+];
+```
+
+---
+
+## Fișiere de Referință
+
+### Fișiere Existente (sursă pentru copiere)
+- `reports-app/frontend/src/views/*.vue` - Views Reports
+- `reports-app/frontend/src/stores/*.js` - Stores Reports
+- `reports-app/frontend/src/services/api.js` - API service Reports
+- `data-entry-app/frontend/src/views/*.vue` - Views DataEntry
+- `data-entry-app/frontend/src/stores/*.js` - Stores DataEntry
+- `data-entry-app/frontend/src/services/api.js` - API service DataEntry
+- `shared/frontend/components/` - Componente shared (AppHeader, SlideMenu, etc.)
+- `shared/frontend/stores/` - Stores shared (auth, companies, accountingPeriod)
+
+### Configurații de Referință
+- `reports-app/frontend/vite.config.js` - Pentru proxy și build config
+- `reports-app/frontend/package.json` - Pentru dependencies
+- `data-entry-app/frontend/vite.config.js` - Pentru proxy config
+- `data-entry-app/frontend/package.json` - Pentru dependencies
+
+---
+
+## URL-uri Finale
+
+| Path | Descriere |
+|------|-----------|
+| `/` | Redirect la `/reports/dashboard` |
+| `/login` | Pagină login |
+| `/reports/dashboard` | Dashboard principal |
+| `/reports/invoices` | Facturi |
+| `/reports/bank-cash` | Casa și Banca |
+| `/reports/trial-balance` | Balanță de Verificare |
+| `/reports/telegram` | Telegram Bot |
+| `/reports/cache-stats` | Statistici Cache |
+| `/data-entry` | Lista Bonuri |
+| `/data-entry/create` | Bon Nou |
+| `/data-entry/:id` | Detalii Bon |
+| `/data-entry/:id/edit` | Editare Bon |
+
+---
+
+## Note Importante
+
+1. **Backend-urile rămân separate** - port 8001 (Reports) și port 8003 (DataEntry)
+2. **IIS proxy routing** - trebuie configurat pentru a ruta API calls corect
+3. **Error Boundaries** - critice pentru izolarea modulelor
+4. **Lazy Loading** - asigură bundle splitting corect
+5. **Feature flags** - permit dezactivarea unui modul fără redeploy
+
+---
+
+## Handover Notes
+
+Această implementare va înlocui cele 2 aplicații separate cu o aplicație unificată.
+După implementare, directoarele `reports-app/frontend/` și `data-entry-app/frontend/`
+pot fi arhivate/șterse, păstrând doar `unified-app/`.
+
+Backend-urile rămân neschimbate în `reports-app/backend/` și `data-entry-app/backend/`.
--- a/data-entry-app/docs/igiena
+++ b/data-entry-app/docs/igiena
--- a/data-entry-app/docs/rechizite
+++ b/data-entry-app/docs/rechizite