Skip to content

feat: scaffold de la app CapMark (MVP local-first) + backend auto-instanciable - #1

Merged
Jrgil20 merged 4 commits into
mainfrom
feat/app-mvp-scaffold
Jul 19, 2026
Merged

feat: scaffold de la app CapMark (MVP local-first) + backend auto-instanciable#1
Jrgil20 merged 4 commits into
mainfrom
feat/app-mvp-scaffold

Conversation

@Jrgil20

@Jrgil20 Jrgil20 commented Jul 5, 2026

Copy link
Copy Markdown
Member

Resumen

Scaffold funcional de CapMark — tracker local-first de manga/manhua/novelas (Ionic React + Capacitor + TS), con arquitectura por capas (RNF-009) y backend auto-instanciable (sin paneles manuales).

Verificado: build limpio, typecheck limpio, 25 tests en verde, bundle de producción arranca.

Qué incluye

  • Dominio (src/domain): Obra, Fuente, Progreso con invariantes puras (RF-001…012).
  • Aplicación (src/application): casos de uso (catálogo, fuentes, progreso, scraper) + puertos (interfaces). No conoce Ionic ni Supabase.
  • Infraestructura (src/infrastructure): persistencia local-first Dexie/IndexedDB, verificador de links, scraper genérico, repo en memoria, sync stub y composition root (DI).
  • UI (src/ui): catálogo con búsqueda + filtros (tag/estado/prioridad) y contador; detalle con progreso (+1 en 1 toque), historial y gestión de fuentes; modo oscuro; rutas con lazy-loading.

Decisiones de producto

  • Scraper opt-in y semi-asistido (S2): propone el capítulo detectado y el usuario confirma antes de guardar. Nunca escribe solo.
  • Backend auto-instanciable: infra/docker-compose.yml self-hosted (Postgres + Auth + Realtime + Edge Functions), migraciones con RLS por usuario que se aplican solas al primer arranque, Edge Functions (verify-link, fetch-html) y scripts/bootstrap.sh que genera secretos y levanta todo con un comando. La app funciona sin backend.

Tooling

25 tests (Vitest), CI (GitHub Actions), Makefile, README, CLAUDE.md, .env.example.

Andamiaje explícito (pendiente)

  • Motor de sync completo (outbox + Realtime) = Fase 3 del plan (Docs/06-plan-de-trabajo.md); hoy es un stub tras el puerto SyncPort.
  • El docker compose se validó con config, no con un up de extremo a extremo en este entorno.

🤖 Generated with Claude Code

…tanciable

App Ionic React + Capacitor + TypeScript con arquitectura por capas (RNF-009):
dominio / aplicación / infraestructura / UI, con dependencias solo hacia adentro.

- Dominio: Obra, Fuente, Progreso con invariantes puras (RF-001…012).
- Aplicación: casos de uso (catálogo, fuentes, progreso, scraper) + puertos.
- Infraestructura: persistencia local-first Dexie/IndexedDB, verificador de links,
  scraper genérico, repo en memoria, sync stub y composition root (DI).
- UI: catálogo con búsqueda + filtros (tag/estado/prioridad) y contador; detalle con
  progreso (+1 en 1 toque), historial, gestión de fuentes; modo oscuro; rutas lazy.

Scraper OPT-IN y semi-asistido (S2): propone el capítulo detectado y el usuario
confirma antes de guardar; nunca escribe solo.

Backend auto-instanciable (sin paneles manuales): docker-compose self-hosted
(Postgres + Auth + Realtime + Edge Functions), migraciones con RLS que se aplican
solas al primer arranque, Edge Functions (verify-link, fetch-html) y bootstrap.sh
que genera secretos y levanta todo con un comando. La app funciona sin backend.

Tooling: 25 tests (Vitest), typecheck y build limpios, CI (GitHub Actions),
Makefile, README, CLAUDE.md, .env.example.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 5, 2026 21:50

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Jrgil20 and others added 3 commits July 5, 2026 17:54
… Supabase)

BackupService (capa aplicación, solo usa el puerto Repositorio) para exportar todo el
catálogo con fuentes e historial a JSON y restaurarlo, permitiendo poseer y mover los
datos entre dispositivos sin backend alguno. Botones exportar/importar en el catálogo;
el indicador de nube muestra "Modo local (sin backend)". +3 tests de round-trip.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Jrgil20
Jrgil20 merged commit 04db8c6 into main Jul 19, 2026
2 checks passed
@Jrgil20
Jrgil20 deleted the feat/app-mvp-scaffold branch July 19, 2026 15:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants