Skip to main content

ADR-002: Separate FonTelePay

ADR-002: Separate FontelePay from Drop Repository

Status: Accepted Date: 2026-02-12 Deciders: John (AI Director) Category: Architecture


Context

FontelePay is an earlier iteration of the payment concept that predates the Drop rebrand. It resided at src/fontelepay/ inside the Drop product directory with:

  • Its own .git/ repository with independent commit history
  • Its own node_modules/ (527 entries)
  • Its own .claude/ configuration directory
  • Separate documentation, R&D research, and project structure
  • Multiple subdirectories: frontend, backend, mobile, AI, infrastructure, security, marketing, sales, support, legal, design, rnd, team

This created several problems:

Problem Impact
Project confusion Developers could not distinguish "Drop source" from "FontelePay source"
Git conflicts Nested .git/ directory caused submodule-like behavior without proper configuration
Build interference FontelePay's node_modules/ could interfere with Drop's build process
Size bloat FontelePay's 527 dependency packages inflated the Drop directory
graph TB
    subgraph before["Before: Nested Repository"]
        drop_dir["Drop/"]
        drop_dir --> src["src/"]
        src --> drop_app["drop-app/ (Drop)"]
        src --> fp["fontelepay/ (FontelePay)"]
        fp --> fp_git[".git/ (separate repo)"]
        fp --> fp_nm["node_modules/ (527 pkgs)"]
        fp --> fp_claude[".claude/"]
        fp --> fp_rnd["rnd/ (market research)"]
    end

    subgraph after["After: Clean Separation"]
        products["ALAI/products/"]
        products --> drop_clean["Drop/<br/>Clean codebase"]
        products --> fp_separate["FontelePay/<br/>Preserved independently"]
    end

    before -->|"ADR-002"| after

Decision

Move FontelePay out of the Drop directory to its own location:

  1. Move src/fontelepay/ to ~/ALAI/products/FontelePay/ (or archive)
  2. Preserve FontelePay's git history by keeping its .git/ intact during move
  3. Keep only a reference document in Drop pointing to FontelePay's new location
  4. Copy relevant research documents (particularly rnd/mobilebank-research/) to Drop's rnd/ directory if directly relevant

Consequences

Positive

  • Clean Drop directory with only Drop-related source code
  • No nested git repository confusion
  • Smaller directory footprint for Drop
  • Clear project boundaries for all developers and AI agents
  • FontelePay research preserved independently for future reference

Negative

  • Any scripts or references pointing to src/fontelepay/ paths break
  • Need to verify no Drop code depends on FontelePay modules
  • Historical context of FontelePay as Drop's predecessor may be lost if not documented

Risks

  • Reference breakage: Scripts or docs pointing to old FontelePay path. Mitigation: search-and-replace across codebase during migration.
  • Lost context: FontelePay's role as Drop's predecessor forgotten. Mitigation: this ADR documents the relationship.

References