Initial commit: Add project structure with GLM OCR demo

.env.example

@@ -0,0 +1,14 @@
+# Application
+APP_NAME=GLM OCR Demo
+APP_VERSION=0.1.0
+DEBUG=true
+
+# Server
+HOST=0.0.0.0
+PORT=8000
+
+# Database
+DATABASE_URL=sqlite:///./app.db
+
+# Security
+SECRET_KEY=your-secret-key-here-change-in-production

.gitignore

@@ -0,0 +1,130 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db

README.md

@@ -0,0 +1,50 @@
+# GLM OCR Demo
+
+基于 Python 的 Web 项目，使用 FastAPI 框架。
+
+## 开发环境设置
+
+1. 创建虚拟环境：
+```bash
+python -m venv venv
+```
+
+2. 激活虚拟环境：
+```bash
+# Windows
+venv\Scripts\activate
+
+# Linux/Mac
+source venv/bin/activate
+```
+
+3. 安装依赖：
+```bash
+pip install -r requirements.txt
+```
+
+4. 复制环境变量文件：
+```bash
+copy .env.example .env
+```
+
+5. 运行开发服务器：
+```bash
+python -m uvicorn src.main:app --reload --host 0.0.0.0 --port 8000
+```
+
+## 项目结构
+
+```
+glmocrdemo/
+├── src/
+│   ├── api/          # API 路由
+│   ├── models/       # 数据模型
+│   ├── services/     # 业务逻辑
+│   ├── core/         # 核心配置
+│   └── main.py       # 应用入口
+├── tests/            # 测试文件
+├── .env.example      # 环境变量示例
+├── requirements.txt  # 项目依赖
+└── README.md         # 项目说明
+```

requirements.txt

@@ -0,0 +1,23 @@
+# Web Framework
+fastapi==0.115.0
+uvicorn[standard]==0.32.0
+
+# Database
+sqlalchemy==2.0.35
+alembic==1.14.0
+
+# Environment variables
+python-dotenv==1.0.1
+
+# Validation
+pydantic==2.9.2
+pydantic-settings==2.6.0
+
+# CORS
+python-multipart==0.0.12
+
+# HTTP client
+httpx==0.27.2
+
+# Utils
+orjson==3.10.12

src/__init__.py

@@ -0,0 +1 @@
+# src package

src/api/__init__.py

@@ -0,0 +1 @@
+# api package

src/core/__init__.py

@@ -0,0 +1 @@
+# core package

src/core/config.py

@@ -0,0 +1,21 @@
+from pydantic_settings import BaseSettings
+
+
+class Settings(BaseSettings):
+    app_name: str = "GLM OCR Demo"
+    app_version: str = "0.1.0"
+    debug: bool = True
+
+    host: str = "0.0.0.0"
+    port: int = 8000
+
+    database_url: str = "sqlite:///./app.db"
+
+    secret_key: str = "your-secret-key-here"
+
+    class Config:
+        env_file = ".env"
+        case_sensitive = False
+
+
+settings = Settings()

src/core/database.py

@@ -0,0 +1,22 @@
+from sqlalchemy import create_engine
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+
+from src.core.config import settings
+
+engine = create_engine(
+    settings.database_url,
+    connect_args={"check_same_thread": False} if "sqlite" in settings.database_url else {}
+)
+
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+
+Base = declarative_base()
+
+
+def get_db():
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()

src/main.py

@@ -0,0 +1,44 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from src.core.config import settings
+
+app = FastAPI(
+    title=settings.app_name,
+    version=settings.app_version,
+    debug=settings.debug
+)
+
+# CORS middleware
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"] if settings.debug else [],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.get("/")
+async def root():
+    return {
+        "app": settings.app_name,
+        "version": settings.app_version,
+        "status": "running"
+    }
+
+
+@app.get("/health")
+async def health_check():
+    return {"status": "healthy"}
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(
+        "src.main:app",
+        host=settings.host,
+        port=settings.port,
+        reload=settings.debug
+    )

src/models/__init__.py

@@ -0,0 +1 @@
+# models package

src/services/__init__.py

@@ -0,0 +1 @@
+# services package

tests/__init__.py

@@ -0,0 +1 @@
+# tests package

tests/test_main.py

@@ -0,0 +1,19 @@
+from fastapi.testclient import TestClient
+from src.main import app
+
+client = TestClient(app)
+
+
+def test_root():
+    response = client.get("/")
+    assert response.status_code == 200
+    data = response.json()
+    assert "app" in data
+    assert "version" in data
+    assert data["status"] == "running"
+
+
+def test_health_check():
+    response = client.get("/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "healthy"}