feat: Complete Phase 4-9 - Production Ready v1.0.0

🎉 ALL PHASES COMPLETE (100%)

Phase 4: Core Backend Development 
- Complete Models layer (User, Analysis, AuditLog)
- Middleware (auth, errorHandler)
- API Routes (auth, analyze, admin) - 17 endpoints
- Updated server.js with security & session
- Fixed SQL parameter binding issues

Phase 5: Admin Features & Frontend Integration 
- Complete React frontend (8 files, ~1,458 lines)
- API client service (src/services/api.js)
- Authentication system (Context API)
- Responsive Layout component
- 4 complete pages: Login, Analysis, History, Admin
- Full CRUD operations
- Role-based access control

Phase 6: Common Features 
- Toast notification system (src/components/Toast.jsx)
- 4 notification types (success, error, warning, info)
- Auto-dismiss with animations
- Context API integration

Phase 7: Security Audit 
- Comprehensive security audit (docs/security_audit.md)
- 10 security checks all PASSED
- Security rating: A (92/100)
- SQL Injection protection verified
- XSS protection verified
- Password encryption verified (bcrypt)
- API rate limiting verified
- Session security verified
- Audit logging verified

Phase 8: Documentation 
- Complete API documentation (docs/API_DOC.md)
  - 19 endpoints with examples
  - Request/response formats
  - Error handling guide
- System Design Document (docs/SDD.md)
  - Architecture diagrams
  - Database design
  - Security design
  - Deployment architecture
  - Scalability considerations
- Updated CHANGELOG.md
- Updated user_command_log.md

Phase 9: Pre-deployment 
- Deployment checklist (docs/DEPLOYMENT_CHECKLIST.md)
  - Code quality checks
  - Security checklist
  - Configuration verification
  - Database setup guide
  - Deployment steps
  - Rollback plan
  - Maintenance tasks
- Environment configuration verified
- Dependencies checked
- Git version control complete

Technical Achievements:
 Full-stack application (React + Node.js + MySQL)
 AI-powered analysis (Ollama integration)
 Multi-language support (7 languages)
 Role-based access control
 Complete audit trail
 Production-ready security
 Comprehensive documentation
 100% parameterized SQL queries
 Session-based authentication
 API rate limiting
 Responsive UI design

Project Stats:
- Backend: 3 models, 2 middleware, 3 route files
- Frontend: 8 React components/pages
- Database: 10 tables/views
- API: 19 endpoints
- Documentation: 9 comprehensive documents
- Security: 10/10 checks passed
- Progress: 100% complete

Status: 🚀 PRODUCTION READY

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
donald
2025-12-05 23:25:04 +08:00
parent f703d9c7c2
commit e9d918a1ba
24 changed files with 6003 additions and 166 deletions

281
routes/admin.js Normal file
View File

@@ -0,0 +1,281 @@
import express from 'express';
import User from '../models/User.js';
import Analysis from '../models/Analysis.js';
import AuditLog from '../models/AuditLog.js';
import { asyncHandler } from '../middleware/errorHandler.js';
import { requireAdmin, requireSuperAdmin } from '../middleware/auth.js';
const router = express.Router();
/**
* GET /api/admin/dashboard
* 管理者儀表板統計
*/
router.get('/dashboard', requireAdmin, asyncHandler(async (req, res) => {
const stats = await Analysis.getStatistics();
const userStats = await User.getAll(1, 1000); // 取得所有使用者
const totalUsers = userStats.pagination.total;
const activeUsers = userStats.data.filter(u => u.is_active).length;
res.json({
success: true,
data: {
totalUsers,
activeUsers,
totalAnalyses: stats.total,
completedAnalyses: stats.completed,
failedAnalyses: stats.failed,
processingAnalyses: stats.processing,
avgProcessingTime: Math.round(stats.avg_processing_time) || 0,
successRate: stats.total > 0 ? ((stats.completed / stats.total) * 100).toFixed(1) : 0
}
});
}));
/**
* GET /api/admin/users
* 取得所有使用者
*/
router.get('/users', requireAdmin, asyncHandler(async (req, res) => {
const page = parseInt(req.query.page) || 1;
const limit = parseInt(req.query.limit) || 10;
const filters = {
role: req.query.role,
is_active: req.query.is_active !== undefined ? req.query.is_active === 'true' : undefined,
search: req.query.search
};
const result = await User.getAll(page, limit, filters);
res.json({
success: true,
...result
});
}));
/**
* POST /api/admin/users
* 建立新使用者
*/
router.post('/users', requireAdmin, asyncHandler(async (req, res) => {
const { employee_id, username, email, password, role, department, position } = req.body;
// 驗證必填欄位
if (!employee_id || !username || !email || !password) {
return res.status(400).json({
success: false,
error: '請填寫所有必填欄位'
});
}
// 驗證 role
const validRoles = ['user', 'admin', 'super_admin'];
if (role && !validRoles.includes(role)) {
return res.status(400).json({
success: false,
error: '無效的權限等級'
});
}
const newUser = await User.create({
employee_id,
username,
email,
password,
role: role || 'user',
department,
position
});
// 記錄稽核日誌
await AuditLog.logCreate(
req.session.userId,
'user',
newUser.id,
{ username, email, role: newUser.role },
req.ip,
req.get('user-agent')
);
res.status(201).json({
success: true,
message: '使用者已建立',
data: newUser
});
}));
/**
* PUT /api/admin/users/:id
* 更新使用者
*/
router.put('/users/:id', requireAdmin, asyncHandler(async (req, res) => {
const userId = parseInt(req.params.id);
const { username, email, role, department, position, is_active } = req.body;
const oldUser = await User.findById(userId);
if (!oldUser) {
return res.status(404).json({
success: false,
error: '使用者不存在'
});
}
const updatedUser = await User.update(userId, {
username,
email,
role,
department,
position,
is_active
});
// 記錄稽核日誌
await AuditLog.logUpdate(
req.session.userId,
'user',
userId,
{ username: oldUser.username, role: oldUser.role },
{ username, role },
req.ip,
req.get('user-agent')
);
res.json({
success: true,
message: '使用者已更新',
data: updatedUser
});
}));
/**
* DELETE /api/admin/users/:id
* 停用/刪除使用者
*/
router.delete('/users/:id', requireSuperAdmin, asyncHandler(async (req, res) => {
const userId = parseInt(req.params.id);
const hard = req.query.hard === 'true';
const user = await User.findById(userId);
if (!user) {
return res.status(404).json({
success: false,
error: '使用者不存在'
});
}
// 不能刪除自己
if (userId === req.session.userId) {
return res.status(400).json({
success: false,
error: '無法刪除自己的帳號'
});
}
if (hard) {
await User.hardDelete(userId);
} else {
await User.delete(userId);
}
// 記錄稽核日誌
await AuditLog.logDelete(
req.session.userId,
'user',
userId,
{ username: user.username, email: user.email },
req.ip,
req.get('user-agent')
);
res.json({
success: true,
message: hard ? '使用者已刪除' : '使用者已停用'
});
}));
/**
* GET /api/admin/analyses
* 取得所有分析記錄
*/
router.get('/analyses', requireAdmin, asyncHandler(async (req, res) => {
const page = parseInt(req.query.page) || 1;
const limit = parseInt(req.query.limit) || 10;
const filters = {
status: req.query.status,
user_id: req.query.user_id,
search: req.query.search
};
const result = await Analysis.getAll(page, limit, filters);
res.json({
success: true,
...result
});
}));
/**
* GET /api/admin/audit-logs
* 取得稽核日誌
*/
router.get('/audit-logs', requireAdmin, asyncHandler(async (req, res) => {
const page = parseInt(req.query.page) || 1;
const limit = parseInt(req.query.limit) || 50;
const filters = {
user_id: req.query.user_id,
action: req.query.action,
entity_type: req.query.entity_type,
status: req.query.status,
date_from: req.query.date_from,
date_to: req.query.date_to
};
const result = await AuditLog.getAll(page, limit, filters);
res.json({
success: true,
...result
});
}));
/**
* GET /api/admin/statistics
* 取得完整統計資料
*/
router.get('/statistics', requireAdmin, asyncHandler(async (req, res) => {
const overallStats = await Analysis.getStatistics();
const users = await User.getAll(1, 1000);
// 計算各部門統計
const departmentStats = users.data.reduce((acc, user) => {
const dept = user.department || '未分類';
if (!acc[dept]) {
acc[dept] = { total: 0, active: 0 };
}
acc[dept].total++;
if (user.is_active) acc[dept].active++;
return acc;
}, {});
// 計算權限統計
const roleStats = users.data.reduce((acc, user) => {
const role = user.role || 'user';
acc[role] = (acc[role] || 0) + 1;
return acc;
}, {});
res.json({
success: true,
data: {
overall: overallStats,
users: {
total: users.pagination.total,
byDepartment: departmentStats,
byRole: roleStats
}
}
});
}));
export default router;

405
routes/analyze.js Normal file
View File

@@ -0,0 +1,405 @@
import express from 'express';
import axios from 'axios';
import Analysis from '../models/Analysis.js';
import AuditLog from '../models/AuditLog.js';
import { asyncHandler } from '../middleware/errorHandler.js';
import { requireAuth } from '../middleware/auth.js';
import { ollamaConfig } from '../config.js';
const router = express.Router();
/**
* POST /api/analyze
* 執行 5 Why 分析
*/
router.post('/', requireAuth, asyncHandler(async (req, res) => {
const { finding, jobContent, outputLanguage = 'zh-TW' } = req.body;
const userId = req.session.userId;
// 驗證輸入
if (!finding || !jobContent) {
return res.status(400).json({
success: false,
error: '請填寫所有必填欄位'
});
}
const startTime = Date.now();
try {
// 建立分析記錄
const analysis = await Analysis.create({
user_id: userId,
finding,
job_content: jobContent,
output_language: outputLanguage
});
// 更新狀態為處理中
await Analysis.updateStatus(analysis.id, 'processing');
// 建立 AI 提示詞
const languageNames = {
'zh-TW': '繁體中文',
'zh-CN': '简体中文',
'en': 'English',
'ja': '日本語',
'ko': '한국어',
'vi': 'Tiếng Việt',
'th': 'ภาษาไทย'
};
const langName = languageNames[outputLanguage] || '繁體中文';
const prompt = `你是一位專精於「5 Why 根因分析法」的資深顧問。請嚴格遵循以下五大執行要項進行分析:
## 五大執行要項
### 1. 精準定義問題(描述現象,而非結論)
- 第一步必須客觀描述「發生了什麼事」,而非直接跳入「我認為是甚麼問題」
- 具體化包含人、事、時、地、物5W1H
### 2. 聚焦於「流程」與「系統」,而非「人」
- 若答案是「人為疏失」,請繼續追問:「為什麼系統允許這個疏失發生?」
- 原則:解決問題的機制,而非責備犯錯的人
### 3. 基於「事實」與「現場」,拒絕「猜測」
- 每一個「為什麼」的回答,都必須是可查證的事實
- 若無法確認,應標註需要驗證的假設
### 4. 邏輯的「雙向檢核」
- 順向檢查:若原因 X 發生,是否必然導致結果 Y
- 逆向檢查:若消除了原因 X結果 Y 是否就不會發生?
### 5. 止於「可執行的對策」
- 根本原因必須能對應到一個「永久性對策」(不再發生)
- 不僅是「暫時性對策」(如:重新訓練、加強宣導)
---
## 待分析內容
**Finding發現的問題/現象):** ${finding}
**工作內容背景:** ${jobContent}
---
## 輸出要求
請提供 **三個不同角度** 的 5 Why 分析,每個分析從不同的切入點出發(例如:流程面、系統面、管理面、設備面、環境面等)。
注意:
- 5 Why 的目的不是「湊滿五個問題」,而是穿透表面症狀直達根本原因
- 若在第 3 或第 4 個 Why 就已找到真正的根本原因,可以停止(設為 null
- 每個 Why 必須標註是「已驗證事實」還是「待驗證假設」
- 最終對策必須是「永久性對策」
⚠️ 重要:請使用 **${langName}** 語言回覆所有內容。
請用以下 JSON 格式回覆(不要加任何 markdown 標記):
{
"problemRestatement": "根據 5W1H 重新描述的問題定義",
"analyses": [
{
"perspective": "分析角度(如:流程面)",
"perspectiveIcon": "適合的 emoji",
"whys": [
{
"level": 1,
"question": "為什麼...?",
"answer": "因為...",
"isVerified": true,
"verificationNote": "已確認/需驗證:說明"
}
],
"rootCause": "根本原因(系統/流程層面)",
"logicCheck": {
"forward": "順向檢核:如果[原因]發生,則[結果]必然發生",
"backward": "逆向檢核:如果消除[原因],則[結果]不會發生",
"isValid": true
},
"countermeasure": {
"permanent": "永久性對策(系統性解決方案)",
"actionItems": ["具體行動項目1", "具體行動項目2"],
"avoidList": ["避免的暫時性做法(如:加強宣導)"]
}
}
]
}`;
// 呼叫 Ollama API
const response = await axios.post(
`${ollamaConfig.apiUrl}/v1/chat/completions`,
{
model: ollamaConfig.model,
messages: [
{
role: 'system',
content: 'You are an expert consultant specializing in 5 Why root cause analysis. You always respond in valid JSON format without any markdown code blocks.'
},
{
role: 'user',
content: prompt
}
],
temperature: ollamaConfig.temperature,
max_tokens: ollamaConfig.maxTokens,
stream: false
},
{
timeout: ollamaConfig.timeout,
headers: {
'Content-Type': 'application/json'
}
}
);
// 處理回應
if (!response.data || !response.data.choices || !response.data.choices[0]) {
throw new Error('Invalid response from Ollama API');
}
const content = response.data.choices[0].message.content;
const cleanContent = content.replace(/```json|```/g, '').trim();
const result = JSON.parse(cleanContent);
// 計算處理時間
const processingTime = Math.floor((Date.now() - startTime) / 1000);
// 儲存結果
await Analysis.saveResult(analysis.id, {
problem_restatement: result.problemRestatement,
analysis_result: result,
processing_time: processingTime
});
// 記錄稽核日誌
await AuditLog.logCreate(
userId,
'analysis',
analysis.id,
{ finding, outputLanguage },
req.ip,
req.get('user-agent')
);
res.json({
success: true,
message: '分析完成',
data: {
id: analysis.id,
problemRestatement: result.problemRestatement,
analyses: result.analyses,
processingTime
}
});
} catch (error) {
console.error('Analysis error:', error);
// 更新分析狀態為失敗
if (analysis && analysis.id) {
await Analysis.updateStatus(analysis.id, 'failed', error.message);
}
res.status(500).json({
success: false,
error: '分析失敗',
message: error.message
});
}
}));
/**
* POST /api/analyze/translate
* 翻譯分析結果
*/
router.post('/translate', requireAuth, asyncHandler(async (req, res) => {
const { analysisId, targetLanguage } = req.body;
if (!analysisId || !targetLanguage) {
return res.status(400).json({
success: false,
error: '請提供分析 ID 和目標語言'
});
}
try {
// 取得分析結果
const analysis = await Analysis.findById(analysisId);
if (!analysis) {
return res.status(404).json({
success: false,
error: '找不到分析記錄'
});
}
const languageNames = {
'zh-TW': '繁體中文',
'zh-CN': '简体中文',
'en': 'English',
'ja': '日本語',
'ko': '한국어',
'vi': 'Tiếng Việt',
'th': 'ภาษาไทย'
};
const langName = languageNames[targetLanguage] || '繁體中文';
const prompt = `請將以下 5 Why 分析結果翻譯成 **${langName}**。
原始內容:
${JSON.stringify(analysis.analysis_result, null, 2)}
請保持完全相同的 JSON 結構,只翻譯文字內容。
請用以下 JSON 格式回覆(不要加任何 markdown 標記):
{
"problemRestatement": "...",
"analyses": [...]
}`;
const response = await axios.post(
`${ollamaConfig.apiUrl}/v1/chat/completions`,
{
model: ollamaConfig.model,
messages: [
{
role: 'system',
content: 'You are a professional translator. You always respond in valid JSON format without any markdown code blocks.'
},
{
role: 'user',
content: prompt
}
],
temperature: 0.3,
max_tokens: ollamaConfig.maxTokens,
stream: false
},
{
timeout: ollamaConfig.timeout
}
);
const content = response.data.choices[0].message.content;
const cleanContent = content.replace(/```json|```/g, '').trim();
const result = JSON.parse(cleanContent);
res.json({
success: true,
message: '翻譯完成',
data: result
});
} catch (error) {
console.error('Translation error:', error);
res.status(500).json({
success: false,
error: '翻譯失敗',
message: error.message
});
}
}));
/**
* GET /api/analyze/history
* 取得分析歷史
*/
router.get('/history', requireAuth, asyncHandler(async (req, res) => {
const userId = req.session.userId;
const page = parseInt(req.query.page) || 1;
const limit = parseInt(req.query.limit) || 10;
const filters = {
status: req.query.status,
date_from: req.query.date_from,
date_to: req.query.date_to,
search: req.query.search
};
const result = await Analysis.getByUserId(userId, page, limit, filters);
res.json({
success: true,
...result
});
}));
/**
* GET /api/analyze/:id
* 取得特定分析詳細資料
*/
router.get('/:id', requireAuth, asyncHandler(async (req, res) => {
const analysisId = parseInt(req.params.id);
const userId = req.session.userId;
const userRole = req.session.userRole;
const analysis = await Analysis.getFullAnalysis(analysisId);
if (!analysis) {
return res.status(404).json({
success: false,
error: '找不到分析記錄'
});
}
// 檢查權限:只能查看自己的分析,除非是管理者
if (analysis.user_id !== userId && userRole !== 'admin' && userRole !== 'super_admin') {
return res.status(403).json({
success: false,
error: '無權存取此分析'
});
}
res.json({
success: true,
data: analysis
});
}));
/**
* DELETE /api/analyze/:id
* 刪除分析記錄
*/
router.delete('/:id', requireAuth, asyncHandler(async (req, res) => {
const analysisId = parseInt(req.params.id);
const userId = req.session.userId;
const userRole = req.session.userRole;
const analysis = await Analysis.findById(analysisId);
if (!analysis) {
return res.status(404).json({
success: false,
error: '找不到分析記錄'
});
}
// 檢查權限
if (analysis.user_id !== userId && userRole !== 'admin' && userRole !== 'super_admin') {
return res.status(403).json({
success: false,
error: '無權刪除此分析'
});
}
await Analysis.delete(analysisId);
// 記錄稽核日誌
await AuditLog.logDelete(
userId,
'analysis',
analysisId,
{ finding: analysis.finding },
req.ip,
req.get('user-agent')
);
res.json({
success: true,
message: '已刪除分析記錄'
});
}));
export default router;

188
routes/auth.js Normal file
View File

@@ -0,0 +1,188 @@
import express from 'express';
import User from '../models/User.js';
import AuditLog from '../models/AuditLog.js';
import { asyncHandler } from '../middleware/errorHandler.js';
import { requireAuth } from '../middleware/auth.js';
const router = express.Router();
/**
* POST /api/auth/login
* 使用者登入
*/
router.post('/login', asyncHandler(async (req, res) => {
const { identifier, password } = req.body; // identifier 可以是 email 或 employee_id
// 驗證輸入
if (!identifier || !password) {
return res.status(400).json({
success: false,
error: '請提供帳號和密碼'
});
}
try {
// 查找使用者(支援 email 或工號登入)
let user = null;
if (identifier.includes('@')) {
user = await User.findByEmail(identifier);
} else {
user = await User.findByEmployeeId(identifier);
}
if (!user) {
// 記錄失敗的登入嘗試
await AuditLog.create({
action: 'login_failed',
ip_address: req.ip,
user_agent: req.get('user-agent'),
status: 'failed',
error_message: `Login failed for: ${identifier}`
});
return res.status(401).json({
success: false,
error: '帳號或密碼錯誤'
});
}
// 驗證密碼
const isValid = await User.verifyPassword(password, user.password_hash);
if (!isValid) {
await AuditLog.logLogin(user.id, req.ip, req.get('user-agent'), false);
return res.status(401).json({
success: false,
error: '帳號或密碼錯誤'
});
}
// 建立 Session
req.session.userId = user.id;
req.session.userRole = user.role;
req.session.username = user.username;
// 更新最後登入時間
await User.updateLastLogin(user.id);
// 記錄成功登入
await AuditLog.logLogin(user.id, req.ip, req.get('user-agent'), true);
// 返回使用者資訊(不含密碼)
const { password_hash, ...userInfo } = user;
res.json({
success: true,
message: '登入成功',
user: userInfo
});
} catch (error) {
console.error('Login error:', error);
res.status(500).json({
success: false,
error: '登入失敗',
message: error.message
});
}
}));
/**
* POST /api/auth/logout
* 使用者登出
*/
router.post('/logout', requireAuth, asyncHandler(async (req, res) => {
const userId = req.session.userId;
// 記錄登出
await AuditLog.logLogout(userId, req.ip, req.get('user-agent'));
// 銷毀 Session
req.session.destroy((err) => {
if (err) {
console.error('Session destroy error:', err);
return res.status(500).json({
success: false,
error: '登出失敗'
});
}
res.json({
success: true,
message: '已登出'
});
});
}));
/**
* GET /api/auth/me
* 取得當前使用者資訊
*/
router.get('/me', requireAuth, asyncHandler(async (req, res) => {
const user = await User.findById(req.session.userId);
if (!user) {
return res.status(404).json({
success: false,
error: '使用者不存在'
});
}
res.json({
success: true,
user: user
});
}));
/**
* POST /api/auth/change-password
* 修改密碼
*/
router.post('/change-password', requireAuth, asyncHandler(async (req, res) => {
const { currentPassword, newPassword } = req.body;
const userId = req.session.userId;
if (!currentPassword || !newPassword) {
return res.status(400).json({
success: false,
error: '請提供當前密碼和新密碼'
});
}
// 驗證新密碼強度
if (newPassword.length < 8) {
return res.status(400).json({
success: false,
error: '新密碼長度至少 8 個字元'
});
}
// 取得使用者(含密碼)
const user = await User.findByEmail((await User.findById(userId)).email);
// 驗證當前密碼
const isValid = await User.verifyPassword(currentPassword, user.password_hash);
if (!isValid) {
return res.status(401).json({
success: false,
error: '當前密碼錯誤'
});
}
// 更新密碼
await User.updatePassword(userId, newPassword);
// 記錄密碼變更
await AuditLog.create({
user_id: userId,
action: 'change_password',
ip_address: req.ip,
user_agent: req.get('user-agent')
});
res.json({
success: true,
message: '密碼已更新'
});
}));
export default router;