# tripeasycompany/frontend architecture

> Architecture diagram of the GitHub repository tripeasycompany/frontend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tripeasycompany/frontend
- Repository: https://github.com/tripeasycompany/frontend

## Overview

##### Project type and purpose
- This is a single-page application (SPA) front-end for “TripEasy,” built with Vue.js (via Vite).
- It provides both public (“front”) user-facing pages (search, home, about) and an admin console (user management, site settings, dashboard).
- It lives as static assets (HTML/CSS/JS) deployed to a GitHub Pages or similar static host and interacts with a separate backend via RESTful APIs.

##### File structure
- Top-level:
- index.html / public/ – static entry point + assets & redirect rules
- src/ – main application code
- src/router/ – Vue Router setup for front vs. admin routes
- src/stores/ – Pinia (Vue store) modules (userStore.js, counter.js)
- src/views/ – page containers, subdivided into front/ and admin/ (with manage/)
- src/utils/ – api.js (HTTP clients), function.js (helpers)
- Build & deploy config: vite.config.js, static.json, .github/workflows/gh-pages.yml
- CSS/asset pipelines: SCSS/CSS under src/assets

##### Architectural patterns
- Component-based UI (Vue single-file components)
- Client-side routing (Vue Router) separating front-end and admin sections
- Global state management (Pinia stores) for user session and counters
- Utilities layer (HTTP API client) decouples API calls from components
- Static-site CI/CD pipeline via GitHub Actions → builds & deploys to GitHub Pages or similar

##### Main components
a. User Browser
b. Static Hosting/CDN (GitHub Pages, Netlify, S3)
c. Vue SPA – App.vue root
- Router Layer (router/index.js)
– Front Routes → HomeView, AboutView, front/searchPage.vue …
– Admin Routes → loginPage, memberPage, manage/dashboardPage.vue …
- State Layer – Pinia stores (userStore, counter)
- Utils Layer – API client (api.js) + helper functions (function.js)
- Assets – SCSS/CSS, images
d. Backend Services (external REST API, authentication service, data store)
e. CI/CD Pipeline (GitHub Actions building via Vite, deploying static files)

##### Relationships and data flow
- Browser → (HTTP GET) → Static Host → Serves index.html + JS/CSS
- App.vue loads → initializes Pinia and Router
- User navigation → Router resolves view → component tree renders
- Components / stores call api.js → HTTP requests → Backend Services → JSON responses
- CI/CD: GitHub Actions → on push to main/dev → runs `npm run build` → deploys /dist to Pages

##### Architectural patterns & design principles
- SPA (MVVM-like): App (ViewModel) binds data from stores to Views (components)
- Separation of concerns: Routing, State, UI, API, Assets each in its own folder
- Module isolation: front vs. admin views live in dedicated subdirectories
- CI/CD as code: workflow .yml orchestrates build and deployment

##### Essential elements to capture
- Separation of public (front) vs. admin modules
- Client-side routing resolving to different views
- Centralized state (Pinia) feeding multiple components
- API abstraction layer (api.js) decoupled from UI
- Build & deploy process as part of the overall architecture

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "User & Delivery"
        Browser["User Browser"]:::infra
    end

    subgraph "Static Host / CDN"
        SH["Static Host/CDN"]:::infra
        index["index.html"]:::infra
        public["public/"]:::infra
        staticcfg["static.json"]:::infra
        deploycfg[".github/workflows/gh-pages.yml"]:::infra
    end

    Browser -->|"HTTP GET"| SH
    SH --> index
    SH --> public
    SH --> staticcfg
    SH --> deploycfg

    subgraph "Vue SPA"
        App["App.vue"]:::ui
        Main["main.js"]:::infra

        subgraph "Routing Layer"
            Router["router/index.js"]:::routing

            subgraph "Front Routes"
                Home["HomeView.vue"]:::ui
                About["AboutView.vue"]:::ui
                Search["searchPage.vue"]:::ui
            end

            subgraph "Admin Routes"
                Login["loginPage.vue"]:::ui
                Register["registerPage.vue"]:::ui
                Forgot["forgotpwPage.vue"]:::ui
                Reset["resetpwPage.vue"]:::ui
                Member["memberPage.vue"]:::ui
                Personal["personalOrder.vue"]:::ui
                Profile["userprofilePage.vue"]:::ui
                Collect["collectPage.vue"]:::ui

                subgraph "Manage"
                    Dashboard["dashboardPage.vue"]:::ui
                    AutoSet["automaticSetting.vue"]:::ui
                    RoleSet["roleSetting.vue"]:::ui
                    ServiceSet["serviceSetting.vue"]:::ui
                    WebSet["websiteSetting.vue"]:::ui
                end
            end

            Router --> Home
            Router --> About
            Router --> Search
            Router --> Login
            Router --> Register
            Router --> Forgot
            Router --> Reset
            Router --> Member
            Router --> Personal
            Router --> Profile
            Router --> Collect
            Router --> Dashboard
            Router --> AutoSet
            Router --> RoleSet
            Router --> ServiceSet
            Router --> WebSet
        end

        subgraph "Component Layer"
            Header["HeaderComponent.vue"]:::ui
            Footer["FooterComponent.vue"]:::ui
            ErrorComp["ErrorComponent.vue"]:::ui

            subgraph "Icons"
                IconComm["IconCommunity.vue"]:::ui
                IconDoc["IconDocumentation.vue"]:::ui
                IconEco["IconEcosystem.vue"]:::ui
                IconSup["IconSupport.vue"]:::ui
                IconTool["IconTooling.vue"]:::ui
            end
        end

        subgraph "State (Pinia) Stores"
            UserStore["userStore.js"]:::state
            Counter["counter.js"]:::state
        end

        subgraph "Utilities"
            API["api.js"]:::state
            Func["function.js"]:::state
        end

        subgraph "Assets"
            SCSS["all.scss"]:::infra
            BaseCSS["base.css"]:::infra
            CommonCSS["common.css"]:::infra
            ResetCSS["reset.css"]:::infra
            StyleCSS["style.css"]:::infra
            MainCSS["main.css"]:::infra
            Images["img/"]:::infra
        end

        SH -->|"Serves"| App
        SH --> Main
        App --> Router
        App --> Header
        App --> Footer
        App --> ErrorComp
        Router --> API
        Header --> IconComm
        Header --> IconDoc
        Header --> IconEco
        Header --> IconSup
        Header --> IconTool
        App --> UserStore
        App --> Counter
        App --> API
        App --> Func
        App --> SCSS
        App --> BaseCSS
        App --> CommonCSS
        App --> ResetCSS
        App --> StyleCSS
        App --> MainCSS
        App --> Images
    end

    Backend["Backend REST API"]:::infra
    API -->|"HTTP Request"| Backend
    Backend -->|"JSON Response"| API

    subgraph "CI/CD Pipeline"
        GHRepo["GitHub Repo"]:::infra
        Action["Actions Workflow"]:::infra
        Build["npm run build"]:::infra
        Deploy["Deploy to Static Host"]:::infra

        GHRepo --> Action
        Action --> Build
        Build --> Deploy
        Deploy --> SH
    end

    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef state fill:#90EE90,stroke:#333,stroke-width:1px
    classDef routing fill:#FFA500,stroke:#333,stroke-width:1px
    classDef infra fill:#D3D3D3,stroke:#333,stroke-width:1px

    click index "https://github.com/tripeasycompany/frontend/blob/dev/index.html"
    click public "https://github.com/tripeasycompany/frontend/tree/dev/public/"
    click staticcfg "https://github.com/tripeasycompany/frontend/blob/dev/static.json"
    click deploycfg "https://github.com/tripeasycompany/frontend/blob/dev/.github/workflows/gh-pages.yml"
    click App "https://github.com/tripeasycompany/frontend/blob/dev/src/App.vue"
    click Main "https://github.com/tripeasycompany/frontend/blob/dev/src/main.js"
    click Router "https://github.com/tripeasycompany/frontend/blob/dev/src/router/index.js"
    click Home "https://github.com/tripeasycompany/frontend/blob/dev/src/views/HomeView.vue"
    click About "https://github.com/tripeasycompany/frontend/blob/dev/src/views/AboutView.vue"
    click Search "https://github.com/tripeasycompany/frontend/blob/dev/src/views/front/searchPage.vue"
    click Login "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/loginPage.vue"
    click Register "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/registerPage.vue"
    click Forgot "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/forgotpwPage.vue"
    click Reset "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/resetpwPage.vue"
    click Member "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/memberPage.vue"
    click Personal "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/personalOrder.vue"
    click Profile "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/userprofilePage.vue"
    click Collect "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/collectPage.vue"
    click Dashboard "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/manage/dashboardPage.vue"
    click AutoSet "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/manage/automaticSetting.vue"
    click RoleSet "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/manage/roleSetting.vue"
    click ServiceSet "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/manage/serviceSetting.vue"
    click WebSet "https://github.com/tripeasycompany/frontend/blob/dev/src/views/admin/manage/websiteSetting.vue"
    click Header "https://github.com/tripeasycompany/frontend/blob/dev/src/components/HeaderComponent.vue"
    click Footer "https://github.com/tripeasycompany/frontend/blob/dev/src/components/FooterComponent.vue"
    click ErrorComp "https://github.com/tripeasycompany/frontend/blob/dev/src/components/ErrorComponent.vue"
    click IconComm "https://github.com/tripeasycompany/frontend/blob/dev/src/components/icons/IconCommunity.vue"
    click IconDoc "https://github.com/tripeasycompany/frontend/blob/dev/src/components/icons/IconDocumentation.vue"
    click IconEco "https://github.com/tripeasycompany/frontend/blob/dev/src/components/icons/IconEcosystem.vue"
    click IconSup "https://github.com/tripeasycompany/frontend/blob/dev/src/components/icons/IconSupport.vue"
    click IconTool "https://github.com/tripeasycompany/frontend/blob/dev/src/components/icons/IconTooling.vue"
    click UserStore "https://github.com/tripeasycompany/frontend/blob/dev/src/stores/userStore.js"
    click Counter "https://github.com/tripeasycompany/frontend/blob/dev/src/stores/counter.js"
    click API "https://github.com/tripeasycompany/frontend/blob/dev/src/utils/api.js"
    click Func "https://github.com/tripeasycompany/frontend/blob/dev/src/utils/function.js"
    click SCSS "https://github.com/tripeasycompany/frontend/blob/dev/src/assets/all.scss"
    click BaseCSS "https://github.com/tripeasycompany/frontend/blob/dev/src/assets/base.css"
    click CommonCSS "https://github.com/tripeasycompany/frontend/blob/dev/src/assets/css/common.css"
    click ResetCSS "https://github.com/tripeasycompany/frontend/blob/dev/src/assets/css/reset.css"
    click StyleCSS "https://github.com/tripeasycompany/frontend/blob/dev/src/assets/css/style.css"
    click MainCSS "https://github.com/tripeasycompany/frontend/blob/dev/src/assets/main.css"
    click Images "https://github.com/tripeasycompany/frontend/tree/dev/src/assets/img/"
    click GHRepo "https://github.com/tripeasycompany/frontend/blob/dev/package.json"
    click Action "https://github.com/tripeasycompany/frontend/blob/dev/.github/workflows/gh-pages.yml"
    click Build "https://github.com/tripeasycompany/frontend/blob/dev/vite.config.js"
```
