plan(common): Update task list

Generated by: Planning Agent
Timestamp: 2025-11-21T23:31:24.905213+00:00
Component: common
This commit is contained in:
AI Agent 2025-11-21 23:31:24 +00:00
parent bbddbe6d15
commit 42c73a25b0

View file

@ -2,8 +2,207 @@
"project": "mnemo_cards_common",
"component": "common",
"version": "1.0",
"generated_at": null,
"generated_at": "2025-01-21T23:30:28.782543+00:00",
"generated_by": "planning_agent",
"tasks": []
"tasks": [
{
"id": "COMMON-001",
"title": "Write comprehensive README documentation",
"priority": "medium",
"status": "pending",
"estimated_hours": 2.0,
"description": "Replace the TODO template in README.md with comprehensive documentation. Include package description, features list, usage examples, and API documentation for main DTOs and utilities. Document the package structure and how to use it in other components.",
"acceptance_criteria": [
"README.md contains clear package description",
"All main features are documented with examples",
"Usage examples for DTOs and utilities are included",
"Package structure is explained",
"Getting started section is complete",
"No TODO placeholders remain"
],
"dependencies": [],
"files_to_modify": [
"mnemo_cards_common/README.md"
],
"component": "common"
},
{
"id": "COMMON-002",
"title": "Update CHANGELOG and LICENSE files",
"priority": "low",
"status": "pending",
"estimated_hours": 1.0,
"description": "Fill out the CHANGELOG.md with initial release information and add proper LICENSE file content. Use standard open-source license (MIT or Apache 2.0) based on project preferences.",
"acceptance_criteria": [
"CHANGELOG.md contains initial release entry",
"LICENSE file has proper license text",
"No TODO placeholders remain in either file",
"License matches project standards"
],
"dependencies": [],
"files_to_modify": [
"mnemo_cards_common/CHANGELOG.md",
"mnemo_cards_common/LICENSE"
],
"component": "common"
},
{
"id": "COMMON-003",
"title": "Create unit tests for utility functions",
"priority": "high",
"status": "pending",
"estimated_hours": 3.0,
"description": "Create comprehensive unit tests for utility functions in utils.dart, json_helper.dart, iterable_helper.dart, and token_generator.dart. Test all extension methods, edge cases, and error handling.",
"acceptance_criteria": [
"Test file created: test/utils/utils_test.dart",
"Test file created: test/utils/json_helper_test.dart",
"Test file created: test/utils/iterable_helper_test.dart",
"Test file created: test/utils/token_generator_test.dart",
"All extension methods have test coverage",
"Edge cases and error scenarios are tested",
"Test coverage >80% for utility functions",
"All tests pass"
],
"dependencies": [],
"files_to_modify": [
"mnemo_cards_common/test/utils/utils_test.dart",
"mnemo_cards_common/test/utils/json_helper_test.dart",
"mnemo_cards_common/test/utils/iterable_helper_test.dart",
"mnemo_cards_common/test/utils/token_generator_test.dart"
],
"component": "common"
},
{
"id": "COMMON-004",
"title": "Create unit tests for DTO serialization",
"priority": "high",
"status": "pending",
"estimated_hours": 4.0,
"description": "Create unit tests for critical DTOs to ensure proper JSON serialization/deserialization. Focus on UserDto, CardPackDto, GameDto, SubscriptionPlanDto, and PaymentDto. Test fromJson, toJson, edge cases, and null handling.",
"acceptance_criteria": [
"Test file created: test/dtos/user/user_dto_test.dart",
"Test file created: test/dtos/packs/card_pack_dto_test.dart",
"Test file created: test/dtos/games/game_dto_test.dart",
"Test file created: test/dtos/subscription/subscription_plan_dto_test.dart",
"Test file created: test/dtos/payment/payment_dto_test.dart",
"All DTOs test fromJson and toJson round-trip",
"Null handling is tested",
"Edge cases (empty lists, null values) are covered",
"Test coverage >80% for tested DTOs",
"All tests pass"
],
"dependencies": [],
"files_to_modify": [
"mnemo_cards_common/test/dtos/user/user_dto_test.dart",
"mnemo_cards_common/test/dtos/packs/card_pack_dto_test.dart",
"mnemo_cards_common/test/dtos/games/game_dto_test.dart",
"mnemo_cards_common/test/dtos/subscription/subscription_plan_dto_test.dart",
"mnemo_cards_common/test/dtos/payment/payment_dto_test.dart"
],
"component": "common"
},
{
"id": "COMMON-005",
"title": "Add validation methods to critical DTOs",
"priority": "medium",
"status": "pending",
"estimated_hours": 3.0,
"description": "Add validation methods to critical DTOs (UserDto, CardPackDto, PaymentDto, SubscriptionPlanDto) to ensure data integrity. Create isValid() methods that check required fields, ranges, and business rules.",
"acceptance_criteria": [
"UserDto has isValid() method",
"CardPackDto has isValid() method",
"PaymentDto has isValid() method",
"SubscriptionPlanDto has isValid() method",
"Validation methods check required fields",
"Validation methods check value ranges where applicable",
"Unit tests created for all validation methods",
"All validation tests pass"
],
"dependencies": ["COMMON-004"],
"files_to_modify": [
"mnemo_cards_common/lib/src/dtos/user/user_dto.dart",
"mnemo_cards_common/lib/src/dtos/packs/card_pack_dto.dart",
"mnemo_cards_common/lib/src/dtos/payment/payment_dto.dart",
"mnemo_cards_common/lib/src/dtos/subscription/subscription_plan_dto.dart",
"mnemo_cards_common/test/dtos/user/user_dto_test.dart",
"mnemo_cards_common/test/dtos/packs/card_pack_dto_test.dart",
"mnemo_cards_common/test/dtos/payment/payment_dto_test.dart",
"mnemo_cards_common/test/dtos/subscription/subscription_plan_dto_test.dart"
],
"component": "common"
},
{
"id": "COMMON-006",
"title": "Create unit tests for deep link parsing",
"priority": "medium",
"status": "pending",
"estimated_hours": 2.5,
"description": "Create unit tests for deep link classes (deeplink.dart, product_for_ad.dart, purchase_check.dart, purchase_init.dart, subscription_open.dart) to ensure proper parsing and validation of deep link URLs.",
"acceptance_criteria": [
"Test file created: test/deeplinks/deeplink_test.dart",
"Test file created: test/deeplinks/product_for_ad_test.dart",
"Test file created: test/deeplinks/purchase_check_test.dart",
"Test file created: test/deeplinks/purchase_init_test.dart",
"Test file created: test/deeplinks/subscription_open_test.dart",
"All deep link parsing scenarios are tested",
"Invalid URL handling is tested",
"Test coverage >80% for deep link classes",
"All tests pass"
],
"dependencies": [],
"files_to_modify": [
"mnemo_cards_common/test/deeplinks/deeplink_test.dart",
"mnemo_cards_common/test/deeplinks/product_for_ad_test.dart",
"mnemo_cards_common/test/deeplinks/purchase_check_test.dart",
"mnemo_cards_common/test/deeplinks/purchase_init_test.dart",
"mnemo_cards_common/test/deeplinks/subscription_open_test.dart"
],
"component": "common"
},
{
"id": "COMMON-007",
"title": "Add test coverage configuration and CI setup",
"priority": "low",
"status": "pending",
"estimated_hours": 2.0,
"description": "Set up test coverage reporting and ensure tests can be run in CI. Add test configuration, coverage thresholds, and documentation on how to run tests. Update pubspec.yaml if needed for test dependencies.",
"acceptance_criteria": [
"Test coverage can be generated and viewed",
"Coverage threshold is set (minimum 70%)",
"Instructions for running tests are in README",
"CI configuration supports running tests",
"All existing tests pass in CI environment"
],
"dependencies": ["COMMON-003", "COMMON-004", "COMMON-006"],
"files_to_modify": [
"mnemo_cards_common/pubspec.yaml",
"mnemo_cards_common/README.md"
],
"component": "common"
},
{
"id": "COMMON-008",
"title": "Review and improve DTO field documentation",
"priority": "low",
"status": "pending",
"estimated_hours": 2.0,
"description": "Add comprehensive documentation comments to DTO classes and their fields. Use Dart doc comments to explain purpose, constraints, and usage examples. Focus on public-facing DTOs used by other components.",
"acceptance_criteria": [
"All public DTO classes have class-level documentation",
"All public fields have field-level documentation",
"Documentation explains purpose and constraints",
"Usage examples are included where helpful",
"Documentation follows Dart style guide"
],
"dependencies": ["COMMON-001"],
"files_to_modify": [
"mnemo_cards_common/lib/src/dtos/user/user_dto.dart",
"mnemo_cards_common/lib/src/dtos/packs/card_pack_dto.dart",
"mnemo_cards_common/lib/src/dtos/games/game_dto.dart",
"mnemo_cards_common/lib/src/dtos/subscription/subscription_plan_dto.dart",
"mnemo_cards_common/lib/src/dtos/payment/payment_dto.dart"
],
"component": "common"
}
]
}