# mojoPortal Embedded — Version Information

## Current Release

**Version:** 1.0.0-alpha  
**Release Date:** 2024  
**Status:** Alpha Test  
**Platform:** .NET Framework 4.8.1 with SQLite  
**Build Target:** Embedded Server Deployment  

---

## Overview

This is the first release of mojoPortal optimized for embedded deployment into servers. The 1.0.0-alpha designation indicates:

- ✅ **Core functionality complete** — All essential portal features operational
- ✅ **Migration system complete** — Legacy database resurrection fully implemented
- ✅ **DevAdmin integration complete** — Admin toolbar with "Siphon" migration launcher
- ⚠️ **Alpha status** — Undergoing active testing and refinement
- 📝 **Feedback welcome** — Issues and landmarks reported during deployment

---

## What's New in 1.0.0-alpha

### Core Portal Features
- Clean SQLite database schema
- Modern ASP.NET WebForms architecture
- Page management with hierarchical navigation
- Module system with extensibility
- Role-based permissions
- Admin UI for site management

### Migration System (New)
- **Comprehensive Legacy Data Migration**
  - Pages with hierarchy preservation
  - Module reassociation and settings transfer
  - Permission mapping
  - Audit logging throughout process

- **Three-Tier Migration Architecture**
  - `LegacyDataMigrationEngine.cs` — Core migration logic
  - `LegacyMigrationHelper.cs` — Analysis and inspection
  - Web UI tools — `MigrationInspector.aspx`, `MigrationExecutor.aspx`

- **DevAdmin Integration (New)**
  - "Siphon (Migration)" button in DevAdmin toolbar
  - Quick access to migration from running program
  - Simplified workflow for administrators

### Documentation
- **MIGRATION_GUIDE.md** — Comprehensive, essay-style migration documentation
  - Step-by-step walkthrough with expected outcomes
  - Verification checklists
  - Troubleshooting guide
  - Technical deep-dive
  - FAQ and common scenarios

---

## Deployment Information

### Workspace Structure

**Development Environment:**
- Path: `C:\___Work\SqliteMojo`
- Repository: `migrate/package-reference` branch
- Status: Alpha testing

**Production Mapping:**
- Source: `C:\___Fire\SqliteMojo` (to be deployed)
- Web Root: `C:\___Fire\SqliteMojo\Web`
- Portal URL: `https://phosend.com/Portal`
- Admin Access: `https://phosend.com/Portal/Admin`
- DevAdmin: `https://phosend.com/Portal/DevAdmin`

### Routing Architecture

- **Main Portal:** `~/` (root)
- **Admin Interface:** `~/Admin/` (admin panel)
- **DevAdmin Tools:** `~/DevAdmin/` (developer/admin tools)
- **MoxOp Utilities:** `~/MoxOp/` (data operations)
- **ABdash Controllers:** `~/ABdash/` (Angular2js legacy routing)
- **Migration Tools:** `~/Admin/MigrationExecutor.aspx`, `~/Admin/MigrationInspector.aspx`

### Embedded Server Usage

This build is optimized for embedding into servers with:
- Self-contained SQLite database
- No external database server required
- IIS or IIS Express hosting
- Standalone deployment capability
- Portal accessibility via mapped URL

---

## Known Limitations (Alpha)

- Single-site migration only (not multi-site yet)
- SQLite database only (no SQL Server/MySQL adapters)
- Module type mapping by FeatureGuid (custom modules must be pre-installed)
- No automatic rollback (pre-migration backup recommended)
- Migration is additive only (doesn't overwrite existing data)

---

## Upgrade Path

**Planned for Future Releases:**
- 1.0.1 — Performance optimizations based on alpha feedback
- 1.1.0 — Multi-site migration support
- 1.2.0 — Database adapter support (SQL Server, MySQL)
- 2.0.0 — Modernized UI framework (future)

---

## Testing & Feedback

During alpha testing, please report:

1. **Landmarks Reached:**
   - Successful deployment
   - Migration completion milestones
   - Performance metrics
   - Admin UI interactions

2. **Issues Encountered:**
   - Migration failures or unexpected results
   - Permission/role mapping issues
   - Module missing or non-functional
   - Performance problems

3. **Suggestions:**
   - UI/UX improvements
   - Feature requests
   - Documentation clarifications
   - Performance optimization ideas

**How to Report:**
- Direct web content snippets welcome
- Error logs and migration summaries helpful
- Screenshots of issues greatly appreciated
- Exact steps to reproduce recommended

---

## Support Resources

- **Migration Guide:** `/Web/Data/sqlitedb/MIGRATION_GUIDE.md`
- **Migration Inspector:** `https://phosend.com/Portal/Admin/MigrationInspector.aspx`
- **Migration Executor:** `https://phosend.com/Portal/Admin/MigrationExecutor.aspx`
- **DevAdmin Panel:** `https://phosend.com/Portal/DevAdmin/Default.aspx`
- **Admin Menu:** `https://phosend.com/Portal/Admin/AdminMenu.aspx`

---

## Contributors & Notes

**Version 1.0.0-alpha** represents a complete implementation of:
- Core portal functionality
- Legacy migration system
- Developer tools and utilities
- Comprehensive documentation

Deployed for alpha testing to ensure stability and gather real-world usage feedback before moving to stable release.

---

**Release Date:** 2024  
**Status:** Alpha — Active Development & Testing  
**Contact:** Landmark reports and feedback welcome