# jackywine/bella architecture

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

- Interactive diagram: https://gitdiagram.com/jackywine/bella
- Repository: https://github.com/jackywine/bella

## Overview

##### Project type and purpose
- From the file tree and README, this is an early-stage, static front-end prototype—a single‐page web application built with HTML, CSS and JavaScript. Its sole purpose today is to present a “Bella” video carousel and a simple “favorability” bar as a window into the longer-term AI‐native vision. There is no backend or AI pipeline code here yet—just the static shell and video assets.

##### File structure
- Top‐level files:
- index.html – main entry point
- style.css – UI styling
- script.js – carousel logic and interactivity
- package.json / package-lock.json – Node/NPM build dependencies (e.g., bundlers, linters)
- node_modules/ – installed packages
- 视频资源/ – all video assets displayed in the carousel
- .trae/ and various GUIDE/PRD Markdown files – project documentation or styling/config rules
- No “backend/” or “api/” directory, so this is purely client‐side.

##### README for additional insights
- The README lays out a three-phase AI‐native roadmap (Sensor-Bus-Processor, State-Context-Persona engine, Proactive Companion), but the current codebase only implements the video carousel UI. All advanced AI modules are still conceptual.

##### Detail without overthinking
- Even though this project is small, break it down:
- Source code vs. bundled code
- Static hosting vs. local development server
- Asset folder separation
- Elements faithfully rather than inventing missing backend layers.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Browser Side"
        Index["index.html"]:::client
        CSS["style.css"]:::client
        JS["script.js"]:::client
    end

    subgraph "NPM Build Process"
        PKG["package.json"]:::build
        PKGLock["package-lock.json"]:::build
        NodeMod["node_modules/"]:::build
    end

    subgraph "Static File Server / CDN"
        SIndex["index.html"]:::deploy
        SCSS["style.css"]:::deploy
        SJS["script.js"]:::deploy
        AssetsFolder["视频资源/"]:::asset
    end

    PKG -->|defines deps| NodeMod
    PKG -->|configures build| SIndex
    PKG -->|configures build| SCSS
    PKG -->|configures build| SJS
    NodeMod -->|outputs bundle to| SIndex
    NodeMod -->|outputs bundle to| SCSS
    NodeMod -->|outputs bundle to| SJS

    Index -->|requests| SIndex
    CSS -->|requests| SCSS
    JS -->|requests| SJS
    JS -->|loads videos| AssetsFolder

    click Index "https://github.com/jackywine/bella/blob/main/index.html"
    click CSS "https://github.com/jackywine/bella/blob/main/style.css"
    click JS "https://github.com/jackywine/bella/blob/main/script.js"
    click SIndex "https://github.com/jackywine/bella/blob/main/index.html"
    click SCSS "https://github.com/jackywine/bella/blob/main/style.css"
    click SJS "https://github.com/jackywine/bella/blob/main/script.js"
    click AssetsFolder "https://github.com/jackywine/bella/tree/main/视频资源/"
    click PKG "https://github.com/jackywine/bella/blob/main/package.json"
    click PKGLock "https://github.com/jackywine/bella/blob/main/package-lock.json"
    click NodeMod "https://github.com/jackywine/bella/tree/main/node_modules/"

    classDef client fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef build fill:#E8FFE8,stroke:#028A0F,color:#028A0F
    classDef deploy fill:#E0F7FA,stroke:#006064,color:#006064
    classDef asset fill:#FFF4E5,stroke:#E65100,color:#E65100
```
