InsightSphere

InsightSphere 鏄竴涓疄鏃躲€佷氦浜掑紡鐨勫姞瀵嗚揣甯佹暟鎹彲瑙嗗寲浠〃鐩樸€傚悗绔粠 CoinGecko 鍏叡 API 鎷夊彇鈥滃叏鐞冨競鍦烘瑙堚€濆拰鈥滃競鍊煎墠10鍔犲瘑璐у竵鈥濈殑鏁版嵁锛屾彁渚涚ǔ瀹氱殑缂撳瓨锛涘墠绔互鍗曢〉搴旂敤锛圫PA锛夊睍绀哄崱鐗囥€佽〃鏍间笌楗煎浘锛屽苟姣?0绉掕嚜鍔ㄥ埛鏂般€?

鍔熻兘姒傝

• 鍏ㄧ悆甯傚満姒傝锛氭€诲競鍊笺€?4灏忔椂鎬讳氦鏄撻噺銆丅TC 甯傚€煎崰姣旂瓑銆?- Top 10 鍔犲瘑璐у竵锛氭帓鍚嶃€佸浘鏍囥€佸悕绉般€佷环鏍笺€?4h 娑ㄨ穼骞呫€佹€诲競鍊笺€?- 甯傚€煎垎甯冮ゼ鍥撅細鎮仠楂樹寒骞舵樉绀哄悕绉颁笌鍗犳瘮銆?- 鑷姩鍒锋柊锛氭瘡 60 绉掓洿鏂帮紱鍚庣鍏峰缂撳瓨涓庨檷绾э紝閬垮厤瑙﹀彂 CoinGecko 棰戠巼闄愬埗銆?- 鍋ュ．閿欒澶勭悊锛氬悗绔粺涓€閿欒鏍煎紡锛涘墠绔弸濂介敊璇彁绀轰笉鑷翠娇椤甸潰宕╂簝銆?

鎶€鏈€夊瀷涓庣悊鐢?- 鍚庣锛欶astAPI + httpx

• FastAPI 鎬ц兘鑹ソ銆佺被鍨嬪弸濂姐€佸唴缃枃妗ｏ紙/docs锛夛紝閫傚悎蹇€熸瀯寤篟EST API銆? - httpx 寮傛璇锋眰鏂逛究鎺у埗瓒呮椂銆侀噸璇曚笌鍙栨秷銆?- 缂撳瓨锛歊edis锛堜紭鍏堬級+ 鍐呭瓨鍥為€€
• Docker Compose 涓彁渚?Redis锛屼繚璇佸瀹炰緥/閲嶅惎涓€鑷存€э紱褰?Redis 涓嶅彲鐢ㄦ椂鑷姩鍒囨崲鍒拌繘绋嬪唴缂撳瓨锛屾彁鍗囧彲鐢ㄦ€с€?- 鍓嶇锛氬師鐢熷崟椤靛簲鐢紙Vanilla JS锛? Chart.js
• 闇€姹備互鏁版嵁灞曠ず涓轰富锛岄€夌敤闆舵瀯寤虹殑鍘熺敓JS鍙互鍑忚交澶嶆潅搴︼紱Chart.js 鎻愪緵鏄撶敤鐨勪氦浜掑紡鍥捐〃銆? - 浣跨敤鍝嶅簲寮?CSS锛屾闈笌绉诲姩绔潎鏈夎緝濂借鎰熴€?- 閮ㄧ讲锛欴ockerfile + docker-compose.yml
• 涓€閿惎鍔ㄥ墠绔紙Nginx闈欐€佹墭绠★級銆佸悗绔紙Uvicorn/FastAPI锛変笌 Redis銆?

鐩綍缁撴瀯

codex/
  backend/
    app/
      __init__.py
      main.py
      cache.py
      coingecko.py
      models.py
      settings.py
    requirements.txt
    Dockerfile
  frontend/
    index.html
    assets/
      style.css
      app.js
    Dockerfile
  docker-compose.yml
  README.md

鏈湴杩愯锛堜笉浣跨敤 Docker锛?鍓嶇疆锛氶渶瑕?Python 3.10+锛屽彲閫?Redis锛堣嫢涓嶅惎鐢紝鍚庣灏嗚嚜鍔ㄩ€€鍖栦负鍐呭瓨缂撳瓨锛夈€?

1. 瀹夎鍚庣渚濊禆

cd backend
python -m venv .venv
. .venv/Scripts/activate  # Windows PowerShell: . .venv/Scripts/Activate.ps1
pip install -r requirements.txt

2. 閰嶇疆鐜鍙橀噺锛堝彲閫夛級

• REDIS_URL锛氬 redis://localhost:6379/0
• CACHE_TTL_SECONDS锛氱紦瀛樼鏁帮紝榛樿 60
• COINGECKO_BASE_URL锛氶粯璁?https://api.coingecko.com/api/v3

3. 鍚姩鍚庣

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

鎺ュ彛绀轰緥锛?- GET http://localhost:8000/api/global

• GET http://localhost:8000/api/top-coins

4. 鍓嶇 鐩存帴鐢ㄦ湰鍦伴潤鎬佹湇鍔″櫒鎴栨祻瑙堝櫒鎵撳紑 frontend/index.html 鍗冲彲銆傝嫢璺ㄥ煙璁块棶锛岄渶瑕佸皢鍓嶇鍦ㄦ祻瑙堝櫒涓闂?file:// 鎴栭€氳繃浠绘剰鏈湴闈欐€佹湇鍔★紙濡?VSCode Live Server锛夎闂紝鍚屾椂纭繚鍚庣杩愯鍦?http://localhost:8000銆?

浣跨敤 Docker 涓€閿惎鍔?鍓嶇疆锛氬畨瑁?Docker 涓?Docker Compose銆?

cd codex
docker compose up --build

鍚姩瀹屾垚鍚庯細

• 鍓嶇璁块棶锛歨ttp://localhost:8080
• 鍚庣 API锛歨ttp://localhost:8000

API 璁捐

• GET /api/health锛氬仴搴锋鏌ャ€?- GET /api/global锛氳繑鍥炲叏鐞冨競鍦烘暟鎹紙甯︾紦瀛橈級銆?- GET /api/top-coins锛氳繑鍥炲競鍊煎墠10鐨勫竵绉嶅熀纭€鏁版嵁锛堝甫缂撳瓨锛夈€? 缁熶竴鍝嶅簲閿欒鏍煎紡锛?``` { "success": false, "error": { "code": "UPSTREAM_ERROR", "message": "鏁版嵁婧愪笉鍙敤锛岃绋嶅悗閲嶈瘯" } }

## 缂撳瓨绛栫暐
- 浼樺厛浣跨敤 Redis锛岄敭锛歚global_market_v1` 涓?`top_coins_v1`锛孴TL 榛樿 60 绉掋€?- 褰?Redis 涓嶅彲鐢ㄦ椂锛岃嚜鍔ㄥ垏鎹负杩涚▼鍐?LRU/TTL 缂撳瓨銆?- 鎵€鏈夊墠绔疆璇?60 绉掍竴娆★紝涓庡悗绔?TTL 瀵归綈锛岄伩鍏嶈繃搴﹁姹?CoinGecko銆?
## 寮傚父涓庨噸璇?- 瀵逛笂娓歌姹傝缃秴鏃讹紙榛樿 8 绉掞級銆?- 鎹曡幏杩炴帴/瓒呮椂/瑙ｆ瀽閿欒锛岃繑鍥炵粺涓€閿欒骞朵繚鐣欑紦瀛樼殑鏈€鍚庢垚鍔熷€硷紙鑻ュ瓨鍦級銆?
## 瀹夊叏瀹炶返
- 涓嶄娇鐢ㄤ换浣曠‖缂栫爜瀵嗛挜锛涘叕鍏?API 鏃犻渶瀵嗛挜銆?- 鍚堢悊鐨勮秴鏃朵笌閿欒淇℃伅鑴辨晱銆?- CORS 鏈€灏忓寲閰嶇疆锛屼粎鍏佽鍓嶇鏉ユ簮銆?
## 寮€鍙戝皬璐村＋
- 鎵撳紑 `http://localhost:8000/docs` 鏌ョ湅鑷姩鐢熸垚鐨勬帴鍙ｆ枃妗ｏ紙FastAPI锛夈€?- 鑻ラ渶瑕佽皟鏁村埛鏂伴鐜囨垨鍥捐〃鏍峰紡锛屽墠绔?`assets/app.js` 涓湁娉ㄩ噴涓庡父閲忓彲閰嶇疆銆?
## 璁稿彲
鏈」鐩敤浜庢妧鏈紨绀猴紝涓嶅惈鐗堟潈/鍟嗕笟鎵胯銆?