docs: add mkdocs, update links, add architecture documentation

2025-11-05 07:44:21 +01:00
parent 6a17236474
commit 54a047f5dc
351 changed files with 3482 additions and 10 deletions
--- a/docs/content/stories/phase0/0.1.2-create-directory-structure.md
+++ b/docs/content/stories/phase0/0.1.2-create-directory-structure.md
@@ -0,0 +1,77 @@
+# Task 0.1.2: Create directory structure:
+
+## Metadata
+- **Task ID**: 0.1.2
+- **Title**: Create directory structure:
+- **Phase**: 0 - Project Setup & Foundation
+- **Section**: 0.1
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create directory structure:
+
+## Requirements
+- Create directory structure:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 0.1.2 is completed
+- [ ] All requirements are met
+- [ ] Code compiles and tests pass
+
+## Related ADRs
+- See relevant ADRs in `docs/adr/`
+
+## Implementation Notes
+- TODO: Add implementation notes
+
+## Testing
+```bash
+# TODO: Add test commands
+go test ./...
+```
+
+
+## Code Reference
+
+```go
+platform/
+  ├── cmd/
+  │   └── platform/          # Main entry point
+  ├── internal/              # Private implementation code
+  │   ├── di/                # Dependency injection container
+  │   ├── registry/          # Module registry
+  │   ├── pluginloader/      # Plugin loader (optional)
+  │   └── infra/             # Infrastructure adapters
+  ├── pkg/                   # Public interfaces (exported)
+  │   ├── config/            # ConfigProvider interface
+  │   ├── logger/            # Logger interface
+  │   ├── module/            # IModule interface
+  │   ├── auth/              # Auth interfaces
+  │   ├── perm/              # Permission DSL
+  │   └── infra/             # Infrastructure interfaces
+  ├── modules/               # Feature modules
+  │   └── blog/              # Sample Blog module (Phase 4)
+  ├── config/                # Configuration files
+  │   ├── default.yaml
+  │   ├── development.yaml
+  │   └── production.yaml
+  ├── api/                   # OpenAPI specs
+  ├── scripts/               # Build/test scripts
+  ├── docs/                  # Documentation
+  ├── ops/                   # Operations (Grafana dashboards, etc.)
+  ├── .github/
+  │   └── workflows/
+  │       └── ci.yml
+  ├── Dockerfile
+  ├── docker-compose.yml
+  ├── docker-compose.test.yml
+  └── go.mod
+```