refactor: 在旧的PhyExp基础上进行重构,采用了monorepo结构,分为frontend和backend两个子项目

这个提交包含在:
2026-05-23 18:15:31 +08:00
当前提交 41813abe48
共有 87 个文件被更改,包括 13257 次插入 和 0 次删除

查看文件

48
backend/app/api/device.py 普通文件
查看文件

@ -0,0 +1,48 @@
from __future__ import annotations
from fastapi import APIRouter, Header
from app.core.dependencies import reading_guard_manager, resolve_session_id
from app.hardware.service import oscilloscope_service
from app.models import ManualAnswerRequest
router = APIRouter(prefix="/device", tags=["device"])
@router.get("/status")
async def get_device_status():
snapshot = oscilloscope_service.probe()
return {
"status": snapshot.status,
"device_idn": snapshot.device_idn,
"peak_value": snapshot.peak_value,
"frequency_hz": snapshot.frequency_hz,
"raw_response": snapshot.raw_response,
"note": snapshot.note,
}
@router.post("/peak")
async def capture_peak_value():
snapshot = oscilloscope_service.capture_peak()
return {
"status": snapshot.status,
"peak_value": snapshot.peak_value,
"note": snapshot.note,
}
@router.post("/manual-answer")
async def set_manual_answer(
request: ManualAnswerRequest,
x_session_id: str | None = Header(default=None),
):
session_id = resolve_session_id(x_session_id)
reading_guard_manager.set_manual_answer(session_id, request.field_id, request.value)
return {
"success": True,
"session_id": session_id,
"field_id": request.field_id,
"message": "已设置该字段标准读数",
}

26
backend/app/api/form.py 普通文件
查看文件

@ -0,0 +1,26 @@
from __future__ import annotations
from fastapi import APIRouter
from app.core.dependencies import config_service
router = APIRouter(prefix="/form", tags=["form"])
@router.get("")
async def get_experiment_form(experiment: str = "voice_speed"):
config = config_service.load_validated(experiment)
return config.model_dump(by_alias=True)
@router.get("/list")
async def list_available_experiments():
experiments = config_service.list_experiments()
return {"experiments": experiments, "count": len(experiments)}
@router.get("/{experiment_name}")
async def get_specific_experiment_form(experiment_name: str):
config = config_service.load_validated(experiment_name)
return config.model_dump(by_alias=True)

查看文件

@ -0,0 +1,19 @@
from __future__ import annotations
from fastapi import APIRouter, HTTPException
from app.core.dependencies import measurement_service
from app.schemas.validation import AnalyzeMeasurementRequest, AnalyzeMeasurementResponse, MeasurementMethod
router = APIRouter(prefix="/measurement", tags=["measurement"])
@router.post("/{method}")
async def analyze_measurement(method: MeasurementMethod, payload: AnalyzeMeasurementRequest) -> AnalyzeMeasurementResponse:
try:
return measurement_service.analyze(method, payload)
except HTTPException:
raise
except Exception as exc:
raise HTTPException(status_code=500, detail=str(exc)) from exc

72
backend/app/api/value.py 普通文件
查看文件

@ -0,0 +1,72 @@
from __future__ import annotations
from fastapi import APIRouter, Header, HTTPException, Query
from app.core.dependencies import find_field, list_fields, reading_guard_manager, resolve_session_id, session_store
from app.core.validation import FieldValidator
from app.schemas.validation import FieldValidationRequest, FieldValidationResponse
router = APIRouter(prefix="/value", tags=["value"])
@router.post("")
async def validate_field_value(
request: FieldValidationRequest,
experiment: str = Query(default="voice_speed"),
x_session_id: str | None = Header(default=None),
) -> FieldValidationResponse:
session_id = resolve_session_id(x_session_id)
field = find_field(experiment, request.field_id)
base_result = FieldValidator.validate_by_config(request.field_id, request.value, field.validation)
if not base_result.accept:
return base_result
guard_result = reading_guard_manager.validate(
session_id=session_id,
current_field=field,
current_value=request.value,
all_fields=list_fields(experiment),
)
if guard_result is not None:
guard_accept, guard_message = guard_result
if not guard_accept:
return FieldValidationResponse(accept=False, message=guard_message)
session_store.set_value(session_id, request.field_id, request.value)
return FieldValidationResponse(accept=True, message=guard_message)
session_store.set_value(session_id, request.field_id, request.value)
return base_result
@router.get("")
async def get_all_field_values(x_session_id: str | None = Header(default=None)):
session_id = resolve_session_id(x_session_id)
fields = session_store.get_all(session_id)
return {"fields": fields, "count": len(fields), "session_id": session_id}
@router.get("/{field_id}")
async def get_field_value(field_id: str, x_session_id: str | None = Header(default=None)):
session_id = resolve_session_id(x_session_id)
value = session_store.get_value(session_id, field_id)
if value is None:
raise HTTPException(status_code=404, detail=f"field '{field_id}' not found or has no value")
return {"field_id": field_id, "value": value, "session_id": session_id}
@router.delete("/{field_id}")
async def delete_field_value(field_id: str, x_session_id: str | None = Header(default=None)):
session_id = resolve_session_id(x_session_id)
ok = session_store.delete_value(session_id, field_id)
if not ok:
raise HTTPException(status_code=404, detail=f"field '{field_id}' not found")
return {"message": f"field '{field_id}' value deleted", "success": True, "session_id": session_id}
@router.delete("")
async def clear_all_field_values(x_session_id: str | None = Header(default=None)):
session_id = resolve_session_id(x_session_id)
removed_count = session_store.clear(session_id)
return {"message": f"cleared {removed_count} field values", "success": True, "session_id": session_id}