# matiasolivera/feedy architecture

> Architecture diagram of the GitHub repository matiasolivera/feedy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/matiasolivera/feedy
- Repository: https://github.com/matiasolivera/feedy

## Overview

Feedly is a collaborative feedback platform: users browse products and, through the GraphQL API, can work with products, organizations, users, issues, and comments. The visible client workflow routes to the products view, dispatches product loading through Vuex, and renders product cards in a grid. On the server, Express mounts GraphQL with a Prisma database context; query and mutation modules expose the domain operations. The excerpts show server queries using Prisma and shared query helpers, but do not show how the client API reaches the server or how mutations invoke validators. Those links are omitted rather than inferred.

Main entry points: [`server/src/database/prisma-client/index.ts`](https://github.com/matiasolivera/feedy/blob/master/server/src/database/prisma-client/index.ts) (Prisma client), [`server/src/app.ts`](https://github.com/matiasolivera/feedy/blob/master/server/src/app.ts) (Express server), [`client/src/main.ts`](https://github.com/matiasolivera/feedy/blob/master/client/src/main.ts) (Vue app), [`client/src/views/ProductsView.vue`](https://github.com/matiasolivera/feedy/blob/master/client/src/views/ProductsView.vue) (Product view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_clientapp["Vue app<br/>[main.ts]"]
  node_header["Navigation header<br/>[TheHeader.vue]"]
  node_router["Route table<br/>[router.ts]"]
  node_productsview["Product view<br/>[ProductsView.vue]"]
  node_productstore["Product state<br/>[products.module.ts]"]
  node_store["Vuex store<br/>[index.ts]"]
  node_grid["Product grid<br/>[Grid.vue]"]
  node_card["Product card<br/>[ProductCard.vue]"]
  node_productapi["Products API<br/>[products.api.ts]"]
  node_request["HTTP request<br/>[request.ts]"]
end

subgraph group_api["GraphQL API"]
  node_server["Express server<br/>[app.ts]"]
  node_graphql["GraphQL schema<br/>[index.ts]"]
  node_cors["CORS middleware<br/>[index.ts]"]
  node_logger["Logger<br/>[log.service.ts]"]
end

subgraph group_domain["Feedback domain"]
  node_queries["Domain queries"]
  node_mutations["Domain mutations"]
  node_types["GraphQL types"]
  node_unions["Product owner union"]
  node_resolvertypes["Resolver contracts<br/>[resolvers.types.ts]"]
  node_models["Payload models<br/>[models.types.ts]"]
end

subgraph group_data["Data and validation"]
  node_validators["Input validators"]
  node_queryhelpers["Query helpers"]
  node_prisma["Prisma client<br/>[index.ts]"]
end

node_visitor(("Visitor"))
node_database[("MySQL database")]

node_visitor -->|"uses"| node_clientapp
node_clientapp -->|"installs"| node_router
node_clientapp -->|"installs"| node_store
node_clientapp -->|"renders"| node_header
node_header -->|"links routes"| node_router
node_router -->|"routes to"| node_productsview
node_productsview -->|"dispatches load"| node_store
node_store -->|"registers module"| node_productstore
node_productsview -->|"renders items"| node_grid
node_productsview -->|"renders product"| node_card
node_productapi -->|"uses request"| node_request
node_server -->|"creates schema"| node_graphql
node_server -->|"mounts middleware"| node_cors
node_server -->|"provides context"| node_prisma
node_server -->|"logs startup"| node_logger
node_graphql -->|"logs schema"| node_logger
node_queries -->|"queries data"| node_prisma
node_queries -->|"uses helpers"| node_queryhelpers
node_queries -->|"uses contracts"| node_resolvertypes
node_resolvertypes -->|"types data"| node_prisma
node_resolvertypes -->|"types payloads"| node_models
node_resolvertypes -.->|"types domain"| node_types
node_mutations -.->|"validates inputs"| node_validators
node_mutations -.->|"writes domain data"| node_prisma
node_prisma -.->|"persists data"| node_database

click node_clientapp "https://github.com/matiasolivera/feedy/blob/master/client/src/main.ts"
click node_header "https://github.com/matiasolivera/feedy/blob/master/client/src/components/TheHeader.vue"
click node_router "https://github.com/matiasolivera/feedy/blob/master/client/src/router.ts"
click node_productsview "https://github.com/matiasolivera/feedy/blob/master/client/src/views/ProductsView.vue"
click node_productstore "https://github.com/matiasolivera/feedy/blob/master/client/src/store/modules/products/products.module.ts"
click node_store "https://github.com/matiasolivera/feedy/blob/master/client/src/store/index.ts"
click node_grid "https://github.com/matiasolivera/feedy/blob/master/client/src/components/Grid.vue"
click node_card "https://github.com/matiasolivera/feedy/blob/master/client/src/components/products/ProductCard.vue"
click node_productapi "https://github.com/matiasolivera/feedy/blob/master/client/src/services/api/products.api.ts"
click node_request "https://github.com/matiasolivera/feedy/blob/master/client/src/services/api/request.ts"
click node_server "https://github.com/matiasolivera/feedy/blob/master/server/src/app.ts"
click node_graphql "https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/index.ts"
click node_queries "https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/queries"
click node_mutations "https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/mutations"
click node_types "https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/types"
click node_unions "https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/unions/product.owner/product.owner.union.ts"
click node_resolvertypes "https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/resolvers.types.ts"
click node_models "https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/models.types.ts"
click node_validators "https://github.com/matiasolivera/feedy/tree/master/server/src/app/validators"
click node_queryhelpers "https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/utils"
click node_prisma "https://github.com/matiasolivera/feedy/blob/master/server/src/database/prisma-client/index.ts"
click node_cors "https://github.com/matiasolivera/feedy/blob/master/server/src/middlewares/index.ts"
click node_logger "https://github.com/matiasolivera/feedy/blob/master/server/src/services/log.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_clientapp,node_header,node_router,node_productsview,node_productstore,node_store,node_grid,node_card,node_productapi,node_request toneBlue
class node_server,node_graphql,node_cors,node_logger,node_database toneAmber
class node_queries,node_mutations,node_types,node_unions,node_resolvertypes,node_models toneMint
class node_validators,node_queryhelpers,node_prisma toneRose
class node_visitor toneIndigo
```

## Components

### Web client

- [Vue app](https://github.com/matiasolivera/feedy/blob/master/client/src/main.ts): `client/src/main.ts`
- [Navigation header](https://github.com/matiasolivera/feedy/blob/master/client/src/components/TheHeader.vue): `client/src/components/TheHeader.vue`
- [Route table](https://github.com/matiasolivera/feedy/blob/master/client/src/router.ts): `client/src/router.ts`
- [Product view](https://github.com/matiasolivera/feedy/blob/master/client/src/views/ProductsView.vue): `client/src/views/ProductsView.vue`
- [Product state](https://github.com/matiasolivera/feedy/blob/master/client/src/store/modules/products/products.module.ts): `client/src/store/modules/products/products.module.ts`
- [Vuex store](https://github.com/matiasolivera/feedy/blob/master/client/src/store/index.ts): `client/src/store/index.ts`
- [Product grid](https://github.com/matiasolivera/feedy/blob/master/client/src/components/Grid.vue): `client/src/components/Grid.vue`
- [Product card](https://github.com/matiasolivera/feedy/blob/master/client/src/components/products/ProductCard.vue): `client/src/components/products/ProductCard.vue`
- [Products API](https://github.com/matiasolivera/feedy/blob/master/client/src/services/api/products.api.ts): `client/src/services/api/products.api.ts`
- [HTTP request](https://github.com/matiasolivera/feedy/blob/master/client/src/services/api/request.ts): `client/src/services/api/request.ts`

### GraphQL API

- [Express server](https://github.com/matiasolivera/feedy/blob/master/server/src/app.ts): `server/src/app.ts`
- [GraphQL schema](https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/index.ts): `server/src/graphql/index.ts`
- [CORS middleware](https://github.com/matiasolivera/feedy/blob/master/server/src/middlewares/index.ts): `server/src/middlewares/index.ts`
- [Logger](https://github.com/matiasolivera/feedy/blob/master/server/src/services/log.service.ts): `server/src/services/log.service.ts`

### Feedback domain

- [Domain queries](https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/queries): `server/src/graphql/queries`
- [Domain mutations](https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/mutations): `server/src/graphql/mutations`
- [GraphQL types](https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/types): `server/src/graphql/types`
- [Product owner union](https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/unions/product.owner/product.owner.union.ts): `server/src/graphql/unions/product.owner/product.owner.union.ts`
- [Resolver contracts](https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/resolvers.types.ts): `server/src/graphql/resolvers.types.ts`
- [Payload models](https://github.com/matiasolivera/feedy/blob/master/server/src/graphql/models.types.ts): `server/src/graphql/models.types.ts`

### Data and validation

- [Input validators](https://github.com/matiasolivera/feedy/tree/master/server/src/app/validators): `server/src/app/validators`
- [Query helpers](https://github.com/matiasolivera/feedy/tree/master/server/src/graphql/utils): `server/src/graphql/utils`
- [Prisma client](https://github.com/matiasolivera/feedy/blob/master/server/src/database/prisma-client/index.ts): `server/src/database/prisma-client/index.ts`

### Other components

- **Visitor**
- **MySQL database**

## Connections

- Visitor → Vue app: uses (evidence: `client/src/main.ts`)
- Vue app → Route table: installs (evidence: `client/src/main.ts`)
- Vue app → Vuex store: installs (evidence: `client/src/main.ts`)
- Vue app → Navigation header: renders
- Navigation header → Route table: links routes (evidence: `client/src/components/TheHeader.vue`)
- Route table → Product view: routes to (evidence: `client/src/router.ts`)
- Product view → Vuex store: dispatches load (evidence: `client/src/views/ProductsView.vue`)
- Vuex store → Product state: registers module (evidence: `client/src/store/index.ts`)
- Product view → Product grid: renders items (evidence: `client/src/views/ProductsView.vue`)
- Product view → Product card: renders product (evidence: `client/src/views/ProductsView.vue`)
- Products API → HTTP request: uses request (evidence: `client/src/services/api/products.api.ts`)
- Express server → GraphQL schema: creates schema (evidence: `server/src/app.ts`)
- Express server → CORS middleware: mounts middleware (evidence: `server/src/app.ts`)
- Express server → Prisma client: provides context (evidence: `server/src/app.ts`)
- Express server → Logger: logs startup (evidence: `server/src/app.ts`)
- GraphQL schema → Logger: logs schema (evidence: `server/src/graphql/index.ts`)
- Domain queries → Prisma client: queries data (evidence: `server/src/graphql/queries/issues/issues.queries.ts`)
- Domain queries → Query helpers: uses helpers (evidence: `server/src/graphql/queries/issues/issues.queries.ts`)
- Domain queries → Resolver contracts: uses contracts (evidence: `server/src/graphql/queries/issues/issues.queries.ts`)
- Resolver contracts → Prisma client: types data (evidence: `server/src/graphql/resolvers.types.ts`)
- Resolver contracts → Payload models: types payloads (evidence: `server/src/graphql/resolvers.types.ts`)
- Resolver contracts → GraphQL types: types domain
- Domain mutations → Input validators: validates inputs
- Domain mutations → Prisma client: writes domain data
- Prisma client → MySQL database: persists data
