feat: microservice architecture

docs/content/stories/phase4/README.md

@@ -1,31 +1,14 @@
 # Phase 4: Sample Feature Module (Blog)
 
 ## Overview
-Create a sample blog module to demonstrate the module framework. This module will implement blog posts with CRUD operations, showing how to build a feature module that integrates with the core platform.
+Create a complete sample module (Blog) to demonstrate the framework, showing how to add routes, permissions, database entities, and services. The Blog module is an independent service that uses service clients to communicate with core services. Provide reference implementation for future developers.
 
-## Tasks
+## Stories
 
-### 4.1 Module Setup
-- [4.1.1 - Create Blog Module Directory](./4.1.1-create-modulesblog-directory.md)
-- [4.1.2 - Initialize Go Module](./4.1.2-initialize-gomod.md)
-
-### 4.2 Module Configuration
-- [4.2.1 - Create Module Manifest](./4.2.1-create-modulesblogmoduleyaml.md)
-
-### 4.3 Domain Layer
-- [4.3.1 - Create Post Domain Model](./4.3.1-create-modulesbloginternaldomainpostgo.md)
-- [4.3.2 - Create Ent Schema](./4.3.2-create-modulesbloginternalentschemapost.md)
-- [4.3.3 - Generate Ent Code](./4.3.3-generate-ent-code-for-blog-module.md)
-
-### 4.4 Repository Layer
-- [4.4.1 - Create Post Repository Interface](./4.4.1-create-modulesbloginternaldomainpost_repogo.md)
-- [4.4.2 - Implement Repository](./4.4.2-implement-using-ent-client-shared-from-core.md)
-
-### 4.5 Service Layer
-- [4.5.1 - Create Post Service](./4.5.1-create-modulesbloginternalservicepost_servicego.md)
-
-### 4.6 API Layer
-- [4.6.1 - Create API Handler](./4.6.1-create-modulesbloginternalapihandlergo.md)
+### 4.1 Complete Blog Module
+- [Story: 4.1 - Blog Module](./4.1-blog-module.md)
+- **Goal:** Create a complete sample blog module to demonstrate the framework.
+- **Deliverables:** Complete blog module with CRUD operations, permissions, database entities, services, API handlers, and integration tests
 
 ## Deliverables Checklist
 - [ ] Blog module directory structure created
@@ -36,6 +19,7 @@ Create a sample blog module to demonstrate the module framework. This module wil
 - [ ] Service layer implements business logic
 - [ ] API endpoints for blog posts working
 - [ ] Module integrated with core platform
+- [ ] Integration tests passing
 
 ## Acceptance Criteria
 - Blog module can be registered with core platform
@@ -44,4 +28,4 @@ Create a sample blog module to demonstrate the module framework. This module wil
 - API endpoints require proper authentication
 - Module migrations run on startup
 - Blog posts are associated with users
-
+- Authorization enforced (users can only edit own posts)