Commit Graph

9 Commits

Author SHA1 Message Date
Andrés Eduardo García Márquez 2276e6f797 refactor(qa): reorganize QA documentation structure
Migrate QA documentation from docs/qa-testing/ to docs/qa/:
- Remove obsolete screenshots from previous testing rounds
- Remove outdated DEFECTOS-QA.md (issues have been resolved)
- Add new QA report for student activation flow testing
- Reorganize qa-testing folder with updated structure

New documentation:
- QA-REPORT-STUDENT-ACTIVATION-FLOW.md: comprehensive test report
  covering activation UI, code validation, expiry handling,
  and admin manual activation features

This cleanup removes 30+ obsolete screenshots and consolidates
QA documentation in a cleaner structure.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 07:44:22 -05:00
Andrés Eduardo García Márquez 2aeca86a9e docs: update project documentation for activation feature
Updated documentation across all deliverables:

Requirements (AN-001):
- Add activation flow requirements
- Document admin management capabilities

User Stories (AN-003):
- Add activation-related user stories
- Admin stories for student management

Domain Model (DI-002):
- Document Student activation fields
- Update entity relationships

GraphQL Schema (DI-004):
- Add activation mutations and queries
- Document new endpoints

Configuration:
- DV-004: Database schema changes
- DV-005: New environment variables

Project docs:
- CLAUDE.md: Update project structure and commands
- README.md: Add activation feature documentation
- ENTREGABLES.md: Update deliverables summary
- DEPLOYMENT.md: Update deployment instructions
- RECOMMENDATIONS.md: Add security recommendations

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 07:43:57 -05:00
Andrés Eduardo García Márquez e60c7b83b4 docs(diagrams): update architecture diagrams for activation feature
Updated PlantUML diagrams and regenerated SVG/PNG exports:

01-use-cases: Add activation and admin use cases
02-domain-model: Add activation fields to Student entity
03-sequence-enrollment: Include activation check in flow
04-components: Add activation and admin components
05-entity-relationship: Add activation columns to Student table
06-state-enrollment: Add inactive/pending states
07-deployment: Update for current infrastructure
08-c4-context: Add admin actor and activation system

All diagrams validated and exported in both SVG and PNG formats.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 07:43:35 -05:00
Andrés Eduardo García Márquez fa607d3fc4 fix(k3s): update image names and deployment docs
Deploy to k3s / deploy (push) Failing after 25s Details
- Rename images from academia-* to student-* for consistency
- Update DEPLOYMENT.md with latest deployment procedures

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 16:40:57 -05:00
Andrés Eduardo García Márquez ca637f8d3b docs: add QA regression report and update recommendations
Build and Deploy to k3s / build-api (push) Failing after 2m53s Details
Build and Deploy to k3s / build-frontend (push) Failing after 34s Details
Build and Deploy to k3s / deploy (push) Has been skipped Details
- Add regression test report with 14 passed tests
- Verify DEF-001 and DEF-002 fixes
- Update recommendations with CI/CD deployment info

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 11:23:19 -05:00
Andrés Eduardo García Márquez ff7f43b053 feat: add CI/CD pipeline, password recovery, and QA improvements
- Add Gitea Actions workflow for automated k3s deployment
- Implement password recovery with recovery codes (no email needed)
- Fix unenroll mutation (missing studentId parameter)
- Fix dashboard handling for expired sessions
- Add optimized Docker builds with caching
- Add k3s all-in-one deployment manifest
- Add QA test report and recommendations

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 10:49:32 -05:00
Andrés Eduardo García Márquez 0562a46d7f docs(qa): add manual QA testing report and dev startup script
- Add comprehensive QA report with 11 test cases and screenshots
- Document DEF-001 bug analysis, solutions, and resolution
- Add dev-start.sh script for faster development server startup
- Include recommendations for UX, technical, and quality improvements

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 08:41:24 -05:00
Andrés Eduardo García Márquez 0f3984b8c9 docs(qa): add QA testing report with defects and screenshots
Add comprehensive QA testing documentation:
- DEFECTOS-QA.md: Detailed defect report with 4 issues found
- screenshots/: 12 screenshots documenting defects and validations

Defects documented:
- DEF-001: SQL Server OOMKilled (Critical) - FIXED
- DEF-002: Messages in English (High) - FIXED
- DEF-003: Pluralization error (Medium) - FIXED
- DEF-004: Favicon 404 (Low) - FIXED

All defects include root cause analysis, proposed solutions,
and unified implementation approach.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 00:02:29 -05:00
Andrés Eduardo García Márquez 3e62a94df7 docs: add project documentation and env template
Environment:
- .env.example template with all configuration variables
- Database, API, GraphQL, and frontend settings

Documentation:
- Architecture Decision Records (ADR-001 to ADR-004)
- Deployment guide with Docker and K8s instructions
- OWASP security checklist
- Code review checklist
- Activity plan and deliverables

Architecture diagrams (PlantUML):
- Use cases, domain model, sequence diagrams
- Component, ER, state, and deployment diagrams
- C4 context diagram

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 23:00:56 -05:00