Legacy Cube Developer Handbook#

Onboarding for the legacy Cube codebase (.NET Framework 4.8, EF6, MVC + WebForms, AngularJS, SQL Server, Windows service). This is the system that Cube 2.0 is replacing — see Getting Started and the Migration Roadmap for the new stack.

Keep this handbook for anyone who still needs to touch the legacy repo (manexcloud/, alohaSite.sln) for hotfixes, release-branch merges, or migration reference.

Overview#

The Cube application follows a .NET monolithic architecture built on Web API principles with an AngularJS frontend. The database (MS SQL) uses a database-first approach with Entity Framework.

For a code-level view of the same solution, see Architecture.

Contents#

  1. Setup Development Environment — IDE, Git, dependencies, Copilot, database
  2. Access for Project Tools — repo, database, Jira
  3. Codebase Walkthrough — running locally, project structure, coding principles
  4. Database Standards & Data Quality — Unicode / mojibake prevention for MnxResourceKey
  5. Git Process — Merging and Pushing — branches, commits, merges, rollbacks, conflicts
  6. Jira Process & Tickets — Kanban flow, statuses, handoff to QA
  7. Tips — working across release branches
Backward Post-Migration Cleanup 1. Setup Development Environment Forward