create-fluxstack 1.0.13 → 1.0.14

package/Dockerfile

@@ -1,58 +0,0 @@
-# FluxStack Docker Image
-FROM oven/bun:1.1-alpine AS base
-
-# Set working directory
-WORKDIR /app
-
-# Copy package files
-COPY package.json bun.lockb* ./
-COPY bunfig.toml ./
-
-# Install dependencies
-RUN bun install --frozen-lockfile
-
-# Copy source code
-COPY . .
-
-# Build the application
-RUN bun run build
-
-# Production stage
-FROM oven/bun:1.1-alpine AS production
-
-WORKDIR /app
-
-# Install only production dependencies
-COPY package.json bun.lockb* ./
-COPY bunfig.toml ./
-RUN bun install --frozen-lockfile --production
-
-# Copy built application and source files needed for runtime
-COPY --from=base /app/dist ./dist
-COPY --from=base /app/core ./core
-COPY --from=base /app/config ./config
-COPY --from=base /app/app ./app
-COPY --from=base /app/tsconfig.json ./tsconfig.json
-COPY --from=base /app/bunfig.toml ./bunfig.toml
-
-# Create non-root user
-RUN addgroup -g 1001 -S fluxstack && \
-    adduser -S fluxstack -u 1001
-
-# Set permissions
-RUN chown -R fluxstack:fluxstack /app
-USER fluxstack
-
-# Environment variables
-ENV NODE_ENV=production
-ENV PORT=3000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD bun run -e "fetch('http://localhost:3000/api/health').then(r => r.ok ? process.exit(0) : process.exit(1))" || exit 1
-
-# Expose port
-EXPOSE 3000
-
-# Start the application
-CMD ["bun", "run", "start"]

package/Dockerfile.backend

@@ -1,52 +0,0 @@
-# FluxStack Backend-Only Docker Image
-FROM oven/bun:1.1-alpine AS base
-
-WORKDIR /app
-
-# Install dependencies
-COPY package.json bun.lockb* bunfig.toml ./
-RUN bun install --frozen-lockfile
-
-# Copy source code (only what backend needs)
-COPY core/ ./core/
-COPY app/server/ ./app/server/
-COPY app/shared/ ./app/shared/
-COPY config/ ./config/
-COPY tsconfig.json ./tsconfig.json
-
-# Production stage
-FROM oven/bun:1.1-alpine AS production
-
-WORKDIR /app
-
-# Install production dependencies
-COPY package.json bun.lockb* bunfig.toml ./
-RUN bun install --frozen-lockfile --production
-
-# Copy backend files and required config
-COPY --from=base /app/core ./core
-COPY --from=base /app/app/server ./app/server
-COPY --from=base /app/app/shared ./app/shared
-COPY --from=base /app/config ./config
-COPY --from=base /app/tsconfig.json ./tsconfig.json
-COPY --from=base /app/bunfig.toml ./bunfig.toml
-
-# Create non-root user
-RUN addgroup -g 1001 -S fluxstack && \
-    adduser -S fluxstack -u 1001
-RUN chown -R fluxstack:fluxstack /app
-USER fluxstack
-
-# Environment for backend-only
-ENV NODE_ENV=production
-ENV BACKEND_PORT=3001
-ENV FLUXSTACK_MODE=backend
-
-# Health check for backend API
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD bun run -e "fetch('http://localhost:3001/health').then(r => r.ok ? process.exit(0) : process.exit(1))" || exit 1
-
-EXPOSE 3001
-
-# Start backend only
-CMD ["bun", "run", "dev:backend"]

package/Dockerfile.frontend

@@ -1,54 +0,0 @@
-# FluxStack Frontend-Only Docker Image
-FROM oven/bun:1.1-alpine AS base
-
-WORKDIR /app
-
-# Install dependencies
-COPY package.json bun.lockb* bunfig.toml ./
-RUN bun install --frozen-lockfile
-
-# Copy frontend source
-COPY app/client/ ./app/client/
-COPY app/shared/ ./app/shared/
-COPY core/client/ ./core/client/
-COPY core/config/ ./core/config/
-COPY core/utils/ ./core/utils/
-
-# Build frontend for production
-COPY config/ ./config/
-RUN cd app/client && bun run build
-
-# Production stage with nginx for serving static files
-FROM nginx:alpine AS production
-
-# Copy built frontend
-COPY --from=base /app/app/client/dist /usr/share/nginx/html
-
-# Create nginx config for SPA routing
-RUN echo 'server {\
-    listen 80;\
-    server_name localhost;\
-    root /usr/share/nginx/html;\
-    index index.html;\
-\
-    location / {\
-        try_files $uri $uri/ /index.html;\
-    }\
-\
-    location /health {\
-        access_log off;\
-        return 200 "healthy\\n";\
-        add_header Content-Type text/plain;\
-    }\
-}' > /etc/nginx/conf.d/default.conf
-
-# Environment for frontend-only
-ENV API_URL=http://backend:3001
-
-EXPOSE 80
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD curl -f http://localhost/health || exit 1
-
-CMD ["nginx", "-g", "daemon off;"]

package/README-Docker.md

@@ -1,85 +0,0 @@
-# FluxStack Docker Deployment Options
-
-## 🚀 Quick Start (Recommended for Development)
-
-```bash
-# Simple microservices (no load balancer)
-docker-compose -f docker-compose.simple.yml up --build
-
-# Access:
-# Frontend: http://localhost:8080
-# API: http://localhost:3001
-# Database: localhost:5432
-```
-
-## 📋 Available Architectures
-
-### 1. **Monolithic** (All-in-one)
-```bash
-docker-compose up --build
-# Everything at: http://localhost:3000
-```
-
-### 2. **Simple Microservices** (Recommended)
-```bash
-docker-compose -f docker-compose.simple.yml up --build
-# Frontend: http://localhost:8080
-# API: http://localhost:3001
-```
-
-### 3. **Enterprise Microservices** (with Load Balancer)
-```bash
-docker-compose -f docker-compose.microservices.yml up --build
-# Unified access: http://localhost:3000
-# Load balancer routes /api/* to backend, /* to frontend
-```
-
-### 4. **Individual Services**
-```bash
-# Backend only
-docker build -f Dockerfile.backend -t fluxstack-backend .
-docker run -p 3001:3001 fluxstack-backend
-
-# Frontend only  
-docker build -f Dockerfile.frontend -t fluxstack-frontend .
-docker run -p 8080:80 fluxstack-frontend
-```
-
-## 🎯 When to Use Each
-
-| Architecture | Use Case | Pros | Cons |
-|-------------|----------|------|------|
-| **Monolithic** | Small projects, prototyping | Simple, fast development | Single point of failure |
-| **Simple Microservices** | Most development scenarios | Clean separation, direct access | Manual routing |
-| **Enterprise** | Production, complex routing | Unified access, SSL, scaling | More complexity |
-| **Individual** | Testing, CI/CD pipelines | Maximum flexibility | Manual orchestration |
-
-## 🔧 Adding Load Balancer Later
-
-If you start with simple microservices and want to add load balancing:
-
-1. Copy `nginx-lb.conf` and customize routing rules
-2. Add nginx service to your docker-compose:
-```yaml
-nginx-lb:
-  image: nginx:alpine
-  ports:
-    - "3000:80"
-  volumes:
-    - ./nginx-lb.conf:/etc/nginx/conf.d/default.conf
-```
-
-## 🌐 Network Access
-
-- **Development**: Use `docker-compose.simple.yml`
-- **External access**: Services bind to `0.0.0.0` by default
-- **CORS**: Configure your specific IPs in backend environment variables
-- **Custom IPs**: Add your network IP to CORS_ORIGINS for external access
-
-## 📊 Resource Usage
-
-| Mode | Containers | Memory | Startup Time |
-|------|-----------|---------|--------------|
-| Monolithic | 1 | ~200MB | ~10s |
-| Simple | 3 | ~400MB | ~15s |
-| Enterprise | 4 | ~500MB | ~20s |

package/ai-context/00-QUICK-START.md

@@ -1,86 +0,0 @@
-# ⚡ FluxStack - Quick Start para LLMs
-
-> **🎯 Objetivo**: Entender e usar FluxStack em < 2 minutos
-
-## 🚀 **Comandos Essenciais** (30 segundos)
-
-```bash
-# Desenvolvimento (escolha UM)
-bun run dev              # ✅ Full-stack (recomendado)
-bun run dev:clean        # ✅ Output limpo (sem logs HEAD do Elysia)
-
-# Build e Deploy
-bun run build           # Build completo
-bun run start           # Produção
-
-# URLs Importantes
-http://localhost:3000   # Backend API
-http://localhost:5173   # Frontend React
-http://localhost:3000/swagger  # Documentação API
-```
-
-## 📁 **Estrutura Crítica** (30 segundos)
-
-```
-FluxStack/
-├── core/                    # 🔒 FRAMEWORK - NUNCA EDITAR!
-├── app/                     # 👨‍💻 SEU CÓDIGO AQUI
-│   ├── server/              # Backend (controllers, routes)
-│   ├── client/              # Frontend (components, pages)
-│   └── shared/              # Types compartilhados
-└── ai-context/              # 📖 Esta documentação
-```
-
-## ⚡ **Regras de Ouro** (30 segundos)
-
-### ❌ NUNCA FAZER:
-- Editar `core/` (framework read-only)
-- Usar `apiCall()` wrapper (quebra type inference)
-- Criar types manuais para Eden Treaty
-
-### ✅ SEMPRE FAZER:
-- Trabalhar em `app/`
-- Usar Eden Treaty nativo: `const { data, error } = await api.users.get()`
-- Manter types em `app/shared/`
-
-## 🎯 **Navegação Rápida** (30 segundos)
-
-### Cenário 1: "Criar nova funcionalidade"
-→ [`development/patterns.md`](./development/patterns.md) + [`examples/crud-complete.md`](./examples/crud-complete.md)
-
-### Cenário 2: "Entender Eden Treaty"
-→ [`development/eden-treaty-guide.md`](./development/eden-treaty-guide.md) + [`recent-changes/eden-treaty-refactor.md`](./recent-changes/eden-treaty-refactor.md)
-
-### Cenário 3: "Corrigir erro"
-→ [`reference/troubleshooting.md`](./reference/troubleshooting.md)
-
-### Cenário 4: "Entender arquitetura"
-→ [`project/overview.md`](./project/overview.md) + [`project/architecture.md`](./project/architecture.md)
-
-### Cenário 5: "Ver mudanças recentes"
-→ [`recent-changes/`](./recent-changes/) (Eden Treaty, tipos, monorepo)
-
-## 🔥 **Estado Atual** (15 segundos)
-
-- **✅ Eden Treaty NATIVO**: Type inference automática funcionando
-- **✅ Monorepo estável**: Uma instalação, hot reload independente
-- **✅ Zero erros TypeScript**: Sistema 100% type-safe
-- **✅ Response schemas**: API com documentação automática
-
-## 📚 **Documentação Completa**
-
-```
-ai-context/
-├── 00-QUICK-START.md      # ⚡ Você está aqui
-├── project/               # 📊 Visão geral e arquitetura
-├── development/           # 👨‍💻 Padrões e guias
-├── reference/             # 📚 Referência técnica
-├── examples/              # 💡 Código prático
-└── recent-changes/        # 🔥 Mudanças importantes
-```
-
----
-
-**🎯 Em 2 minutos você já sabe**: comandos, estrutura, regras e onde encontrar cada informação!
-
-**🚀 Próximo passo**: Escolha um dos cenários acima e vá direto ao arquivo relevante!

package/ai-context/README.md

@@ -1,88 +0,0 @@
-# 🤖 AI Context - FluxStack Documentation
-
-> **Documentação especializada para LLMs trabalharem eficientemente com FluxStack**
-
-## 🎯 **Início Rápido**
-
-👉 **[00-QUICK-START.md](./00-QUICK-START.md)** - Entenda tudo em 2 minutos!
-
-## 📚 **Estrutura da Documentação**
-
-### ⚡ **[00-QUICK-START.md](./00-QUICK-START.md)**
-**Ponto de entrada ultra-rápido** - Comandos, estrutura, regras e navegação em 2 minutos
-
-### 📊 **[project/](./project/)**
-**Visão geral e arquitetura do projeto**
-- [`overview.md`](./project/overview.md) - Estado atual, stack, funcionalidades
-- [`architecture.md`](./project/architecture.md) - Como o framework funciona
-- [`changelog.md`](./project/changelog.md) - Mudanças importantes v1.4→v1.5
-
-### 👨‍💻 **[development/](./development/)**
-**Padrões e guias de desenvolvimento**
-- [`patterns.md`](./development/patterns.md) - Padrões fundamentais e boas práticas
-- [`api-creation.md`](./development/api-creation.md) - Como criar APIs step-by-step
-- [`frontend-patterns.md`](./development/frontend-patterns.md) - Padrões React específicos
-- [`eden-treaty-guide.md`](./development/eden-treaty-guide.md) - 🔥 Guia Eden Treaty completo
-
-### 📚 **[reference/](./reference/)**
-**Referência técnica completa**
-- [`api-reference.md`](./reference/api-reference.md) - APIs do framework
-- [`cli-commands.md`](./reference/cli-commands.md) - Todos os comandos disponíveis
-- [`environment-vars.md`](./reference/environment-vars.md) - Variáveis de ambiente
-- [`troubleshooting.md`](./reference/troubleshooting.md) - Solução de problemas
-
-### 💡 **[examples/](./examples/)**
-**Exemplos práticos e código real**
-- [`crud-complete.md`](./examples/crud-complete.md) - CRUD completo com Eden Treaty
-- [`plugin-creation.md`](./examples/plugin-creation.md) - Como criar plugins
-- [`testing-patterns.md`](./examples/testing-patterns.md) - Padrões de teste
-
-### 🔥 **[recent-changes/](./recent-changes/)**
-**Mudanças importantes e contexto recente**
-- [`eden-treaty-refactor.md`](./recent-changes/eden-treaty-refactor.md) - Refatoração completa
-- [`type-inference-fix.md`](./recent-changes/type-inference-fix.md) - Fix de inferência
-- [`monorepo-updates.md`](./recent-changes/monorepo-updates.md) - Atualizações estruturais
-
-## 🎯 **Cenários de Uso Comum**
-
-| Cenário | Documentos Recomendados |
-|---------|------------------------|
-| **🆕 Primeira vez** | [`00-QUICK-START.md`](./00-QUICK-START.md) → [`project/overview.md`](./project/overview.md) |
-| **🛠️ Criar funcionalidade** | [`development/patterns.md`](./development/patterns.md) + [`examples/crud-complete.md`](./examples/crud-complete.md) |
-| **🔧 Eden Treaty** | [`development/eden-treaty-guide.md`](./development/eden-treaty-guide.md) + [`recent-changes/eden-treaty-refactor.md`](./recent-changes/eden-treaty-refactor.md) |
-| **🐛 Debugar erro** | [`reference/troubleshooting.md`](./reference/troubleshooting.md) |
-| **🏗️ Arquitetura** | [`project/architecture.md`](./project/architecture.md) |
-| **📖 Referência** | [`reference/api-reference.md`](./reference/api-reference.md) |
-
-## 🚨 **Regras Críticas**
-
-### ❌ **NUNCA FAZER**
-- Editar arquivos em `core/` (framework read-only)
-- Usar `apiCall()` wrapper (quebra type inference)
-- Criar types manuais para Eden Treaty
-- Ignorar response schemas nas rotas
-
-### ✅ **SEMPRE FAZER**
-- Trabalhar em `app/` (código da aplicação)
-- Usar Eden Treaty nativo: `const { data, error } = await api.users.get()`
-- Manter types compartilhados em `app/shared/`
-- Testar com `bun run dev`
-
-## 📊 **Estado Atual (v1.5+)**
-
-- **✅ Eden Treaty Nativo**: Type inference automática
-- **✅ Zero Tipos Unknown**: Inferência funcionando perfeitamente
-- **✅ Monorepo Estável**: Hot reload independente
-- **✅ Response Schemas**: API documentada automaticamente
-- **✅ Type Safety**: End-to-end sem declarações manuais
-
-## 🆘 **Suporte Rápido**
-
-1. **Erro específico?** → [`reference/troubleshooting.md`](./reference/troubleshooting.md)
-2. **Como fazer X?** → [`development/patterns.md`](./development/patterns.md)
-3. **Eden Treaty?** → [`development/eden-treaty-guide.md`](./development/eden-treaty-guide.md)
-4. **Não entendo nada?** → [`00-QUICK-START.md`](./00-QUICK-START.md)
-
----
-
-**🎯 Objetivo**: Capacitar LLMs a trabalhar eficientemente com FluxStack, seguindo padrões estabelecidos e garantindo código de alta qualidade.