This commit is contained in:
2026-03-14 12:47:21 -04:00
parent aa7bf61df6
commit 588860e66a
109 changed files with 3945 additions and 6217 deletions

View File

@@ -1,99 +0,0 @@
# AudiobookPipeline Web Platform - Atomic Facts
- id: fact-001
type: project_status
content: Architecture plan complete for web platform conversion
created_at: 2026-03-08T20:02:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-002
type: technical_stack
content: "Tech stack: SolidStart + Turso (libSQL) + S3 + Redis + Clerk auth + Stripe billing"
created_at: 2026-03-08T20:02:00Z
access_count: 3
last_accessed: 2026-03-09T00:54:00Z
- id: fact-003
type: pricing
content: "Pricing tiers: $39/mo (10 hours, character voices, priority queue), $79/mo (unlimited, highest priority, API access)"
created_at: 2026-03-08T18:47:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-004
type: infrastructure_cost
content: "Monthly infrastructure cost: ~$639 (Vercel $20, Turso $29, S3 $23, GPU workers $548, Redis $9, Monitoring $10)"
created_at: 2026-03-08T20:02:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-005
type: timeline
content: "4-week MVP timeline: Week 1-2 Foundation, Week 2-3 Pipeline Integration, Week 3-4 UX + Billing"
created_at: 2026-03-08T20:02:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-006
type: implementation_issues
content: "14 implementation issues created (FRE-37 to FRE-50) covering all components of web platform"
created_at: 2026-03-09T00:54:00Z
access_count: 1
last_accessed: 2026-03-09T00:54:00Z
- id: fact-007
type: database_schema
content: "Database schema: users (id, email, subscription_status, credits), jobs (id, user_id, status, progress), files (id, user_id, s3_key), usage_events (id, user_id, job_id, minutes_generated, cost)"
created_at: 2026-03-08T20:02:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-008
type: cost_economics
content: "Unit economics: $0.15/min GPU cost, $0.39/min billed rate, 62% gross margin"
created_at: 2026-03-08T20:02:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-009
type: market
content: "Target market: 10k-50k indie authors, Revenue projection: $234k ARR Year 1, $936k ARR Year 2"
created_at: 2026-03-08T18:47:00Z
access_count: 2
last_accessed: 2026-03-09T00:54:00Z
- id: fact-010
type: competitive_advantage
content: "Competitive advantages: Character voice differentiation, genre-aware narration, self-hosted option, one-time CLI tool + optional cloud service"
created_at: 2026-03-08T18:47:00Z
access_count: 1
last_accessed: 2026-03-09T00:54:00Z
- id: fact-011
type: infrastructure_status
content: "Redis deployed locally in Docker container (redis:alpine) at redis://localhost:6379 for job queue management"
created_at: 2026-03-10T11:03:00Z
access_count: 1
last_accessed: 2026-03-10T11:03:00Z
- id: fact-012
type: infrastructure_constraint
content: "No local GPU available - GPU testing deferred to external/cloud machines. Local testing uses mocked GPU operations."
created_at: 2026-03-10T11:03:00Z
access_count: 1
last_accessed: 2026-03-10T11:03:00Z
- id: fact-013
type: infrastructure_documentation
content: "Infrastructure documentation created at /home/mike/code/AudiobookPipeline/INFRASTRUCTURE.md - documents hybrid approach, testing strategy, and cost estimates"
created_at: 2026-03-10T11:03:00Z
access_count: 1
last_accessed: 2026-03-10T11:03:00Z
- id: fact-014
type: blocker_resolution
content: "FRE-128 completed - Infrastructure blockers resolved. Redis available locally. FRE-41 and FRE-43 unblocked with modified testing approach (GPU testing deferred)."
created_at: 2026-03-10T11:03:00Z
access_count: 1
last_accessed: 2026-03-10T11:03:00Z

View File

@@ -1,64 +0,0 @@
# AudiobookPipeline Web Platform
## Overview
Commercial web application for AudiobookPipeline - converting eBooks to audiobooks with AI-generated character voices.
## Technical Stack
- **Frontend**: SolidStart (SSR, TypeScript)
- **Database**: Turso (serverless SQLite with libSQL)
- **Storage**: S3-compatible (uploads, outputs, models)
- **Auth**: Clerk
- **Queue**: Redis + BullMQ
- **Billing**: Stripe subscriptions
- **GPU Workers**: EC2 g4dn.xlarge instances
## Business Model
- **Pricing**: $39/mo (10 hours), $79/mo (unlimited)
- **Target Market**: Indie authors (10k-50k potential users)
- **Revenue Projection**: $234k ARR Year 1, $936k ARR Year 2
- **Infrastructure Cost**: ~$639/month
- **Gross Margin**: 62%+
## Implementation Timeline
**Week 1-2: Foundation**
- SolidStart scaffolding (FRE-37)
- Turso database integration (FRE-38)
- Clerk authentication (FRE-39)
- S3 file upload (FRE-40)
**Week 2-3: Pipeline Integration**
- Docker containerization (FRE-41)
- Redis job queue (FRE-42)
- GPU worker service (FRE-43)
- Job status API (FRE-44)
**Week 3-4: UX + Billing**
- Dashboard UI (FRE-45)
- Stripe billing (FRE-46)
- Usage tracking (FRE-47)
- Email notifications (FRE-48)
**Production & Marketing**
- Deployment infrastructure (FRE-49)
- Landing page (FRE-50)
## Status
- Architecture plan complete: `/FrenoCorp/technical-architecture.md`
- 14 implementation issues created (FRE-37 to FRE-50)
- **Infrastructure Progress (2026-03-10)**:
- ✅ Redis deployed locally in Docker
- ⚠️ No local GPU available - testing deferred to external machines
- 📋 Infrastructure documentation: `/home/mike/code/AudiobookPipeline/INFRASTRUCTURE.md`
- FRE-41 and FRE-43 unblocked with modified testing approach
- Ready for assignment to engineering team
## Related
- Parent issue: FRE-7 (Explore commercial potential)
- Codebase: `/home/mike/code/AudiobookPipeline`
- Team: Atlas (Founding Engineer), Hermes (Junior), Pan (Intern)

View File

@@ -1,239 +0,0 @@
- id: life-and-lineage-tech-stack
type: fact
category: technical
content:
project: Life-and-Lineage
framework: React Native with Expo v55
state_management: MobX with mobx-react-lite
navigation: expo-router (file-based routing)
storage: MMKV with Flatted serialization
iap: RevenueCat (react-native-purchases)
auth: Google Sign-In, Apple Authentication
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-revenue-gap
type: metric
category: business
content:
current_mrr: $5-10
target_mrr: $5,000
gap_multiplier: 500x
target_users: 10,000 MAU
target_conversion: 5%
target_arppu: $10
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: FRE-53
- id: life-and-lineage-pvp-status
type: status
category: feature
content:
feature: PvP Battle System
completion: 70%
status: partially_implemented
blockers:
- Battle initiation disabled in production (playerCanEngageInPvP returns false)
- Blood Token economy not connected
- Rewards not delivered
foundation: PVPStore, AIPlayerCharacter entity, UI exist
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-dungeon-status
type: status
category: content
content:
total_dungeons: 17
complete: 8
incomplete: 9
encounter_types:
- camps (rest)
- chests (loot/mimics)
- ritual_altars
- water_basins
progression: linear
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-npc-system
type: status
category: feature
content:
relationship_scale: -100 to +100
relationship_types:
- parents
- partners
- children
- friends
- enemies
- acquaintances
features:
- dating/marriage
- pregnancy/birth
- adoption (15% gold or 25k minimum)
- chat interaction
limitations:
- gift_giving: dev_mode_only
- no_quest_giving
- limited_interactions
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-entity-hierarchy
type: architecture
category: technical
content:
base: Being
hierarchy:
- type: Character
description: NPCs with relationships
subclass: PlayerCharacter (player with skills, inventory, spells)
- type: Creature
description: monsters
subclasses:
- Enemy (dungeon enemies)
- Minion (summons/pets)
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-core-stores
type: architecture
category: technical
content:
stores:
- name: RootStore
purpose: Game ticks, death/birth checks, old age debuffs
- name: CharacterStore
purpose: NPCs, children, adoption
- name: DungeonStore
purpose: Instances, levels, combat, map generation
- name: PVPStore
purpose: Opponents, tokens, battle results
- name: IAPStore
purpose: RevenueCat integration, class unlocks, stash tabs
- name: TimeStore
purpose: Game time (52 weeks/year), seasons, dates
- name: EnemyStore
purpose: Active enemies in combat
- name: ShopsStore
purpose: Shop inventories, shopkeeper affection
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-engagement-plan
type: plan
category: project
content:
issue: FRE-53
sub_issues:
- FRE-61: Complete PvP Battle System (high priority)
- FRE-62: Create Radiant Quest System (high priority)
- FRE-63: Enhance NPC Relationship Depth (high priority)
- FRE-64: Implement Character Age-Gated Activities (high priority)
- FRE-65: Build Comprehensive Education System (high priority)
- FRE-66: Expand Life Simulation Features (medium priority)
- FRE-67: Expand Dungeon Content and Variance (medium priority)
- FRE-68: Enhance Early Game Onboarding (high priority)
- FRE-69: Optimize IAP Monetization for $5K MRR (high priority)
phases:
- phase: 1
sprints: 1-2
focus: PvP + Early Game Onboarding
- phase: 2
sprints: 3-4
focus: Radiant Quests + NPC Relationships
- phase: 3
sprints: 5-6
focus: Age-Gated Activities + Education
- phase: 4
sprints: 7-8
focus: Life Sim + Dungeon Expansion
- phase: ongoing
focus: IAP Optimization
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: FRE-53_plan_creation
- id: life-and-lineage-missing-systems
type: gap_analysis
category: technical
content:
missing:
- system: Quest Store
status: non_existent
impact: high
- system: Quest Entity
status: non_existent
impact: high
- system: Objective Tracking
status: non_existent
impact: high
- system: Education Gameplay
status: placeholder_only
impact: medium
- system: Age-Gated Content
status: minimal
impact: high
- system: Childhood Activities
status: non_existent
impact: medium
- system: University System
status: referenced_only
impact: medium
technical_debt: low
architecture: extensible
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration
- id: life-and-lineage-iap-products
type: inventory
category: monetization
content:
current_products:
- name: Ranger Class
unlocks: Ranger class + Remote Saves
- name: Necromancer Class
unlocks: Necromancer + Remote Saves
- name: Dual Class Bundle
unlocks: Both classes + Remote Saves
- name: Remote Saves
unlocks: Cloud save functionality
- name: Stash Tabs
unlocks: 4 additional inventory tabs per purchase
features:
- offline_validation (14-day token expiry)
- device_specific_tokens
- purchase_restoration
- customer_info_evaluation
metadata:
created_at: 2026-03-09
access_count: 1
last_accessed: 2026-03-09
source: codebase_exploration

View File

@@ -1,105 +0,0 @@
# Life-and-Lineage
React Native mobile game combining RPG dungeon crawling with life simulation and lineage mechanics.
## Project Overview
- **Type**: Mobile game (React Native + Expo)
- **Platform**: iOS/Android
- **Tech Stack**: React Native, Expo, MobX, RevenueCat
- **Location**: `/home/mike/code/Life-and-Lineage`
- **Paperclip Project**: FRE - Lineage (game) [1fbae108-9318-4b6c-9ef1-aa077ed782fe]
## Current State (March 2026)
### Revenue
- **Current MRR**: $5-10
- **Target MRR**: $5,000
- **Gap**: 500x increase needed
### Feature Implementation Status
- **PvP System**: 70% complete (disabled in production)
- **Dungeons**: 17 defined (8 complete, 9 incomplete)
- **NPC Relationships**: Basic affection system, limited interactions
- **Quest System**: Non-existent
- **Education System**: Placeholder only
- **Life Simulation**: Minimal (jobs, basic activities)
- **Age System**: Exists but no age-gated content
### Architecture
- **State Management**: MobX with mobx-react-lite
- **Navigation**: expo-router (file-based)
- **Storage**: MMKV with Flatted serialization
- **IAP**: RevenueCat integration
- **Auth**: Google Sign-In, Apple Authentication
## Engagement Improvement Plan (FRE-53)
9 sub-issues created for increasing engagement and reaching $5K MRR:
### Phase 1: Foundation
1. FRE-61: Complete PvP Battle System
2. FRE-68: Enhance Early Game Onboarding
3. FRE-62: Create Radiant Quest System
### Phase 2: Social & Life Sim
4. FRE-63: Enhance NPC Relationship Depth
5. FRE-64: Implement Character Age-Gated Activities
6. FRE-65: Build Comprehensive Education System
### Phase 3: Content
7. FRE-66: Expand Life Simulation Features
8. FRE-67: Expand Dungeon Content and Variance
### Phase 4: Monetization
9. FRE-69: Optimize IAP Monetization
## Revenue Strategy
**Path to $5K MRR**:
1. Increase engagement → higher retention → more conversions
2. Expand IAP catalog (boosters, cosmetics, consumables, subscriptions)
3. Optimize pricing ($0.99 to $49.99+ tiers)
4. Add subscription option ($4.99/month Premium Pass)
**Target Metrics**:
- 10,000 monthly active users
- 5% conversion rate
- $10 ARPPU
- $5,000 MRR
## Key Technical Details
### Entity System
```
Being (base)
├── Character (NPCs with relationships)
│ └── PlayerCharacter (player with skills, inventory, spells)
└── Creature (monsters)
├── Enemy (dungeon enemies)
└── Minion (summons/pets)
```
### Core Stores
- RootStore: Game ticks, death/birth checks
- CharacterStore: NPCs, children, adoption
- DungeonStore: Instances, levels, combat
- PVPStore: Opponents, tokens, battles
- IAPStore: RevenueCat integration
- TimeStore: Game time (weeks/years), seasons
### IAP Products (Current)
- Ranger Class unlock
- Necromancer Class unlock
- Dual Class Bundle
- Remote Saves
- Stash Tabs
## Next Steps
1. Board review of engagement plan
2. Assign sub-issues to implementation team
3. Begin with PvP and Onboarding (highest impact)
4. Implement quest system
5. Build life sim depth
6. Optimize monetization continuously

View File

@@ -1,105 +0,0 @@
# Nessa Project Facts
## Project Overview
- Type: "iOS fitness tracking application (Strava competitor)"
- Tech Stack: "Swift, SwiftUI, GRDB (local database), HealthKit"
- Location: "/home/mike/code/Nessa"
- Repository: "https://git.freno.me/Mike/Nessa.git"
- Target: "2,000 paying users = $10k MRR"
## Architecture
### Database
- ORM: "GRDB with migrations"
- Schema: "users, workouts, social features (profiles, follows, kudos, comments), segments"
- Migration pattern: "Incremental migrations with existence checks"
- DatabaseManager: "Centralized database access with read/write methods"
### Current Features
- Workout types: 11
- HealthKit integration: true
- Basic dashboard and authentication: true
- Social features: "profiles, follows, kudos, comments, activity feed"
- Segments with leaderboards and efforts: true
- Heart rate tracking: true
### Subscription Model (Planned)
- Free price: "$0"
- Free features: "Core features except route planning, AI features, offline maps"
- Plus price: "$4.99/mo"
- Plus features: "Route planning, offline maps, advanced segments, personal heatmaps"
- Pro price: "$9.99/mo"
- Pro features: "AI training plans, premium challenges, priority support, fitness tracking"
### Subscription Implementation
- Payment: "StoreKit 2 for iOS native subscriptions"
- Product IDs: "com.nessa.subscription.plus.monthly, com.nessa.subscription.pro.monthly, com.nessa.subscription.plus.yearly, com.nessa.subscription.pro.yearly"
- Feature Gating: "SubscriptionService with PremiumFeature enum"
- Backend: "Receipt validation endpoints, App Store Server Notifications webhook"
- Timeline: "4 weeks (6 phases)"
- Sub-issues: "FRE-108 through FRE-112"
## Completed Work (2026-03-10)
### StoreKit 2 Integration (FRE-108)
- Status: "Completed"
- Deliverables:
- ProductStore.swift: "Product fetching, caching, tier/period management"
- PurchaseManager.swift: "Transaction handling, restoration, secure storage"
- TransactionObserver.swift: "Real-time monitoring, entitlement tracking"
- SubscriptionView.swift: "Complete UI with tier/period selection"
- StoreKitConfiguration.storekit: "4 subscription products configured"
- Products configured:
- Plus Monthly: "$4.99"
- Pro Monthly: "$9.99"
- Plus Yearly: "$49.99 (17% savings)"
- Pro Yearly: "$99.99 (17% savings)"
- Integration points:
- NessaApp.swift: "TransactionObserver initialization"
- SettingsTabView: "Premium section with tier indicator"
- Pending transaction processing on app launch
## Feature Roadmap
### Phase 1 MVP Status
- Status: "Completed"
- Features: "Activity tracking + feed + kudos + comments, Profiles + follow system, Basic segments"
### Phase 2 Community Growth
- Issue: "FRE-92"
- Features: "Clubs system, Monthly challenges, 1v1 challenges, Share to social, Invite system"
- Timeline: "10 weeks"
- Sub-issues: "FRE-102 through FRE-107"
### Phase 3 Premium Features
- Features: "Route planning with turn-by-turn, AI training plans, Offline maps, Advanced analytics"
## Revenue Targets
- Month 1: "$500-1,000 MRR (100 paying users)"
- Month 3: "$2,500-5,000 MRR (500 paying users)"
- Month 6: "$5,000-10,000 MRR (1,000 paying users)"
- Year 1: "$10,000+ MRR (2,000 paying users)"
## Technical Debt and Considerations
- Subscription infrastructure: "Not yet implemented"
- Backend API: "Required for subscriptions (not yet built)"
- Architecture: "Local-first with GRDB (sync TBD)"
- Competitive goal: "Feature parity with Strava"
## Key Files
- User model: "Nessa/Models/User.swift"
- Database manager: "Nessa/Core/Database/DatabaseManager.swift"
- Subscription plan: "plans/2026-03-09-subscription-tiers-implementation.md"
- Community plan: "plans/2026-03-09-phase2-community-growth.md"
## Related Issues
- Strava parity: "FRE-73"
- Community growth: "FRE-92 (in_review)"
- Subscription tiers: "FRE-94 (in_review)"
- Subscription sub-issues: "FRE-108 to FRE-112"
- Community sub-issues: "FRE-102 to FRE-107"
## Access Metadata
- created: "2026-03-09"
- last_accessed: "2026-03-10T23:10:00Z"
- access_count: 2