Zan Visual Novel

Zan Visual Novel é uma plataforma de criação e consumo de visual novels interativas com IA generativa local. Criadores constroem histórias com escolhas, cenas, assets multimídia e árvores de decisão; jogadores experimentam narrativas dinâmicas onde LLMs locais (LFM ONNX) geram continuidade além das ramificações pré-definidas.

---

✨ Funcionalidades

🎮 Client (Jogador)

🛠️ Dashboard (Criador)

---

🏗️ Tech Stack

┌──────────────────────────────────────────────────┐
│  Monorepo (Turborepo)                             │
│                                                   │
│  ┌─────────────────┐  ┌───────────────────────┐  │
│  │ apps/client      │  │ apps/dashboard         │  │
│  │ React 19 + Vite  │  │ React 19 + Vite 6      │  │
│  │ Transformers.js  │  │ MUI v6                 │  │
│  │ LangChain.js     │  │ React Flow (árvore)    │  │
│  │ MUI v6           │  │ TipTap (editor)        │  │
│  └────────┬────────┘  └───────────┬───────────┘  │
│           │                       │               │
│  ┌────────┴───────────────────────┴───────────┐  │
│  │ packages/                                    │  │
│  │ shared (tipos, schemas)                     │  │
│  │ ui (componentes MUI)                        │  │
│  │ lib (hooks, utilitários)                    │  │
│  │ vn-engine (engine core TS puro)             │  │
│  └─────────────────────────────────────────────┘  │
│                                                   │
│  ┌──────────────────────────────────────────────┐ │
│  │ backend/api                                    │ │
│  │ Node.js + Express  |  PostgreSQL  |  Redis     │ │
│  │ JWT Auth  |  Stripe  |  S3 (Cloudflare R2)     │ │
│  └──────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────┘

🧠 Modelos LFM 2.5 (Inferência)

Inferência local: O modelo LFM2.5-350M-ONNX (Q4) roda diretamente no navegador via ONNX Runtime Web + WebGPU, com fallback para WASM/CPU. Os modelos maiores (>1GB) usam a API cloud do Liquid AI ou backend próprio com Transformers.js.

---

🚀 Começo Rápido

# Clone o repositório
git clone https://github.com/zan-ia/zan-visual-novel.git
cd zan-visual-novel

# Instale dependências
npm install

# Inicie todos os apps em dev
npm run dev

# Build para produção
npm run build

# Execute testes
npm run test

Pré-requisitos: Node.js 20+, npm 10+, PostgreSQL 16+, Redis 7+

---

📂 Estrutura do Projeto

zan-visual-novel/
├── apps/
│   ├── client/              # Vite + React 19 — Player de VN
│   │   ├── src/
│   │   │   ├── components/  # UI components (library, player, profile)
│   │   │   ├── hooks/       # Custom hooks (useVNEngine, useLLM)
│   │   │   ├── pages/       # Routes (Library, Player, Profile)
│   │   │   ├── stores/      # Zustand stores (auth, credits)
│   │   │   └── workers/     # Web Workers (ONNX inference)
│   │   └── public/
│   │       └── models/      # ONNX models (gitignored, baixados em runtime)
│   │
│   └── dashboard/           # Vite + React 19 — Creator Studio
│       ├── src/
│       │   ├── components/  # Editor components (scene, tree, assets)
│       │   ├── hooks/       # Custom hooks
│       │   ├── pages/       # Routes (Studio, Analytics, Settings)
│       │   └── stores/      # Zustand stores
│       └── public/
│
├── packages/
│   ├── shared/              # Tipos TypeScript, Schemas Zod, Constantes
│   ├── ui/                  # Componentes MUI reutilizáveis
│   ├── lib/                 # Hooks, utilitários, clientes API
│   └── vn-engine/           # Engine core (máquina de estados, parser)
│
├── backend/
│   └── api/                 # Node.js + Express + PostgreSQL
│       ├── src/
│       │   ├── routes/      # REST endpoints
│       │   ├── services/    # Lógica de negócio
│       │   ├── db/          # Drizzle ORM schemas + migrations
│       │   ├── middleware/   # Auth, rate limit, validation
│       │   └── workers/     # Background jobs
│       └── tests/
│
├── .github/                 # CI/CD, harness, agents, skills, instructions
├── docs/                    # Documentação detalhada
└── turbo.json               # Turborepo config

---

📚 Documentação

---

🔒 Privacidade

• Inferência local: Modelos LFM ONNX rodam no navegador do jogador — textos não saem do dispositivo
• Cloud fallback: Apenas quando necessário; dados enviados são efêmeros (não armazenados)
• Dados pessoais: Apenas email e perfil; senhas hasheadas com bcrypt
• Assets: Armazenados em S3/R2 com acesso controlado
• Sem rastreamento: Nenhum analytics de terceiros

📄 Licença

MIT © Zan IA

---

_{Built with ❤️ using React, Vite, Transformers.js, Liquid AI Foundation Models, and LangChain}