grabbit/meteor_detection_system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
meteor_detection_system/.claude/commands/BMad/tasks/validate-next-story.md
grabbit a04d6eba88 🎉 Epic 1 Complete: Foundation, User Core & First Light 
## Major Achievements ✅

### Story 1.14: 前端事件画廊页面 - Gallery Page Implementation
- ✅ Protected /gallery route with authentication redirect
- ✅ Infinite scroll with React Query + Intersection Observer
- ✅ Responsive event cards with thumbnail, date, location
- ✅ Loading states, empty states, error handling
- ✅ Dark theme UI consistent with design system

### Full-Stack Integration Testing Framework
- ✅ Docker-based test environment (PostgreSQL + LocalStack)
- ✅ E2E tests with Playwright (authentication, gallery workflows)
- ✅ API integration tests covering complete user journeys
- ✅ Automated test data generation and cleanup
- ✅ Performance and concurrency testing

### Technical Stack Validation
- ✅ Next.js 15 + React Query + TypeScript frontend
- ✅ NestJS + TypeORM + PostgreSQL backend
- ✅ AWS S3/SQS integration (LocalStack for testing)
- ✅ JWT authentication with secure token management
- ✅ Complete data pipeline: Edge → Backend → Processing → Gallery

## Files Added/Modified

### Frontend Implementation
- src/app/gallery/page.tsx - Main gallery page with auth protection
- src/services/events.ts - API client for events with pagination
- src/hooks/use-events.ts - React Query hooks for infinite scroll
- src/components/gallery/ - Modular UI components (EventCard, GalleryGrid, States)
- src/contexts/query-provider.tsx - React Query configuration

### Testing Infrastructure
- docker-compose.test.yml - Complete test environment setup
- test-setup.sh - One-command test environment initialization
- test-data/seed-test-data.js - Automated test data generation
- e2e/gallery.spec.ts - Comprehensive E2E gallery tests
- test/integration.e2e-spec.ts - Full-stack workflow validation
- TESTING.md - Complete testing guide and documentation

### Project Configuration
- package.json (root) - Monorepo scripts and workspace management
- playwright.config.ts - E2E testing configuration
- .env.test - Test environment variables
- README.md - Project documentation

## Test Results 📊
- ✅ Unit Tests: 10/10 passing (Frontend components)
- ✅ Integration Tests: Full workflow validation
- ✅ E2E Tests: Complete user journey coverage
- ✅ Lint: No warnings or errors
- ✅ Build: Production ready (11.7kB gallery page)

## Milestone: Epic 1 "First Light" Achieved 🚀

The complete data flow is now validated:
1. User Authentication ✅
2. Device Registration ✅
3. Event Upload Pipeline ✅
4. Background Processing ✅
5. Gallery Display ✅

This establishes the foundation for all future development.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-31 18:49:48 +08:00

6.3 KiB
Raw Blame History

/validate-next-story Task

When this command is used, execute the following task:

Validate Next Story Task

Purpose

To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.

SEQUENTIAL Task Execution (Do not proceed until current Task is complete)

0. Load Core Configuration and Inputs

  • Load .bmad-core/core-config.yaml
  • If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
  • Extract key configurations: devStoryLocation, prd.*, architecture.*
  • Identify and load the following inputs:
    • Story file: The drafted story to validate (provided by user or discovered in devStoryLocation)
    • Parent epic: The epic containing this story's requirements
    • Architecture documents: Based on configuration (sharded or monolithic)
    • Story template: bmad-core/templates/story-tmpl.md for completeness validation

1. Template Completeness Validation

  • Load bmad-core/templates/story-tmpl.md and extract all section headings from the template
  • Missing sections check: Compare story sections against template sections to verify all required sections are present
  • Placeholder validation: Ensure no template placeholders remain unfilled (e.g., {{EpicNum}}, {{role}}, _TBD_)
  • Agent section verification: Confirm all sections from template exist for future agent use
  • Structure compliance: Verify story follows template structure and formatting

2. File Structure and Source Tree Validation

  • File paths clarity: Are new/existing files to be created/modified clearly specified?
  • Source tree relevance: Is relevant project structure included in Dev Notes?
  • Directory structure: Are new directories/components properly located according to project structure?
  • File creation sequence: Do tasks specify where files should be created in logical order?
  • Path accuracy: Are file paths consistent with project structure from architecture docs?

3. UI/Frontend Completeness Validation (if applicable)

  • Component specifications: Are UI components sufficiently detailed for implementation?
  • Styling/design guidance: Is visual implementation guidance clear?
  • User interaction flows: Are UX patterns and behaviors specified?
  • Responsive/accessibility: Are these considerations addressed if required?
  • Integration points: Are frontend-backend integration points clear?

4. Acceptance Criteria Satisfaction Assessment

  • AC coverage: Will all acceptance criteria be satisfied by the listed tasks?
  • AC testability: Are acceptance criteria measurable and verifiable?
  • Missing scenarios: Are edge cases or error conditions covered?
  • Success definition: Is "done" clearly defined for each AC?
  • Task-AC mapping: Are tasks properly linked to specific acceptance criteria?

5. Validation and Testing Instructions Review

  • Test approach clarity: Are testing methods clearly specified?
  • Test scenarios: Are key test cases identified?
  • Validation steps: Are acceptance criteria validation steps clear?
  • Testing tools/frameworks: Are required testing tools specified?
  • Test data requirements: Are test data needs identified?

6. Security Considerations Assessment (if applicable)

  • Security requirements: Are security needs identified and addressed?
  • Authentication/authorization: Are access controls specified?
  • Data protection: Are sensitive data handling requirements clear?
  • Vulnerability prevention: Are common security issues addressed?
  • Compliance requirements: Are regulatory/compliance needs addressed?

7. Tasks/Subtasks Sequence Validation

  • Logical order: Do tasks follow proper implementation sequence?
  • Dependencies: Are task dependencies clear and correct?
  • Granularity: Are tasks appropriately sized and actionable?
  • Completeness: Do tasks cover all requirements and acceptance criteria?
  • Blocking issues: Are there any tasks that would block others?

8. Anti-Hallucination Verification

  • Source verification: Every technical claim must be traceable to source documents
  • Architecture alignment: Dev Notes content matches architecture specifications
  • No invented details: Flag any technical decisions not supported by source documents
  • Reference accuracy: Verify all source references are correct and accessible
  • Fact checking: Cross-reference claims against epic and architecture documents

9. Dev Agent Implementation Readiness

  • Self-contained context: Can the story be implemented without reading external docs?
  • Clear instructions: Are implementation steps unambiguous?
  • Complete technical context: Are all required technical details present in Dev Notes?
  • Missing information: Identify any critical information gaps
  • Actionability: Are all tasks actionable by a development agent?

10. Generate Validation Report

Provide a structured validation report including:

Template Compliance Issues

  • Missing sections from story template
  • Unfilled placeholders or template variables
  • Structural formatting issues

Critical Issues (Must Fix - Story Blocked)

  • Missing essential information for implementation
  • Inaccurate or unverifiable technical claims
  • Incomplete acceptance criteria coverage
  • Missing required sections

Should-Fix Issues (Important Quality Improvements)

  • Unclear implementation guidance
  • Missing security considerations
  • Task sequencing problems
  • Incomplete testing instructions

Nice-to-Have Improvements (Optional Enhancements)

  • Additional context that would help implementation
  • Clarifications that would improve efficiency
  • Documentation improvements

Anti-Hallucination Findings

  • Unverifiable technical claims
  • Missing source references
  • Inconsistencies with architecture documents
  • Invented libraries, patterns, or standards

Final Assessment

  • GO: Story is ready for implementation
  • NO-GO: Story requires fixes before implementation
  • Implementation Readiness Score: 1-10 scale
  • Confidence Level: High/Medium/Low for successful implementation