docs: add agent bootstrap quickstart and consolidate documentation
- Add BOOTSTRAP__AI_Agent_Quickstart.md — fast-path entry doc for AI agents covering critical rules, V3 action patterns, Redis/auth/logger_reset gotchas, and a mistakes-agents-have-made section - Expand ARCH__V3_DEVELOPMENT_STANDARDS.md with merged content from ARCH__V3_CRUD_LEARNINGS: dependency injection reference, security/isolation model detail, and FastAPI/Pydantic gotchas - Archive 4 outdated docs: GUIDE__LOCAL_DEVELOPMENT (predates Docker), FRONTEND_API_SAMPLES (belongs in SvelteKit repo), ARCH__UNIFIED_AGENT (replaced by MCP ecosystem), ARCH__V3_CRUD_LEARNINGS (content merged above) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
78
documentation/archive/GUIDE__LOCAL_DEVELOPMENT.md
Normal file
78
documentation/archive/GUIDE__LOCAL_DEVELOPMENT.md
Normal file
@@ -0,0 +1,78 @@
|
||||
# Local Development Guide
|
||||
|
||||
This guide provides instructions for setting up and running the Aether API locally for development.
|
||||
|
||||
## 1. Prerequisites
|
||||
- Python 3.9+ (or as specified in `requirements.txt`)
|
||||
- `virtualenv` or `venv`
|
||||
|
||||
## 2. Setup Procedure
|
||||
|
||||
### Create and Activate Environment
|
||||
```bash
|
||||
# Go to root of application
|
||||
cd ~/path/to/directory/aether_api_fastapi/
|
||||
|
||||
# Create new application environment
|
||||
virtualenv environment
|
||||
|
||||
# Activate application environment
|
||||
source environment/bin/activate
|
||||
```
|
||||
|
||||
### Install Requirements
|
||||
```bash
|
||||
# Install application requirements
|
||||
pip install -r admin/requirements.txt
|
||||
|
||||
# Troubleshooting/Force Reinstall if needed:
|
||||
# pip install --upgrade --force-reinstall -r admin/requirements.txt
|
||||
# pip install --ignore-installed -r admin/requirements.txt
|
||||
```
|
||||
|
||||
## 3. Running the Application
|
||||
|
||||
### Start with Uvicorn (Reload enabled)
|
||||
```bash
|
||||
uvicorn app.main:app --host 0.0.0.0 --port 5005 --reload
|
||||
```
|
||||
|
||||
### Accessing the API
|
||||
The application will be available at:
|
||||
- API Root: [http://localhost:5005](http://localhost:5005)
|
||||
- Swagger Docs: [http://localhost:5005/docs](http://localhost:5005/docs)
|
||||
|
||||
## 4. Git Workflow Basics
|
||||
|
||||
### Initialization
|
||||
```bash
|
||||
git init
|
||||
git remote add origin https://scott_idem@bitbucket.org/oneskyit/one-sky-it-api.git
|
||||
```
|
||||
|
||||
### Basic Commands
|
||||
```bash
|
||||
# Adding and committing
|
||||
git add .
|
||||
git commit -m 'Your commit message'
|
||||
|
||||
# Pushing to branches
|
||||
git push -u origin master
|
||||
git push -u origin development
|
||||
```
|
||||
|
||||
### Branch Management
|
||||
```bash
|
||||
# List branches
|
||||
git branch -a
|
||||
|
||||
# Create and switch to new branch
|
||||
git branch new-branch-name
|
||||
git switch new-branch-name
|
||||
```
|
||||
|
||||
## 5. Deployment Basics (Manual)
|
||||
If you are cloning for the first time on a server:
|
||||
```bash
|
||||
git clone https://scott_idem@bitbucket.org/oneskyit/one-sky-it-api-fastapi.git /srv/http/destination_path
|
||||
```
|
||||
Reference in New Issue
Block a user