52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
# Epic 8: Functional Debt
|
|
|
|
## Epic Goal
|
|
To address functional limitations and gaps in the system that prevent users from achieving specific business requirements, particularly around customization and control of content generation and linking behavior.
|
|
|
|
## Rationale
|
|
While the system provides automated content generation with sensible defaults, there are cases where users need explicit control over specific aspects (like anchor text terms) that don't fit the standard algorithmic approach. This epic addresses these functional gaps to provide the flexibility needed for real-world use cases.
|
|
|
|
## Status
|
|
- **Story 8.1**: 🔄 PLANNING (Job-Level Anchor Text Control)
|
|
|
|
## Stories
|
|
|
|
### Story 8.1: Job-Level Anchor Text Control for T1 and T2+
|
|
**Estimated Effort**: 2 story points
|
|
|
|
**As a user**, I want to explicitly specify anchor text terms in my job configuration for both Tier 1 and Tier 2+ links, so that I can include specific terms (like "high volume") that aren't covered by the standard algorithm.
|
|
|
|
**Acceptance Criteria**:
|
|
* Job JSON supports explicit anchor text configuration for both Tier 1 and Tier 2+
|
|
* Anchor text can be specified at job-level (applies to all tiers) or tier-level (tier-specific)
|
|
* When explicit anchor text is provided, it should be used in addition to or instead of algorithm-generated anchor text
|
|
* Support for multiple anchor text terms per tier
|
|
* Anchor text terms are used when injecting links (tiered links, homepage links, etc.)
|
|
* If explicit anchor text is provided, it takes precedence over algorithm-generated terms
|
|
* Backward compatible: existing jobs without explicit anchor text continue to work with current algorithm
|
|
|
|
**Technical Notes**:
|
|
* Extend `anchor_text_config` in job JSON to support explicit term lists
|
|
* Update `_get_anchor_texts_for_tier()` in `content_injection.py` to prioritize explicit terms
|
|
* Consider adding a new mode like "explicit" that uses only the provided terms, or extend "override" mode
|
|
* Document in `JOB_FIELD_REFERENCE.md` how to use explicit anchor text
|
|
|
|
**Example Job Configuration**:
|
|
```json
|
|
{
|
|
"jobs": [{
|
|
"project_id": 26,
|
|
"anchor_text_config": {
|
|
"mode": "explicit",
|
|
"tier1": ["high volume", "precision machining", "custom manufacturing"],
|
|
"tier2": ["high volume production", "bulk manufacturing", "large scale"]
|
|
},
|
|
"tiers": {
|
|
"tier1": {"count": 12},
|
|
"tier2": {"count": 38}
|
|
}
|
|
}]
|
|
}
|
|
```
|
|
|