create-genia-os 2.1.0 → 2.2.0

package/template/.genia/contexts/api-patterns.md

@@ -1,134 +1,134 @@
-# Contexto: API Patterns
-
-> Principios de design de API e tomada de decisao.
-
-## Mapa de Conteudo
-
-| Topico | Quando Usar |
-|--------|-------------|
-| REST vs GraphQL vs tRPC | Escolher tipo de API |
-| Resource naming, HTTP methods | Design REST |
-| Envelope pattern, error format | Estrutura de resposta |
-| Schema design | GraphQL |
-| Type safety | TS fullstack |
-
-## Arvore de Decisao: Escolher Tipo de API
-
-```
-Projeto → TypeScript monorepo?
-├── Sim → tRPC (type safety end-to-end)
-│
-└── Nao → Clientes diversos?
-    ├── Sim → REST (universal, cacheable)
-    │
-    └── Nao → Queries complexas?
-        ├── Sim → GraphQL (flexivel, self-documenting)
-        └── Nao → REST (simples, padrao da industria)
-```
-
-## REST Design
-
-### Naming de Recursos
-```
-GET    /users           # Lista
-GET    /users/{id}      # Detalhe
-POST   /users           # Criar
-PUT    /users/{id}      # Atualizar (completo)
-PATCH  /users/{id}      # Atualizar (parcial)
-DELETE /users/{id}      # Remover
-```
-
-### Status Codes
-| Code | Uso |
-|------|-----|
-| 200 | OK - Sucesso |
-| 201 | Created - Recurso criado |
-| 204 | No Content - Deletado |
-| 400 | Bad Request - Input invalido |
-| 401 | Unauthorized - Nao autenticado |
-| 403 | Forbidden - Sem permissao |
-| 404 | Not Found - Recurso nao existe |
-| 422 | Unprocessable - Validacao falhou |
-| 500 | Internal Error - Erro do servidor |
-
-## Formato de Resposta
-
-### Sucesso
-```json
-{
-  "data": { ... },
-  "meta": {
-    "pagination": { "page": 1, "total": 100 }
-  }
-}
-```
-
-### Erro
-```json
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Email invalido",
-    "details": [
-      { "field": "email", "message": "Formato invalido" }
-    ]
-  }
-}
-```
-
-## Paginacao
-
-### Offset-based
-```
-GET /users?page=2&limit=20
-```
-
-### Cursor-based (recomendado para grandes volumes)
-```
-GET /users?cursor=abc123&limit=20
-```
-
-## Versionamento
-
-| Metodo | Exemplo | Uso |
-|--------|---------|-----|
-| URI | `/v1/users` | Mais comum, facil |
-| Header | `Accept: application/vnd.api.v1+json` | Mais limpo |
-| Query | `/users?version=1` | Nao recomendado |
-
-## Autenticacao
-
-| Metodo | Quando Usar |
-|--------|-------------|
-| JWT | SPAs, mobile apps |
-| API Keys | Servicos, integracao |
-| OAuth 2.0 | Login social, terceiros |
-| Session | Apps tradicionais |
-
-## Rate Limiting
-
-### Headers de Resposta
-```
-X-RateLimit-Limit: 100
-X-RateLimit-Remaining: 95
-X-RateLimit-Reset: 1640995200
-```
-
-## Anti-Patterns
-
-| NAO Fazer | Fazer |
-|-----------|-------|
-| `/getUsers` | `GET /users` |
-| `/createUser` | `POST /users` |
-| Retornar 200 para erros | Usar status codes corretos |
-| Expor erros internos | Mensagens genericas |
-| Pular rate limiting | Sempre limitar |
-
-## Checklist
-
-- [ ] Escolhi estilo de API para o contexto?
-- [ ] Formato de resposta consistente?
-- [ ] Estrategia de versionamento?
-- [ ] Autenticacao definida?
-- [ ] Rate limiting planejado?
-- [ ] Documentacao (OpenAPI)?
+# Contexto: API Patterns
+
+> Principios de design de API e tomada de decisao.
+
+## Mapa de Conteudo
+
+| Topico | Quando Usar |
+|--------|-------------|
+| REST vs GraphQL vs tRPC | Escolher tipo de API |
+| Resource naming, HTTP methods | Design REST |
+| Envelope pattern, error format | Estrutura de resposta |
+| Schema design | GraphQL |
+| Type safety | TS fullstack |
+
+## Arvore de Decisao: Escolher Tipo de API
+
+```
+Projeto → TypeScript monorepo?
+├── Sim → tRPC (type safety end-to-end)
+│
+└── Nao → Clientes diversos?
+    ├── Sim → REST (universal, cacheable)
+    │
+    └── Nao → Queries complexas?
+        ├── Sim → GraphQL (flexivel, self-documenting)
+        └── Nao → REST (simples, padrao da industria)
+```
+
+## REST Design
+
+### Naming de Recursos
+```
+GET    /users           # Lista
+GET    /users/{id}      # Detalhe
+POST   /users           # Criar
+PUT    /users/{id}      # Atualizar (completo)
+PATCH  /users/{id}      # Atualizar (parcial)
+DELETE /users/{id}      # Remover
+```
+
+### Status Codes
+| Code | Uso |
+|------|-----|
+| 200 | OK - Sucesso |
+| 201 | Created - Recurso criado |
+| 204 | No Content - Deletado |
+| 400 | Bad Request - Input invalido |
+| 401 | Unauthorized - Nao autenticado |
+| 403 | Forbidden - Sem permissao |
+| 404 | Not Found - Recurso nao existe |
+| 422 | Unprocessable - Validacao falhou |
+| 500 | Internal Error - Erro do servidor |
+
+## Formato de Resposta
+
+### Sucesso
+```json
+{
+  "data": { ... },
+  "meta": {
+    "pagination": { "page": 1, "total": 100 }
+  }
+}
+```
+
+### Erro
+```json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Email invalido",
+    "details": [
+      { "field": "email", "message": "Formato invalido" }
+    ]
+  }
+}
+```
+
+## Paginacao
+
+### Offset-based
+```
+GET /users?page=2&limit=20
+```
+
+### Cursor-based (recomendado para grandes volumes)
+```
+GET /users?cursor=abc123&limit=20
+```
+
+## Versionamento
+
+| Metodo | Exemplo | Uso |
+|--------|---------|-----|
+| URI | `/v1/users` | Mais comum, facil |
+| Header | `Accept: application/vnd.api.v1+json` | Mais limpo |
+| Query | `/users?version=1` | Nao recomendado |
+
+## Autenticacao
+
+| Metodo | Quando Usar |
+|--------|-------------|
+| JWT | SPAs, mobile apps |
+| API Keys | Servicos, integracao |
+| OAuth 2.0 | Login social, terceiros |
+| Session | Apps tradicionais |
+
+## Rate Limiting
+
+### Headers de Resposta
+```
+X-RateLimit-Limit: 100
+X-RateLimit-Remaining: 95
+X-RateLimit-Reset: 1640995200
+```
+
+## Anti-Patterns
+
+| NAO Fazer | Fazer |
+|-----------|-------|
+| `/getUsers` | `GET /users` |
+| `/createUser` | `POST /users` |
+| Retornar 200 para erros | Usar status codes corretos |
+| Expor erros internos | Mensagens genericas |
+| Pular rate limiting | Sempre limitar |
+
+## Checklist
+
+- [ ] Escolhi estilo de API para o contexto?
+- [ ] Formato de resposta consistente?
+- [ ] Estrategia de versionamento?
+- [ ] Autenticacao definida?
+- [ ] Rate limiting planejado?
+- [ ] Documentacao (OpenAPI)?

package/template/.genia/contexts/nextjs-react.md

@@ -1,210 +1,210 @@
-# Contexto: Next.js & React
-
-> Patterns de performance e boas praticas para Next.js e React.
-
-## Eliminando Waterfalls
-
-### Problema: Requests Sequenciais
-```typescript
-// ERRADO - waterfall
-const user = await getUser(id);
-const posts = await getPosts(user.id);
-const comments = await getComments(posts);
-```
-
-### Solucao: Parallelizar
-```typescript
-// CORRETO - paralelo
-const [user, posts] = await Promise.all([
-  getUser(id),
-  getPosts(id)
-]);
-```
-
-## Bundle Size Optimization
-
-### Code Splitting
-```typescript
-// Dynamic imports
-const HeavyComponent = dynamic(() => import('./Heavy'), {
-  loading: () => <Skeleton />
-});
-```
-
-### Tree Shaking
-```typescript
-// ERRADO - importa tudo
-import _ from 'lodash';
-
-// CORRETO - importa so o necessario
-import debounce from 'lodash/debounce';
-```
-
-## Server-Side Performance
-
-### Streaming
-```typescript
-// app/page.tsx
-export default function Page() {
-  return (
-    <main>
-      <Header />
-      <Suspense fallback={<Loading />}>
-        <SlowComponent />
-      </Suspense>
-    </main>
-  );
-}
-```
-
-### Caching
-```typescript
-// Revalidate a cada hora
-export const revalidate = 3600;
-
-// Ou fetch com cache
-const data = await fetch(url, {
-  next: { revalidate: 3600 }
-});
-```
-
-## Client-Side Data Fetching
-
-### SWR ou React Query
-```typescript
-import useSWR from 'swr';
-
-function Profile() {
-  const { data, error, isLoading } = useSWR('/api/user', fetcher);
-
-  if (isLoading) return <Loading />;
-  if (error) return <Error />;
-  return <User data={data} />;
-}
-```
-
-## Re-render Optimization
-
-### useMemo para calculos pesados
-```typescript
-const expensiveValue = useMemo(() => {
-  return heavyCalculation(data);
-}, [data]);
-```
-
-### useCallback para funcoes
-```typescript
-const handleClick = useCallback(() => {
-  doSomething(id);
-}, [id]);
-```
-
-### React.memo para componentes
-```typescript
-const Card = React.memo(function Card({ user }) {
-  return <div>{user.name}</div>;
-});
-```
-
-## Rendering Performance
-
-### Keys corretas
-```typescript
-// ERRADO - index como key
-{items.map((item, i) => <Item key={i} />)}
-
-// CORRETO - id unico
-{items.map(item => <Item key={item.id} />)}
-```
-
-### Virtualizacao para listas longas
-```typescript
-import { FixedSizeList } from 'react-window';
-
-<FixedSizeList
-  height={400}
-  itemCount={1000}
-  itemSize={35}
->
-  {Row}
-</FixedSizeList>
-```
-
-## JavaScript Performance
-
-### Debounce inputs
-```typescript
-const debouncedSearch = useDebouncedCallback(
-  (value) => search(value),
-  300
-);
-```
-
-### Web Workers para calculos pesados
-```typescript
-const worker = new Worker('/worker.js');
-worker.postMessage(heavyData);
-worker.onmessage = (e) => setResult(e.data);
-```
-
-## Advanced Patterns
-
-### Server Components
-```typescript
-// Componente servidor (default no App Router)
-async function Posts() {
-  const posts = await db.posts.findMany(); // Direto no banco!
-  return <PostList posts={posts} />;
-}
-```
-
-### Server Actions
-```typescript
-async function submitForm(formData: FormData) {
-  'use server';
-  await db.users.create({ data: formData });
-}
-```
-
-### Parallel Routes
-```typescript
-// app/@dashboard/page.tsx
-// app/@sidebar/page.tsx
-// Carregam em paralelo
-```
-
-## Image Optimization
-
-```typescript
-import Image from 'next/image';
-
-<Image
-  src="/hero.jpg"
-  width={1200}
-  height={600}
-  placeholder="blur"
-  priority // Para imagens above-the-fold
-/>
-```
-
-## Font Optimization
-
-```typescript
-import { Inter } from 'next/font/google';
-
-const inter = Inter({
-  subsets: ['latin'],
-  display: 'swap',
-});
-```
-
-## Checklist de Performance
-
-- [ ] Requests em paralelo (Promise.all)?
-- [ ] Code splitting implementado?
-- [ ] Imagens otimizadas (next/image)?
-- [ ] Fontes otimizadas (next/font)?
-- [ ] Caching configurado?
-- [ ] Listas virtualizadas?
-- [ ] Memos apropriados?
-- [ ] Bundle analisado?
+# Contexto: Next.js & React
+
+> Patterns de performance e boas praticas para Next.js e React.
+
+## Eliminando Waterfalls
+
+### Problema: Requests Sequenciais
+```typescript
+// ERRADO - waterfall
+const user = await getUser(id);
+const posts = await getPosts(user.id);
+const comments = await getComments(posts);
+```
+
+### Solucao: Parallelizar
+```typescript
+// CORRETO - paralelo
+const [user, posts] = await Promise.all([
+  getUser(id),
+  getPosts(id)
+]);
+```
+
+## Bundle Size Optimization
+
+### Code Splitting
+```typescript
+// Dynamic imports
+const HeavyComponent = dynamic(() => import('./Heavy'), {
+  loading: () => <Skeleton />
+});
+```
+
+### Tree Shaking
+```typescript
+// ERRADO - importa tudo
+import _ from 'lodash';
+
+// CORRETO - importa so o necessario
+import debounce from 'lodash/debounce';
+```
+
+## Server-Side Performance
+
+### Streaming
+```typescript
+// app/page.tsx
+export default function Page() {
+  return (
+    <main>
+      <Header />
+      <Suspense fallback={<Loading />}>
+        <SlowComponent />
+      </Suspense>
+    </main>
+  );
+}
+```
+
+### Caching
+```typescript
+// Revalidate a cada hora
+export const revalidate = 3600;
+
+// Ou fetch com cache
+const data = await fetch(url, {
+  next: { revalidate: 3600 }
+});
+```
+
+## Client-Side Data Fetching
+
+### SWR ou React Query
+```typescript
+import useSWR from 'swr';
+
+function Profile() {
+  const { data, error, isLoading } = useSWR('/api/user', fetcher);
+
+  if (isLoading) return <Loading />;
+  if (error) return <Error />;
+  return <User data={data} />;
+}
+```
+
+## Re-render Optimization
+
+### useMemo para calculos pesados
+```typescript
+const expensiveValue = useMemo(() => {
+  return heavyCalculation(data);
+}, [data]);
+```
+
+### useCallback para funcoes
+```typescript
+const handleClick = useCallback(() => {
+  doSomething(id);
+}, [id]);
+```
+
+### React.memo para componentes
+```typescript
+const Card = React.memo(function Card({ user }) {
+  return <div>{user.name}</div>;
+});
+```
+
+## Rendering Performance
+
+### Keys corretas
+```typescript
+// ERRADO - index como key
+{items.map((item, i) => <Item key={i} />)}
+
+// CORRETO - id unico
+{items.map(item => <Item key={item.id} />)}
+```
+
+### Virtualizacao para listas longas
+```typescript
+import { FixedSizeList } from 'react-window';
+
+<FixedSizeList
+  height={400}
+  itemCount={1000}
+  itemSize={35}
+>
+  {Row}
+</FixedSizeList>
+```
+
+## JavaScript Performance
+
+### Debounce inputs
+```typescript
+const debouncedSearch = useDebouncedCallback(
+  (value) => search(value),
+  300
+);
+```
+
+### Web Workers para calculos pesados
+```typescript
+const worker = new Worker('/worker.js');
+worker.postMessage(heavyData);
+worker.onmessage = (e) => setResult(e.data);
+```
+
+## Advanced Patterns
+
+### Server Components
+```typescript
+// Componente servidor (default no App Router)
+async function Posts() {
+  const posts = await db.posts.findMany(); // Direto no banco!
+  return <PostList posts={posts} />;
+}
+```
+
+### Server Actions
+```typescript
+async function submitForm(formData: FormData) {
+  'use server';
+  await db.users.create({ data: formData });
+}
+```
+
+### Parallel Routes
+```typescript
+// app/@dashboard/page.tsx
+// app/@sidebar/page.tsx
+// Carregam em paralelo
+```
+
+## Image Optimization
+
+```typescript
+import Image from 'next/image';
+
+<Image
+  src="/hero.jpg"
+  width={1200}
+  height={600}
+  placeholder="blur"
+  priority // Para imagens above-the-fold
+/>
+```
+
+## Font Optimization
+
+```typescript
+import { Inter } from 'next/font/google';
+
+const inter = Inter({
+  subsets: ['latin'],
+  display: 'swap',
+});
+```
+
+## Checklist de Performance
+
+- [ ] Requests em paralelo (Promise.all)?
+- [ ] Code splitting implementado?
+- [ ] Imagens otimizadas (next/image)?
+- [ ] Fontes otimizadas (next/font)?
+- [ ] Caching configurado?
+- [ ] Listas virtualizadas?
+- [ ] Memos apropriados?
+- [ ] Bundle analisado?