سوو یک شبکه فروشگاهی اجتماعی فارسی برای فروشندگان آنلاین فعال ایران است. هر فروشنده فروشگاه مستقل و قابل شخصیسازی دارد؛ خریدار میتواند از لینک مستقیم وارد شود، کالا ببیند، فروشگاهها را دنبال کند، در فید کشف گردش کند و سفارش خود را درون پلتفرم پیگیری کند.
نام رسمی محصول «سوو» است و در متن لاتین فقط به صورت
Sevoنوشته میشود. نام مخزنsevomartصرفاً شناسه فنی مخزن است.
پشته فنی، مرز ماژولها و خط پایه مهندسی نسخه اول پذیرفته شدهاند. مخزن یک pnpm workspace با web، API، worker، PostgreSQL محلی و کنترلهای تست و CI دارد؛ قابلیتهای محصول فقط از Issue ساخت افزوده میشوند.
با Node.js 22.13+، Corepack و Docker:
corepack enable
pnpm install
pnpm compose:upاین فرمان PostgreSQL، MinIO، migration، API، worker و web را build میکند و تا سلامت کامل منتظر
میماند. web در http://localhost:3100، API در http://localhost:3101 و OpenAPI در
http://localhost:3101/openapi است. توقف با pnpm compose:down دادهها را حفظ میکند.
برای حلقهٔ سریع hot reload، pnpm dev زیرساخت را در Docker و برنامهها را بومی اجرا میکند؛ web روی
3200 و API روی 3201 خواهد بود تا همزمان با Compose یا پروژههای رایج دیگر تداخل نداشته باشد. pnpm quality کنترل سریع و pnpm test کل آزمونهاست. جزئیات در
راهنمای خط پایه توسعه ثبت شده است.
pnpm test:e2e در اجرای محلی PostgreSQL و MinIO واقعی اما جدا و موقت با نام
sevomart-e2e میسازد و پس از آزمون container و volumeهای همان پروژه را حذف میکند؛
دادهٔ محیط توسعه برای آمادهسازی fixtureها تغییر نمیکند.
ریل امن demo:seed، fingerprint مقصد، manifest نسخهدار و profile جداگانهٔ demo/QA در
راهنمای runtime دادهٔ نمایشی و QA توضیح داده شده است.
این فرمان DATABASE_URL ارثی را نمیپذیرد و هنوز دادهٔ داستانی کامل نمیسازد؛ baseline کامل
در Issue مستقل خود افزوده میشود.
- قواعد همکاری و عاملها
- زمینه و زبان مشترک
- تصویر محصول
- محدوده نسخه اول
- نقشه Wayfinder
- راهنمای کار موازی
- فهرست پژوهشها
- خط پایه توسعه، تست و CI
دلیل وجود محصول، قابلاعتمادتر و قابلپیگیریتر کردن خرید از فروشندگان آنلاین است. هیچ رابط، متن یا قابلیت نباید سطح حفاظت را بیشتر از واقعیت نشان دهد.
کار از Issue شروع میشود، در یک شاخه محدود انجام میشود و با Pull Request توسعهدهنده دیگر ادغام میشود. تصمیمهای Wayfinder و کارهای ساخت دو backlog جدا هستند؛ جزئیات در راهنمای مشارکت آمده است.