📚 Documentação inicial do ALETHEIA
- MANUAL-PRODUTO.md: Manual do usuário final - MANUAL-VENDAS.md: Estratégia comercial e vendas - MANUAL-TECNICO.md: Infraestrutura e deploy - README.md: Visão geral do projeto
This commit is contained in:
1178
docs/ARQUITETURA-TECNICA.md
Normal file
1178
docs/ARQUITETURA-TECNICA.md
Normal file
File diff suppressed because it is too large
Load Diff
167
docs/MANUAL-PRODUTO.md
Normal file
167
docs/MANUAL-PRODUTO.md
Normal file
@@ -0,0 +1,167 @@
|
||||
# ALETHEIA - Manual do Produto
|
||||
|
||||
## 📱 O que é o ALETHEIA?
|
||||
|
||||
O **ALETHEIA** é um aplicativo inteligente que analisa rótulos de alimentos usando Inteligência Artificial. Com ele, você pode escanear o código de barras de qualquer produto alimentício e receber instantaneamente uma análise completa sobre sua qualidade nutricional.
|
||||
|
||||
O nome vem do grego **ἀλήθεια** (alétheia), que significa "verdade" — porque nosso objetivo é revelar a verdade sobre o que você está comendo.
|
||||
|
||||
### Por que usar o ALETHEIA?
|
||||
|
||||
- 🔍 **Transparência**: Entenda exatamente o que está nos alimentos que você consome
|
||||
- 🧠 **IA Avançada**: Análise inteligente de ingredientes, aditivos e valores nutricionais
|
||||
- 🇧🇷 **Feito para brasileiros**: Interface e análises em português, considerando a realidade do mercado nacional
|
||||
- 🍳 **Receitas saudáveis**: Sugestões de como substituir ou preparar alternativas mais saudáveis
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Como Usar
|
||||
|
||||
### 1. Escanear Código de Barras
|
||||
A forma mais rápida de analisar um produto:
|
||||
|
||||
1. Abra o ALETHEIA no seu celular
|
||||
2. Toque no botão **"Escanear"**
|
||||
3. Aponte a câmera para o código de barras do produto
|
||||
4. Aguarde a análise automática
|
||||
|
||||
### 2. Busca Manual
|
||||
Se o código de barras não funcionar:
|
||||
|
||||
1. Toque em **"Buscar Manual"**
|
||||
2. Digite o nome do produto ou o código de barras (números)
|
||||
3. Selecione o produto na lista de resultados
|
||||
|
||||
### 3. Modo Demo
|
||||
Quer conhecer o app antes de usar?
|
||||
|
||||
1. Toque em **"Experimentar Demo"**
|
||||
2. Veja exemplos de análises com produtos reais
|
||||
3. Explore todas as funcionalidades sem precisar de login
|
||||
|
||||
---
|
||||
|
||||
## 📊 Entendendo o Score de Saúde
|
||||
|
||||
O ALETHEIA atribui uma pontuação de **0 a 100** para cada produto, baseada em múltiplos fatores analisados pela nossa IA:
|
||||
|
||||
| Score | Classificação | Significado |
|
||||
|-------|---------------|-------------|
|
||||
| **90-100** | 🟢 Excelente | Produto muito saudável, pode consumir livremente |
|
||||
| **70-89** | 🟢 Bom | Produto saudável, boa escolha para o dia a dia |
|
||||
| **50-69** | 🟡 Regular | Produto aceitável, consuma com moderação |
|
||||
| **30-49** | 🟠 Ruim | Produto pouco saudável, evite consumo frequente |
|
||||
| **0-29** | 🔴 Péssimo | Produto muito prejudicial à saúde, evite |
|
||||
|
||||
### O que influencia o Score?
|
||||
|
||||
**Fatores positivos** (aumentam o score):
|
||||
- Alto teor de fibras
|
||||
- Presença de vitaminas e minerais
|
||||
- Ingredientes naturais
|
||||
- Baixo sódio
|
||||
- Proteínas de qualidade
|
||||
|
||||
**Fatores negativos** (diminuem o score):
|
||||
- Excesso de açúcar
|
||||
- Excesso de sódio
|
||||
- Gorduras trans ou saturadas em excesso
|
||||
- Aditivos artificiais (corantes, conservantes)
|
||||
- Ultraprocessamento
|
||||
|
||||
---
|
||||
|
||||
## 🥗 Informações Nutricionais
|
||||
|
||||
Cada análise inclui uma explicação detalhada dos valores nutricionais:
|
||||
|
||||
### Macronutrientes
|
||||
- **Carboidratos**: Fonte de energia. Atenção aos açúcares adicionados.
|
||||
- **Proteínas**: Essenciais para músculos e tecidos.
|
||||
- **Gorduras**: Importantes, mas prefira as insaturadas (boas) às saturadas.
|
||||
|
||||
### Micronutrientes
|
||||
- **Sódio**: Excesso causa hipertensão. Limite: 2.000mg/dia.
|
||||
- **Fibras**: Ajudam na digestão. Meta: 25-30g/dia.
|
||||
- **Vitaminas e Minerais**: Essenciais para o funcionamento do corpo.
|
||||
|
||||
### Aditivos Alimentares
|
||||
A IA identifica e explica cada aditivo:
|
||||
- 🟢 **Inofensivos**: Corantes naturais, vitaminas adicionadas
|
||||
- 🟡 **Atenção**: Alguns conservantes, aromatizantes
|
||||
- 🔴 **Evitar**: Gordura trans, excesso de glutamato monossódico
|
||||
|
||||
---
|
||||
|
||||
## 🍳 Receitas Saudáveis
|
||||
|
||||
Quando você escaneia um produto com score baixo, o ALETHEIA sugere **alternativas saudáveis** e **receitas caseiras** para substituí-lo.
|
||||
|
||||
### Exemplos:
|
||||
- Escaneou um **refrigerante**? → Receba receita de água saborizada natural
|
||||
- Escaneou um **biscoito recheado**? → Receba receita de cookies integrais caseiros
|
||||
- Escaneou um **macarrão instantâneo**? → Receba receita de macarrão com molho rápido e saudável
|
||||
|
||||
As receitas são geradas pela IA considerando:
|
||||
- Ingredientes fáceis de encontrar
|
||||
- Tempo de preparo realista
|
||||
- Sabor semelhante ao produto original
|
||||
- Valor nutricional muito superior
|
||||
|
||||
---
|
||||
|
||||
## 💎 Planos
|
||||
|
||||
### Plano Gratuito
|
||||
- ✅ 3 scans por dia
|
||||
- ✅ Score de saúde completo
|
||||
- ✅ Análise de ingredientes
|
||||
- ✅ Informações nutricionais
|
||||
- ✅ Histórico limitado (últimos 7 dias)
|
||||
|
||||
### Plano Premium
|
||||
- ✅ **Scans ilimitados**
|
||||
- ✅ Histórico completo permanente
|
||||
- ✅ Receitas saudáveis personalizadas
|
||||
- ✅ Comparação entre produtos
|
||||
- ✅ Exportar relatórios
|
||||
- ✅ Suporte prioritário
|
||||
- ✅ Sem anúncios
|
||||
|
||||
---
|
||||
|
||||
## ❓ Perguntas Frequentes (FAQ)
|
||||
|
||||
### O app funciona offline?
|
||||
Não. O ALETHEIA precisa de conexão com a internet para consultar nossa base de dados e processar as análises com IA.
|
||||
|
||||
### O app funciona com todos os produtos?
|
||||
O ALETHEIA tem acesso a uma base com mais de **3 milhões de produtos**. Se um produto não for encontrado, você pode adicioná-lo manualmente.
|
||||
|
||||
### O score é confiável?
|
||||
Sim! Nosso algoritmo de IA foi treinado com dados nutricionais validados e segue as diretrizes da OMS e do Guia Alimentar para a População Brasileira.
|
||||
|
||||
### Posso usar no computador?
|
||||
Sim! Acesse **aletheia.aivertice.com** pelo navegador. O app é uma PWA (Progressive Web App) e funciona em qualquer dispositivo.
|
||||
|
||||
### Como cancelo o Premium?
|
||||
Você pode cancelar a qualquer momento nas configurações do app. O acesso Premium continua até o fim do período pago.
|
||||
|
||||
### Meus dados estão seguros?
|
||||
Sim. Utilizamos criptografia SSL e não compartilhamos seus dados pessoais com terceiros. Sua privacidade é prioridade.
|
||||
|
||||
### O app substitui um nutricionista?
|
||||
Não. O ALETHEIA é uma ferramenta de informação e conscientização. Para orientações personalizadas de saúde, consulte sempre um profissional.
|
||||
|
||||
---
|
||||
|
||||
## 📞 Suporte
|
||||
|
||||
Dúvidas, sugestões ou problemas?
|
||||
|
||||
- **Email**: suporte@aivertice.com
|
||||
- **Site**: aletheia.aivertice.com
|
||||
|
||||
---
|
||||
|
||||
*ALETHEIA — A verdade sobre o que você come* 🥬
|
||||
679
docs/MANUAL-TECNICO.md
Normal file
679
docs/MANUAL-TECNICO.md
Normal file
@@ -0,0 +1,679 @@
|
||||
# ALETHEIA - Manual Técnico
|
||||
|
||||
## 📐 Arquitetura Geral
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ CLIENTE │
|
||||
│ ┌─────────────────────────────────────────────────────────┐ │
|
||||
│ │ Next.js (PWA) - Porta 3080 │ │
|
||||
│ │ aletheia.aivertice.com (Cloudflare) │ │
|
||||
│ └─────────────────────────────────────────────────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
│ HTTPS
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ NGINX (Reverse Proxy) │
|
||||
│ SSL/TLS Termination │
|
||||
│ / → :3080 (Frontend) │
|
||||
│ /api → :8090 (Backend) │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
┌───────────────┴───────────────┐
|
||||
▼ ▼
|
||||
┌─────────────────────────┐ ┌─────────────────────────┐
|
||||
│ Next.js Frontend │ │ FastAPI Backend │
|
||||
│ Porta 3080 │ │ Porta 8090 │
|
||||
│ /opt/aletheia/frontend│ │ /opt/aletheia/backend │
|
||||
└─────────────────────────┘ └─────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────┼─────────────────────────┐
|
||||
▼ ▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||||
│ PostgreSQL │ │ Open Food Facts │ │ OpenAI API │
|
||||
│ aletheia DB │ │ API │ │ GPT-4o-mini │
|
||||
│ Porta 5432 │ │ (3M+ prods) │ │ │
|
||||
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
||||
```
|
||||
|
||||
### Stack Tecnológico
|
||||
|
||||
| Camada | Tecnologia | Versão |
|
||||
|--------|------------|--------|
|
||||
| Frontend | Next.js (React) | 14.x |
|
||||
| Backend | FastAPI (Python) | 0.100+ |
|
||||
| Banco de Dados | PostgreSQL | 15+ |
|
||||
| IA | OpenAI GPT-4o-mini | - |
|
||||
| Process Manager | PM2 | 5.x |
|
||||
| Proxy/SSL | Nginx | 1.24+ |
|
||||
| CDN/DNS | Cloudflare | - |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Deploy e Infraestrutura
|
||||
|
||||
### Estrutura de Diretórios
|
||||
|
||||
```
|
||||
/opt/aletheia/
|
||||
├── backend/
|
||||
│ ├── main.py
|
||||
│ ├── requirements.txt
|
||||
│ ├── .env
|
||||
│ └── ...
|
||||
├── frontend/
|
||||
│ ├── package.json
|
||||
│ ├── .env.local
|
||||
│ ├── public/
|
||||
│ │ └── sw.js (Service Worker)
|
||||
│ └── ...
|
||||
└── docs/
|
||||
```
|
||||
|
||||
### PM2 - Gerenciamento de Processos
|
||||
|
||||
**Processos ativos:**
|
||||
- `aletheia-backend` - FastAPI (porta 8090)
|
||||
- `aletheia-frontend` - Next.js (porta 3080)
|
||||
|
||||
**Comandos úteis:**
|
||||
|
||||
```bash
|
||||
# Status dos processos
|
||||
pm2 status
|
||||
|
||||
# Logs em tempo real
|
||||
pm2 logs aletheia-backend
|
||||
pm2 logs aletheia-frontend
|
||||
|
||||
# Reiniciar processos
|
||||
pm2 restart aletheia-backend
|
||||
pm2 restart aletheia-frontend
|
||||
|
||||
# Reiniciar tudo
|
||||
pm2 restart all
|
||||
|
||||
# Salvar configuração
|
||||
pm2 save
|
||||
```
|
||||
|
||||
### Nginx - Configuração
|
||||
|
||||
Arquivo: `/etc/nginx/sites-available/aletheia`
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 443 ssl http2;
|
||||
server_name aletheia.aivertice.com;
|
||||
|
||||
ssl_certificate /etc/letsencrypt/live/aletheia.aivertice.com/fullchain.pem;
|
||||
ssl_certificate_key /etc/letsencrypt/live/aletheia.aivertice.com/privkey.pem;
|
||||
|
||||
# Frontend
|
||||
location / {
|
||||
proxy_pass http://127.0.0.1:3080;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
proxy_set_header Host $host;
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
}
|
||||
|
||||
# Backend API
|
||||
location /api {
|
||||
proxy_pass http://127.0.0.1:8090;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
}
|
||||
|
||||
server {
|
||||
listen 80;
|
||||
server_name aletheia.aivertice.com;
|
||||
return 301 https://$server_name$request_uri;
|
||||
}
|
||||
```
|
||||
|
||||
### SSL/TLS
|
||||
|
||||
- **Provedor**: Let's Encrypt (Certbot)
|
||||
- **Renovação**: Automática via cron
|
||||
- **CDN**: Cloudflare (SSL Full Strict)
|
||||
|
||||
```bash
|
||||
# Renovar certificado manualmente
|
||||
sudo certbot renew
|
||||
|
||||
# Verificar certificado
|
||||
sudo certbot certificates
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🗄️ Banco de Dados
|
||||
|
||||
### Conexão
|
||||
|
||||
```
|
||||
Host: localhost
|
||||
Porta: 5432
|
||||
Database: aletheia
|
||||
User: aletheia
|
||||
Password: Aletheia2026!
|
||||
```
|
||||
|
||||
**Connection String:**
|
||||
```
|
||||
postgresql://aletheia:Aletheia2026!@localhost:5432/aletheia
|
||||
```
|
||||
|
||||
### Tabelas Principais
|
||||
|
||||
#### users
|
||||
```sql
|
||||
CREATE TABLE users (
|
||||
id SERIAL PRIMARY KEY,
|
||||
email VARCHAR(255) UNIQUE NOT NULL,
|
||||
password_hash VARCHAR(255) NOT NULL,
|
||||
name VARCHAR(255),
|
||||
plan VARCHAR(50) DEFAULT 'free', -- 'free' ou 'premium'
|
||||
scans_today INTEGER DEFAULT 0,
|
||||
last_scan_date DATE,
|
||||
created_at TIMESTAMP DEFAULT NOW(),
|
||||
updated_at TIMESTAMP DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
#### products
|
||||
```sql
|
||||
CREATE TABLE products (
|
||||
id SERIAL PRIMARY KEY,
|
||||
barcode VARCHAR(50) UNIQUE NOT NULL,
|
||||
name VARCHAR(255),
|
||||
brand VARCHAR(255),
|
||||
categories TEXT,
|
||||
ingredients TEXT,
|
||||
nutrition_data JSONB,
|
||||
image_url TEXT,
|
||||
source VARCHAR(50), -- 'openfoodfacts', 'manual'
|
||||
created_at TIMESTAMP DEFAULT NOW(),
|
||||
updated_at TIMESTAMP DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
#### scans
|
||||
```sql
|
||||
CREATE TABLE scans (
|
||||
id SERIAL PRIMARY KEY,
|
||||
user_id INTEGER REFERENCES users(id),
|
||||
product_id INTEGER REFERENCES products(id),
|
||||
barcode VARCHAR(50),
|
||||
score INTEGER, -- 0-100
|
||||
analysis JSONB, -- Análise completa da IA
|
||||
recipe TEXT, -- Receita sugerida
|
||||
scanned_at TIMESTAMP DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
### Comandos Úteis
|
||||
|
||||
```bash
|
||||
# Conectar ao banco
|
||||
psql -U aletheia -d aletheia -h localhost
|
||||
|
||||
# Backup
|
||||
pg_dump -U aletheia -d aletheia > backup_$(date +%Y%m%d).sql
|
||||
|
||||
# Restore
|
||||
psql -U aletheia -d aletheia < backup_20260210.sql
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔌 APIs e Endpoints
|
||||
|
||||
### Autenticação
|
||||
|
||||
#### POST /api/auth/register
|
||||
Registra novo usuário.
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"email": "usuario@email.com",
|
||||
"password": "senha123",
|
||||
"name": "Nome do Usuário"
|
||||
}
|
||||
```
|
||||
|
||||
**Response (201):**
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"email": "usuario@email.com",
|
||||
"name": "Nome do Usuário",
|
||||
"plan": "free",
|
||||
"token": "eyJhbGciOiJIUzI1NiIs..."
|
||||
}
|
||||
```
|
||||
|
||||
#### POST /api/auth/login
|
||||
Autentica usuário existente.
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"email": "usuario@email.com",
|
||||
"password": "senha123"
|
||||
}
|
||||
```
|
||||
|
||||
**Response (200):**
|
||||
```json
|
||||
{
|
||||
"token": "eyJhbGciOiJIUzI1NiIs...",
|
||||
"user": {
|
||||
"id": 1,
|
||||
"email": "usuario@email.com",
|
||||
"name": "Nome do Usuário",
|
||||
"plan": "free",
|
||||
"scans_today": 2
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Scans
|
||||
|
||||
#### POST /api/scan
|
||||
Analisa um produto pelo código de barras.
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer <token>
|
||||
```
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"barcode": "7891000100103"
|
||||
}
|
||||
```
|
||||
|
||||
**Response (200):**
|
||||
```json
|
||||
{
|
||||
"id": 123,
|
||||
"product": {
|
||||
"barcode": "7891000100103",
|
||||
"name": "Leite Condensado",
|
||||
"brand": "Moça",
|
||||
"image_url": "https://..."
|
||||
},
|
||||
"score": 25,
|
||||
"classification": "Péssimo",
|
||||
"analysis": {
|
||||
"summary": "Produto com alto teor de açúcar...",
|
||||
"positives": ["Fonte de cálcio"],
|
||||
"negatives": ["Alto teor de açúcar", "Calorias elevadas"],
|
||||
"additives": [],
|
||||
"nutrition": {
|
||||
"calories": 321,
|
||||
"sugar": 55,
|
||||
"sodium": 128
|
||||
}
|
||||
},
|
||||
"recipe": {
|
||||
"title": "Leite condensado caseiro saudável",
|
||||
"ingredients": ["1 litro de leite desnatado", "..."],
|
||||
"instructions": "..."
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Erros:**
|
||||
- `403`: Limite de scans atingido (plano free)
|
||||
- `404`: Produto não encontrado
|
||||
- `500`: Erro na análise
|
||||
|
||||
### Histórico
|
||||
|
||||
#### GET /api/history
|
||||
Lista histórico de scans do usuário.
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer <token>
|
||||
```
|
||||
|
||||
**Query Params:**
|
||||
- `limit` (opcional): Número de resultados (default: 20)
|
||||
- `offset` (opcional): Paginação
|
||||
|
||||
**Response (200):**
|
||||
```json
|
||||
{
|
||||
"total": 45,
|
||||
"scans": [
|
||||
{
|
||||
"id": 123,
|
||||
"barcode": "7891000100103",
|
||||
"product_name": "Leite Condensado",
|
||||
"score": 25,
|
||||
"scanned_at": "2026-02-10T14:30:00Z"
|
||||
},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
#### GET /api/history/{id}
|
||||
Retorna detalhes de um scan específico.
|
||||
|
||||
**Response (200):**
|
||||
```json
|
||||
{
|
||||
"id": 123,
|
||||
"product": { ... },
|
||||
"score": 25,
|
||||
"analysis": { ... },
|
||||
"recipe": { ... },
|
||||
"scanned_at": "2026-02-10T14:30:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Integrações
|
||||
|
||||
### Open Food Facts API
|
||||
|
||||
Base de dados aberta com mais de 3 milhões de produtos.
|
||||
|
||||
**Endpoint:**
|
||||
```
|
||||
https://world.openfoodfacts.org/api/v2/product/{barcode}.json
|
||||
```
|
||||
|
||||
**Exemplo:**
|
||||
```python
|
||||
import requests
|
||||
|
||||
def get_product(barcode: str):
|
||||
url = f"https://world.openfoodfacts.org/api/v2/product/{barcode}.json"
|
||||
response = requests.get(url)
|
||||
if response.status_code == 200:
|
||||
data = response.json()
|
||||
if data.get("status") == 1:
|
||||
return data["product"]
|
||||
return None
|
||||
```
|
||||
|
||||
### OpenAI GPT-4o-mini
|
||||
|
||||
Usamos o modelo GPT-4o-mini para análise inteligente dos ingredientes.
|
||||
|
||||
**Uso:**
|
||||
```python
|
||||
from openai import OpenAI
|
||||
|
||||
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
|
||||
|
||||
def analyze_product(product_data: dict) -> dict:
|
||||
prompt = f"""
|
||||
Analise este produto alimentício e forneça:
|
||||
1. Score de saúde (0-100)
|
||||
2. Pontos positivos
|
||||
3. Pontos negativos
|
||||
4. Análise dos aditivos
|
||||
5. Sugestão de receita saudável alternativa
|
||||
|
||||
Produto: {product_data['name']}
|
||||
Ingredientes: {product_data['ingredients']}
|
||||
Valores nutricionais: {product_data['nutrition']}
|
||||
"""
|
||||
|
||||
response = client.chat.completions.create(
|
||||
model="gpt-4o-mini",
|
||||
messages=[{"role": "user", "content": prompt}],
|
||||
response_format={"type": "json_object"}
|
||||
)
|
||||
|
||||
return json.loads(response.choices[0].message.content)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 PWA / Service Worker
|
||||
|
||||
O ALETHEIA é uma Progressive Web App (PWA), permitindo:
|
||||
- Instalação na home screen
|
||||
- Funcionamento parcial offline
|
||||
- Notificações push (futuro)
|
||||
|
||||
### Service Worker
|
||||
|
||||
Arquivo: `/opt/aletheia/frontend/public/sw.js`
|
||||
|
||||
```javascript
|
||||
const CACHE_NAME = 'aletheia-v1';
|
||||
const urlsToCache = [
|
||||
'/',
|
||||
'/scan',
|
||||
'/history',
|
||||
'/offline.html'
|
||||
];
|
||||
|
||||
self.addEventListener('install', (event) => {
|
||||
event.waitUntil(
|
||||
caches.open(CACHE_NAME)
|
||||
.then((cache) => cache.addAll(urlsToCache))
|
||||
);
|
||||
});
|
||||
|
||||
self.addEventListener('fetch', (event) => {
|
||||
event.respondWith(
|
||||
caches.match(event.request)
|
||||
.then((response) => response || fetch(event.request))
|
||||
);
|
||||
});
|
||||
```
|
||||
|
||||
### Manifest
|
||||
|
||||
Arquivo: `/opt/aletheia/frontend/public/manifest.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "ALETHEIA",
|
||||
"short_name": "ALETHEIA",
|
||||
"description": "Scanner de rótulos com IA",
|
||||
"start_url": "/",
|
||||
"display": "standalone",
|
||||
"background_color": "#ffffff",
|
||||
"theme_color": "#22c55e",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icon-192.png",
|
||||
"sizes": "192x192",
|
||||
"type": "image/png"
|
||||
},
|
||||
{
|
||||
"src": "/icon-512.png",
|
||||
"sizes": "512x512",
|
||||
"type": "image/png"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Variáveis de Ambiente
|
||||
|
||||
### Backend (.env)
|
||||
|
||||
```env
|
||||
# Database
|
||||
DATABASE_URL=postgresql://aletheia:Aletheia2026!@localhost:5432/aletheia
|
||||
|
||||
# OpenAI
|
||||
OPENAI_API_KEY=sk-...
|
||||
|
||||
# JWT
|
||||
JWT_SECRET=sua-chave-secreta-muito-longa
|
||||
JWT_ALGORITHM=HS256
|
||||
JWT_EXPIRATION_HOURS=24
|
||||
|
||||
# App
|
||||
APP_ENV=production
|
||||
DEBUG=false
|
||||
CORS_ORIGINS=https://aletheia.aivertice.com
|
||||
```
|
||||
|
||||
### Frontend (.env.local)
|
||||
|
||||
```env
|
||||
NEXT_PUBLIC_API_URL=https://aletheia.aivertice.com/api
|
||||
NEXT_PUBLIC_APP_NAME=ALETHEIA
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Monitoramento
|
||||
|
||||
### PM2
|
||||
|
||||
```bash
|
||||
# Dashboard em tempo real
|
||||
pm2 monit
|
||||
|
||||
# Status detalhado
|
||||
pm2 show aletheia-backend
|
||||
|
||||
# Métricas
|
||||
pm2 info aletheia-backend
|
||||
```
|
||||
|
||||
### Logs
|
||||
|
||||
```bash
|
||||
# Logs do backend
|
||||
tail -f ~/.pm2/logs/aletheia-backend-out.log
|
||||
tail -f ~/.pm2/logs/aletheia-backend-error.log
|
||||
|
||||
# Logs do frontend
|
||||
tail -f ~/.pm2/logs/aletheia-frontend-out.log
|
||||
|
||||
# Logs do Nginx
|
||||
tail -f /var/log/nginx/access.log
|
||||
tail -f /var/log/nginx/error.log
|
||||
|
||||
# Logs do PostgreSQL
|
||||
tail -f /var/log/postgresql/postgresql-15-main.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💾 Backup e Manutenção
|
||||
|
||||
### Backup Automático (Cron)
|
||||
|
||||
```bash
|
||||
# Editar crontab
|
||||
crontab -e
|
||||
|
||||
# Adicionar backup diário às 3h
|
||||
0 3 * * * pg_dump -U aletheia -d aletheia > /opt/aletheia/backups/backup_$(date +\%Y\%m\%d).sql
|
||||
|
||||
# Limpar backups antigos (manter últimos 30 dias)
|
||||
0 4 * * * find /opt/aletheia/backups -name "*.sql" -mtime +30 -delete
|
||||
```
|
||||
|
||||
### Manutenção do Banco
|
||||
|
||||
```sql
|
||||
-- Vacuum e análise (rodar semanalmente)
|
||||
VACUUM ANALYZE;
|
||||
|
||||
-- Verificar tamanho das tabelas
|
||||
SELECT
|
||||
relname as table,
|
||||
pg_size_pretty(pg_total_relation_size(relid)) as size
|
||||
FROM pg_catalog.pg_statio_user_tables
|
||||
ORDER BY pg_total_relation_size(relid) DESC;
|
||||
```
|
||||
|
||||
### Atualizações
|
||||
|
||||
```bash
|
||||
# Backend
|
||||
cd /opt/aletheia/backend
|
||||
git pull
|
||||
pip install -r requirements.txt
|
||||
pm2 restart aletheia-backend
|
||||
|
||||
# Frontend
|
||||
cd /opt/aletheia/frontend
|
||||
git pull
|
||||
npm install
|
||||
npm run build
|
||||
pm2 restart aletheia-frontend
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Problema: Backend não inicia
|
||||
```bash
|
||||
# Verificar logs
|
||||
pm2 logs aletheia-backend --lines 50
|
||||
|
||||
# Verificar porta em uso
|
||||
lsof -i :8090
|
||||
|
||||
# Testar manualmente
|
||||
cd /opt/aletheia/backend
|
||||
python -m uvicorn main:app --host 0.0.0.0 --port 8090
|
||||
```
|
||||
|
||||
### Problema: Erro de conexão com banco
|
||||
```bash
|
||||
# Verificar se PostgreSQL está rodando
|
||||
sudo systemctl status postgresql
|
||||
|
||||
# Testar conexão
|
||||
psql -U aletheia -d aletheia -h localhost -c "SELECT 1"
|
||||
```
|
||||
|
||||
### Problema: Certificado SSL expirado
|
||||
```bash
|
||||
# Renovar
|
||||
sudo certbot renew
|
||||
|
||||
# Reiniciar Nginx
|
||||
sudo systemctl restart nginx
|
||||
```
|
||||
|
||||
### Problema: Open Food Facts não responde
|
||||
```bash
|
||||
# Testar API diretamente
|
||||
curl "https://world.openfoodfacts.org/api/v2/product/7891000100103.json"
|
||||
|
||||
# Verificar rate limiting (máx 100 req/min)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 Contatos Técnicos
|
||||
|
||||
- **Infraestrutura**: infra@aivertice.com
|
||||
- **Desenvolvimento**: dev@aivertice.com
|
||||
|
||||
---
|
||||
|
||||
*Última atualização: Fevereiro 2026*
|
||||
237
docs/MANUAL-VENDAS.md
Normal file
237
docs/MANUAL-VENDAS.md
Normal file
@@ -0,0 +1,237 @@
|
||||
# ALETHEIA - Manual de Vendas e Negócio
|
||||
|
||||
## 🎯 Proposta de Valor
|
||||
|
||||
O **ALETHEIA** é o primeiro aplicativo brasileiro de análise de rótulos alimentares com Inteligência Artificial, que permite ao consumidor entender em segundos se um produto é saudável ou não.
|
||||
|
||||
### Problema que resolvemos
|
||||
|
||||
- **67% dos alimentos** vendidos no Brasil são ultraprocessados
|
||||
- **60% da população brasileira** está com sobrepeso ou obesidade
|
||||
- Rótulos são confusos, com letras pequenas e termos técnicos
|
||||
- Consumidores não têm tempo ou conhecimento para analisar cada produto
|
||||
- Apps existentes são em inglês ou não consideram a realidade brasileira
|
||||
|
||||
### Nossa solução
|
||||
|
||||
> "Escaneia, entende, decide melhor."
|
||||
|
||||
Com um simples scan do código de barras, o consumidor recebe:
|
||||
- Score de saúde de 0 a 100 (fácil de entender)
|
||||
- Análise detalhada de ingredientes pela IA
|
||||
- Alertas sobre aditivos prejudiciais
|
||||
- Sugestões de alternativas mais saudáveis
|
||||
- Receitas para substituir produtos ruins
|
||||
|
||||
---
|
||||
|
||||
## 👥 Público-Alvo
|
||||
|
||||
### B2C - Consumidores Finais
|
||||
|
||||
**Persona primária: "Maria Consciente"**
|
||||
- Idade: 28-45 anos
|
||||
- Classe B/C
|
||||
- Preocupada com saúde da família
|
||||
- Usa smartphone diariamente
|
||||
- Faz compras semanais no supermercado
|
||||
- Quer fazer escolhas melhores mas não sabe como
|
||||
|
||||
**Persona secundária: "João Fitness"**
|
||||
- Idade: 22-35 anos
|
||||
- Pratica exercícios regularmente
|
||||
- Lê rótulos mas quer mais informação
|
||||
- Disposto a pagar por ferramentas que ajudem sua dieta
|
||||
|
||||
**Persona terciária: "Vovó Digital"**
|
||||
- Idade: 55+
|
||||
- Tem condições de saúde (diabetes, hipertensão)
|
||||
- Precisa controlar alimentação
|
||||
- Interface simples é essencial
|
||||
|
||||
### B2B - Indústria Alimentar
|
||||
|
||||
**Fabricantes de alimentos**
|
||||
- Querem entender como seus produtos são percebidos
|
||||
- Buscam melhorar formulações
|
||||
- Interessados em selo de qualidade ALETHEIA
|
||||
|
||||
**Varejistas**
|
||||
- Supermercados e redes de varejo
|
||||
- Querem oferecer diferencial aos clientes
|
||||
- Integração com apps de fidelidade
|
||||
|
||||
**Nutricionistas e profissionais de saúde**
|
||||
- Ferramenta para auxiliar pacientes
|
||||
- Licenças corporativas
|
||||
|
||||
---
|
||||
|
||||
## 💰 Modelo de Monetização
|
||||
|
||||
### 1. Freemium (B2C)
|
||||
- **Gratuito**: 3 scans/dia, funcionalidades básicas
|
||||
- **Premium**: Scans ilimitados, histórico completo, receitas, relatórios
|
||||
|
||||
### 2. B2B - Selo ALETHEIA
|
||||
- Certificação para produtos com score 70+
|
||||
- Fabricantes podem exibir o selo na embalagem
|
||||
- Validação trimestral
|
||||
- Modelo de assinatura anual
|
||||
|
||||
### 3. B2B - API e Licenças
|
||||
- Acesso à API para integração em outros sistemas
|
||||
- Licenças corporativas para nutricionistas
|
||||
- White-label para redes de varejo
|
||||
|
||||
### 4. Dados e Insights (futuro)
|
||||
- Relatórios agregados e anonimizados para a indústria
|
||||
- Tendências de consumo por região
|
||||
- Análise de mercado
|
||||
|
||||
---
|
||||
|
||||
## 💬 Argumentos de Venda
|
||||
|
||||
### Para Consumidores
|
||||
|
||||
1. **Simplicidade**: "Em 3 segundos você sabe se o produto é bom ou ruim"
|
||||
2. **Confiança**: "IA treinada com dados científicos e diretrizes da OMS"
|
||||
3. **Economia**: "Pare de comprar produtos que não fazem bem"
|
||||
4. **Família**: "Proteja quem você ama de alimentos prejudiciais"
|
||||
5. **Praticidade**: "Funciona no celular, sem instalar nada"
|
||||
|
||||
### Para Empresas (B2B)
|
||||
|
||||
1. **Diferenciação**: "Seja a primeira marca do seu segmento com selo ALETHEIA"
|
||||
2. **Transparência**: "Mostre que sua empresa não tem nada a esconder"
|
||||
3. **Tendência**: "Consumidores estão cada vez mais conscientes"
|
||||
4. **Dados**: "Entenda como seu produto é percebido pelo público"
|
||||
5. **Marketing**: "O selo ALETHEIA é um argumento de venda poderoso"
|
||||
|
||||
---
|
||||
|
||||
## 🏆 Análise Competitiva
|
||||
|
||||
### Concorrentes Diretos
|
||||
|
||||
| App | Origem | Pontos Fortes | Pontos Fracos |
|
||||
|-----|--------|---------------|---------------|
|
||||
| **Yuka** | França | Interface bonita, grande base | Em francês/inglês, não considera Brasil |
|
||||
| **Open Food Facts** | Global | Base gigante, open source | Interface complexa, sem IA |
|
||||
| **Desrotulando** | Brasil | Foco brasileiro | Base pequena, sem IA |
|
||||
|
||||
### Nossos Diferenciais
|
||||
|
||||
1. **🇧🇷 100% em português brasileiro**
|
||||
- Interface, análises e receitas no nosso idioma
|
||||
- Considera produtos e marcas nacionais
|
||||
|
||||
2. **🤖 IA de verdade (GPT-4)**
|
||||
- Não é só banco de dados, é análise inteligente
|
||||
- Entende contexto e explica em linguagem simples
|
||||
|
||||
3. **🍳 Receitas saudáveis**
|
||||
- Único app que sugere alternativas caseiras
|
||||
- Geradas por IA, personalizadas para cada produto
|
||||
|
||||
4. **📱 PWA - Sem instalar**
|
||||
- Funciona direto no navegador
|
||||
- Não ocupa espaço no celular
|
||||
- Atualizações automáticas
|
||||
|
||||
5. **💚 Foco na realidade brasileira**
|
||||
- Considera marcas nacionais
|
||||
- Preços acessíveis
|
||||
- Entende o contexto do consumidor brasileiro
|
||||
|
||||
---
|
||||
|
||||
## 📊 Métricas de Mercado
|
||||
|
||||
### O Problema é Real
|
||||
|
||||
- **67%** dos alimentos vendidos no Brasil são ultraprocessados
|
||||
- **60%** dos brasileiros estão com sobrepeso ou obesidade
|
||||
- **14 milhões** de brasileiros têm diabetes
|
||||
- **38 milhões** têm hipertensão
|
||||
- Doenças relacionadas à má alimentação custam **R$ 3,5 bilhões/ano** ao SUS
|
||||
|
||||
### Mercado Potencial
|
||||
|
||||
- **150 milhões** de brasileiros com smartphone
|
||||
- **80%** fazem compras em supermercados
|
||||
- **43%** dizem ler rótulos (mas poucos entendem)
|
||||
- Mercado de apps de saúde cresce **25% ao ano**
|
||||
|
||||
### Tendências Favoráveis
|
||||
|
||||
- Aumento da consciência alimentar pós-pandemia
|
||||
- Novas regras de rotulagem da ANVISA (2022)
|
||||
- Crescimento do mercado de produtos saudáveis
|
||||
- Geração Z mais preocupada com sustentabilidade e saúde
|
||||
|
||||
---
|
||||
|
||||
## 📣 Estratégia de Marketing
|
||||
|
||||
### Canais Principais
|
||||
|
||||
1. **Redes Sociais**
|
||||
- Instagram/TikTok: Vídeos curtos mostrando scans surpreendentes
|
||||
- "Você não vai acreditar no score desse produto famoso!"
|
||||
|
||||
2. **Influenciadores**
|
||||
- Parcerias com nutricionistas e fitness influencers
|
||||
- Mães/pais que falam sobre alimentação infantil
|
||||
|
||||
3. **SEO/Conteúdo**
|
||||
- Blog com análises de produtos populares
|
||||
- "Os 10 piores cereais matinais do Brasil"
|
||||
|
||||
4. **Parcerias**
|
||||
- Academias e estúdios de pilates
|
||||
- Clínicas de nutrição
|
||||
- Empresas de plano de saúde
|
||||
|
||||
### Nota Importante
|
||||
> **Não divulgar preços em materiais de marketing externos.**
|
||||
> Preços devem ser apresentados apenas dentro do app, após o usuário conhecer o valor do produto.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Roadmap Comercial
|
||||
|
||||
### Fase 1 - Lançamento (Atual)
|
||||
- Foco em aquisição de usuários B2C
|
||||
- Validação do produto e feedback
|
||||
- Construção de base de usuários
|
||||
|
||||
### Fase 2 - Monetização
|
||||
- Lançamento do plano Premium
|
||||
- Início de conversão freemium → premium
|
||||
- Parcerias com influenciadores
|
||||
|
||||
### Fase 3 - B2B
|
||||
- Lançamento do selo ALETHEIA
|
||||
- Abordagem a fabricantes de alimentos saudáveis
|
||||
- API para integrações
|
||||
|
||||
### Fase 4 - Expansão
|
||||
- Novos mercados (Portugal, LATAM)
|
||||
- Novas funcionalidades (comparador, listas de compras)
|
||||
- Dados e insights para indústria
|
||||
|
||||
---
|
||||
|
||||
## 📞 Contato Comercial
|
||||
|
||||
**Parcerias B2B e Selo ALETHEIA:**
|
||||
- comercial@aivertice.com
|
||||
|
||||
**Imprensa:**
|
||||
- imprensa@aivertice.com
|
||||
|
||||
---
|
||||
|
||||
*ALETHEIA — A verdade sobre o que você come* 🥬
|
||||
467
docs/PESQUISA-MERCADO.md
Normal file
467
docs/PESQUISA-MERCADO.md
Normal file
@@ -0,0 +1,467 @@
|
||||
# 🔬 ALETHEIA — Pesquisa de Mercado
|
||||
|
||||
> **App que escaneia rótulos de alimentos e usa IA para traduzir ingredientes em linguagem simples**
|
||||
>
|
||||
> Última atualização: 10/02/2026
|
||||
|
||||
---
|
||||
|
||||
## Sumário Executivo
|
||||
|
||||
O Aletheia ataca uma dor real e crescente: **o brasileiro não entende o que come**. Com 67% da população acima do peso, regulamentação ANVISA recém-implementada e zero concorrentes locais com IA generativa, existe uma janela de oportunidade clara para um app que democratize a leitura de rótulos alimentícios no Brasil.
|
||||
|
||||
**TAM Brasil:** ~R$ 2,5 bilhões (saúde digital/nutrição) · **SAM:** ~R$ 400M (apps de nutrição) · **SOM ano 1:** R$ 2-5M
|
||||
|
||||
---
|
||||
|
||||
## 1. Tamanho do Mercado
|
||||
|
||||
### 1.1 Mercado Global
|
||||
|
||||
| Métrica | Valor | Fonte |
|
||||
|---------|-------|-------|
|
||||
| Mercado global de mHealth apps (2024) | **USD 37,5 bilhões** | Grand View Research |
|
||||
| Projeção 2030 | **USD 86,4 bilhões** | Grand View Research |
|
||||
| CAGR 2025-2030 | **14,8%** | Grand View Research |
|
||||
| Mercado de nutrition apps global (2024) | **USD 9,2 bilhões** | Mordor Intelligence |
|
||||
| Mercado de food scanning apps (nicho) | **USD 800M–1,2B** (estimativa) | Análise própria |
|
||||
|
||||
### 1.2 Mercado Brasil
|
||||
|
||||
| Métrica | Valor | Fonte |
|
||||
|---------|-------|-------|
|
||||
| Saúde digital Brasil (2024) | **USD 2,7 bilhões** | Statista |
|
||||
| Smartphones ativos no Brasil | **~260 milhões** | FGV (2024) |
|
||||
| Penetração de internet | **84%** da população | IBGE/Pnad 2023 |
|
||||
| Downloads de apps de saúde/fitness (BR, 2023) | **~180 milhões** | App Annie |
|
||||
| Mercado de alimentos saudáveis (BR) | **R$ 116 bilhões (2024)** | Euromonitor |
|
||||
|
||||
### 1.3 Comportamento do Consumidor Brasileiro
|
||||
|
||||
- **Apenas 31% dos brasileiros leem rótulos regularmente** (pesquisa IDEC/Datafolha, 2022)
|
||||
- Dos que leem, **47% dizem não entender as informações** (IDEC, 2022)
|
||||
- **73% dos brasileiros gostariam de entender melhor o que comem** (pesquisa Nestlé/IBOPE, 2021)
|
||||
- O brasileiro médio consome **~20% das calorias diárias de ultraprocessados** (NUPENS/USP, POF 2017-2018)
|
||||
- Em crianças e adolescentes esse número sobe para **~27%** (estudo The Lancet Regional Health, 2023)
|
||||
- O consumo de ultraprocessados **cresceu 5,5% entre 2008 e 2018** no Brasil (IBGE/POF)
|
||||
|
||||
### 1.4 Público-Alvo Primário
|
||||
|
||||
| Segmento | Tamanho estimado | Disposição a pagar |
|
||||
|----------|-----------------|---------------------|
|
||||
| Mães com filhos 0-12 anos | ~25M mulheres | Alta (R$ 10-20/mês) |
|
||||
| Fitness/wellness enthusiasts | ~30M pessoas | Média-alta |
|
||||
| Pessoas com alergias/intolerâncias | ~10M | Muito alta |
|
||||
| Diabéticos e pré-diabéticos | ~20M | Alta |
|
||||
| Gen Z health-conscious (18-28) | ~35M | Média (mas alto potencial viral) |
|
||||
|
||||
---
|
||||
|
||||
## 2. A Dor
|
||||
|
||||
### 2.1 Rótulos São Intencionalmente Confusos
|
||||
|
||||
A indústria alimentícia usa **nomenclatura técnica como barreira informacional**:
|
||||
|
||||
| O que o rótulo diz | O que realmente é |
|
||||
|---------------------|-------------------|
|
||||
| Maltodextrina | Açúcar de absorção rápida |
|
||||
| Xarope de glucose | Açúcar líquido do milho |
|
||||
| Proteína hidrolisada de soja | Glutamato/realçador de sabor |
|
||||
| Gordura vegetal hidrogenada | Gordura trans disfarçada |
|
||||
| Extrato de levedura | Glutamato monossódico natural |
|
||||
| Amido modificado | Carboidrato ultraprocessado |
|
||||
| "Sem adição de açúcares" | Pode ter adoçantes artificiais |
|
||||
|
||||
### 2.2 Healthy Washing — A Enganação Sistêmica
|
||||
|
||||
- **Produtos "integrais"** que têm farinha branca como primeiro ingrediente
|
||||
- **"Zero gordura"** mas com 30g de açúcar por porção
|
||||
- **"Natural"** sem definição regulatória no Brasil
|
||||
- **"Fonte de fibras"** com 2,5g de fibra e 15g de açúcar
|
||||
- Pesquisa PROTESTE (2023): **62% dos produtos com claims de saúde não cumprem integralmente** o que prometem na embalagem frontal
|
||||
|
||||
### 2.3 Impacto na Saúde Pública
|
||||
|
||||
| Indicador | Dado | Fonte |
|
||||
|-----------|------|-------|
|
||||
| Brasileiros com sobrepeso/obesidade | **67,5%** dos adultos | Vigitel/MS 2023 |
|
||||
| Diabéticos no Brasil | **~16,8 milhões** (6º país do mundo) | IDF Atlas 2024 |
|
||||
| Hipertensos | **~38,1 milhões** | SBC 2023 |
|
||||
| Custo da obesidade ao SUS (anual) | **R$ 3,6 bilhões** diretos | MS 2023 |
|
||||
| Mortes/ano por doenças crônicas ligadas à dieta (BR) | **~300.000** | OMS/OPAS |
|
||||
| Alérgicos alimentares (BR) | **~10% da população** (~20M) | ASBAI 2023 |
|
||||
|
||||
### 2.4 Nova Regulamentação ANVISA — A Lupa Frontal
|
||||
|
||||
- **RDC 429/2020**: obriga rótulo frontal com lupa para alto teor de açúcar, gordura saturada e sódio
|
||||
- **Prazo final de adequação: outubro de 2025** (já implementado)
|
||||
- A lupa indica que é alto, **mas não traduz o impacto nem compara alternativas**
|
||||
- **Oportunidade**: o Aletheia complementa a lupa com contexto e inteligência → "sim, tem a lupa de alto açúcar, e isso equivale a X colheres de açúcar por porção"
|
||||
|
||||
---
|
||||
|
||||
## 3. Concorrência
|
||||
|
||||
### 3.1 Mapa Competitivo Global
|
||||
|
||||
| App | País | Users | Modelo | Scan com IA? | Brasil? |
|
||||
|-----|------|-------|--------|--------------|---------|
|
||||
| **Yuka** | 🇫🇷 França | **60M+** downloads | Freemium (€15/ano) | Não (score algorítmico) | Funciona, mas sem base local |
|
||||
| **Open Food Facts** | 🌍 Global | **3M+** usuários/mês | Gratuito/open source | Não | Base BR fraca (~50k produtos) |
|
||||
| **MyFitnessPal** | 🇺🇸 EUA | **200M+** downloads | Freemium ($20/mês) | Não | Foco em calorias, não ingredientes |
|
||||
| **FatSecret** | 🇦🇺 Austrália | **50M+** | Freemium | Não | Popular no BR, mas só nutricional |
|
||||
| **Foodvisor** | 🇫🇷 França | **5M+** | Freemium | Sim (foto→calorias) | Não |
|
||||
| **Nima** | 🇺🇸 EUA | Hardware | Dispositivo ($289) | N/A | Não |
|
||||
|
||||
### 3.2 O Que Falta no Brasil
|
||||
|
||||
1. **Nenhum app traduz ingredientes em linguagem simples com IA generativa**
|
||||
2. **Nenhum tem base de dados robusta de produtos brasileiros** (Yuka/OFF são eurocêntricos)
|
||||
3. **Nenhum contextualiza a regulamentação ANVISA** (lupa frontal)
|
||||
4. **Nenhum oferece comparação com alternativas no mercado local**
|
||||
5. **Nenhum tem UX pensada para o consumidor brasileiro** (português nativo, contexto cultural)
|
||||
|
||||
### 3.3 Por Que Outros Falharam/Não Escalaram no Brasil
|
||||
|
||||
- **Deseat (BR, 2019)**: app brasileiro de scan de rótulos. Morreu por falta de funding e base de dados pobre
|
||||
- **Ingred (BR, 2020)**: foco em alérgenos. Pivot para B2B, nunca escalou consumer
|
||||
- **Problema recorrente**: construir base de dados própria é caro. **Solução Aletheia**: Open Food Facts + crowdsourcing + IA para preencher gaps
|
||||
- **Yuka no Brasil**: funciona mas a cobertura de produtos brasileiros é ~15-20%. Sem tradução cultural dos ingredientes.
|
||||
|
||||
### 3.4 Moat / Vantagem Competitiva do Aletheia
|
||||
|
||||
| Vantagem | Defensibilidade |
|
||||
|----------|----------------|
|
||||
| IA generativa (GPT-4o-mini) para tradução de ingredientes | Média (replicável, mas first-mover advantage) |
|
||||
| Base de dados brasileira construída via crowdsource | Alta (network effect) |
|
||||
| Score proprietário (Aletheia Score 0-100) | Média |
|
||||
| Conteúdo viral nativo (formato TikTok) | Alta (brand building) |
|
||||
| Parcerias B2B com marcas ("selo Aletheia") | Alta (lock-in) |
|
||||
| Dados de consumo agregados (insights para indústria) | Muito alta |
|
||||
|
||||
---
|
||||
|
||||
## 4. Regulação
|
||||
|
||||
### 4.1 ANVISA — Rotulagem
|
||||
|
||||
| Norma | Status | Impacto no Aletheia |
|
||||
|-------|--------|---------------------|
|
||||
| RDC 429/2020 (rotulagem nutricional) | ✅ Vigente (out/2025) | **Positivo** — cria awareness |
|
||||
| IN 75/2020 (lupa frontal) | ✅ Vigente | **Positivo** — Aletheia complementa |
|
||||
| Tabela nutricional obrigatória | ✅ Vigente | **Positivo** — dados estruturados |
|
||||
| Declaração de alérgenos (RDC 26/2015) | ✅ Vigente | **Positivo** — feature de alertas |
|
||||
|
||||
**Risco regulatório: BAIXO.** O Aletheia não é dispositivo médico, não prescreve dietas, não faz diagnóstico. É uma **ferramenta de informação ao consumidor**, protegida pelo CDC (Código de Defesa do Consumidor, Art. 6°, III — direito à informação).
|
||||
|
||||
### 4.2 LGPD
|
||||
|
||||
| Dado coletado | Classificação LGPD | Base legal |
|
||||
|---------------|---------------------|------------|
|
||||
| Email/nome | Dado pessoal | Consentimento |
|
||||
| Histórico de scans | Dado pessoal | Consentimento / Legítimo interesse |
|
||||
| Preferências alimentares | Dado pessoal (NÃO sensível) | Consentimento |
|
||||
| Alergias informadas pelo usuário | **Dado de saúde (sensível)** ⚠️ | Consentimento explícito |
|
||||
|
||||
**Estratégia LGPD:**
|
||||
- Alergias = opt-in explícito com consentimento específico (Art. 11, I)
|
||||
- Dados anonimizados para analytics B2B (Art. 12 — dados anonimizados não são dados pessoais)
|
||||
- Privacy by design: coletar o mínimo necessário
|
||||
- **Não armazenar dados de saúde sensíveis** no MVP — user declara alergias localmente no device
|
||||
|
||||
### 4.3 Livre para Operar?
|
||||
|
||||
**✅ SIM.** Não há barreira regulatória significativa. O app:
|
||||
- Não é dispositivo médico (ANVISA Classe I/II)
|
||||
- Não prescreve tratamento
|
||||
- Não é profissional de saúde regulado
|
||||
- Informação nutricional é pública (está no rótulo)
|
||||
- Disclaimer claro: "informações educativas, não substitui orientação profissional"
|
||||
|
||||
---
|
||||
|
||||
## 5. Modelo de Negócio
|
||||
|
||||
### 5.1 Revenue Streams
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ ALETHEIA REVENUE MODEL │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ B2C (Freemium) B2B │
|
||||
│ ├─ Free: 3 scans/dia ├─ Selo "Approved" │
|
||||
│ ├─ Pro: R$9,90/mês ├─ Consumer insights │
|
||||
│ └─ Anual: R$79,90/ano └─ API para varejistas │
|
||||
│ │
|
||||
│ Marketplace/Afiliados │
|
||||
│ ├─ Sugestões de produtos saudáveis │
|
||||
│ └─ Comissão 5-15% por redirecionamento │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.2 Projeção Financeira (Cenário Conservador)
|
||||
|
||||
| Métrica | Mês 6 | Mês 12 | Mês 24 |
|
||||
|---------|-------|--------|--------|
|
||||
| Downloads acumulados | 100K | 500K | 2M |
|
||||
| MAU (Monthly Active Users) | 40K | 180K | 600K |
|
||||
| Conversão Pro | 3% | 4% | 5% |
|
||||
| Assinantes pagantes | 1.200 | 7.200 | 30.000 |
|
||||
| MRR (B2C) | R$ 11.880 | R$ 71.280 | R$ 297.000 |
|
||||
| Revenue B2B | R$ 0 | R$ 15.000/mês | R$ 80.000/mês |
|
||||
| Afiliados | R$ 0 | R$ 5.000/mês | R$ 30.000/mês |
|
||||
| **MRR Total** | **R$ 11.880** | **R$ 91.280** | **R$ 407.000** |
|
||||
|
||||
### 5.3 Unit Economics
|
||||
|
||||
| Métrica | Valor |
|
||||
|---------|-------|
|
||||
| CAC (orgânico/viral) | R$ 2-5 |
|
||||
| CAC (pago — Instagram/TikTok) | R$ 8-15 |
|
||||
| LTV assinante mensal (churn 8%) | R$ 124 |
|
||||
| LTV assinante anual (churn 25%/ano) | R$ 240 |
|
||||
| LTV/CAC (orgânico) | **25-60x** |
|
||||
| LTV/CAC (pago) | **8-16x** |
|
||||
| Custo por scan (API GPT-4o-mini) | R$ 0,01-0,03 |
|
||||
| Custo infra/user/mês | R$ 0,15-0,30 |
|
||||
|
||||
### 5.4 Selo "ALETHEIA Approved"
|
||||
|
||||
Modelo inspirado no Yuka B2B (que gera ~30% da receita):
|
||||
- Marcas pagam R$ 5.000-50.000/ano por categoria para exibir selo
|
||||
- Critérios transparentes e públicos (não é pay-to-play)
|
||||
- Auditoria com base no Aletheia Score ≥ 75
|
||||
- **Cuidado legal**: o selo não pode ser enganoso (CDC). Critérios devem ser claros e auditáveis.
|
||||
|
||||
---
|
||||
|
||||
## 6. MVP Scope
|
||||
|
||||
### 6.1 Funcionalidades do MVP
|
||||
|
||||
```
|
||||
MVP v0.1 (8-12 semanas)
|
||||
━━━━━━━━━━━━━━━━━━━━━━━
|
||||
✅ Scan de código de barras (câmera nativa)
|
||||
✅ Busca no Open Food Facts API
|
||||
✅ Análise de ingredientes via GPT-4o-mini
|
||||
✅ Tradução para linguagem simples
|
||||
✅ Aletheia Score (0-100)
|
||||
✅ Alertas: ultraprocessado, alérgenos, açúcar oculto
|
||||
✅ Sugestão de 1-2 alternativas mais saudáveis
|
||||
✅ Histórico de scans (local)
|
||||
✅ Compartilhamento social (card para Stories/Reels)
|
||||
|
||||
❌ NÃO no MVP:
|
||||
- Cadastro/login (usar app sem fricção)
|
||||
- Gamificação
|
||||
- Comunidade
|
||||
- Plano pago (monetizar depois)
|
||||
- OCR de rótulo físico (scan da lista de ingredientes)
|
||||
```
|
||||
|
||||
### 6.2 Stack Técnica
|
||||
|
||||
| Camada | Tecnologia | Justificativa |
|
||||
|--------|------------|---------------|
|
||||
| **Frontend** | **React Native (Expo)** | Cross-platform, community, hot reload |
|
||||
| Alternativa | PWA (Next.js) | Menor custo, sem app store, mas UX de câmera limitada |
|
||||
| **Scan** | react-native-camera + ML Kit Barcode | Nativo, rápido |
|
||||
| **Base de produtos** | Open Food Facts API | Gratuita, 3M+ produtos, ~50K BR |
|
||||
| **IA/Análise** | GPT-4o-mini via API | Custo baixo (~$0.15/1M tokens), qualidade boa |
|
||||
| **Backend** | Supabase (PostgreSQL + Auth + Edge Functions) | Rápido para MVP, escala bem |
|
||||
| **Cache** | Redis (Upstash) | Cache de análises recorrentes (mesmo produto) |
|
||||
| **Infra** | Vercel + Supabase | Zero DevOps no início |
|
||||
|
||||
### 6.3 Decisão: React Native vs PWA
|
||||
|
||||
| Critério | React Native | PWA |
|
||||
|----------|-------------|-----|
|
||||
| UX de câmera | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
|
||||
| Distribuição (App Store/Play Store) | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ (link direto) |
|
||||
| Custo de desenvolvimento | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| Push notifications | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
|
||||
| Confiança do usuário | ⭐⭐⭐⭐⭐ (app "de verdade") | ⭐⭐⭐ |
|
||||
| Velocidade do scan | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
|
||||
|
||||
**Recomendação: React Native (Expo)** — a experiência de câmera é crítica para o core do produto. PWA como fallback para web.
|
||||
|
||||
### 6.4 Fluxo do Usuário (MVP)
|
||||
|
||||
```
|
||||
[Abrir app] → [Apontar câmera] → [Scan automático do barcode]
|
||||
↓
|
||||
[Busca Open Food Facts] → [Produto encontrado?]
|
||||
↓ SIM ↓ NÃO
|
||||
[Envia ingredientes [Tela: "Produto não encontrado.
|
||||
para GPT-4o-mini] Tire foto do rótulo" → OCR v2]
|
||||
↓
|
||||
[Resposta IA em ~2 segundos]
|
||||
↓
|
||||
┌────────────────────────────────┐
|
||||
│ 🔍 Nescau 2.0 │
|
||||
│ │
|
||||
│ Aletheia Score: 38/100 🟡 │
|
||||
│ │
|
||||
│ ⚠️ Açúcar é o 2º ingrediente │
|
||||
│ ⚠️ Contém maltodextrina │
|
||||
│ (= açúcar disfarçado) │
|
||||
│ │
|
||||
│ 📊 1 copo = 6 colheres açúcar │
|
||||
│ │
|
||||
│ 🔄 Alternativa: Cacau em pó │
|
||||
│ + banana = Score 82 ✅ │
|
||||
│ │
|
||||
│ [Compartilhar] [Salvar] │
|
||||
└────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 6.5 Custo Estimado do MVP
|
||||
|
||||
| Item | Custo mensal |
|
||||
|------|-------------|
|
||||
| Supabase (Pro) | R$ 125/mês |
|
||||
| OpenAI API (GPT-4o-mini, 100K scans/mês) | R$ 150-500/mês |
|
||||
| Vercel (Pro) | R$ 100/mês |
|
||||
| Redis (Upstash) | R$ 0-50/mês |
|
||||
| Apple Developer Account | R$ 500/ano |
|
||||
| Google Play Console | R$ 125 (one-time) |
|
||||
| **Total infraestrutura MVP** | **~R$ 500-800/mês** |
|
||||
| Desenvolvimento (1 dev full-time, 3 meses) | R$ 30-45K total |
|
||||
|
||||
---
|
||||
|
||||
## 7. Potencial Viral
|
||||
|
||||
### 7.1 O Formato Killer: "Escaneei e Descobri Que..."
|
||||
|
||||
O Aletheia tem **viralidade nativa** porque o formato de revelação é perfeito para short-form video:
|
||||
|
||||
```
|
||||
📱 "Escaneei o iogurte 'natural' do meu filho e..."
|
||||
→ CORTE para o Aletheia Score: 22/100
|
||||
→ "O primeiro ingrediente é AÇÚCAR"
|
||||
→ 😱 cara de choque
|
||||
→ "A alternativa: [produto X] — Score 89"
|
||||
```
|
||||
|
||||
**Referências de viralidade:**
|
||||
- Yuka: hashtag #yuka tem **2,7 bilhões de views no TikTok** (dados 2024)
|
||||
- Formato "watch me scan" gera 5-15% de engagement rate (vs 1-3% média)
|
||||
- "Revelação chocante" é o #1 driver de compartilhamento no TikTok (Source: Later, 2024)
|
||||
|
||||
### 7.2 Estratégia de Distribuição Orgânica
|
||||
|
||||
| Canal | Tática | Custo | Potencial |
|
||||
|-------|--------|-------|-----------|
|
||||
| **TikTok/Reels** | Criadores escaneiam produtos populares | R$ 0-2K/mês (seeding) | 🔥🔥🔥🔥🔥 |
|
||||
| **Instagram Stories** | Card compartilhável nativo do app | R$ 0 | 🔥🔥🔥🔥 |
|
||||
| **WhatsApp** | "Olha o que descobri sobre esse produto" (deep link) | R$ 0 | 🔥🔥🔥🔥🔥 |
|
||||
| **Twitter/X** | Threads: "Escaneei 10 produtos 'saudáveis'" | R$ 0 | 🔥🔥🔥 |
|
||||
| **YouTube** | Nutricionistas usando o app em vídeos | R$ 0-5K/mês | 🔥🔥🔥🔥 |
|
||||
| **Moms groups (Facebook)** | Mães compartilhando descobertas | R$ 0 | 🔥🔥🔥🔥🔥 |
|
||||
|
||||
### 7.3 Coeficiente Viral Esperado
|
||||
|
||||
- **K-factor estimado: 1,2-1,8** (cada usuário traz 1,2-1,8 novos)
|
||||
- Comparação: Yuka teve K-factor de ~1,5 nos primeiros 2 anos (fonte: Julie Chapon, co-founder, entrevista Sifted 2022)
|
||||
- **Chave**: o card de compartilhamento precisa ser bonito, informativo e ter call-to-action claro
|
||||
|
||||
### 7.4 Parcerias com Influenciadores
|
||||
|
||||
| Tipo | Exemplos | Seguidores | Custo |
|
||||
|------|----------|------------|-------|
|
||||
| Nutricionistas | @dramairasoliani, @dr.barakat | 1-10M | R$ 5-30K/post |
|
||||
| Fitness | @gracyannebarbosa, @paulo.muzy | 5-20M | R$ 10-50K/post |
|
||||
| Mães | @faborges, @tfrancini | 1-5M | R$ 3-15K/post |
|
||||
| **Micro-influencers (meta)** | Nutricionistas locais | 10-100K | R$ 200-2K/post ou permuta |
|
||||
|
||||
**Recomendação:** Começar com **50-100 micro-influencers** (nutricionistas e mães) com permuta (acesso Pro gratuito vitalício) antes de investir em grandes nomes.
|
||||
|
||||
---
|
||||
|
||||
## 8. Riscos e Mitigações
|
||||
|
||||
### 8.1 Matriz de Riscos
|
||||
|
||||
| Risco | Probabilidade | Impacto | Mitigação |
|
||||
|-------|--------------|---------|-----------|
|
||||
| **Base de dados fraca no BR** | Alta | Alto | Crowdsourcing + OCR de rótulos + parcerias com ANVISA Open Data |
|
||||
| **IA dá informação incorreta** (alucinação) | Média | Muito Alto | Prompt engineering rigoroso + validação humana dos top 500 produtos + disclaimer legal |
|
||||
| **Processo judicial de marca** | Média | Alto | Score baseado em critérios objetivos (NOVA, Nutri-Score adaptado) + seguro jurídico + parecer preventivo |
|
||||
| **Big tech copia** (Google Lens, Apple) | Média | Alto | Construir comunidade e brand antes. Especialização > generalização |
|
||||
| **Yuka entra forte no Brasil** | Baixa-Média | Alto | IA generativa é diferencial. Foco em UX brasileira e base local |
|
||||
| **Churn alto** (app de uso esporádico) | Alta | Médio | Gamificação, histórico, insights semanais, push inteligente |
|
||||
| **Custo de API OpenAI escala** | Média | Médio | Cache agressivo (mesmo produto = mesma análise), modelos locais como fallback |
|
||||
| **Rejeição App Store** | Baixa | Alto | Seguir guidelines rigorosamente, ter disclaimer claro |
|
||||
| **LGPD violation** | Baixa | Muito Alto | Privacy by design, DPO desde o início, consentimento granular |
|
||||
| **Dependência de Open Food Facts** | Média | Médio | Base própria em paralelo, partnership formal com OFF |
|
||||
|
||||
### 8.2 Riscos Jurídicos Específicos
|
||||
|
||||
**Risco: Marca processa por "difamação" ao receber score baixo**
|
||||
- Mitigação: Score baseado em **critérios científicos públicos** (classificação NOVA da USP/NUPENS, guidelines OMS)
|
||||
- Precedente: Yuka venceu processo da Lactalis na França (2021) — tribunal reconheceu direito à informação do consumidor
|
||||
- Ação: contratar parecer jurídico preventivo antes do lançamento (~R$ 5-10K)
|
||||
|
||||
**Risco: Responsabilidade por informação incorreta**
|
||||
- Mitigação: Disclaimer claro em todo scan: "Informação educativa. Consulte um profissional de saúde"
|
||||
- Seguro de responsabilidade civil profissional (~R$ 3-5K/ano)
|
||||
|
||||
### 8.3 Riscos Técnicos
|
||||
|
||||
| Risco | Mitigação |
|
||||
|-------|-----------|
|
||||
| Latência da API OpenAI (>3s) | Cache Redis, pre-compute top 10K produtos, fallback para análise local |
|
||||
| Barcode não reconhecido | Fallback para busca por texto/nome do produto |
|
||||
| OFF API down | Cache local dos últimos 50K produtos consultados |
|
||||
| GPT-4o-mini descontinuado | Abstração de provider, fallback para Claude Haiku ou Llama local |
|
||||
|
||||
---
|
||||
|
||||
## 9. Cronograma Sugerido
|
||||
|
||||
```
|
||||
Sem 1-2: Validação (landing page + waitlist + 50 entrevistas)
|
||||
Sem 3-4: Design UX/UI + definição de stack
|
||||
Sem 5-10: Desenvolvimento MVP
|
||||
Sem 11-12: Beta fechado (200 usuários) + iteração
|
||||
Sem 13: Lançamento soft (App Store + Play Store)
|
||||
Sem 14-16: Campanha viral TikTok/Reels
|
||||
Sem 17-20: Iteração baseada em dados + feature de OCR
|
||||
Sem 21-24: Monetização (plano Pro) + primeiros contatos B2B
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. Referências e Fontes
|
||||
|
||||
1. Grand View Research — mHealth Apps Market Report, 2024
|
||||
2. IBGE/POF 2017-2018 — Pesquisa de Orçamentos Familiares
|
||||
3. NUPENS/USP — Estudos sobre ultraprocessados no Brasil
|
||||
4. IDEC/Datafolha — Pesquisa de rotulagem, 2022
|
||||
5. Vigitel/Ministério da Saúde — Vigilância de Fatores de Risco, 2023
|
||||
6. IDF Diabetes Atlas, 10ª edição, 2024
|
||||
7. ANVISA — RDC 429/2020 e IN 75/2020
|
||||
8. Yuka — Dados públicos e entrevistas dos fundadores
|
||||
9. Open Food Facts — Estatísticas da base de dados
|
||||
10. Euromonitor — Health & Wellness in Brazil, 2024
|
||||
11. The Lancet Regional Health Americas — Consumo de ultraprocessados em crianças brasileiras, 2023
|
||||
|
||||
---
|
||||
|
||||
## TL;DR — Por Que o Aletheia Vai Funcionar
|
||||
|
||||
1. **Timing perfeito**: regulamentação ANVISA recém-chegou, awareness está no pico
|
||||
2. **Dor real**: 67% do Brasil está acima do peso e não entende o que come
|
||||
3. **Zero concorrência local com IA**: o mercado está aberto
|
||||
4. **Viralidade nativa**: formato "escaneei e descobri" é feito para TikTok
|
||||
5. **Unit economics fortes**: CAC orgânico de R$ 2-5, LTV de R$ 124+
|
||||
6. **MVP barato**: R$ 30-45K para lançar, R$ 500-800/mês de infra
|
||||
7. **Moat crescente**: base de dados brasileira + comunidade + dados B2B
|
||||
8. **Regulação favorável**: livre para operar, CDC protege direito à informação
|
||||
|
||||
> *"Aletheia" (ἀλήθεια) = verdade em grego. O app que revela a verdade sobre o que você come.*
|
||||
Reference in New Issue
Block a user