Prepare project for pipeline takeover: task tracker, UX doc, CLAUDE.md pointers

Adds docs/tasks/ (16 epics + 102 stories converted to task/subtask files with
statuses.md as the new status source of truth) and docs/ux-design.md
(retrospective design-system reference), and points CLAUDE.md at them.
docs/prd.md and docs/architecture.md are kept as BMAD wrote them; the legacy
docs/stories/, docs/epics/, docs/qa/gates/ and .bmad-core/ stay in place as
historical/traceability records, superseded but not deleted.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Naser Mansour
2026-09-27 22:02:23 +03:00
parent 147231f216
commit 0f9d12c3cf
121 changed files with 3628 additions and 1 deletions
+52
View File
@@ -0,0 +1,52 @@
---
id: 6-7
title: 6-7 Monthly Statistics Report
status: QA Review
date: 2026-09-27
parent: 6
---
## Description
As an admin, I want to generate comprehensive monthly PDF reports from the admin dashboard, So that I can archive business performance records, share summaries with stakeholders, and track month-over-month trends. Full implementation history: docs/stories/story-6.7-monthly-statistics-report.md
## Acceptance Criteria
- [ ] "Generate Monthly Report" button in admin dashboard (below metrics cards or in a Reports section)
- [ ] Month/year selector dropdown (default: previous month)
- [ ] Selectable range: last 12 months only (no future months)
- [ ] Libra logo and branding
- [ ] Report title: "Monthly Statistics Report"
- [ ] Period: Month and Year (e.g., "December 2025")
- [ ] Generated date and time
- [ ] List of sections with page numbers
- [ ] Non-clickable (simple text list for print compatibility)
- [ ] Key highlights (2-3 bullet points)
- [ ] Month-over-month comparison if prior month data exists
- [ ] New clients registered this month
- [ ] Total active clients (end of month)
- [ ] Individual vs company breakdown
- [ ] Client growth trend (compared to previous month)
- [ ] Total consultations this month
- [ ] Approved/Completed/Cancelled/No-show breakdown
- [ ] Free vs paid ratio
- [ ] No-show rate percentage
- [ ] Pie chart: Consultation types (rendered as image)
- [ ] Active timelines (end of month)
- [ ] New timelines created this month
- [ ] Timeline updates added this month
- [ ] Archived timelines this month
- [ ] Posts published this month
- [ ] Total published posts (cumulative)
- [ ] Line chart showing monthly consultations trend (last 6 months ending with selected month)
- [ ] Rendered as base64 PNG image
- [ ] Professional A4 portrait layout
- [ ] Libra branding: Navy Blue (#0A1F44) headers, Gold (#D4AF37) accents
- [ ] Consistent typography and spacing
- [ ] Print-friendly (no dark backgrounds, adequate margins)
- [ ] Bilingual: Arabic or English based on admin's `preferred_language` setting
- [ ] Loading indicator with "Generating report..." message during PDF creation
- [ ] Disable generate button while processing
- [ ] Auto-download PDF on completion
- [ ] Success toast notification after download starts
- [ ] Error handling with user-friendly message if generation fails