Metadata-Version: 2.4
Name: production-build-app-fastapi-service-for-rag-document-retrieval
Version: 0.1.0
Summary: Production-build FastAPI starter scaffold generated by ARES with a strict developer contract, installable package artifacts, and clean-room release verification.
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: fastapi<1.0,>=0.116
Requires-Dist: uvicorn[standard]<1.0,>=0.35
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: httpx>=0.28; extra == "dev"
Dynamic: requires-python

# Production Build App Fastapi Service For Rag Document Retrieval With Upload, Indexing, Search, Health Endpoint, Tests, A

Generated by ARES for the request:

> production build app FastAPI service for RAG document retrieval with upload, indexing, search, health endpoint, tests, and installable package. Keep scope minimal and make it pass release verification.

## Contract

- Stack: Python + FastAPI
- Delivery mode: `production_build`
- Workspace: `inventions/production-build-app-fastapi-service-for-rag-document-retrieval`
- Entrypoint: `app.main:app`
- Verification: compile Python sources and run structural unit tests
- Release verification: build, install, and smoke-test from a clean virtual environment

## File Layout

- `app/main.py` creates the FastAPI application instance.
- `app/api/routes.py` defines the HTTP routes.
- `tests/test_contract.py` validates the scaffold contract without requiring third-party imports.
- `run_demo.py` prints the registered routes after dependencies are installed.

## Quick Start

```bash
python -m pip install -e .
python run_demo.py
python -m uvicorn app.main:app --reload
```

## Verification

```bash
"Q:\ARES\.venv-cuda311\Scripts\python.exe" -m py_compile "run_demo.py"
"Q:\ARES\.venv-cuda311\Scripts\python.exe" -m compileall "app" "tests"
"Q:\ARES\.venv-cuda311\Scripts\python.exe" -m unittest discover -s tests -p test_*.py
```

## Release Gates

- Build wheel and sdist from pyproject.toml.
- Install the built wheel into a clean virtual environment.
- Run pip check inside the clean environment.
- Import the public package entrypoint from the clean environment.
- Run the packaged smoke command from the clean environment.

ARES should not call this scaffold runnable local until the clean-room release gates pass.


## Notes

Production-build FastAPI starter scaffold generated by ARES with a strict developer contract, installable package artifacts, and clean-room release verification.

<!-- ARES_AUTO_VERIFIED_SUMMARY:START -->
## Verified Project Notes

- Package import path: `app`
- Entrypoint: `run_demo.py`
- Delivery mode: `prototype`
- Release tier: `prototype`
- Verification status: `FAIL`
- Clean-room release gates: `NOT_RUN`
- Python files detected: `run_demo.py, app/__init__.py, app/main.py, app/api/__init__.py, app/api/routes.py, tests/test_contract.py`

## Verification Commands

- `PASS` `"Q:\ARES\.venv-cuda311\Scripts\python.exe" -m py_compile "run_demo.py"`
- `PASS` `"Q:\ARES\.venv-cuda311\Scripts\python.exe" -m compileall "app" "tests"`
- `FAIL` `"Q:\ARES\.venv-cuda311\Scripts\python.exe" run_demo.py`
- `FAIL` `"Q:\ARES\.venv-cuda311\Scripts\python.exe" -m pytest -q`

## Current Limits

- Downgraded `production-ready` wording to `runnable local` until stronger verification exists.
- Verification failure: Install dependencies first with "python.exe" -m pip install -e .
<!-- ARES_AUTO_VERIFIED_SUMMARY:END -->
