# cine-verse/erpc-front architecture

> Architecture diagram of the GitHub repository cine-verse/erpc-front, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cine-verse/erpc-front
- Repository: https://github.com/cine-verse/erpc-front

## Overview

##### Project type and purpose
- This is a full-stack single-page application (SPA) built with Vue 3 and Vite on the frontend and a minimal Node/Express server (server.js) to serve the static build (and potentially proxy API calls).
- The app appears to be an “ERP-style” administrative dashboard (“erpc”) with modules for approvals, contracts, customers, estimates, orders, billing, performance, logistics, notices, sales opportunities, and employee management.
- Deployment targets AWS Elastic Beanstalk (see .ebextensions and Procfile) and uses GitHub Actions (/.github/workflows/deploy.yml) for CI/CD.

##### File structure
- Top-level:
- package.json, vite.config.js, jsconfig.json: npm scripts, Vite config, JS paths
- server.js: Express server to serve the SPA (and possibly API proxy)
- Procfile/.ebextensions: Elastic Beanstalk deployment config
- .github/workflows/deploy.yml: CI/CD pipeline
- index.html & public/: public assets
- src/: Vue app source
- src/ substructure:
- main.js & App.vue: root of the Vue app
- router/mainRouter.js: client-side routing (SPA)
- components/: feature-based UI modules (approval, contract, customer, etc.)
- assets/css & assets/img: static styles and images
- No direct database or service-layer code, implying that either:
- server.js contains API endpoints, or

##### README for additional insights
- Confirms usage of Vue 3 + Vite.
- Standard npm “dev” and “build” scripts.

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Development Workflow"
    Dev["Developer"]:::external
    Dev -->|"push code"| GitHub["GitHub Repo"]:::external
    GitHub -->|"clone/fork"| IDE["Local Dev Env"]:::external
    IDE -->|"npm run dev"| ViteDev["Vite Dev Server"]:::frontend
    IDE -->|"npm scripts"| Package["package.json"]:::frontend
    IDE -->|"config"| ViteConf["vite.config.js"]:::frontend
    IDE -->|"config"| JSConf["jsconfig.json"]:::frontend

    IDE -->|"build"| ViteBuild["Vite Build (dist/)"]:::frontend

    subgraph "Vue 3 SPA Source"
      Main["Entry Point: src/main.js"]:::frontend
      App["Root Component: src/App.vue"]:::frontend
      Router["Client Router: src/router/mainRouter.js"]:::frontend

      subgraph "Domain Modules"
        Approval["Approval Module"]:::frontend
        Contract["Contract Module"]:::frontend
        Customer["Customer Module"]:::frontend
        Estimate["Estimate Module"]:::frontend
        Order["Order Module"]:::frontend
        Billing["Billing Module"]:::frontend
        Performance["Performance Module"]:::frontend
        Logistics["Logistics Module"]:::frontend
        Notice["Notice Module"]:::frontend
        Salesopp["SalesOpp Module"]:::frontend
        Employee["Employee Module"]:::frontend
      end

      Utilities["Shared/Delete Utilities"]:::frontend

      subgraph "Assets"
        CSS["CSS Assets: src/assets/css"]:::frontend
        Img["Image Assets: src/assets/img"]:::frontend
      end

      PublicHTML["HTML Template: public/index.html"]:::frontend
      PublicStatic["Public Static Files: public/"]:::frontend
    end
  end

  subgraph "CI/CD Pipeline"
    GitHub -->|"trigger CI"| Actions["GitHub Actions CI/CD"]:::ci
    Actions -->|"deploy"| EB["AWS Elastic Beanstalk"]:::external
    EB -->|"deploy config"| Procfile["Procfile"]:::backend
    EB -->|"deploy config"| EBExt[".ebextensions/nodecommand.config"]:::backend
  end

  subgraph "Runtime Environment"
    Browser["Browser"]:::external
    Browser -->|"HTTP GET /"| Express["Express Static Server (server.js)"]:::backend
    Express -->|"serves static"| Dist["Static Files (dist/)"]:::backend
    Express -->|"API Calls"| ExternalAPI["External API / Database"]:::external
  end

  EB -->|"hosts"| Express

  click Main "https://github.com/cine-verse/erpc-front/blob/main/src/main.js"
  click App "https://github.com/cine-verse/erpc-front/blob/main/src/App.vue"
  click Router "https://github.com/cine-verse/erpc-front/blob/main/src/router/mainRouter.js"
  click Approval "https://github.com/cine-verse/erpc-front/tree/main/src/components/approval/"
  click Contract "https://github.com/cine-verse/erpc-front/tree/main/src/components/contract/"
  click Customer "https://github.com/cine-verse/erpc-front/tree/main/src/components/customer/"
  click Estimate "https://github.com/cine-verse/erpc-front/tree/main/src/components/estimate/"
  click Order "https://github.com/cine-verse/erpc-front/tree/main/src/components/order/"
  click Billing "https://github.com/cine-verse/erpc-front/tree/main/src/components/bill/"
  click Performance "https://github.com/cine-verse/erpc-front/tree/main/src/components/performance/"
  click Logistics "https://github.com/cine-verse/erpc-front/tree/main/src/components/logistics/"
  click Notice "https://github.com/cine-verse/erpc-front/tree/main/src/components/notice/"
  click Salesopp "https://github.com/cine-verse/erpc-front/tree/main/src/components/salesopp/"
  click Employee "https://github.com/cine-verse/erpc-front/tree/main/src/components/employee/"
  click Utilities "https://github.com/cine-verse/erpc-front/tree/main/src/components/delete/"
  click CSS "https://github.com/cine-verse/erpc-front/tree/main/src/assets/css/"
  click Img "https://github.com/cine-verse/erpc-front/tree/main/src/assets/img/"
  click PublicHTML "https://github.com/cine-verse/erpc-front/blob/main/public/index.html"
  click PublicStatic "https://github.com/cine-verse/erpc-front/tree/main/public/"
  click Package "https://github.com/cine-verse/erpc-front/blob/main/package.json"
  click ViteConf "https://github.com/cine-verse/erpc-front/blob/main/vite.config.js"
  click JSConf "https://github.com/cine-verse/erpc-front/blob/main/jsconfig.json"
  click Procfile "https://github.com/cine-verse/erpc-front/tree/main/Procfile"
  click EBExt "https://github.com/cine-verse/erpc-front/blob/main/.ebextensions/nodecommand.config"
  click Actions "https://github.com/cine-verse/erpc-front/blob/main/.github/workflows/deploy.yml"
  click Express "https://github.com/cine-verse/erpc-front/blob/main/server.js"

  classDef frontend fill:#D6EAF8,stroke:#1B4F72,color:#1B2631
  classDef backend fill:#D5F5E3,stroke:#145A32,color:#145A32
  classDef ci fill:#FCF3CF,stroke:#B9770E,color:#7D6608
  classDef external fill:#F2F3F4,stroke:#47535E,color:#212F3D
  classDef database fill:#E8DAEF,stroke:#6C3483,color:#4A235A
```
