# edwardblanco/proyecto-agro architecture

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

- Interactive diagram: https://gitdiagram.com/edwardblanco/proyecto-agro
- Repository: https://github.com/edwardblanco/proyecto-agro

## Overview

SENAgro is presented as an agricultural-records demo frontend: users sign in, view a dashboard, and consult or manage farm records stored in browser localStorage. The tree also contains an Express/MongoDB API, although the README explicitly describes the frontend as standalone and says it has no API connection; these are therefore shown as separate systems. Frontend links beyond README-documented responsibilities are marked unverified or omitted because their call sites were not sampled.

Main entry points: [`backend/src/app.js`](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/app.js) (API application), [`frontend/src/features/records/pages/RecordsPage.vue`](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/pages/RecordsPage.vue) (Agricultural records), [`frontend/src/layouts/AppLayout.vue`](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/layouts/AppLayout.vue) (App navigation), [`backend/src/controllers/users.controller.js`](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/users.controller.js) (User controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_login["Demo login<br/>[LoginPage.vue]"]
  node_router["Routes and guards<br/>[index.js]"]
  node_layout["App navigation<br/>[AppLayout.vue]"]
  node_dashboard["Dashboard<br/>[DashboardPage.vue]"]
  node_records["Agricultural records<br/>[RecordsPage.vue]"]
  node_cycle["Cycle details"]
  node_record_config["Record configuration<br/>[config.js]"]
end

subgraph group_local["Local demo data"]
  node_auth_store["Session state<br/>[auth.js]"]
  node_farm_service["Farm operations<br/>[farms.service.js]"]
  node_user_service["User operations<br/>[users.service.js]"]
  node_storage[("Local persistence<br/>[storage.js]")]
  node_production["Production conversion<br/>[production.js]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_backend_app["API application<br/>[app.js]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.js]"]
  node_users_routes["User routes<br/>[users.routes.js]"]
  node_farms_routes["Farm routes<br/>[farms.routes.js]"]
  node_dashboard_routes["Dashboard routes"]
end

subgraph group_domain["API domain"]
  node_auth_controller["Authentication controller<br/>[auth.controller.js]"]
  node_users_controller["User controller"]
  node_farms_controller["Farm controller"]
  node_users_service["User service<br/>[users.service.js]"]
  node_farms_service["Farm service<br/>[farms.service.js]"]
  node_user_model[("User model<br/>[User.model.js]")]
  node_farm_model[("Farm model<br/>[Farm.model.js]")]
end

subgraph group_platform["API platform"]
  node_db_config["Database connection<br/>[db.js]"]
  node_seed["Demo seed data<br/>[seed.js]"]
  node_response["HTTP responses<br/>[response.js]"]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_user -->|"views summary"| node_dashboard
node_user -->|"manages records"| node_records
node_login -.->|"updates session"| node_auth_store
node_router -.->|"guards access"| node_login
node_router -.->|"routes through"| node_layout
node_layout -.->|"navigates to"| node_dashboard
node_layout -.->|"navigates to"| node_records
node_records -.->|"opens cycles"| node_cycle
node_records -.->|"uses fields"| node_record_config
node_records -.->|"uses operations"| node_farm_service
node_records -.->|"uses operations"| node_user_service
node_farm_service -.->|"persists locally"| node_storage
node_user_service -.->|"persists locally"| node_storage
node_auth_store -.->|"persists session"| node_storage
node_records -.->|"converts output"| node_production
node_backend_app -->|"mounts routes"| node_auth_routes
node_backend_app -->|"mounts routes"| node_users_routes
node_backend_app -->|"mounts routes"| node_farms_routes
node_backend_app -->|"mounts routes"| node_dashboard_routes
node_auth_routes -->|"dispatches to"| node_auth_controller
node_users_routes -->|"dispatches to"| node_users_controller
node_farms_routes -->|"dispatches to"| node_farms_controller
node_dashboard_routes -->|"mounted by"| node_backend_app
node_users_controller -->|"calls"| node_users_service
node_farms_controller -->|"calls"| node_farms_service
node_users_service -->|"uses model"| node_user_model
node_farms_service -->|"uses model"| node_farm_model
node_users_controller -->|"formats response"| node_response
node_farms_controller -->|"formats response"| node_response
node_backend_app -.->|"initializes"| node_db_config
node_backend_app -.->|"loads seed"| node_seed

click node_login "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/auth/pages/LoginPage.vue"
click node_router "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/router/index.js"
click node_layout "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/layouts/AppLayout.vue"
click node_dashboard "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/dashboard/pages/DashboardPage.vue"
click node_records "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/pages/RecordsPage.vue"
click node_cycle "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/pages/CycleDetailPage.vue"
click node_record_config "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/config.js"
click node_auth_store "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/stores/auth.js"
click node_farm_service "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/farms.service.js"
click node_user_service "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/users.service.js"
click node_storage "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/storage.js"
click node_production "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/production.js"
click node_backend_app "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/app.js"
click node_auth_routes "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/auth.routes.js"
click node_users_routes "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/users.routes.js"
click node_farms_routes "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/farms.routes.js"
click node_dashboard_routes "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/dashboard.routes.js"
click node_auth_controller "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/auth.controller.js"
click node_users_controller "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/users.controller.js"
click node_farms_controller "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/farms.controller.js"
click node_users_service "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/services/users.service.js"
click node_farms_service "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/services/farms.service.js"
click node_user_model "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/models/User.model.js"
click node_farm_model "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/models/Farm.model.js"
click node_db_config "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/config/db.js"
click node_seed "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/config/seed.js"
click node_response "https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/shared/http/response.js"
click node_api_client "https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/api.js"

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_login,node_router,node_layout,node_dashboard,node_records,node_cycle,node_record_config,node_user toneBlue
class node_auth_store,node_farm_service,node_user_service,node_storage,node_production,node_api_client toneAmber
class node_backend_app,node_auth_routes,node_users_routes,node_farms_routes,node_dashboard_routes toneMint
class node_auth_controller,node_users_controller,node_farms_controller,node_users_service,node_farms_service,node_user_model,node_farm_model toneRose
class node_db_config,node_seed,node_response toneIndigo
```

## Components

### Frontend experience

- [Demo login](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/auth/pages/LoginPage.vue): `frontend/src/features/auth/pages/LoginPage.vue`
- [Routes and guards](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/router/index.js): `frontend/src/router/index.js`
- [App navigation](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/layouts/AppLayout.vue): `frontend/src/layouts/AppLayout.vue`
- [Dashboard](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/dashboard/pages/DashboardPage.vue): `frontend/src/features/dashboard/pages/DashboardPage.vue`
- [Agricultural records](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/pages/RecordsPage.vue): `frontend/src/features/records/pages/RecordsPage.vue`
- [Cycle details](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/pages/CycleDetailPage.vue): `frontend/src/features/records/pages/CycleDetailPage.vue`
- [Record configuration](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/features/records/config.js): `frontend/src/features/records/config.js`

### Local demo data

- [Session state](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/stores/auth.js): `frontend/src/stores/auth.js`
- [Farm operations](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/farms.service.js): `frontend/src/services/farms.service.js`
- [User operations](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/users.service.js): `frontend/src/services/users.service.js`
- [Local persistence](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/storage.js): `frontend/src/services/storage.js`
- [Production conversion](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/production.js): `frontend/src/services/production.js`
- [API client](https://github.com/edwardblanco/proyecto-agro/blob/develop/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [API application](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/app.js): `backend/src/app.js`
- [Authentication routes](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [User routes](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/users.routes.js): `backend/src/routes/users.routes.js`
- [Farm routes](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/farms.routes.js): `backend/src/routes/farms.routes.js`
- [Dashboard routes](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/routes/dashboard.routes.js): `backend/src/routes/dashboard.routes.js`

### API domain

- [Authentication controller](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [User controller](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/users.controller.js): `backend/src/controllers/users.controller.js`
- [Farm controller](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/controllers/farms.controller.js): `backend/src/controllers/farms.controller.js`
- [User service](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/services/users.service.js): `backend/src/services/users.service.js`
- [Farm service](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/services/farms.service.js): `backend/src/services/farms.service.js`
- [User model](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/models/User.model.js): `backend/src/models/User.model.js`
- [Farm model](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/models/Farm.model.js): `backend/src/models/Farm.model.js`

### API platform

- [Database connection](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/config/db.js): `backend/src/config/db.js`
- [Demo seed data](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/config/seed.js): `backend/src/config/seed.js`
- [HTTP responses](https://github.com/edwardblanco/proyecto-agro/blob/develop/backend/src/shared/http/response.js): `backend/src/shared/http/response.js`

### Other components

- **User**

## Connections

- User → Demo login: signs in
- User → Dashboard: views summary
- User → Agricultural records: manages records
- Demo login → Session state: updates session
- Routes and guards → Demo login: guards access
- Routes and guards → App navigation: routes through
- App navigation → Dashboard: navigates to
- App navigation → Agricultural records: navigates to
- Agricultural records → Cycle details: opens cycles
- Agricultural records → Record configuration: uses fields
- Agricultural records → Farm operations: uses operations
- Agricultural records → User operations: uses operations
- Farm operations → Local persistence: persists locally
- User operations → Local persistence: persists locally
- Session state → Local persistence: persists session
- Agricultural records → Production conversion: converts output
- API application → Authentication routes: mounts routes (evidence: `backend/src/app.js`)
- API application → User routes: mounts routes (evidence: `backend/src/app.js`)
- API application → Farm routes: mounts routes (evidence: `backend/src/app.js`)
- API application → Dashboard routes: mounts routes (evidence: `backend/src/app.js`)
- Authentication routes → Authentication controller: dispatches to (evidence: `backend/src/routes/auth.routes.js`)
- User routes → User controller: dispatches to (evidence: `backend/src/routes/users.routes.js`)
- Farm routes → Farm controller: dispatches to (evidence: `backend/src/routes/farms.routes.js`)
- Dashboard routes → API application: mounted by (evidence: `backend/src/app.js`)
- User controller → User service: calls (evidence: `backend/src/controllers/users.controller.js`)
- Farm controller → Farm service: calls (evidence: `backend/src/controllers/farms.controller.js`)
- User service → User model: uses model (evidence: `backend/src/services/users.service.js`)
- Farm service → Farm model: uses model (evidence: `backend/src/services/farms.service.js`)
- User controller → HTTP responses: formats response (evidence: `backend/src/controllers/users.controller.js`)
- Farm controller → HTTP responses: formats response (evidence: `backend/src/controllers/farms.controller.js`)
- API application → Database connection: initializes
- API application → Demo seed data: loads seed
