sonpx/loyalty-agent-service
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4534e4ecb823a5f2f82413604a12794e6af80ba1
loyalty-agent-service/docs/specs/00_MIGRATION_TRACKER.md

3.3 KiB
Raw Blame History

Migration Tracker: FSD to OpenSpec

Objective

Convert docs/FSD P1_Finnal Version.docx to a structured, modular Knowledge Base based on the OpenSpec format.

Stages

  • Step 1: Convert .docx to HTML using Python (mammoth), then to Markdown (markdownify) to preserve tables and structure. (Script: convert_fsd.py)
  • Step 2: Generate the Master Markdown file (docs/FSD_Master_Clean.md).
  • Step 3: Analyze the Master Markdown file to extract domains (e.g., Campaign, Customer, OneAccess).
  • Step 4: Split the content into modular OpenSpec Markdown files under docs/specs/, clean up heavy image tags, and apply standard headings.
  • Step 5: Finalize migration and generate report (docs/specs/00_MIGRATION_REPORT.md), remove temporary files.

Extracted Domains

  1. overview.md (Overview)
  2. scope_and_assumption.md (Scope & Assumption)
  3. one_access.md (OneAccess)
  4. one_loyalty.md (OneLoyalty / Campaign)
  5. customer_management.md (Customer Management)
  6. one_marketing.md (OneMarketing)
  7. one_catalogue.md (OneCatalogue)
  8. one_targeting.md (OneTargeting)

Decomposed and Verified

  • onetargeting.md -> onetargeting/segmentation.md, onetargeting/audience_upload.md, onetargeting/customer_audience.md
  • application_parameter.md -> system_management/application_parameter.md
  • introduction.md -> introduction/terminology.md
  • reference.md -> reference/change_history.md, reference/document_references.md
  • oneaccess.md -> oneaccess/user_group.md, oneaccess/permission_management.md, oneaccess/user_profile.md
  • oneadmin.md -> oneadmin/framework_behavior.md
  • onecatalogue.md -> onecatalogue/catalogue.md, onecatalogue/category.md, onecatalogue/item_master.md, onecatalogue/item_price.md, onecatalogue/voucher_code.md
  • onemarketing.md -> onemarketing/marketing_message.md, onemarketing/marketing_campaign.md, onemarketing/frequency_capping.md, onemarketing/ab_testing.md, onemarketing/blacklist.md, onemarketing/whitelist.md
  • customer_management.md -> customer_management/customer_profile.md, customer_management/customer_360.md, customer_management/account.md, customer_management/card.md, customer_management/pool_balance_detail.md, customer_management/transaction_history.md, customer_management/no_hit_cp_transaction.md, customer_management/statement.md, customer_management/attribute.md, customer_management/counter.md, customer_management/adjustment.md, customer_management/transfer_balance.md, customer_management/re_instatement.md, customer_management/item_redemption.md, customer_management/award_transaction.md
  • reward_campaign_management.md -> reward_campaign/campaign_structure.md, reward_campaign/external_transaction_code.md, reward_campaign/ols_transaction_code.md, reward_campaign/pool_definition.md, reward_campaign/counter_definition.md, reward_campaign/transaction_category.md, reward_campaign/account_type_group.md, reward_campaign/reward_campaign.md, reward_campaign/reward_campaign_rule.md, reward_campaign/campaign_rule_criteria.md, reward_campaign/campaign_rule_formula.md, reward_campaign/campaign_rule_contributor.md, reward_campaign/cep_rule.md, reward_campaign/rep_rule.md, reward_campaign/item_redemption_rule.md, reward_campaign/campaign_insight.md 1