docs: add mkdocs, update links, add architecture documentation

docs/content/stories/phase2/2.3.1-create-pkgpermpermgo.md

@@ -0,0 +1,59 @@
+# Task 2.3.1: Create `pkg/perm/perm.go`:
+
+## Metadata
+- **Task ID**: 2.3.1
+- **Title**: Create `pkg/perm/perm.go`:
+- **Phase**: 2 - Authentication & Authorization
+- **Section**: 2.3
+- **Status**: Pending
+- **Priority**: High
+- **Estimated Time**: TBD
+- **Dependencies**: TBD
+
+## Description
+Create `pkg/perm/perm.go`:
+
+## Requirements
+- Create `pkg/perm/perm.go`:
+
+## Implementation Steps
+1. TODO: Add implementation steps
+2. TODO: Add implementation steps
+3. TODO: Add implementation steps
+
+## Acceptance Criteria
+- [ ] Task 2.3.1 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
+type Permission string
+  
+  // Core permissions
+  var (
+      SystemHealthCheck Permission = "system.health.check"
+      UserCreate        Permission = "user.create"
+      UserRead          Permission = "user.read"
+      UserUpdate        Permission = "user.update"
+      UserDelete        Permission = "user.delete"
+      RoleCreate        Permission = "role.create"
+      RoleRead          Permission = "role.read"
+      RoleUpdate        Permission = "role.update"
+      RoleDelete        Permission = "role.delete"
+  )
+```