feat: migrate memu-server with comprehensive quality automation

Major changes:
- Complete project migration from original repository
- Python 3.13 environment with uv package manager
- FastAPI + SQLModel + PostgreSQL 16 + pgvector
- Temporal workflow engine integration
- Comprehensive pre-commit hooks (20 checks)
  * Code formatting: ruff format
  * Linting: ruff, pylint (9.84/10)
  * Security: bandit
  * Custom validators: credentials, migrations, makefile, markdown
- Test coverage: 41% with automated checks
- GitHub Actions CI/CD pipeline
- Environment variable validation at startup
- All security best practices enforced
- Complete English documentation

Author: SparkZou

.env.example

@@ -0,0 +1,40 @@
+# ===================================
+# Database Configuration
+# ===================================
+# For docker-compose
+POSTGRES_USER=memu_user
+POSTGRES_PASSWORD=memu_pass
+POSTGRES_DB=memu_db
+
+# For application
+DATABASE_HOST=localhost
+DATABASE_PORT=54320
+DATABASE_USER=memu_user
+DATABASE_PASSWORD=memu_pass
+DATABASE_NAME=memu_db
+
+# ===================================
+# Temporal Configuration
+# ===================================
+TEMPORAL_HOST=localhost
+TEMPORAL_PORT=17233
+TEMPORAL_NAMESPACE=default
+
+# ===================================
+# LLM Configuration
+# ===================================
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_BASE_URL=https://api.openai.com/v1
+DEFAULT_LLM_MODEL=gpt-4o-mini
+
+# ===================================
+# Embedding Configuration
+# ===================================
+EMBEDDING_API_KEY=your_embedding_api_key_here
+EMBEDDING_BASE_URL=https://api.voyageai.com/v1
+EMBEDDING_MODEL=voyage-3.5-lite
+
+# ===================================
+# Storage Configuration
+# ===================================
+STORAGE_PATH=/var/data/memu-server

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -7,7 +7,7 @@ body:
     attributes:
       value: |
         Thanks for taking the time to report a bug! Please fill out the form below.
-  
+
   - type: textarea
     id: description
     attributes:
@@ -16,7 +16,7 @@ body:
       placeholder: Describe the bug...
     validations:
       required: true
-  
+
   - type: textarea
     id: reproduction
     attributes:
@@ -28,7 +28,7 @@ body:
         3. See error
     validations:
       required: true
-  
+
   - type: textarea
     id: expected
     attributes:
@@ -37,7 +37,7 @@ body:
       placeholder: What should happen?
     validations:
       required: true
-  
+
   - type: textarea
     id: actual
     attributes:
@@ -46,7 +46,7 @@ body:
       placeholder: What actually happened?
     validations:
       required: true
-  
+
   - type: textarea
     id: environment
     attributes:
@@ -58,7 +58,7 @@ body:
         - memU-server Version: [e.g. 1.0.0]
     validations:
       required: false
-  
+
   - type: textarea
     id: logs
     attributes:
@@ -67,7 +67,7 @@ body:
       render: shell
     validations:
       required: false
-  
+
   - type: textarea
     id: additional
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -7,7 +7,7 @@ body:
     attributes:
       value: |
         Thanks for suggesting a new feature! Please fill out the form below.
-  
+
   - type: textarea
     id: problem
     attributes:
@@ -16,7 +16,7 @@ body:
       placeholder: I'm always frustrated when...
     validations:
       required: true
-  
+
   - type: textarea
     id: solution
     attributes:
@@ -25,7 +25,7 @@ body:
       placeholder: I would like to have...
     validations:
       required: true
-  
+
   - type: textarea
     id: alternatives
     attributes:
@@ -34,7 +34,7 @@ body:
       placeholder: Alternative approaches could be...
     validations:
       required: false
-  
+
   - type: textarea
     id: benefits
     attributes:
@@ -43,7 +43,7 @@ body:
       placeholder: This feature would help users...
     validations:
       required: false
-  
+
   - type: textarea
     id: additional
     attributes:

.github/ISSUE_TEMPLATE/improvement_suggestion.yml

@@ -7,7 +7,7 @@ body:
     attributes:
       value: |
         Thanks for suggesting an improvement! Please fill out the form below.
-  
+
   - type: textarea
     id: current
     attributes:
@@ -16,7 +16,7 @@ body:
       placeholder: Currently, the system...
     validations:
       required: true
-  
+
   - type: textarea
     id: suggested
     attributes:
@@ -25,7 +25,7 @@ body:
       placeholder: It would be better if...
     validations:
       required: true
-  
+
   - type: textarea
     id: rationale
     attributes:
@@ -34,7 +34,7 @@ body:
       placeholder: This would improve...
     validations:
       required: true
-  
+
   - type: textarea
     id: impact
     attributes:
@@ -43,7 +43,7 @@ body:
       placeholder: This would affect...
     validations:
       required: false
-  
+
   - type: textarea
     id: implementation
     attributes:
@@ -52,7 +52,7 @@ body:
       placeholder: This could be implemented by...
     validations:
       required: false
-  
+
   - type: textarea
     id: additional
     attributes:

.github/workflows/code-quality.yml

@@ -0,0 +1,56 @@
+name: Code Quality
+
+on:
+  push:
+    branches: [ main, develop, 'feature/**' ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  quality-check:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+    - name: Install dependencies
+      run: |
+        uv venv
+        uv sync
+
+    - name: Check code formatting
+      run: |
+        uv run ruff format --check .
+
+    - name: Lint code
+      run: |
+        uv run ruff check .
+
+    - name: Run tests
+      env:
+        OPENAI_API_KEY: "test-openai-key"
+        DATABASE_URL: "sqlite:///:memory:"
+      run: |
+        uv run pytest -v --cov=app --cov-report=xml --cov-report=term
+
+    - name: Upload coverage reports
+      if: matrix.python-version == '3.13'
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}