techguard

Aperta
#255 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
20/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
android

Direzione di ricerca

The issue lists broad Android authentication, security, performance, and validation requirements, but names no repository files, tests, or entry points. First clarify which requirement is in scope and locate the relevant app code and tests. Done would need to be defined by selecting specific acceptance criteria from the issue and verifying them.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

AGENTS.md — TechGuard J&E (Single Source of Truth)

Evaluación Metodológica: [APROBADO: LISTO PARA DESARROLLO]


1. Módulos de Requisitos (ISO/IEC/IEEE 29148:2018)

PRD (Historias de Usuario)

PRD: Necesidades de Usuario e Historias (TechGuard J&E)

Módulo 1: Privacidad y Confianza

  • Voz: "Como ciudadano de Medellín, me preocupa registrar mis datos..."
  • HU-01: Como usuario de TechGuard, quiero que mis datos estén cifrados para tener certeza de que no serán vulnerados.

Módulo 2: Rapidez en Situaciones de Alerta

  • Voz: "Si voy por la calle... necesito entrar de inmediato."
  • HU-02: Como ciudadano en movilidad, quiero acceder en pocos segundos y mantener mi sesión iniciada.

Módulo 3: Prevención de Errores

  • Voz: "A veces me equivoco escribiendo el correo..."
  • HU-03: Como usuario nuevo, quiero recibir retroalimentación visual clara e instantánea si ingreso datos inválidos.

Módulo 4: Control de Acceso

  • Voz: "Si presto mi celular... quiero estar seguro..."
  • HU-04: Como usuario de dispositivo compartido, quiero poder cerrar mi sesión completamente.
TRD (Especificaciones Técnicas)

TRD: Especificaciones Técnicas TechGuard

Seguridad y Cifrado

  • RF-SEG-01: Cifrado de contraseña (mínimo SHA-256 o bcrypt).
  • RNF-SEG-02: Cero envío o almacenamiento de credenciales en texto plano.

Rendimiento y Autenticación

  • RNF-DES-01: Cold start estricto < 3.0 segundos.
  • RNF-DES-02: Latencia de Login < 2.0 segundos en red móvil.
  • RF-SES-01: Token de sesión seguro en almacenamiento local (Android).

Validación y Usabilidad

  • RF-VAL-01: Validación sintáctica de email vía regex en cliente.
  • RF-VAL-02: Longitud mínima de password (6 caracteres).
  • RNF-USA-01: Errores explícitos en español señalando el campo.

Control de Sesión

  • RF-SES-03: Destrucción de token local al cerrar sesión.
  • RF-SEG-03: Bloqueo de botón "Atrás" de Android tras cierre de sesión.
PLAN (Criterios QA)

PLAN: Criterios de Aceptación QA (Given-When-Then)

QA-01 (Seguridad - Módulo 1)

  • Dado un usuario que completa el registro...
  • Cuando se confirma la cuenta...
  • Entonces la BD guarda un hash irreversible (0 contraseñas texto claro).

QA-02 (Rendimiento - Módulo 2)

  • Dado un usuario autenticado...
  • Cuando abre la app tras cerrarla en background...
  • Entonces accede directo sin login.

QA-03 (UI/UX - Módulo 3)

  • Dado un correo sin formato correcto...
  • Cuando pulsa Registrarse...
  • Entonces la app resalta el campo en rojo sin limpiar el resto.

QA-04 (Control - Módulo 4)

  • Dado un usuario que pulsa Cerrar sesión...
  • Cuando presiona botón "Atrás" de Android...
  • Entonces permanece en login (no recarga vistas privadas).
USER FLOW (Navegación Android)

USER FLOW & Metodología

Enfoque (Pressman, Maxim & Sommerville)

  • Trazabilidad estructurada: Necesidad -> Historia -> Especificación -> QA.
  • Estándar: ISO/IEC/IEEE 29148:2018.

Flujos de Navegación Derivados (Android)

  1. Registro -> Validación Cliente (Regex) -> API (Cifrado) -> BD.
  2. Login -> API -> Respuesta < 2.0s -> Generación Token Local Android.
  3. Cold Start -> Verifica Token Local -> (< 3.0s) -> Main Activity o Login.
  4. Cierre de Sesión -> Destruye Token -> Login Activity (Clear Task en Android).

2. Directrices para el Agente IA Desarrollador

  • Todas las rutas y flujos en Android (o framework móvil) deben prevenir explícitamente el uso de la tecla "Atrás" después del logout.
  • No omitir los mensajes visuales (usabilidad en formularios) dictados por la HU-03.
  • Utilizar exclusivamente variables de entorno y algoritmos robustos (SHA-256 o superior) para BD.
Lingua principale
TypeScript
Stelle
24.8k
Fork
1.9k
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di agentsmd/agents.md

Tutte le issue di agentsmd/agents.md

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.