Cliente móvil Flutter para acits.ru — software libre y de código abierto para el registro de animales dentro de un refugio.
El personal del refugio y los curadores mantienen un registro en vivo de los animales a su cuidado: prescripciones médicas, horarios, solicitantes de adopción, documentos y fotos. La app se distribuye en los sabores (flavors) dev y prod y se comunica con el backend de ACITS a través de un cliente OpenAPI generado.
flutter_bloc (Cubit) · go_router · easy_localization · get_it + injectable · Chopper/Dio (OpenAPI) · Firebase · Patrol para e2e. Fijado a Flutter 3.44 / Dart 3.12 mediante FVM.
git clone https://github.com/aiserrock/acits-flutter.git
cd acits-flutter
fvm install && fvm flutter pub get
fvm dart run build_runner build --delete-conflicting-outputs
fvm flutter run -t test/dev/main.dart --flavor devLos archivos de configuración de Firebase están excluidos del repositorio (gitignored) — copia primero las plantillas *.example (ver CONTRIBUTING.md).
El CI se ejecuta en los pull requests (lint, análisis, tests, build) — un simple merge a main/develop no dispara nada, porque el PR que lo trajo ya pasó por el pipeline completo.
Al hacer push de una etiqueta v* (por ejemplo v0.5.1) se compilan Android/iOS/web, se publica una GitHub Release con el APK de dev adjunto, se despliega la compilación web prod a GitHub Pages y se publica una notificación de compilación en el canal de notificaciones de compilación de Telegram.
PWA en vivo — la compilación web prod, instalable como Progressive Web App.
- Guía de contribución — instalación, estructura del proyecto, localización, tests, compilación y flujo de trabajo de PR.
- Wiki — notas de arquitectura, sabores (flavors) y detalles del pipeline de CI.
- Política de seguridad — versiones soportadas y cómo reportar una vulnerabilidad.
- Código de conducta
- Discussions — preguntas, ideas y charla general.
- Issues — reportes de errores y solicitudes de funcionalidades.
- Notificaciones de compilación en Telegram.
Las contribuciones son bienvenidas — consulta CONTRIBUTING.md antes de abrir un pull request.
Publicado bajo la Licencia MIT.