diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..420be3d --- /dev/null +++ b/.gitignore @@ -0,0 +1,37 @@ +# Dependencies +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* + +# Environment variables +.env +.env.local +.env.*.local + +# IDEs and Editors +.vscode/ +.idea/ +*.swp +*.swo +*~ +.DS_Store + +# Temporary files +/tmp/ +*.tmp +*.log + +# Build outputs +dist/ +build/ +*.pid +*.seed +*.pid.lock + +# Test coverage +coverage/ +.nyc_output/ + +# OS files +Thumbs.db diff --git a/README.md b/README.md index 3b37fad..cdf1a75 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,194 @@ -# shendaoen -Transform World +# ๐ŸŒ Transform World - ๆ”นๅ˜ไธ–็•Œ็š„็Ÿฅ่ฏ†ๅนณๅฐ + +> **"็Ÿฅ่ฏ†ๆ˜ฏๆ”นๅ˜ไธ–็•Œๆœ€ๅผบๅคง็š„ๅทฅๅ…ท"** | *"Knowledge is the most powerful tool to transform the world"* + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Node.js](https://img.shields.io/badge/node-%3E%3D%2018.0.0-brightgreen)](https://nodejs.org/) + +## ๐ŸŽฏ Vision | ๆ„ฟๆ™ฏ + +Transform World is an open-source knowledge-sharing platform that democratizes education and empowers people globally to learn, collaborate, and create positive change. We believe that accessible knowledge can solve the world's greatest challenges. + +**Our Mission:** +- ๐ŸŒ Break down barriers to quality education +- ๐Ÿค Connect learners and educators worldwide +- ๐Ÿ’ก Foster innovation and problem-solving +- ๐ŸŒฑ Cultivate the next generation of world-changers +- โ™ป๏ธ Promote sustainable development through technology + +## โœจ How This Software Can Change the World + +1. **Democratized Education**: Free access to knowledge for everyone, regardless of location or economic status +2. **Global Collaboration**: Connecting minds across borders to solve complex problems +3. **Scalable Impact**: One platform can reach millions of learners simultaneously +4. **Open Source**: Transparent, auditable, and community-driven development +5. **Sustainable Development**: Digital platform with minimal environmental footprint +6. **Cultural Exchange**: Multilingual support promoting cross-cultural understanding + +## ๐Ÿš€ Quick Start + +### Prerequisites +- Node.js (v18.0.0 or higher - LTS version recommended) +- No external dependencies required - uses built-in Node.js modules! + +### Installation & Running + +```bash +# Clone the repository +git clone https://github.com/donglovejava/shendaoen.git +cd shendaoen + +# Start the server +npm start + +# Or run directly +node src/app.js +``` + +The platform will be available at: +- ๐Ÿ–ฅ๏ธ **Web Interface**: http://localhost:3000 +- ๐Ÿ”Œ **REST API**: http://localhost:3000/api/articles + +## ๐Ÿ“š Features + +### Web Interface +- Beautiful, responsive design with bilingual support (ไธญๆ–‡/English) +- Browse curated knowledge articles +- View platform statistics in real-time +- Modern gradient UI with smooth animations +- Mobile-friendly responsive layout + +### REST API Endpoints + +```bash +# Get all articles +GET /api/articles + +# Get specific article +GET /api/articles/:id + +# Create new article +POST /api/articles +Content-Type: application/json +{ + "title": "Your Title", + "content": "Your content", + "category": "Category", + "impact": "้ซ˜" +} + +# Get platform statistics +GET /api/stats +``` + +### Example API Usage + +```bash +# Fetch all knowledge articles +curl http://localhost:3000/api/articles + +# Get platform statistics +curl http://localhost:3000/api/stats + +# Create new article +curl -X POST http://localhost:3000/api/articles \ + -H "Content-Type: application/json" \ + -d '{ + "title": "ๆ–ฐ็Ÿฅ่ฏ†ๅˆ†ไบซ", + "content": "่ฟ™ๆ˜ฏไธ€ไธชๆ”นๅ˜ไธ–็•Œ็š„ๆƒณๆณ•...", + "category": "ๅˆ›ๆ–ฐ", + "impact": "้ซ˜", + "author": "Your Name (optional, defaults to ๅŒฟๅ)" + }' +``` + +### API Request Requirements + +**POST /api/articles** requires: +- `title` (string, required): Article title +- `content` (string, required): Article content +- `category` (string, required): Article category +- `impact` (string, required): Must be either "้ซ˜" (High) or "ๅ…ณ้”ฎ" (Critical) +- `author` (string, optional): Author name, defaults to "ๅŒฟๅ" (Anonymous) if not provided + +All string fields will be trimmed of whitespace. Maximum request body size is 1MB. + +## ๐ŸŒŸ Core Concepts + +### Knowledge Categories +- ๐ŸŽ“ **ๆŠ€ๆœฏๆ•™่‚ฒ** (Technology Education) +- ๐Ÿค **ๅผ€ๆบๆ–‡ๅŒ–** (Open Source Culture) +- โ™ป๏ธ **ๅฏๆŒ็ปญๅ‘ๅฑ•** (Sustainable Development) +- ๐Ÿ’ก **ๅˆ›ๆ–ฐๆ€็ปด** (Innovation) +- ๐ŸŒ **ๅ…จ็ƒๅไฝœ** (Global Collaboration) + +### Impact Levels +- **้ซ˜** (High): Significant positive impact on communities +- **ๅ…ณ้”ฎ** (Critical): Game-changing potential for global issues + +## ๐Ÿ› ๏ธ Technology Stack + +- **Runtime**: Node.js (built-in modules only) +- **Architecture**: RESTful API with server-side rendering +- **Storage**: In-memory (easily extensible to database) +- **Frontend**: Pure HTML5 + CSS3 (no frameworks needed) +- **Deployment**: Works on any platform supporting Node.js + +## ๐Ÿค Contributing + +We welcome contributions from everyone! Here's how you can help: + +1. **Add Knowledge**: Submit new educational content via API +2. **Improve Code**: Fork, improve, and submit pull requests +3. **Translate**: Help make content accessible in more languages +4. **Share Ideas**: Open issues with suggestions for improvement +5. **Spread the Word**: Share this project with others + +## ๐Ÿ“ˆ Roadmap + +- [x] Core knowledge-sharing platform +- [x] REST API with CRUD operations +- [x] Bilingual web interface +- [ ] User authentication system +- [ ] Database integration (MongoDB/PostgreSQL) +- [ ] Advanced search and filtering +- [ ] Multi-language support (Spanish, French, Arabic, etc.) +- [ ] Mobile applications (iOS/Android) +- [ ] AI-powered content recommendations +- [ ] Real-time collaboration features +- [ ] Integration with popular learning platforms + +## ๐Ÿ’ก Real-World Applications + +This platform can be adapted for: +- ๐Ÿซ **Schools & Universities**: Digital learning platforms +- ๐Ÿข **Corporations**: Internal knowledge management +- ๐ŸŒ **NGOs**: Community education programs +- ๐Ÿ›๏ธ **Governments**: Public information systems +- ๐Ÿ‘ฅ **Communities**: Local knowledge sharing networks + +## ๐Ÿ”’ Security & Privacy + +- No user tracking or data collection +- Open source for transparency +- No external dependencies to minimize attack surface +- CORS enabled for API accessibility +- Graceful error handling + +## ๐Ÿ“„ License + +MIT License - feel free to use, modify, and distribute this software to make the world a better place. + +## ๐ŸŒ Join the Movement + +**Every great change starts with knowledge. Let's transform the world together.** + +- Star โญ this project to show your support +- Fork and contribute to make it better +- Share it with others who want to make a difference + +--- + +*"The best way to predict the future is to create it."* - Abraham Lincoln + +**Made with โค๏ธ for a better world | ็”จโค๏ธไธบๆ›ด็พŽๅฅฝ็š„ไธ–็•Œ่€Œๅˆ›้€ ** diff --git a/package.json b/package.json new file mode 100644 index 0000000..9bb2ef4 --- /dev/null +++ b/package.json @@ -0,0 +1,22 @@ +{ + "name": "shendaoen-transform-world", + "version": "1.0.0", + "description": "A knowledge-sharing platform that transforms the world through education and collaboration", + "main": "src/app.js", + "scripts": { + "start": "node src/app.js", + "dev": "node src/app.js" + }, + "engines": { + "node": ">=18.0.0" + }, + "keywords": [ + "education", + "knowledge-sharing", + "collaboration", + "learning", + "transform-world" + ], + "author": "", + "license": "MIT" +} diff --git a/src/app.js b/src/app.js new file mode 100644 index 0000000..1a4ab5a --- /dev/null +++ b/src/app.js @@ -0,0 +1,474 @@ +#!/usr/bin/env node + +/** + * Transform World - Knowledge Sharing Platform + * + * This application connects learners and educators globally, + * democratizing access to knowledge and skills that can change lives. + */ + +const http = require('http'); +const url = require('url'); + +// In-memory storage for knowledge articles +const knowledgeBase = [ + { + id: 1, + title: "ๅฆ‚ไฝ•้€š่ฟ‡็ผ–็จ‹ๆ”นๅ˜ไธ–็•Œ (How to Change the World Through Programming)", + content: "็ผ–็จ‹ไธไป…ไป…ๆ˜ฏๅ†™ไปฃ็ ๏ผŒๅฎƒๆ˜ฏ่งฃๅ†ณ็œŸๅฎž้—ฎ้ข˜็š„ๅทฅๅ…ทใ€‚้€š่ฟ‡ๅˆ›ๅปบๆœ‰ๆ„ไน‰็š„่ฝฏไปถ๏ผŒๆˆ‘ไปฌๅฏไปฅ๏ผš1) ๆ้ซ˜ๆ•™่‚ฒๅฏๅŠๆ€ง 2) ๆ”นๅ–„ๅŒป็–—ไฟๅฅ 3) ไฟๆŠค็Žฏๅขƒ 4) ไฟƒ่ฟ›็คพไผšๅ…ฌๅนณ", + author: "็ณป็ปŸ", + category: "ๆŠ€ๆœฏๆ•™่‚ฒ", + impact: "้ซ˜" + }, + { + id: 2, + title: "ๅผ€ๆบๅไฝœ็š„ๅŠ›้‡ (The Power of Open Source Collaboration)", + content: "ๅผ€ๆบ่ฝฏไปถๅทฒ็ปๆ”นๅ˜ไบ†ไธ–็•Œใ€‚Linuxใ€Gitใ€Python็ญ‰ๅทฅๅ…ท่ฎฉๅ…จ็ƒๅผ€ๅ‘่€…่ƒฝๅคŸๅไฝœๅˆ›ๆ–ฐใ€‚้€š่ฟ‡ๅˆ†ไบซ็Ÿฅ่ฏ†ๅ’Œไปฃ็ ๏ผŒๆˆ‘ไปฌๅฏไปฅๅŠ ้€Ÿไบบ็ฑป่ฟ›ๆญฅใ€‚", + author: "็ณป็ปŸ", + category: "ๅผ€ๆบๆ–‡ๅŒ–", + impact: "้ซ˜" + }, + { + id: 3, + title: "ๅฏๆŒ็ปญๅ‘ๅฑ•ไธŽๆŠ€ๆœฏ (Sustainable Development and Technology)", + content: "ๆŠ€ๆœฏๅฏไปฅๅธฎๅŠฉๆˆ‘ไปฌๅบ”ๅฏนๆฐ”ๅ€™ๅ˜ๅŒ–ใ€่ƒฝๆบๅฑๆœบๅ’Œ่ต„ๆบ็Ÿญ็ผบใ€‚้€š่ฟ‡ๆ™บ่ƒฝ็ฎ—ๆณ•ใ€ๆ•ฐๆฎๅˆ†ๆžๅ’Œ่‡ชๅŠจๅŒ–๏ผŒๆˆ‘ไปฌๅฏไปฅๅˆ›ๅปบๆ›ดๅฏๆŒ็ปญ็š„ๆœชๆฅใ€‚", + author: "็ณป็ปŸ", + category: "ๅฏๆŒ็ปญๅ‘ๅฑ•", + impact: "ๅ…ณ้”ฎ" + } +]; + +let nextId = 4; + +// Constants +const MAX_BODY_SIZE = 1024 * 1024; // 1MB limit for request body +const IMPACT_LEVELS = { + HIGH: '้ซ˜', + CRITICAL: 'ๅ…ณ้”ฎ' +}; +const VALID_IMPACT_VALUES = [IMPACT_LEVELS.HIGH, IMPACT_LEVELS.CRITICAL]; + +// Server configuration +const PORT = process.env.PORT || 3000; +const HOST = process.env.HOST || '0.0.0.0'; + +// Helper function to send JSON response +function sendJSON(res, statusCode, data) { + res.writeHead(statusCode, { 'Content-Type': 'application/json; charset=utf-8' }); + res.end(JSON.stringify(data, null, 2)); +} + +// Helper function to send HTML response +function sendHTML(res, statusCode, html) { + res.writeHead(statusCode, { 'Content-Type': 'text/html; charset=utf-8' }); + res.end(html); +} + +// Main request handler +function handleRequest(req, res) { + const parsedUrl = url.parse(req.url, true); + const pathname = parsedUrl.pathname; + const method = req.method; + + // Enable CORS + res.setHeader('Access-Control-Allow-Origin', '*'); + res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS'); + res.setHeader('Access-Control-Allow-Headers', 'Content-Type'); + + if (method === 'OPTIONS') { + res.writeHead(200); + res.end(); + return; + } + + // Routes + if (pathname === '/' && method === 'GET') { + // Home page with web interface + const html = ` + + + + + + Transform World - ๆ”นๅ˜ไธ–็•Œ็š„็Ÿฅ่ฏ†ๅนณๅฐ + + + +
+
+

๐ŸŒ Transform World

+

้€š่ฟ‡็Ÿฅ่ฏ†ๅˆ†ไบซๆ”นๅ˜ไธ–็•Œ | Change the World Through Knowledge Sharing

+
+ +
+
+
${knowledgeBase.length}
+
็Ÿฅ่ฏ†ๆ–‡็ซ 
+
+
+
โˆž
+
ๅญฆไน ่€…
+
+
+
100%
+
ๅ…่ดนๅผ€ๆ”พ
+
+
+ +
+
+

๐ŸŽฏ ๆˆ‘ไปฌ็š„ไฝฟๅ‘ฝ (Our Mission)

+

ๆˆ‘ไปฌ็›ธไฟก็Ÿฅ่ฏ†ๆ˜ฏๆ”นๅ˜ไธ–็•Œๆœ€ๅผบๅคง็š„ๅทฅๅ…ทใ€‚้€š่ฟ‡ๅˆ›ๅปบๅผ€ๆ”พใ€ๅŒ…ๅฎน็š„ๅญฆไน ๅนณๅฐ๏ผŒๆˆ‘ไปฌ่‡ดๅŠ›ไบŽ๏ผš

+
    +
  • โœจ ่ฎฉๆฏไธชไบบ้ƒฝ่ƒฝ่Žทๅพ—ไผ˜่ดจๆ•™่‚ฒ่ต„ๆบ
    • +
  • ๐Ÿค ่ฟžๆŽฅๅ…จ็ƒ็š„ๅญฆไน ่€…ๅ’Œๆ•™่‚ฒ่€…
    • +
  • ๐Ÿ’ก ๆฟ€ๅ‘ๅˆ›ๆ–ฐๆ€็ปดๅ’Œ่งฃๅ†ณ้—ฎ้ข˜็š„่ƒฝๅŠ›
    • +
  • ๐ŸŒฑ ๅŸนๅ…ป่ƒฝๅคŸๆ”นๅ˜ไธ–็•Œ็š„ไธ‹ไธ€ไปฃ้ข†ๅฏผ่€…
    • +
+
+ +

๐Ÿ“š ็ฒพ้€‰็Ÿฅ่ฏ†ๆ–‡็ซ 

+
+ ${knowledgeBase.map(article => ` +
+
${article.title}
+
+ ๐Ÿ‘ค ${article.author} + ๐Ÿ“ ${article.category} + + ๅฝฑๅ“ๅŠ›: ${article.impact} + +
+
${article.content}
+
+ `).join('')} +
+ +
+

๐Ÿ”Œ API ๆŽฅๅฃ (REST API Endpoints)

+

ๅผ€ๅ‘่€…ๅฏไปฅไฝฟ็”จไปฅไธ‹ API ๆฅ้›†ๆˆ็Ÿฅ่ฏ†ๅนณๅฐ๏ผš

+
GET /api/articles - ่Žทๅ–ๆ‰€ๆœ‰ๆ–‡็ซ 
+
GET /api/articles/:id - ่Žทๅ–ๆŒ‡ๅฎšๆ–‡็ซ 
+
POST /api/articles - ๅˆ›ๅปบๆ–ฐๆ–‡็ซ  +
Required fields: title, content, category, impact (้ซ˜ or ๅ…ณ้”ฎ) +
Optional: author (defaults to ๅŒฟๅ if not provided) +
+
GET /api/stats - ่Žทๅ–ๅนณๅฐ็ปŸ่ฎกไฟกๆฏ
+
+ +
+ ๐Ÿš€ ๆŽข็ดข API +
+
+ + +
+ + + `; + sendHTML(res, 200, html); + } + + else if (pathname === '/api/articles' && method === 'GET') { + // Get all articles + sendJSON(res, 200, { + success: true, + count: knowledgeBase.length, + data: knowledgeBase + }); + } + + else if (pathname.match(/^\/api\/articles\/\d+$/) && method === 'GET') { + // Get single article + const id = parseInt(pathname.split('/')[3]); + const article = knowledgeBase.find(a => a.id === id); + + if (article) { + sendJSON(res, 200, { success: true, data: article }); + } else { + sendJSON(res, 404, { success: false, error: 'Article not found' }); + } + } + + else if (pathname === '/api/articles' && method === 'POST') { + // Create new article + let body = ''; + let bodySize = 0; + + req.on('data', chunk => { + bodySize += chunk.length; + + // Prevent memory exhaustion attacks + if (bodySize > MAX_BODY_SIZE) { + res.writeHead(413, { 'Content-Type': 'application/json; charset=utf-8' }); + res.end(JSON.stringify({ success: false, error: 'Request body too large' })); + req.destroy(); + return; + } + + body += chunk.toString(); + }); + + req.on('end', () => { + try { + const newArticle = JSON.parse(body); + + // Validate required fields + if (!newArticle.title || typeof newArticle.title !== 'string' || newArticle.title.trim() === '') { + sendJSON(res, 400, { success: false, error: 'Title is required and must be a non-empty string' }); + return; + } + if (!newArticle.content || typeof newArticle.content !== 'string' || newArticle.content.trim() === '') { + sendJSON(res, 400, { success: false, error: 'Content is required and must be a non-empty string' }); + return; + } + if (!newArticle.category || typeof newArticle.category !== 'string' || newArticle.category.trim() === '') { + sendJSON(res, 400, { success: false, error: 'Category is required and must be a non-empty string' }); + return; + } + if (!newArticle.impact || typeof newArticle.impact !== 'string' || newArticle.impact.trim() === '') { + sendJSON(res, 400, { success: false, error: 'Impact is required and must be a non-empty string' }); + return; + } + + // Sanitize inputs + newArticle.title = newArticle.title.trim(); + newArticle.content = newArticle.content.trim(); + newArticle.category = newArticle.category.trim(); + newArticle.impact = newArticle.impact.trim(); + + // Validate impact level + if (!VALID_IMPACT_VALUES.includes(newArticle.impact)) { + sendJSON(res, 400, { + success: false, + error: `Impact must be one of: ${VALID_IMPACT_VALUES.join(', ')}` + }); + return; + } + + newArticle.id = nextId++; + newArticle.author = newArticle.author?.trim() || 'ๅŒฟๅ'; + knowledgeBase.push(newArticle); + sendJSON(res, 201, { + success: true, + message: 'Article created successfully', + data: newArticle + }); + } catch (error) { + sendJSON(res, 400, { success: false, error: 'Invalid JSON' }); + } + }); + } + + else if (pathname === '/api/stats' && method === 'GET') { + // Get platform statistics + const stats = { + totalArticles: knowledgeBase.length, + categories: [...new Set(knowledgeBase.map(a => a.category))], + highImpactArticles: knowledgeBase.filter(a => + a.impact === IMPACT_LEVELS.HIGH || a.impact === IMPACT_LEVELS.CRITICAL + ).length, + mission: "Democratizing knowledge to transform the world" + }; + sendJSON(res, 200, { success: true, data: stats }); + } + + else { + sendJSON(res, 404, { success: false, error: 'Endpoint not found' }); + } +} + +// Create and start server +const server = http.createServer(handleRequest); + +server.listen(PORT, HOST, () => { + console.log(''); + console.log('โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•'); + console.log('๐ŸŒ Transform World - Knowledge Sharing Platform'); + console.log('โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•'); + console.log(''); + console.log(`โœ… Server is running on http://${HOST}:${PORT}`); + console.log(''); + console.log('๐Ÿ“ฑ Access the platform:'); + console.log(` Web Interface: http://localhost:${PORT}/`); + console.log(` API Endpoint: http://localhost:${PORT}/api/articles`); + console.log(''); + console.log('๐Ÿ’ก This platform enables:'); + console.log(' โ€ข Knowledge sharing across borders'); + console.log(' โ€ข Collaborative learning'); + console.log(' โ€ข Democratized education'); + console.log(' โ€ข Community-driven content'); + console.log(''); + console.log('๐Ÿš€ Press Ctrl+C to stop the server'); + console.log('โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•'); + console.log(''); +}); + +// Handle graceful shutdown +process.on('SIGTERM', () => { + console.log('\n\n๐Ÿ‘‹ Shutting down gracefully...'); + server.close(() => { + console.log('โœ… Server closed'); + process.exit(0); + }); +}); + +process.on('SIGINT', () => { + console.log('\n\n๐Ÿ‘‹ Shutting down gracefully...'); + server.close(() => { + console.log('โœ… Server closed'); + process.exit(0); + }); +});