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