Arca_Ensina

Aplicação web multiplataforma para centralizar protocolos médicos e oferecer ferramentas de apoio à prática clínica. Reúne conteúdos da equipe ARCA Ensina com funcionalidades que auxiliam na tomada de decisão e organização do fluxo de trabalho médico.

Público-alvo: pediatras intensivistas recém-formados.

🔗 arcaapp.lat 🔗 Site sobre o projeto

Stack

• Backend: Django 6 + Django REST Framework + SimpleJWT (SQLite em dev, PostgreSQL em Docker/prod)
• Frontend: React 18 + TypeScript + Vite
• CI/CD: GitHub Actions + Docker Compose

---

Quero executar localmente:

Veja o CONTRIBUTING.md para o guia completo.

Docker (recomendado)

cp .env.example .env
docker compose up

Migrations rodam automaticamente na primeira inicialização.

Manual (dois terminais)

# Terminal 1 — backend
cp .env.example .env              # obrigatório (SECRET_KEY, etc.)
python3 -m venv .venv && source .venv/bin/activate
pip install -r backend/requirements.txt
cd backend
python manage.py migrate
python manage.py runserver        # :8000

# Terminal 2 — frontend
cd frontend
npm install
npm run dev                       # :5173

Abra http://localhost:5173 no navegador.

Credenciais de teste:

• Login: teste@arcaapp.com
• Senha: punTaw5%

---

Estrutura

backend/
  project/       ← configurações Django (settings, urls)
  apps/
    accounts/    ← autenticação (User, login, register, logout)
    audit/       ← auditoria (AuditLog, AuditableMixin)
frontend/        ← SPA React + Vite
docs/            ← planejamento (stories, infra, roadmap)

Convenção: cada domínio do produto vira um app Django próprio dentro de backend/apps/. Veja a seção Adicionando um domínio novo no CONTRIBUTING.md.

---

Funcionalidades

• Consulta de protocolos médicos
• Calculadoras de medicamentos
• Interface responsiva
• Modo Offline
• Bulário digital
• Suporte à exportação de dados para pesquisa

---

Pesquisa e Análise

• Levantamento de aplicações similares
• Análise comparativa

Persona

• Definição do perfil do usuário

Jornada do Usuário

• Mapeamento de interações

Coleta de Dados

• Aplicação de formulário
• Análise dos resultados

Ideação

• Divisão em 3 equipes
• Uso de diferentes abordagens

Priorização (MoSCoW)

• Must have – essenciais
• Should have – importantes
• Could have – desejáveis
• Won't have – fora do escopo

Planejamento Ágil

• Histórias de usuário
• Organização em 3 épicos

Gestão

• Uso do Jira
• Apresentação de Status Report

---

📖 Histórias Épicas

Épico 1 - Fundamentos clínicos + design foundation

Período: 06/05 – 13/05 (Sprint 1, 1 semana) Prioridade: Must Have Objetivo: Entregar fundações de dados (modelo dual guiado+painel, engine de dose, modelo de paciente) e fundação visual (design tokens, shadcn base, AppShell, disclaimer-ready) que destravam todo o trabalho FE de Sprint 2 sem retrabalho.

Stories: CORE-001 , CORE-002a, CORE-003, CORE-007, CORE-013 , CORE-014 - 51 pts

---

Épico 2 - Fluxo end-to-end + offline + coleta + painel BE + auth UX polida

Período: 13/05 – 27/05 (Sprint 2, 2 semanas) Prioridade: Must Have Objetivo: Fluxo clínico utilizável de ponta a ponta + experiência de auth com identidade ARCA + disclaimer educacional pronto para safety-critical.

Stories: CORE-002b, CORE-004, CORE-005, CORE-009, EXP-001a, EXP-003, EXP-004, PAINEL-001, CORE-011, CORE-012 - 67 pts

---

Épico 3 - Inteligência + dados + painel FE + offline pleno

Período: 27/05 – 10/06 (Sprint 3, 2 semanas) Prioridade: Should Have / Could Have Objetivo: Sugestão automática, modo emergência, painel sedação FE, engine offline guiada, sync, calculadora offline, painel pesquisa, exportação, notificações.

Stories: CORE-008, CORE-010, PAINEL-002, EXP-001b, EXP-001c, EXP-002, ADV-001, ADV-002, ADV-004 — 70 pts

---

Épico 4 - Polimento, agenda + buffer

Período: 10/06 – 17/06 (1 semana) Prioridade: Should/Could Objetivo: Estabilizar, polir, dashboard pessoal, agenda de doses, E2E e documentação de handoff.

Stories: EXP-006, ADV-006, ADV-007, PAINEL-003 — 23 pts + buffer

---

Acesse nosso site sobre o projeto para todas as informações sobre a SR2: https://sites.google.com/cesar.school/arca-grupo7/

---

👨‍💻 Equipe

Desenvolvedores

Designers