How jahanvi11-1/ecovia works
Ecovia is a PLM application whose central workflow is to propose product or BoM changes as ECOs, move them through configurable approvals and validation, then apply them; application can archive and version product or BoM state. Users also browse products and BoMs, manage stages and approval rules, and review audit and version reports. The React app calls a FastAPI API backed by PostgreSQL. Core lifecycle links are supported by the ECO router’s indexed references; some frontend and reporting details are documented but their implementation was not sampled.
Main entry points: client.js API client · App.jsx Application routes · ecos.py ECO API · database.py Async database session
Components 25
PLM interface
- Application routes
frontend/src/App.jsx - API client
frontend/src/api/client.js - Auth state
frontend/src/store/authStore.js - Product views
frontend/src/components/products/ProductList.jsx - BoM views
frontend/src/components/bom/BomList.jsx - ECO views
frontend/src/components/eco/EcoDetail.jsx - Workflow settings
frontend/src/components/settings/EcoStageSettings.jsx - Reports
frontend/src/components/reports/AuditLogReport.jsx
API routes
- Authentication API
backend/app/routers/auth.py - Product API
backend/app/routers/products.py - BoM API
backend/app/routers/boms.py - ECO API
backend/app/routers/ecos.py - Settings API
backend/app/routers/settings.py - Reports API
backend/app/routers/reports.py
Change workflow
- Stage machine
backend/app/core/stage_machine.py - Version manager
backend/app/core/version_manager.py - Change diff
backend/app/core/diff_engine.py
Identity and access
- JWT and RBAC
backend/app/core/deps.py
PLM data
- Product versions
backend/app/models/product.py - BoM records
backend/app/models/bom.py - ECO and approvals
backend/app/models/eco.py - User records
backend/app/models/user.py - Async database session
backend/app/database.py
Other components
- PLM user
- PostgreSQL
Connections 40
- PLM user → Application routes: uses
frontend/src/App.jsx - Application routes → API client: loads identity
frontend/src/App.jsx - Application routes → Auth state: checks session
frontend/src/App.jsx - Application routes → Product views: routes to
frontend/src/App.jsx - Application routes → BoM views: routes to
frontend/src/App.jsx - Application routes → ECO views: routes to
frontend/src/App.jsx - Application routes → Workflow settings: routes to
frontend/src/App.jsx - Application routes → Reports: routes to
frontend/src/App.jsx - Product views → API client: requests data
frontend/src/components/products/ProductList.jsx - BoM views → API client: requests data
frontend/src/components/bom/BomList.jsx - ECO views → API client: requests lifecycle
frontend/src/components/eco/EcoDetail.jsx - Workflow settings → API client: configures stages
frontend/src/components/settings/EcoStageSettings.jsx - Reports → API client: requests reports
frontend/src/components/reports/AuditLogReport.jsx - API client → Authentication API: calls API
README.md - API client → Product API: calls API
README.md - API client → BoM API: calls API
README.md - API client → ECO API: calls API
README.md - API client → Settings API: calls API
README.md - API client → Reports API: calls API
README.md - Authentication API → JWT and RBAC: authenticates
backend/app/routers/auth.py - Authentication API → User records: reads and writes
backend/app/routers/auth.py - Product API → Product versions: queries
backend/app/routers/products.py - BoM API → BoM records: queries
backend/app/routers/boms.py - ECO API → Stage machine: advances stages
backend/app/routers/ecos.py - ECO API → Version manager: applies changes
backend/app/routers/ecos.py - ECO API → Change diff: computes diff
backend/app/routers/ecos.py - ECO API → ECO and approvals: records lifecycle
backend/app/routers/ecos.py - ECO API → Product versions: targets product
backend/app/routers/ecos.py - ECO API → BoM records: targets BoM
backend/app/routers/ecos.py - Settings API → ECO and approvals: configures stages
backend/app/routers/settings.py - Version manager → Product versions: versions product
backend/app/core/version_manager.py - Version manager → BoM records: versions BoM
backend/app/core/version_manager.py - Version manager → ECO and approvals: reads proposal
backend/app/core/version_manager.py - JWT and RBAC → User records: resolves user
backend/app/core/deps.py - JWT and RBAC → Auth state: issues JWT
- Product versions → Async database session: maps records
backend/app/models/product.py - BoM records → Async database session: maps records
backend/app/models/bom.py - ECO and approvals → Async database session: maps records
backend/app/models/eco.py - User records → Async database session: maps records
backend/app/models/user.py - Async database session → PostgreSQL: persists data
README.md