Issue 1: repo scaffold and project structure

2026-06-07 19:20:02 +00:00
parent e0b31009b7
commit a70bdeaa5e
52 changed files with 6750 additions and 0 deletions
@@ -0,0 +1,48 @@
+# Ten31Portal
+
+Internal system of record for Ten31 entities, holdings, positions, and quarterly valuation sign-off.
+
+## Prerequisites
+
+- Python 3.11+
+- Node.js 20+
+
+## Backend
+
+```bash
+cd backend
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+uvicorn ten31portal.main:app --reload --port 8000
+```
+
+Health check: `GET http://localhost:8000/api/health`
+
+## Frontend
+
+```bash
+cd frontend
+npm install
+npm run dev
+```
+
+Opens at `http://localhost:5173`. Proxies `/api` to the backend on port 8000.
+
+## Project structure
+
+```
+ten31portal/
+  backend/
+    ten31portal/       # FastAPI application
+      main.py          # App object and health endpoint
+      config.py        # Env-based configuration
+    pyproject.toml
+  frontend/
+    src/
+      App.tsx          # Main component
+      main.tsx         # Entry point
+    vite.config.ts
+  deploy/              # StartOS packaging (Issue 17)
+  SPEC.md              # v1 issue specs
+```