Dev

.dockerignore

@@ -1,82 +1,44 @@
-# =============================================================================
-# Git
-# =============================================================================
 .git
-.gitignore
-.gitattributes
 .github
+.gitignore
+.pre-commit-config.yaml
+.dockerignore
+.claude
+
+# Archives
+archive-legacy-*.tar.gz
 
-# =============================================================================
 # Environment & Secrets
-# =============================================================================
 .env
 .env.*
-**/.env
-**/.env.*
-*.key
-*.pem
 
-# =============================================================================
-# Python
-# =============================================================================
-__pycache__
-*.pyc
-*.pyo
-*.pyd
-.ruff_cache
-.mypy_cache
-.pytest_cache
-.coverage
-htmlcov
-.venv
-venv
-env
-*.egg-info
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
 
-# =============================================================================
-# Node.js / Frontend
-# =============================================================================
+# Node.js
 node_modules
-.next
-out
-.pnp
-.pnp.js
-.pnp.cjs
-.yarn
 *.tsbuildinfo
 .eslintcache
-.turbo
 npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
 
-# =============================================================================
-# Docker
-# =============================================================================
-Dockerfile
-Dockerfile.*
-docker-compose*.yml
-.dockerignore
+# Go build artifacts
+backend/bin
 
-# =============================================================================
-# IDE & Editor
-# =============================================================================
-.idea
-.vscode
-*.swp
-*.swo
-.claude
+# Frontend build output
+frontend/dist
 
-# =============================================================================
-# Documentation & Tests
-# =============================================================================
-docs/
-tests/
+# Documentation
 *.md
 !README.md
 
-# =============================================================================
-# CI/CD & Config
-# =============================================================================
-.pre-commit-config.yaml
-.github/
+# Docker
+Dockerfile
+docker-compose*.yml
+deploy/
+
+# Scripts & Config
+scripts/
+Makefile

.env.example

@@ -1,57 +1,36 @@
 # MomShell Environment Configuration
-# Copy this file to .env and fill in your values
-# NOTE: Do not use quotes around values - Docker --env-file includes them literally
-
-# Application
-APP_NAME=MomShell
-DEBUG=false
-
-# Server
-# Local dev: uncomment PORT=8000
-# Docker: leave PORT commented (Dockerfile sets 7860)
-HOST=0.0.0.0
-# PORT=8000
-
-# Database
-# Local development: sqlite+aiosqlite:///./data/momshell.db
-# Docker/ModelScope: sqlite+aiosqlite:////mnt/workspace/momshell.db (persistent storage)
-# PostgreSQL cloud: postgresql+asyncpg://user:pass@host:5432/dbname
-DATABASE_URL=sqlite+aiosqlite:///./data/momshell.db
-
-# ModelScope API Configuration
-# Get your API key from: https://modelscope.cn/
-MODELSCOPE_KEY=your_modelscope_api_key_here
-MODELSCOPE_MODEL=Qwen/Qwen2.5-72B-Instruct
-# For image generation model (optional)
-# MODELSCOPE_IMAGE_MODEL=your_image_model_here
-
-# MediaPipe Configuration
-POSE_MODEL_COMPLEXITY=1
-MIN_DETECTION_CONFIDENCE=0.5
-MIN_TRACKING_CONFIDENCE=0.3
-
-# TTS Configuration (Microsoft Edge TTS)
-TTS_VOICE=zh-CN-XiaoxiaoNeural
-TTS_RATE=-10%
-
-# Safety Thresholds
-MAX_DEVIATION_ANGLE=30.0
-FATIGUE_DETECTION_THRESHOLD=0.7
-REST_PROMPT_INTERVAL=300
-
-# JWT Authentication
-# IMPORTANT: Change this secret key in production!
-JWT_SECRET_KEY=your-secret-key-change-in-production
-JWT_ALGORITHM=HS256
+# Copy to .env and fill in your values
+
+# ==================== Database ====================
+# Local development
+DATABASE_URL=postgres://momshell:momshell@localhost:5432/momshell?sslmode=disable
+# Docker deployment (uses container name "postgres" as host)
+# DATABASE_URL=postgres://momshell:momshell@postgres:5432/momshell?sslmode=disable
+
+# Docker Postgres container settings
+POSTGRES_USER=momshell
+POSTGRES_PASSWORD=momshell
+POSTGRES_DB=momshell
+
+# ==================== JWT ====================
+# IMPORTANT: Change this in production
+JWT_SECRET_KEY=change-me-in-production
 JWT_ACCESS_TOKEN_EXPIRE_MINUTES=30
 JWT_REFRESH_TOKEN_EXPIRE_DAYS=7
 
-# Web Search (Firecrawl API for reducing AI hallucinations)
-# Get your API key from: https://www.firecrawl.dev/
-# FIRECRAWL_API_KEY=your_firecrawl_api_key_here
+# ==================== OpenAI Compatible API ====================
+OPENAI_API_KEY=
+OPENAI_BASE_URL=https://api-inference.modelscope.cn/v1
+OPENAI_MODEL=Qwen/Qwen2.5-72B-Instruct
+
+# ==================== Server ====================
+PORT=8000
+
+# ==================== Frontend ====================
+# Backend API URL (defaults to http://localhost:8000, leave empty for Nginx proxy in production)
+VITE_API_BASE_URL=http://localhost:8000
 
-# Initial Admin Account (optional, created on first startup)
-# Set these to automatically create an admin account when the app starts
-# ADMIN_USERNAME=admin
-# ADMIN_EMAIL=admin@example.com
-# ADMIN_PASSWORD=your_secure_password
+# ==================== Initial Admin (optional, created on first startup) ====================
+ADMIN_USERNAME=
+ADMIN_EMAIL=
+ADMIN_PASSWORD=

.github/ISSUE_TEMPLATE/ai_provider_issue.yml

@@ -1,21 +1,21 @@
 name: AI Provider Issue
-description: Report issues with AI responses, ModelScope API, or LLM behavior
+description: Report issues with AI responses, LLM API, or content moderation
 title: "[AI]: "
 labels: ["ai", "triage"]
 body:
   - type: markdown
     attributes:
       value: |
-        This template is for issues related to AI/LLM functionality, including the Soulful Companion chat and AI-powered coaching feedback.
+        This template is for issues related to AI/LLM functionality, including the Soul Companion chat, Echo memoir generation, and content moderation.
 
   - type: dropdown
     id: feature
     attributes:
       label: Affected AI Feature
       description: Which AI-powered feature is affected?
       options:
-        - Soulful Companion (Chat responses)
-        - Recovery Coach (Voice feedback)
+        - Soul Companion (Chat responses)
+        - Echo (Memoir generation)
         - Content moderation
         - Other
     validations:
@@ -29,10 +29,9 @@ body:
       options:
         - API connection failed
         - No response / timeout
-        - Incorrect/inappropriate response
+        - Incorrect / inappropriate response
         - Response parsing error (malformed JSON)
         - Conversation memory not working
-        - TTS (Text-to-Speech) not working
         - Other
     validations:
       required: true
@@ -66,7 +65,7 @@ body:
       label: Error Logs
       description: |
         Please provide backend logs showing the API error.
-        Look for errors related to ModelScope, OpenAI client, or JSON parsing.
+        Look for errors related to OpenAI client or JSON parsing.
       placeholder: Paste relevant logs here...
 
   - type: checkboxes
@@ -75,9 +74,9 @@ body:
       label: API Configuration Checklist
       description: Please confirm the following
       options:
-        - label: MODELSCOPE_SDK_TOKEN environment variable is set
+        - label: OPENAI_API_KEY environment variable is set
+        - label: OPENAI_BASE_URL is correct
         - label: API endpoint is accessible from my network
-        - label: I have verified my API token is valid
 
   - type: textarea
     id: additional

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -14,13 +14,15 @@ body:
       label: Affected Component
       description: Which part of MomShell is affected?
       options:
-        - Soulful Companion (Chat)
-        - Recovery Coach (Exercise/Pose Detection)
-        - Community (Q&A/Posts)
-        - Frontend/UI
-        - Backend/API
+        - Soul Companion (Chat)
+        - Sisterhood Bond (Community)
+        - Echo / Memoir
+        - Admin Panel
+        - Auth / Login / Registration
+        - Frontend / UI
+        - Backend / API
         - Database
-        - Deployment/Docker
+        - Deployment / Docker
         - Other
     validations:
       required: true
@@ -61,7 +63,7 @@ body:
       label: Error Logs / Screenshots
       description: |
         If applicable, add error logs or screenshots to help explain the problem.
-        - For backend errors: Check terminal/Docker logs
+        - For backend errors: Check terminal or `make docker-logs`
         - For frontend errors: Check browser console (F12 → Console)
       placeholder: Paste logs or drag-and-drop screenshots here...
 
@@ -71,9 +73,8 @@ body:
       label: Deployment Method
       description: How is MomShell deployed?
       options:
-        - Local Development (uvicorn + npm run dev)
-        - Docker Compose
-        - Single Container
+        - Local Development (make dev-backend + make dev-frontend)
+        - Docker Compose (make docker-up)
         - Other
     validations:
       required: true
@@ -83,7 +84,7 @@ body:
     attributes:
       label: Operating System
       description: What OS are you running on?
-      placeholder: "e.g., Ubuntu 22.04, Windows 11, macOS 14"
+      placeholder: "e.g., Ubuntu 22.04, Arch Linux, Windows 11, macOS 14"
     validations:
       required: true