# juanchifranco/shop-amiduciel architecture

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

- Interactive diagram: https://gitdiagram.com/juanchifranco/shop-amiduciel
- Repository: https://github.com/juanchifranco/shop-amiduciel

## Overview

##### Project type and purpose
- This is a full-stack e-commerce web application (“Shop-Amiduciel”) with a headless CMS backend (Strapi-based) and a React-Vite/TailwindCSS frontend.
- The backend provides content types for categories, products, reviews, and user-permissions; the frontend is a single-page application that consumes the backend’s REST API.

##### File structure
Top-level directories:
- amiduciel-back – Strapi headless CMS
– config/      (server, database, middleware, plugins)
– src/api/     (content-types, controllers, services, routes for category, product, review)
– src/admin/   (admin UI entry points & Vite config examples)
– public/      (robots.txt, uploads folder)
– database/    (migrations)
– index.js     (server bootstrap)
– types/       (auto-generated TS definitions)
- amiduciel-front – React SPA
– public/      (static assets)
– src/         (JSX components, pages, layouts, assets)
– tailwind.config.js, vite.config.js, eslint.config.js

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Browser"]:::external
        SPA["Frontend SPA\n(React + Vite + Tailwind)"]:::frontend
        AdminUI["Admin UI\n(Strapi Admin)"]:::frontend
    end

    %% Application Layer - Strapi CMS
    subgraph "Strapi CMS" 
        direction TB
        Server["Strapi API Server\n(Node.js + Koa)"]:::backend
        subgraph "Config"
            ServerConfig["server.js"]:::backend
            DBConfig["database.js"]:::backend
            MWConfig["middlewares.js"]:::backend
            PluginConfig["plugins.js"]:::backend
            AdminConfig["admin.js"]:::backend
        end
        subgraph "APIs"
            direction TB
            CategoryModule["Category Module"]:::backend
            ProductModule["Product Module"]:::backend
            ReviewModule["Review Module"]:::backend
            UserPerms["Users-Permissions Extension"]:::backend
        end
        subgraph "Migrations & Types"
            Migrations["Migrations"]:::backend
            Types["Auto-generated Types"]:::backend
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        DB["SQL Database"]:::database
        FileStorage["File Storage\n(public/uploads)"]:::filestorage
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Email["Email Service"]:::external
        CloudStorage["Cloud Storage"]:::external
        OAuth["OAuth Provider"]:::external
    end

    %% Connections
    Browser -->|"HTTP GET"| SPA
    SPA -->|"REST API (GET/POST)"| Server
    AdminUI -->|"REST API (/admin)"| Server
    Server -->|"knex ORM\nCRUD Operations"| DB
    Server -->|"Write Files"| FileStorage
    Server -->|"SMTP"| Email
    Server -->|"S3 API"| CloudStorage
    Server -->|"OAuth"| OAuth

    %% Click Events - Frontend
    click SPA "https://github.com/juanchifranco/shop-amiduciel/tree/main/amiduciel-front/src/"
    click Browser "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-front/src/main.jsx"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-front/src/App.jsx"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/tree/main/amiduciel-front/src/pages/"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-front/src/layouts/MainLayout.jsx"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/tree/main/amiduciel-front/src/components/"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/tree/main/amiduciel-front/public/"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-front/vite.config.js"
    click SPA "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-front/tailwind.config.js"

    %% Click Events - Backend
    click Server "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/index.js"
    click ServerConfig "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/config/server.js"
    click DBConfig "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/config/database.js"
    click MWConfig "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/config/middlewares.js"
    click PluginConfig "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/config/plugins.js"
    click AdminConfig "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/config/admin.js"
    click CategoryModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/category/content-types/category/schema.json"
    click CategoryModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/category/controllers/category.js"
    click CategoryModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/category/services/category.js"
    click CategoryModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/category/routes/category.js"
    click ProductModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/product/content-types/product/schema.json"
    click ProductModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/product/controllers/product.js"
    click ProductModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/product/services/product.js"
    click ProductModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/product/routes/product.js"
    click ReviewModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/review/content-types/review/schema.json"
    click ReviewModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/review/controllers/review.js"
    click ReviewModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/review/services/review.js"
    click ReviewModule "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/api/review/routes/review.js"
    click UserPerms "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/extensions/users-permissions/content-types/user/schema.json"
    click Migrations "https://github.com/juanchifranco/shop-amiduciel/tree/main/amiduciel-back/database/migrations/"
    click Types "https://github.com/juanchifranco/shop-amiduciel/tree/main/amiduciel-back/types/generated/"
    click AdminUI "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/admin/app.example.js"
    click AdminUI "https://github.com/juanchifranco/shop-amiduciel/blob/main/amiduciel-back/src/admin/vite.config.example.js"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366D6,color:#0366D6,stroke-width:1px;
    classDef backend fill:#FFE5B4,stroke:#D35400,color:#D35400,stroke-width:1px;
    classDef database fill:#D5F5E3,stroke:#27AE60,color:#27AE60,stroke-width:1px,stroke-dasharray: 5 5;
    classDef filestorage fill:#F2F3F4,stroke:#7F8C8D,color:#7F8C8D,stroke-width:1px,stroke-dasharray: 5 5;
    classDef external fill:#F5EEF8,stroke:#8E44AD,color:#8E44AD,stroke-width:1px,stroke-dasharray: 2 2;
```
