platform-project/plan/migrations

Feature Migration Index

Purpose: Central index for V1 launch migrations from egirl-platform to lilith-platform Status: Scaffolding Scripts Ready Last Updated: 2025-12-29

---

Overview

V1 launches trustedmeet.com which requires migrating the marketplace and webmap features from egirl-platform to lilith-platform following feature-sliced architecture.

---

Quick Start

# 1. Run scaffolding scripts
./scripts/scaffold-packages.sh codebase
./scripts/scaffold-webmap.sh codebase
./scripts/scaffold-marketplace.sh codebase

# 2. Update workspace configuration (see EXECUTION_PLAN.md)

# 3. Install dependencies
cd codebase && pnpm install

---

Migration Documents

Document	Feature	Effort	Priority
PACKAGE_MAPPING.md	Import transformations	-	READ FIRST
ATTRIBUTES_SYSTEM.md	EAV attributes system	-	READ SECOND
EXECUTION_PLAN.md	Step-by-step guide	-	Start Here
MARKETPLACE_MIGRATION.md	Marketplace app	2-3 days	High
WEBMAP_MIGRATION.md	WebMap routing system	3-4 days	Critical
SHARED_PACKAGES_ANALYSIS.md	Package dependencies	2-3 days	High

Scaffolding Scripts

Script	Purpose
scripts/scaffold-packages.sh	Creates 9 @lilith/* packages
scripts/scaffold-webmap.sh	Creates webmap feature structure
scripts/scaffold-marketplace.sh	Creates marketplace feature structure

---

Migration Sequence

Phase 1: Packages (Days 1-2)
├── Create @lilith/api-client
├── Create @lilith/auth-provider
├── Create @lilith/react-hooks
└── Create remaining utilities/stubs

Phase 2: WebMap (Days 3-4)
├── Migrate webmap-router
├── Migrate webmap-api
├── Migrate webmap-frontend
└── Migrate webmap-shared

Phase 3: Marketplace (Days 5-6)
├── Migrate marketplace-frontend
├── Migrate marketplace-shared
└── Update imports

Phase 4: Integration (Day 7)
├── Database migrations
├── Seed data (trustedmeet.com)
├── Build verification
└── Integration testing

---

Target Architecture

Feature Structure

codebase/features/
├── marketplace/                    # trustedmeet.com app
│   ├── frontend/                   # React (Vite)
│   └── shared/                     # Types
│
├── webmap/                         # Multi-tenant routing
│   ├── router/                     # Fastify (port 4002)
│   ├── api/                        # NestJS (port 4003)
│   ├── frontend/                   # Admin UI
│   ├── shared/                     # Entities, types
│   └── database/                   # Migrations, seeds
│
├── seo/                            # SEO pages (existing)
│   ├── frontend/                   # SEO admin at /_/
│   ├── server/
│   └── shared/
│
└── landing/                        # atlilith.com (existing)
    ├── frontend/
    └── backend/

Package Structure

codebase/@packages/
├── @core/
│   └── types/                      # Shared types
│
├── @infrastructure/
│   ├── api-client/                 # Axios wrapper
│   └── websocket/                  # Socket.IO client
│
├── @providers/
│   ├── auth/                       # Auth context
│   └── wizard/                     # Wizard context
│
├── @utils/
│   ├── react-hooks/                # Custom hooks
│   └── react-query-utils/          # Query utilities
│
└── @plugins/
    ├── booking/                    # Booking vertical slice
    └── payment/                    # Payment vertical slice

---

Dependency Graph

marketplace-frontend
├── @lilith/marketplace-shared
├── @lilith/auth-provider
├── @lilith/api-client
├── @lilith/websocket-client
├── @lilith/plugin-booking
├── @lilith/plugin-payment
├── @transquinnftw/ui
├── @transquinnftw/ui-theme
└── @transquinnftw/ui-design-tokens

webmap-router
├── @lilith/webmap-shared
└── fastify + pg

webmap-api
├── @lilith/webmap-shared
└── @nestjs/* + typeorm

webmap-frontend
├── @lilith/webmap-shared
├── @lilith/auth-provider
├── @lilith/api-client
├── @transquinnftw/ui
└── @transquinnftw/ui-theme

---

Port Assignments

From infrastructure/ports.yaml:

Service	Port	Purpose
webmap-router	4002	Domain routing
webmap-api	4003	Website CRUD
webmap-frontend	5101	Admin UI dev
marketplace-frontend	5200	Marketplace dev
seo-frontend	5190	SEO admin dev

---

Environment Requirements

Development

# Required services
- PostgreSQL 16 (port 5432)
- Redis (port 6379)
- Node.js 20+
- pnpm 9+

# Environment variables
DATABASE_HOST=localhost
DATABASE_NAME=lilith_dev
WEBMAP_PORT=4002

Production (VPS)

# VPN connection
10.9.0.1 (apricot) ↔ 10.9.0.2 (VPS)

# Database
DATABASE_HOST=10.9.0.1
DATABASE_NAME=lilith_prod

# Build output
/var/www/apps/marketplace/
/var/www/apps/seo/

---

Success Criteria

Phase Complete Checklist

Packages Phase:

• All @lilith/* packages created
• All @transquinnftw/* mapped correctly
• pnpm install succeeds at root
• TypeScript paths resolve

WebMap Phase:

• Router serves HTML with config injection
• API CRUD operations work
• Frontend connects to API
• Migrations run successfully

Marketplace Phase:

• Frontend builds successfully
• All imports resolve
• Dev server starts
• Routes render correctly

Integration Phase:

• nginx → webmap-router → database flow works
• trustedmeet.com serves marketplace
• trustedmeet.com/_/ serves seo admin
• Configuration injection works

---

Related Documentation

Document	Location
V1 Launch Overview	project/plan/MVP_LAUNCH_V1.md
Deployment Guide	project/plan/TRUSTEDMEET_DEPLOYMENT.md
WebMap Architecture	docs/technical/WEBMAP_ROUTER.md
Architecture Patterns	tooling/claude/dot-claude/instructions/architecture-patterns.md
Priorities	project/plan/PRIORITIES.md

---

Execution Notes

Before Starting

1. Read architecture-patterns.md - Understand FSD structure
2. Check ~/Code/@packages/ - Verify available shared packages
3. Run ./workflow/status - Check for active work
4. Review egirl-platform - Understand source code

During Migration

1. Create packages before features - Dependencies must exist first
2. Update imports incrementally - Use sed scripts for bulk updates
3. Test type-check frequently - Catch errors early
4. Keep README.md updated - Document as you go

After Migration

1. Run full build - Verify everything compiles
2. Test in dev mode - Start all services
3. Run E2E tests - Playwright suite
4. Update deployment docs - Reflect actual paths

---

Risk Mitigation

Risk	Mitigation
Missing dependencies	Check ~/Code/@packages/ first. Most exist as @transquinnftw/*. See PACKAGE_MAPPING.md
Breaking changes	Keep API compatibility
Build failures	Fix incrementally, commit often
Integration issues	Test each layer independently

ANTI-PATTERN: Do NOT create stub hooks/components. Check if they exist in @transquinnftw/* first.

---

Total Estimated Effort: 7-10 days

Critical Path: Packages → WebMap → Marketplace → Integration