Deep System Map V1

Mapa sistêmico — Evolução

Fonte visual, estrutural e operacional pública: abas, rotas, telas, features, entidades, persistência, integrações, lineage, debug e regressões sanitizadas.

131 nós 44 relações 2 fluxos TIPOLT_SYSTEM_MAP_STANDARD_V1

sourceCommit 4f9947f 4f9947fa9f4f49c38d1d52b8ec3a7d986b96142a

inventoryDigest893be232c05999d856e1a6b434f393735896b2e6ae611daa923d8481a6c44995

evidenceDigest386851f21eaddd1f0e91d0f924dbf59671f9bd0a3b7d87db7a2cebe4da8a0853

Mapa profundo do sistema

Árvore HTML acessível como representação principal. Grafo SVG complementar opt-in.

admin 4
- Domain admin
- Stack route Admin
- Screen src/screens/AdminScreen.js
- Área restrita a contas autorizadas para operações internas de suporte.
auth 5
- Questionnaire routing guard
- Domain auth
- Stack route Cadastro
- Autentica usuário, restaura sessão e conduz onboarding quando necessário.
- Authenticated user identity
coach 9
- Domain coach
- Tab Coach
- Stack route AutoCoach
- Stack route IAWeekly
- Stack route Insights
- Screen src/screens/AutoCoachScreen.js
- Screen src/screens/CoachChatScreen.js
- Screen src/screens/InsightsScreen.js
- Entrega recomendações e planos do módulo Coach conforme perfil do usuário.
core 34
- Fitness app — treino, nutrição, coach, social, perfil
- Domain core
- Stack route MainTabs
- Apresenta política de privacidade, consentimentos e opções de dados do usuário.
- Envia lembretes de treino e alertas configuráveis via push e in-app.
- Inicializa runtime Expo, tema, navegação e providers globais do app.
- Persiste dados localmente e sincroniza com Firestore quando online.
- Local storage key admin.local.exercises.v1
- Local storage key admin.local.foods.v1
- Local storage key app.store.secure.v1
- Local storage key app.store.v1
- Local storage key coach.memory.v1
- Local storage key evolucao.admin.local.unlock.v1
- Local storage key evolucao.admin.token.v1
- Local storage key evolucao.analytics.last_open_day.v1
- Local storage key evolucao.analytics.session.v1
- Local storage key evolucao.analytics.snapshot_history.v1
- Local storage key evolucao.beta.enabled.v1
- Local storage key evolucao.beta.suggestions.v1
- Local storage key evolucao.hydration.pending.v1
- Local storage key evolucao.notifications.creatine.id.v1
- Local storage key evolucao.notifications.state.v1
- Local storage key evolucao.profile_plan.v1
- Local storage key evolucao.subscription.v1
- Local storage key evolucao.user.identity.v1
- Local storage key evolucao.workouts.pending.v1
- Local storage key gamification.store.v1
- Local storage key nutrition.favorite.foods.v1
- Local storage key nutrition.store.v2
- Local storage key observability.runtime.v2
- Local storage key qa.health.v1
- Local storage key runtime.error.collector.v1
- Local storage key user.store.v1
- Local storage key workout.store.v1
home 4
- Domain home
- Tab Home
- Screen src/screens/HomeScreen.js
- Apresenta visão consolidada de treino, metas e atalhos para módulos principais.
monetization 4
- Domain monetization
- Stack route Paywall
- Screen src/screens/PaywallScreen.js
- Apresenta planos premium, status da assinatura e fluxo de upgrade.
nutrition 7
- Domain nutrition
- Tab Nutricao
- Stack route AnaliseDia
- Stack route MacroSemanal
- Stack route Scanner
- Screen src/screens/NutritionScanner.js
- Registra refeições, metas calóricas e acompanha hábitos alimentares.
observability 4
- Domain observability
- Stack route DebugMetrics
- Screen src/screens/DebugMetricsScreen.js
- Coleta logs e métricas de uso sem expor dados pessoais no snapshot público.
onboarding 2
- Domain onboarding
- Stack route Questionario
profile 5
- Domain profile
- Tab Perfil
- Stack route PerfilConta
- Screen src/screens/ProfileScreen.js
- Gerencia dados pessoais, preferências de treino, metas e configurações gerais.
social 9
- Domain social
- Tab Social
- Stack route RankingEvolution
- Stack route SocialChallenges
- Screen src/screens/RankingEvolutionScreen.js
- Screen src/screens/SocialChallengesScreen.js
- Screen src/screens/SocialScreen.js
- Permite participar de desafios, visualizar feed e interagir com a comunidade.
- Social
workout 28
- Domain workout
- Tab Treino
- Stack route ExerciseDetail
- Stack route Historico
- Stack route ImportWorkout
- Stack route Rotinas
- Stack route TreinoHoje
- Stack route TreinoLivre
- Stack route WorkoutCompleteScreen
- Screen src/screens/ExerciseDetailScreen.js
- Screen src/screens/ImportWorkoutScreen.js
- Screen src/screens/WorkoutCompleteScreen.js
- Screen src/screens/WorkoutScreen.js
- Consulta catálogo de exercícios com demonstrações em vídeo quando disponíveis.
- Finish guided workout session, persist logs, sync cloud, update streak/social
- Resume sessão concluída, estatísticas e persistência do histórico.
- Timer e controles de intervalo entre séries durante a sessão guiada.
- Exibe sessões anteriores, volumes e evolução ao longo do tempo.
- Centraliza início de sessão, rotinas ativas e atalhos para modos de treino.
- Importa rotinas ou exercícios de fontes suportadas pelo app.
- Lista, edita e organiza rotinas vinculadas ao módulo de treino.
- Conduz série a série com registro de carga, repetições e progressão guiada.
- Permite registrar treino ad hoc sem rotina pré-definida.
- Persist set log during active workout
- Per-set workout log entry
- Active workout session identity
- Finish validation guard
- Workout persistence guard

Fluxos críticos

Lineage com evidência comprovada ou parcial.

Registration and onboarding

ID: evolucao.flow.auth.registration

App launch without account

Cadastro
Questionario
MainTabs

Workout completion

ID: evolucao.flow.workout.completion

User taps finish on WorkoutScreen when guided sets complete

TRIGGER: finish handler on WorkoutScreen
INPUT: today session logs, volume, duration
VALIDATION: canFinishWorkout planned vs completed sets
TRANSFORMATION: buildWorkoutCompleteSummary, normalizedExercises
ENTITY: WorkoutLog entries already appended during session
IDENTITY: workoutSessionId scoped logs
WRITE: persistWorkoutState APPEND/REPLACE via MMKV
WRITE: saveCompletedWorkoutToApi SYNC_PUSH with offline queue fallback
WRITE: updateStreak UPSERT Firebase gamification
WRITE: onWorkoutCompleted SYNC_PUSH social XP/ranking when online
STORAGE: workout.store.v1 local + cloud API
CONSUMERS: WorkoutCompleteScreen, HistoryScreen, Home streak, Ranking when sync succeeds
UI OUTPUT: WorkoutCompleteScreen navigation params
FAILURE: streak/social/API errors logged; local logs retained
FALLBACK: queuedOffline sync message; social failure non-blocking

Diagramas derivados

SVGs Mermaid gerados em build a partir do manifesto público arquitetural.

Diagrama da jornada pública Evolução — Diagrama Mermaid da jornada

Diagrama de fluxo de dados Evolução — Fluxo de dados

Limitações conhecidas

Lote B: validação em dispositivo físico Android ocorreu no commit anterior ao merge; no commit 4f9947f a validação registrada foi apenas automatizada.
iOS permanece Expo-capable sem validação em dispositivo físico neste ciclo.
Snapshot público omite mecanismos internos de administração e credenciais.

Suporte: tipoltlabs@gmail.com