roa2web-service-auto/.auto-build-data/specs/unified-app/critical-files.md

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:

const api = axios.create({
  baseURL: '/api'
})

New:

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:

const api = axios.create({
  baseURL: '/api'
})

New:

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:

<ErrorBoundary module-name="Reports">
  <router-view />
</ErrorBoundary>

File: /mnt/e/proiecte/roa2web/src/modules/data-entry/DataEntryLayout.vue

Wrapper:

<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:

# 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