# 42aditya31/d-mic architecture

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

- Interactive diagram: https://gitdiagram.com/42aditya31/d-mic
- Repository: https://github.com/42aditya31/d-mic

## Overview

##### Project Type and Purpose
- This is a full‐stack microblogging platform (“D_MIC”) built as a React single‐page application (SPA) on the frontend and a Strapi headless CMS on the backend.
- Purpose: engineers create, read, update, delete (CRUD) posts, comments, likes and manage profiles via JWT‐secured REST APIs.

##### Main Components
a. Frontend (React SPA)
- UI Components: PostCard, CommentSection, LikeButton, ProfileHeader, etc.
- Routing: PublicRoute, PrivateRoute for auth gating.
- State Management: Redux slices (postSlice, userSlice, saveSlice) or Context for auth and global state.
- HTTP Client: Axios/Fetch connecting to Strapi REST endpoints.
- Assets & Utilities: custom hooks (useFetchPosts, useTimeAgo), authUtils.

b. Backend (Strapi Headless CMS)
- API Layer: auto‐generated REST endpoints under `/posts`, `/comments`, `/likes`, `/users`.
- Content Types & Models: defined in `/src/api/{post,comment,like,global}/content-types/.../schema.json`.
- Controllers, Services & Routes: per‐entity logic in `/src/api/*/controllers`, `/services`, `/routes`.
- Admin Panel: Strapi client under `/.strapi/client/` and custom admin config in `/src/admin`.
- Configuration: `config/server.js`, `config/database.js`, `config/middlewares.js`, etc.
- Scripts & Seeds: `scripts/seed.js` for data population.

c. Database
- Development: SQLite (default), Production: PostgreSQL.
- Migration folders under `database/migrations`.
- Upload Storage: local files under `/public/uploads`.

d. External & Infrastructure
- JWT Auth: `/auth/local` endpoints, tokens in HTTP‐only cookies or localStorage.
- Hosting: Frontend on Vercel/Netlify; Backend on Heroku/Render/DigitalOcean.
- Environment Variables: `.env`, `REACT_APP_API_URL`, DB credentials, email config.

##### Component Interactions and Data Flow
1. User → React SPA (login/register UI)
2. React → Strapi Auth endpoint → returns JWT
3. React stores token → includes in Authorization header for protected calls
4. React → Strapi CRUD endpoints for Posts/Comments/Likes → Strapi Controller → Service → Database
5. Strapi → returns JSON response → React updates Redux store/UI
6. Strapi Admin UI used by moderators via browser

##### Architectural Patterns & Design Principles
- Layered Architecture: Presentation (React) → API Gateway (Strapi) → Business Logic (Controllers/Services) → Data Layer (DB).
- MVC‐like within Strapi (Models = Content Types, Views = JSON endpoints, Controllers/Services = business logic).
- Componentization on frontend: reusability, separation of concerns.
- RESTful API design, JWT‐based stateless auth.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External
    Browser["User Browser/Device"]:::external

    %% Frontend
    subgraph "React SPA" 
        direction TB
        Main["src/main.jsx\n(Entry Point)"]:::frontend
        UI[/"UI Components"/]:::frontend
        PostCard["PostCard"]:::frontend
        CommentSection["CommentSection"]:::frontend
        ProfileHeader["ProfileHeader"]:::frontend
        Routing[/"Routing"/]:::frontend
        PublicRoute["PublicRoute"]:::frontend
        PrivateRoute["PrivateRoute"]:::frontend
        State[/"State Management"/]:::frontend
        PostSlice["postSlice"]:::frontend
        UserSlice["userSlice"]:::frontend
        SaveSlice["saveSlice"]:::frontend
        HTTP[/"HTTP Client"/]:::frontend
        UseFetchPosts["useFetchPosts"]:::frontend
        UseFetchUser["useFetchLoggedUser"]:::frontend
        Utils[/"Utilities"/]:::frontend
        UseTimeAgo["useTimeAgo"]:::frontend
        AuthUtils["authUtils"]:::frontend
    end

    Browser -->|"loads"| Main
    Main --> UI
    UI --> PostCard
    UI --> CommentSection
    UI --> ProfileHeader
    Main --> Routing
    Routing --> PublicRoute
    Routing --> PrivateRoute
    Main --> State
    State --> PostSlice
    State --> UserSlice
    State --> SaveSlice
    Main --> HTTP
    HTTP --> UseFetchPosts
    HTTP --> UseFetchUser
    Main --> Utils
    Utils --> UseTimeAgo
    Utils --> AuthUtils

    %% Backend
    subgraph "Strapi CMS" 
        direction TB
        CT[/"Content Types"/]:::backend
        PostCT["Post Schema"]:::backend
        CommentCT["Comment Schema"]:::backend
        LikeCT["Like Schema"]:::backend
        GlobalCT["User Schema"]:::backend
        Controllers[/"Controllers"/]:::backend
        PostController["Post Controller"]:::backend
        CommentController["Comment Controller"]:::backend
        LikeController["Like Controller"]:::backend
        GlobalController["Global Controller"]:::backend
        Services[/"Services"/]:::backend
        PostService["Post Service"]:::backend
        CommentService["Comment Service"]:::backend
        LikeService["Like Service"]:::backend
        GlobalService["Global Service"]:::backend
        Routes[/"Routes"/]:::backend
        PostRoutes["Post Routes"]:::backend
        CommentRoutes["Comment Routes"]:::backend
        LikeRoutes["Like Routes"]:::backend
        Extensions["Strapi Extensions\n(users-permissions)"]:::backend
        AdminPanel[/"Admin Panel"/]:::backend
        AdminClient[".strapi/client/app.js"]:::backend
        AdminConfig["src/admin/app.example.js"]:::backend
        Config[/"Config"/]:::backend
        ServerConfig["server.js"]:::backend
        DBConfig["database.js"]:::backend
        Middlewares["middlewares.js"]:::backend
        Plugins["plugins.js"]:::backend
        Scripts["scripts/seed.js"]:::backend
    end

    Main -.->|"API Requests"| PostCT
    Main -.-> CommentCT
    Main -.-> LikeCT
    Main -.-> GlobalCT
    CT --> Controllers
    Controllers --> Services
    Services --> Routes
    CT --> Extensions
    CT --> AdminPanel
    AdminPanel --> AdminClient
    AdminPanel --> AdminConfig
    Config --> ServerConfig
    Config --> DBConfig
    Config --> Middlewares
    Config --> Plugins
    Scripts -->|"Seeds DB"| DB

    %% Database
    DB["Database<br/>SQLite/PostgreSQL<br/>Migrations & Uploads"]:::database

    Routes --> DB
    Extensions --> DB
    DB -->|"data"| Main

    %% Infrastructure
    subgraph "Hosting" 
        direction TB
        FrontendHost["Vercel/Netlify"]:::external
        BackendHost["Heroku/Render/DigitalOcean"]:::external
    end

    Main -->|"deployed on"| FrontendHost
    PostCT -->|"deployed on"| BackendHost

    %% Click Events
    click Main "https://github.com/42aditya31/d-mic/blob/main/src/main.jsx"
    click PostCard "https://github.com/42aditya31/d-mic/blob/main/src/Components/Post/PostCard.jsx"
    click CommentSection "https://github.com/42aditya31/d-mic/blob/main/src/Components/CommentLike/CommentSection.jsx"
    click ProfileHeader "https://github.com/42aditya31/d-mic/blob/main/src/Pages/Profile/ProfileCard.jsx"
    click PublicRoute "https://github.com/42aditya31/d-mic/blob/main/src/Components/Auth/PublicRoute.jsx"
    click PrivateRoute "https://github.com/42aditya31/d-mic/blob/main/src/Components/Auth/PrivateRoute.jsx"
    click PostSlice "https://github.com/42aditya31/d-mic/blob/main/src/store/postSlice.js"
    click UserSlice "https://github.com/42aditya31/d-mic/blob/main/src/store/userSlice.js"
    click SaveSlice "https://github.com/42aditya31/d-mic/blob/main/src/store/saveSlice.js"
    click UseFetchPosts "https://github.com/42aditya31/d-mic/blob/main/src/hooks/useFetchPosts.js"
    click UseFetchUser "https://github.com/42aditya31/d-mic/blob/main/src/hooks/useFetchLoggedUser.js"
    click UseTimeAgo "https://github.com/42aditya31/d-mic/blob/main/src/hooks/useTimeAgo.js"
    click AuthUtils "https://github.com/42aditya31/d-mic/blob/main/src/utils/authUtils.js"
    click PostCT "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/post/content-types/post/schema.json"
    click PostController "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/post/controllers/post.js"
    click PostService "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/post/services/post.js"
    click PostRoutes "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/post/routes/post.js"
    click CommentCT "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/comment/content-types/comment/schema.json"
    click CommentController "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/comment/controllers/comment.js"
    click CommentService "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/comment/services/comment.js"
    click CommentRoutes "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/comment/routes/comment.js"
    click LikeCT "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/like/content-types/like/schema.json"
    click LikeController "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/like/controllers/like.js"
    click LikeService "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/like/services/like.js"
    click LikeRoutes "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/like/routes/like.js"
    click GlobalCT "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/global/content-types/global/schema.json"
    click GlobalController "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/global/controllers/global.js"
    click GlobalService "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/api/global/services/global.js"
    click Extensions "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/extensions/users-permissions/content-types/user/schema.json"
    click ServerConfig "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/config/server.js"
    click DBConfig "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/config/database.js"
    click Middlewares "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/config/middlewares.js"
    click Plugins "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/config/plugins.js"
    click AdminClient "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/.strapi/client/app.js"
    click AdminConfig "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/src/admin/app.example.js"
    click Scripts "https://github.com/42aditya31/d-mic/blob/main/azoraBackend/scripts/seed.js"
    click DB "https://github.com/42aditya31/d-mic/tree/main/azoraBackend/database/migrations"
    click DB "https://github.com/42aditya31/d-mic/tree/main/azoraBackend/public/uploads"

    %% Styles
    classDef frontend fill:#E8F1FF,stroke:#2B6CB0,stroke-width:1px
    classDef backend fill:#E6FFFA,stroke:#2C7A7B,stroke-width:1px
    classDef database fill:#FEFCBF,stroke:#D69E2E,stroke-width:1px
    classDef external fill:#EDF2F7,stroke:#4A5568,stroke-width:1px
```
