Commit Graph

11 Commits

Author SHA1 Message Date
Andrés Eduardo García Márquez 73a193d8ac refactor(docs): move DEV-GUIDE.md to docs folder
Consolidate documentation by moving DEV-GUIDE.md from root to docs/.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 14:12:38 -05:00
Andrés Eduardo García Márquez c86f92d2bb refactor: rename CLAUDE.md to DEV-GUIDE.md and update references
CI/CD Pipeline / deploy (push) Failing after 28s Details
CI/CD Pipeline / smoke-tests (push) Has been skipped Details
CI/CD Pipeline / e2e-tests (push) Has been skipped Details
CI/CD Pipeline / rollback (push) Has been skipped Details
- Rename CLAUDE.md to DEV-GUIDE.md for clearer purpose
- Update all documentation references to new filename
- Standardize QA report authorship
2026-01-09 08:25:42 -05:00
Andrés Eduardo García Márquez df8a8e74f8 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.
2026-01-09 07:44:22 -05:00
Andrés Eduardo García Márquez df06225b98 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:
- DEV-GUIDE.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
2026-01-09 07:43:57 -05:00
Andrés Eduardo García Márquez cf5ba2010d 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.
2026-01-09 07:43:35 -05:00
Andrés Eduardo García Márquez 1ad090329b fix(k3s): update image names and deployment docs
- Rename images from academia-* to student-* for consistency
- Update DEPLOYMENT.md with latest deployment procedures
2026-01-08 16:40:57 -05:00
Andrés Eduardo García Márquez 9f25e8bf9d docs: add QA regression report and update recommendations
- Add regression test report with 14 passed tests
- Verify DEF-001 and DEF-002 fixes
- Update recommendations with CI/CD deployment info
2026-01-08 11:23:19 -05:00
Andrés Eduardo García Márquez a98862add8 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
2026-01-08 10:49:32 -05:00
Andrés Eduardo García Márquez bcfd2ba6f9 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
2026-01-08 08:41:24 -05:00
Andrés Eduardo García Márquez b234c9c5de 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.
2026-01-08 00:02:29 -05:00
Andrés Eduardo García Márquez 4fa8dc03a0 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
2026-01-07 23:00:56 -05:00