chore: collect auth-server wiki and lib refresh

Picks up the rewritten auth-server wiki (platform anatomy theme) and the
regenerated lib artifacts, including the new pep-typed marker bounce.
This commit is contained in:
2026-09-16 19:51:24 +05:30
parent 7aadae1736
commit a115df113d
12 changed files with 233 additions and 154 deletions

View File

@@ -478,7 +478,7 @@
<li class="md-nav__item">
<a href="#environment-variables" class="md-nav__link">
<span class="md-ellipsis">
Environment variables
⚙️ Environment variables
</span>
</a>
@@ -487,7 +487,7 @@
<li class="md-nav__item">
<a href="#running-locally" class="md-nav__link">
<span class="md-ellipsis">
Running locally
💻 Running locally
</span>
</a>
@@ -496,7 +496,7 @@
<li class="md-nav__item">
<a href="#container-image" class="md-nav__link">
<span class="md-ellipsis">
Container image
🐳 Container image
</span>
</a>
@@ -505,7 +505,7 @@
<li class="md-nav__item">
<a href="#cicd-drone" class="md-nav__link">
<span class="md-ellipsis">
CI/CD (Drone)
🔄 CI/CD (Drone)
</span>
</a>
@@ -514,7 +514,16 @@
<li class="md-nav__item">
<a href="#environments" class="md-nav__link">
<span class="md-ellipsis">
Environments
🌍 Environments
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#read-next" class="md-nav__link">
<span class="md-ellipsis">
📚 Read Next
</span>
</a>
@@ -566,9 +575,10 @@
<h1 id="deployment">Deployment</h1>
<h1 id="deployment">🚀 Deployment</h1>
<p>How the auth server is configured and shipped.</p>
<h2 id="environment-variables">Environment variables</h2>
<hr />
<h2 id="environment-variables">⚙️ Environment variables</h2>
<table>
<thead>
<tr>
@@ -619,13 +629,15 @@
</table>
<p>Credentials and the token secret live in the environment / Deploy secrets —
see <code>.env.example</code> for the shape. <code>.env</code> is gitignored.</p>
<h2 id="running-locally">Running locally</h2>
<hr />
<h2 id="running-locally">💻 Running locally</h2>
<div class="language-bash highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1">1</a></span>
<span class="normal"><a href="#__codelineno-0-2">2</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a>cp<span class="w"> </span>.env.example<span class="w"> </span>.env<span class="w"> </span><span class="c1"># fill in MONGO_HOST, JWT_SECRET</span>
</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2"></a>uvicorn<span class="w"> </span>main:app<span class="w"> </span>--reload<span class="w"> </span>--port<span class="w"> </span><span class="m">8000</span>
</span></code></pre></div></td></tr></table></div>
<p>The health endpoint is available at <code>GET /health</code>.</p>
<h2 id="container-image">Container image</h2>
<hr />
<h2 id="container-image">🐳 Container image</h2>
<p>The <code>Dockerfile</code> is a multi-stage build on <code>python:3.13-slim</code>:</p>
<ol>
<li><strong>Builder</strong> installs <code>requirements.txt</code> from the private pip index using
@@ -634,7 +646,8 @@ see <code>.env.example</code> for the shape. <code>.env</code> is gitignored.</p
port <code>8000</code>, and runs <code>uvicorn main:app</code>. A <code>HEALTHCHECK</code> curls
<code>/health</code>.</li>
</ol>
<h2 id="cicd-drone">CI/CD (Drone)</h2>
<hr />
<h2 id="cicd-drone">🔄 CI/CD (Drone)</h2>
<p><code>.drone.yml</code> ships on <strong>git tag</strong> events (arm64):</p>
<ol>
<li>Resolve the latest tag.</li>
@@ -647,7 +660,8 @@ see <code>.env.example</code> for the shape. <code>.env</code> is gitignored.</p
<p>The deployed container runs with <code>--restart always</code>, maps host <strong><code>9003</code>
<code>8000</code></strong>, resolves <code>private-pi</code> to <code>192.168.1.111</code> for Mongo, and receives
<code>MONGO_*</code> + <code>JWT_SECRET</code> from secrets.</p>
<h2 id="environments">Environments</h2>
<hr />
<h2 id="environments">🌍 Environments</h2>
<table>
<thead>
<tr>
@@ -671,6 +685,11 @@ see <code>.env.example</code> for the shape. <code>.env</code> is gitignored.</p
</tbody>
</table>
<hr />
<h2 id="read-next">📚 Read Next</h2>
<ul>
<li><a href="../03_platform_integration/">Platform Integration</a> — the <code>/introspect</code> contract.</li>
<li><a href="../05_development/">Development</a> — local setup, tests, and docs.</li>
</ul>