goplt/docs/content/stories/phase3/README.md

Phase 3: Module Framework

Overview

Define module interface and registration system, implement static module registry, create permission code generation tool, build module loader (support both static and plugin modes), and add module discovery and initialization.

Tasks

3.1 Module Interface

• 3.1.1 - Create Module Interface
• 3.1.2 - Create Module Manifest
• 3.1.3 - Define Module YAML Schema

3.2 Static Module Registry

• 3.2.1 - Create Registry
• 3.2.2 - Add Registration Validation

3.3 Permission Code Generation

• 3.3.1 - Create Generate Script
• 3.3.2 - Add Go Generate Directive
• 3.3.3 - Update Makefile

3.4 Module Loader

• 3.4.1 - Create Loader Interface
• 3.4.2 - Implement Static Loader
• 3.4.3 - Implement Plugin Loader

3.5 Module Initialization

• 3.5.1 - Create Initializer
• 3.5.2 - Run Migrations

3.6 Module Lifecycle

• 3.6.1 - Extend Module Interface
• 3.6.2 - Integrate with FX Lifecycle

3.7 Platform CLI

• 3.7.1 - Create CLI Tool
• 3.7.2 - Add to Makefile

Deliverables Checklist

• Module interface defined
• Static module registry implemented
• Permission code generation working
• Module loader supports static and plugin modes
• Modules can be discovered and initialized
• Module migrations run on startup
• Platform CLI tool for module management

Acceptance Criteria

• Modules can be registered statically
• Permission constants are generated from module manifests
• Modules are initialized with correct dependency order
• Module migrations run automatically
• CLI tool can list and manage modules