fix: db path error, add i18n.

Author: PttCodingMan

.env.example

@@ -4,9 +4,11 @@ ADMIN_USER=admin
 ADMIN_PASS=admin
 
 # ── 路徑 ──
-DATA_DIR=./data
-DB_PATH=./data/just-wiki.db
-MEDIA_DIR=./data/media
+# Resolved relative to the process cwd (repo root for `make dev-backend`).
+# Docker overrides these to /app/data/... in docker-compose.yml.
+DATA_DIR=./backend/data
+DB_PATH=./backend/data/just-wiki.db
+MEDIA_DIR=./backend/data/media
 
 # ── Security ──
 COOKIE_SECURE=false  # Set to true in production with HTTPS

CLAUDE.md

@@ -65,7 +65,7 @@ These are separate systems with independent rendering logic — changes to one d
 - **Viewer**: `components/Viewer/MarkdownViewer.jsx` — Renders via `lib/markdown.js`. Sanitized with DOMPurify.
 - **Markdown pipeline**: `lib/markdown.js` — Centralized markdown-it + GFM pipeline. Adds callout blocks (`:::info/warning/tip/danger`), wikilinks (`[[slug]]`, `[[slug|text]]`), transclusion (`![[slug]]`), KaTeX (`$...$`, `$$...$$`), Mermaid fences, Draw.io embeds (`::drawio[id]`). Both the Viewer and any other rendering must go through this module.
 
-### Database (SQLite, single file at `data/just-wiki.db`)
+### Database (SQLite, single file at `backend/data/just-wiki.db` in dev, `/app/data/just-wiki.db` in docker)
 
 Key tables: `users`, `pages` (with `parent_id` hierarchy and `slug` URL), `page_versions`, `tags`, `page_tags`, `backlinks`, `templates`, `media`, `media_references`, `diagrams`, `comments`, `bookmarks`, `activity_log`, `page_acl`, `groups`, `group_members`, `page_watchers`, `notifications`, `view_dedup`. FTS5 virtual table `search_index` for full-text search with CJK support.
 

Makefile

@@ -6,7 +6,7 @@ dev:
 	@make dev-frontend
 
 dev-backend:
-	cd backend && source .venv/bin/activate && PYTHON_GIL=1 uvicorn app.main:app --reload --port 8000
+	source backend/.venv/bin/activate && PYTHON_GIL=1 uvicorn app.main:app --reload --reload-dir backend --port 8000 --app-dir backend
 
 dev-frontend:
 	cd frontend && npm run dev

README.en.md

@@ -100,7 +100,7 @@ Key variables:
 | `SECRET_KEY`    | Session signing key                | `change-me-...`      |
 | `ADMIN_USER`    | Admin username                     | `admin`              |
 | `ADMIN_PASS`    | Admin password                     | `admin`              |
-| `DB_PATH`       | SQLite database path               | `./data/just-wiki.db`|
+| `DB_PATH`       | SQLite database path               | `./backend/data/just-wiki.db`|
 | `AI_ENABLED`    | Enable AI chat                     | `false`              |
 | `AI_API_KEY`    | LLM provider API key (required if enabled) | —            |
 

README.md

@@ -96,7 +96,7 @@ docker-compose up -d
 | `SECRET_KEY`      | Session 簽章金鑰              | `change-me-...`       |
 | `ADMIN_USER`      | 管理員帳號                    | `admin`               |
 | `ADMIN_PASS`      | 管理員密碼                    | `admin`               |
-| `DB_PATH`         | SQLite 資料庫路徑             | `./data/just-wiki.db` |
+| `DB_PATH`         | SQLite 資料庫路徑             | `./backend/data/just-wiki.db` |
 | `AI_ENABLED`      | 啟用 AI 問答功能              | `false`               |
 | `AI_API_KEY`      | LLM 供應商 API 金鑰（啟用時必填） | —                     |
 

backend/app/database.py

@@ -1169,10 +1169,11 @@ def hello():
 
 Welcome to JustWiki! The pages below walk you through what the wiki can do in both English and 中文. Feel free to edit or delete them once your team has settled in.
 
-- [[welcome|Welcome to JustWiki]] — English walkthrough
 - [[welcome-zh|歡迎使用 JustWiki]] — 中文導覽
-- [[welcome-mindmap|JustWiki Feature Mindmap]] — English mindmap overview
 - [[welcome-mindmap-zh|JustWiki 功能心智圖]] — 中文心智圖總覽
+- [[welcome|Welcome to JustWiki]] — English walkthrough
+- [[welcome-mindmap|JustWiki Feature Mindmap]] — English mindmap overview
+
 """
 
 

docker-compose.yml

@@ -9,6 +9,13 @@ services:
     volumes:
       - ./data:/app/data
     env_file: .env
+    # Override the dev-oriented paths in .env so the container reads/writes
+    # the mounted /app/data volume regardless of what DATA_DIR is set to in
+    # the shared .env file.
+    environment:
+      DATA_DIR: /app/data
+      DB_PATH: /app/data/just-wiki.db
+      MEDIA_DIR: /app/data/media
     restart: unless-stopped
 
   frontend:

frontend/package-lock.json

@@ -26,6 +26,8 @@
     "@prosemirror-adapter/react": "^0.5.3",
     "axios": "^1.15.0",
     "dompurify": "^3.3.3",
+    "i18next": "^26.0.8",
+    "i18next-browser-languagedetector": "^8.2.1",
     "katex": "^0.16.45",
     "markdown-it": "^14.1.1",
     "markdown-it-container": "^4.0.0",
@@ -34,6 +36,7 @@
     "react-dom": "^19.2.4",
     "react-force-graph-2d": "^1.29.1",
     "react-force-graph-3d": "^1.29.1",
+    "react-i18next": "^17.0.4",
     "react-router-dom": "^7.14.0",
     "remark-math": "^6.0.0",
     "three": "^0.184.0",

frontend/package.json

@@ -1,5 +1,6 @@
 import { Routes, Route, Navigate, Outlet, useLocation } from 'react-router-dom'
 import { lazy, Suspense, useEffect } from 'react'
+import { useTranslation } from 'react-i18next'
 import useAuth from './store/useAuth'
 import useTheme from './store/useTheme'
 import useSettings from './store/useSettings'
@@ -37,13 +38,14 @@ import PageOrPublicView from './pages/PageOrPublicView'
  * notification bell unmounting and refetching.
  */
 function AuthGate() {
+  const { t } = useTranslation()
   const { user, loading } = useAuth()
   const location = useLocation()
   const homeSlug = useSettings((s) => s.home_page_slug)
   const settingsLoaded = useSettings((s) => s.loaded)
 
   if (loading || !settingsLoaded) {
-    return <div className="flex items-center justify-center h-screen">Loading...</div>
+    return <div className="flex items-center justify-center h-screen">{t('common.loading')}</div>
   }
 
   if (user) {
@@ -87,6 +89,7 @@ function RoleRoute({ role }) {
 }
 
 export default function App() {
+  const { t } = useTranslation()
   const { checkAuth } = useAuth()
   const initTheme = useTheme((s) => s.init)
   const fetchSettings = useSettings((s) => s.fetch)
@@ -118,7 +121,7 @@ export default function App() {
         <Route
           path="/graph"
           element={
-            <Suspense fallback={<div className="text-text-secondary">Loading graph…</div>}>
+            <Suspense fallback={<div className="text-text-secondary">{t('common.loadingGraph')}</div>}>
               <GraphView />
             </Suspense>
           }
@@ -127,7 +130,7 @@ export default function App() {
           <Route
             path="/admin"
             element={
-              <Suspense fallback={<div className="text-text-secondary">Loading admin…</div>}>
+              <Suspense fallback={<div className="text-text-secondary">{t('common.loadingAdmin')}</div>}>
                 <Admin />
               </Suspense>
             }