# 屋頂日光

> 台灣屋頂太陽能自助評估 — 陰影分析、投資試算、廠商媒合

## Docs

- [簡介](https://solarium-1f74f072.mintlify.app/index.md): 在台灣評估自家屋頂是否適合裝設太陽能，並試算投資報酬與聯絡廠商
- [地區分析](https://solarium-1f74f072.mintlify.app/guide/region-analysis.md): 依台灣 368 鄉鎮市評估太陽能推廣潛力，協助政府與廠商決定資源配置與行銷優先順序
- [商業模式與資料變現](https://solarium-1f74f072.mintlify.app/guide/business-model.md): 屋頂日光如何將屋頂評估轉為案源資料平台，服務屋主、廠商與投資者，並以授權案源與地區分析變現
- [資料處理與運算](https://solarium-1f74f072.mintlify.app/developer-guide/data-pipeline.md): 從輸入地址到發電量與投資報酬的完整計算路徑
- [系統架構](https://solarium-1f74f072.mintlify.app/developer-guide/architecture.md): 屋頂日光前後端技術架構與資料流
- [本地安裝](https://solarium-1f74f072.mintlify.app/developer-guide/installation.md): 在本機設定 Solar Money 開發環境
- [API 參考](https://solarium-1f74f072.mintlify.app/developer-guide/api-reference.md): FastAPI 後端 REST API 總覽與互動式測試
- [Health](https://solarium-1f74f072.mintlify.app/api-reference/health/health.md)
- [Api Get Buildings](https://solarium-1f74f072.mintlify.app/api-reference/buildings/api-get-buildings.md): 回傳指定範圍內的建物清單（GBA DB → OSM Overpass fallback）。 接受兩種形式： - 地圖視口 bbox：?min_lon=...&min_lat=...&max_lon=...&max_lat=... - 點+半徑：?lat=...&lng=...&radius_m=...（預設 300m）
- [Compute Shadow](https://solarium-1f74f072.mintlify.app/api-reference/shadows/compute-shadow.md)
- [Get All Shadows](https://solarium-1f74f072.mintlify.app/api-reference/shadows/get-all-shadows.md): Fetch OSM buildings inside the bbox, compute their shadow polygons via pvlib, and return a GeoJSON FeatureCollection.
- [Shadows From Features](https://solarium-1f74f072.mintlify.app/api-reference/shadows/shadows-from-features.md)
- [Precompute](https://solarium-1f74f072.mintlify.app/api-reference/shadows/precompute.md): Compute shadows for all daylight hours (6–19). DB cache hit → instant; miss → compute + store.
- [Usable Fraction Endpoint](https://solarium-1f74f072.mintlify.app/api-reference/shadows/usable-fraction-endpoint.md): Calculate usable roof fraction for the target building. Fetches neighbouring buildings from GBA DB (radius ~200 m) rather than relying on whatever the frontend happens to have rendered. Returns usable_fraction (0–1) and setback_area_m2.
- [Get Township Climate](https://solarium-1f74f072.mintlify.app/api-reference/terrain-&-climate/get-township-climate.md): 依座標查詢最近鄉鎮市的 12 個月 NASA POWER 氣候資料，並以 pvlib 計算最佳仰角。 前端 Results.tsx 用此取代靜態 TW_IRRADIANCE 三區常數與硬編碼 GOAL_ADJ。 回傳：(   township_code, county_name,   monthly_ghi:  [12 floats, kWh/m²/day],   monthly_temp: [12 floats, °C],   monthly_wind: [12 floats, m/s],   best_angle:   int  (pvlib 最佳仰角，南向),   goal_adj:…
- [Get Climate Data](https://solarium-1f74f072.mintlify.app/api-reference/terrain-&-climate/get-climate-data.md): 回傳指定鄉鎮市的氣候資料： - annual：年均統計（GHI、氣溫、風速、濕度、地理中心） - monthly：12 個月典型 GHI/溫度/風速/濕度
- [Dem Tile](https://solarium-1f74f072.mintlify.app/api-reference/terrain-&-climate/dem-tile.md): Serve Taiwan 20m DEM as Mapbox terrain-rgb PNG tiles.
- [Taiwan Sun Times](https://solarium-1f74f072.mintlify.app/api-reference/terrain-&-climate/taiwan-sun-times.md): Return today's sunrise/sunset for Taiwan (computed once per day, cached in memory).
- [Create Assessment](https://solarium-1f74f072.mintlify.app/api-reference/assessments/create-assessment.md)
- [List Assessments](https://solarium-1f74f072.mintlify.app/api-reference/assessments/list-assessments.md)
- [Register](https://solarium-1f74f072.mintlify.app/api-reference/authentication/register.md)
- [Login](https://solarium-1f74f072.mintlify.app/api-reference/authentication/login.md)
- [Me Assessments](https://solarium-1f74f072.mintlify.app/api-reference/user-account/me-assessments.md)
- [Claim Assessments](https://solarium-1f74f072.mintlify.app/api-reference/user-account/claim-assessments.md): 登入後將匿名評估綁定到帳號。
- [Me Inquiries](https://solarium-1f74f072.mintlify.app/api-reference/user-account/me-inquiries.md): 用戶查看自己送出的詢價（含廠商回覆與評價狀態）。
- [Vendors](https://solarium-1f74f072.mintlify.app/api-reference/vendors/vendors.md)
- [Vendor Detail](https://solarium-1f74f072.mintlify.app/api-reference/vendors/vendor-detail.md)
- [Apply Vendor](https://solarium-1f74f072.mintlify.app/api-reference/vendors/apply-vendor.md)
- [Vendor Inquire](https://solarium-1f74f072.mintlify.app/api-reference/vendors/vendor-inquire.md)
- [Places Autocomplete](https://solarium-1f74f072.mintlify.app/api-reference/places/places-autocomplete.md)
- [Places Details](https://solarium-1f74f072.mintlify.app/api-reference/places/places-details.md)

## OpenAPI Specs

- [openapi](https://solarium-1f74f072.mintlify.app/openapi.json)