Repository navigation
Review project epics and documentation structure - #15
Merged
CoderMariusz merged 20 commits intoDec 3, 2025
Merged
Conversation
- Create epic-03-tech-spec.md with Conveyor System, Filtering, Splitter - Create epic-04-tech-spec.md with Offline Production, Welcome Back modal - Copy epic-05-tech-spec.md to epics folder with UI references - Clean Epic 2 SYSTEMS.md - keep only NPC Trading, Grid Expansion - Update Epic 2 INDEX.md with cross-references to other epics This reorganization ensures each epic contains only its own systems, making it easier to implement stories per-epic without scope confusion.
- Move Conveyor Transport System from Epic 2 to Epic 3 - Move Offline Production from Epic 2 to Epic 4 - Archive old epic-contexts/ files to 5-ARCHIVE/ - Archive duplicate tech-specs to 5-ARCHIVE/sprint-artifacts-old/ - Create epic-02-tech-spec.md as index to detailed specs - Copy epic-08-tech-spec.md to epics/ folder - Update epic-02-stories.md: - AC6 now only has Conveyor building definition - Full transport mechanics reference Epic 3 - Updated Success Metrics and Implementation Notes - Clear scope boundaries between epics: - Epic 2: Tier 1 Economy (resources, buildings def, NPC, grid) - Epic 3: Automation (conveyor transport, filtering, splitter) - Epic 4: Offline Production (80% efficiency, welcome back)
7 stories totaling 42 SP: - STORY-03.1: A* Pathfinding System (5 SP) - STORY-03.2: Conveyor Transport Mechanics (8 SP) - STORY-03.3: Filtering System (5 SP) - STORY-03.4: Splitter System (5 SP) - STORY-03.5: Conveyor UI & Creation Flow (8 SP) - STORY-03.6: Storage Integration & Networks (6 SP) - STORY-03.7: Integration Testing & Performance (5 SP) Based on epic-03-tech-spec.md with detailed acceptance criteria, implementation notes, and dependency mapping.
6 stories totaling 26 SP: - STORY-04.1: Offline Production Calculator (6 SP) - STORY-04.2: Tier 2 Chain Simulation (6 SP) - STORY-04.3: Welcome-Back Modal UI (5 SP) - STORY-04.4: Rewarded Video Ad Integration (4 SP) - STORY-04.5: Time Validation & Anti-Cheat (3 SP) - STORY-04.6: Integration Testing & Persistence (2 SP) Key features: - 80% offline efficiency formula - Topological sort for conveyor chains - Animated gold counter and coin rain - AdMob rewarded video integration - Server timestamp anti-cheat
7 stories totaling 29 SP: - STORY-05.1: Touch Controls System (5 SP) - STORY-05.2: Camera System (5 SP) - STORY-05.3: Haptic Feedback System (2 SP) - STORY-05.4: Performance Optimization (6 SP) - STORY-05.5: One-Handed UI Layout (4 SP) - STORY-05.6: Animation System (4 SP) - STORY-05.7: Accessibility Features (3 SP) Key features: - Touch-first design (tap, swipe, pinch, double-tap) - 60 FPS target with sprite batching and culling - Haptic feedback patterns (light/medium/heavy) - One-handed UI with thumb-reachable zones - WCAG AAA accessibility (7:1 contrast, colorblind modes)
7 stories totaling 23 SP: - STORY-08.1: IAP Product Catalog & Domain (2 SP) - STORY-08.2: Purchase Manager & Cap Enforcement (4 SP) - STORY-08.3: Platform IAP Integration (5 SP) - STORY-08.4: Receipt Validation & Cloud Functions (4 SP) - STORY-08.5: Rewarded Video Ads (3 SP) - STORY-08.6: Shop UI (3 SP) - STORY-08.7: Analytics & Integration Testing (2 SP) Key features: - $10 lifetime spending cap (ethical protection) - 5 IAP products with "Best Value" badge - Google Play Billing & Apple StoreKit integration - Server-side receipt validation (fraud prevention) - Rewarded video ads with 6/day cap - Ethical fallbacks (ad failure = reward granted)
Epic 6 (28 SP) - 6 stories: - STORY-06.1: Tier 2 Unlock Requirements (5 SP) - STORY-06.2: Progression Tracker UI (4 SP) - STORY-06.3: Tier 2 Unlock Celebration (5 SP) - STORY-06.4: Achievement System (5 SP) - STORY-06.5: Extended Skill System (6 SP) - STORY-06.6: Achievements Screen (3 SP) Key features: - Tier 2 unlock gate: 5 types + 10 buildings + 500 gold - Always-visible progression tracker widget - Full-screen celebration with fireworks/confetti - 7 Tier 1 achievements with notifications - Extended skill trees (Mining, Smelting, Trading, Crafting, Automation) - Skill points earned through milestones and achievements
Epic 7 (21 SP) - 5 stories: - STORY-07.1: Tutorial State Machine (5 SP) - STORY-07.2: Tooltip System (5 SP) - STORY-07.3: First-Time User Experience (5 SP) - STORY-07.4: Tutorial Analytics Tracking (3 SP) - STORY-07.5: Skip Tutorial Option (3 SP) Key features: - Event-driven state machine (7 states) - "Show don't tell" approach - Contextual tooltips with arrows - FTUE flow: 3-5 minutes - Firebase Analytics funnel tracking - Skip option with confirmation
- Epic 9: Firebase Backend (24 SP, 6 stories) - Auth flow, Cloud Save, Offline-First, Security Rules, Cloud Functions, Cost Monitoring - Epic 10: Analytics & Metrics (13 SP, 4 stories) - Firebase Analytics, D7 Retention, Tier 2 Metrics, Custom Events - Epic 11: Testing & Quality (20 SP, 8 stories) - Unit Tests, Data Tests, Widget Tests, Integration, Performance, E2E, CI/CD, Manual QA
- Created epic-01-tech-spec.md with architecture details - Created epic-01-stories.md with 8 stories (34 SP) - Compared planned vs implemented features - Documented known bugs: - Bug #1: Integration test parameter name (HIGH) - Bug #2: addResource() logic broken (CRITICAL) - Bug #8: Type cast precedence (MEDIUM) - Status: 6/8 stories done, 3 bugs to fix
Bug #2 (CRITICAL) - player_economy.dart: - addResource() now creates new Resource when not in inventory - Added _capitalizeResourceName() helper for display names Bug #1 (HIGH) - integration_test: - Changed parameter from 'buildingId' to 'building' in all 4 locations - Fixed variable references after upgrade Bug #8 (MEDIUM) - main.dart: - Fixed type cast precedence: (metrics['cullRate'] as double) * 100 Updated documentation to reflect fixed status.
- Add Epic 00 (Project Setup) tech-spec and stories (13 SP) - Create MVP-SPRINT-PLAN.md with 11 sprint timeline (299 SP total) - Unify BuildingType enum to 6 types: mining, storage, smelter, conveyor, workshop, farm - Update all code and tests to use new BuildingType values - Make Cloud Functions REQUIRED in EPIC-09 (time validation, receipt validation) - Add Cloud Functions architecture documentation - Create Cross-Epic Integration Guide for system dependencies - Update Epic 08 with standard header format - Fix player_economy_test.dart to expect new addResource behavior - Fix collect_resources_test.dart for new resource creation
- Update BuildingType values to new enum (mining, storage, smelter, etc.) - Mark STORY-01.2 as DONE with fixed addResource() code - Mark STORY-01.8 as DONE (integration test compiles) - Update dependencies graph with correct status symbols - Add 6 BuildingTypes documentation in STORY-01.1
- Updated STORY-01.6 status from⚠️ TODO to ✅ Done (→ EPIC-05) - Added moveTo() animation to EPIC-05 STORY-05.2 acceptance criteria - Updated Fix Priority sections in both tech-spec and stories - Deferred low-priority polish work to Mobile UX epic
- Added Story Overview table to epic-02-stories.md - Fixed resource count: 7 → 8 Tier 1 resources - Fixed Wata translation: Salt → Cotton (correct Polish) - Fixed Sól translation: Brine → Salt - Added note clarifying grid relationship (EPIC-01 50×50 vs EPIC-02 20×20-40×40) - Updated Cross-Epic Integration Guide with 8 resources
- Add Story Overview Table with 7 stories (42 SP) - Fix Sprint reference: 3-4 → 4-5 (correct per MVP plan) - Fix UI flow cost: 45 gold → 18 Drewno + 9 Żelazo (resource-based) - Fix travel time: 9 seconds → 18 seconds (0.5 items/sec = 2s/tile)
- Add Story Overview Table with 6 stories (26 SP) - Fix Sprint reference: 4-5 → 6-7 (correct per MVP plan) - Fix Implementation Order section Sprint reference
- Add Story Overview Table with 7 stories (29 SP) - Fix Sprint reference: 6-7 → 8 (shared with EPIC-08 per MVP plan) - Update Implementation Order section
- Add Story Overview Table with 7 stories (23 SP) - Fix Sprint reference: tech-spec said "Sprint 10" → "Sprint 8 (shared with EPIC-05)"
Epic 06 (Progression): - Add Story Overview Table with 6 stories (28 SP) - Fix Sprint reference: 5-6 → 9 (post-MVP, blocks EPIC-03) Epic 07 (Tutorial): - Add Story Overview Table with 5 stories (21 SP) - Fix Sprint reference: 7 → 10 (post-MVP, after EPIC-06) Epic 10 (Analytics): - Fix Sprint reference: 8 → 11 (post-MVP) Epic 11 (Testing): - Fix Sprint reference: 8 → 11 (post-MVP)
CoderMariusz
deleted the
claude/review-project-epics-012Ssgqq17CKnVsjR3YNc7z6
branch
December 4, 2025 09:32
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.